New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Docs Gardening

by mhmzdev in mhmzdev/the-holy-quran-app

Audit and maintain The Holy Qur'an app's knowledge base (AGENTS.md, .agents/rules/, docs/ OKF bundle) for staleness, broken cross-links, drift from code, and OKF structural issues.

MITAuto-check passedAgent Workflows

Install Docs Gardening

skills CLI
$ npx skills add mhmzdev/the-holy-quran-app --skill docs-gardening -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mhmzdev/the-holy-quran-app docs-gardening --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mhmzdev/the-holy-quran-app.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/docs-gardening .claude/skills/docs-gardening && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
docs-gardening
GitHub stars
889
Token cost
~1.1k tokens
SKILL.md length
438 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Audit and maintain The Holy Qur'an app's knowledge base (AGENTS.md, .agents/rules/, docs/ OKF bundle) for staleness, broken cross-links, drift from code, and OKF structural issues.

  • Works in 7 steps: Inventory → Frontmatter (OKF) → Staleness (docs vs code) → …
  • Asked to review
  • SKILL.md covers Principles, Layout being gardened, Passes (report findings after… and Reporting format, plus 1 more section
  • Calls git

What it does

Docs Gardening is an agent skill from mhmzdev/the-holy-quran-app. Audit and maintain The Holy Qur'an app's knowledge base (AGENTS.md, .agents/rules/, docs/ OKF bundle) for staleness, broken cross-links, drift from code, and OKF structural issues. Use when asked to review, garden, audit, update, or clean up the docs. Also use proactively after any architectural change, convention shift, dependency/SDK bump, or feature merge.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Agent instruction files and Knowledge bases. It works with Android and Flutter. The repository describes itself as: Holy Qur'an application developed via Flutter. The licence is MIT.

When your agent uses it

  • Asked to review
  • Clean up the docs

Example prompts

  • “an app”
  • “/docs-gardening”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Inventory
  2. Frontmatter (OKF)
  3. Staleness (docs vs code)
  4. Cross-links
  5. Duplication
  6. Structural rules
  7. Obsolete files

What it can do on your machine

Read from SKILL.md and the folder at commit 33edb90. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Docs Gardening loads about 1.1k tokens when it runs. Until then it costs about 94 tokens; SKILL.md has 438 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~94
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mhmzdev/the-holy-quran-app at commit 33edb90, republished under its MIT licence (© mhmzdev). 438 words, ~1,122 tokens.

Download SKILL.mdSave it as .claude/skills/docs-gardening/SKILL.md (or your agent's skills folder).
name
docs-gardening
description
Audit and maintain The Holy Qur'an app's knowledge base (AGENTS.md, .agents/rules/, docs/ OKF bundle) for staleness, broken cross-links, drift from code, and OKF structural issues. Use when asked to review, garden, audit, update, or clean up the docs. Also use proactively after any architectural change, convention shift, dependency/SDK bump, or feature merge.
argument-hint
optional scope — e.g. architecture, features, decisions, all

Docs Gardening

Keep the harness honest: every doc reflects current code, cross-links resolve, frontmatter is valid, and each file earns its place. Stale docs are worse than none — agents trust them.

This is maintenance, not writing. Default to fixing or deleting, not adding.

Principles

  1. Docs exist to cut re-instruction cost. If a page doesn't help an agent ship correctly, it's dead weight.
  2. AGENTS.md is a map (< ~100 lines) pointing into docs/. Growth is drift.
  3. docs/ is the system of record, an OKF bundle: markdown + YAML frontmatter, one concept per file, file path = identity, index.md per folder for progressive disclosure, log.md for chronology, relative markdown links for the graph.
  4. .agents/rules/*.md are the always-on digest; they summarize and link to docs/conventions/, never restate at length.
  5. Duplication is drift — one home per fact, cross-link elsewhere.
  6. Code wins over docs. Update or delete the doc; never "fix" code to match a stale doc.

Layout being gardened

AGENTS.md  (CLAUDE.md is just @AGENTS.md)
.agents/rules/   .agents/skills/   (.claude/{rules,skills} are symlinks)
docs/
  index.md  log.md
  architecture/  conventions/  decisions/  domain/  features/  screens/
  tooling/  platforms/  learnings/  exec-plans/{index.md,backlog,active,completed}
  brainstorm/  code-review/

Passes (report findings after each; ask before mass edits; single-file fixes go straight through)

1 — Inventory

List every .md under docs/, AGENTS.md, .agents/rules/. Note sizes and git log -1 --format=%ci <file>. Flag files outside the layout.

2 — Frontmatter (OKF)

Every docs/**/*.md (except .gitkeep) starts with YAML frontmatter containing at least type; expect title, description, tags, timestamp (ISO 8601). decisions/ also carry status and date; exec-plans/ carry status. Fix missing/invalid fields.

3 — Staleness (docs vs code)
  • File paths mentioned → exist? Class/function names → grep them.
  • Bloc list (architecture/state-management.md) ↔ lib/blocs/. Provider list ↔ lib/providers/.
  • Routes (screens/flows.md) ↔ lib/router/routes.dart + router.dart.
  • Models/typeIds/box keys (architecture/data-layer.md, domain/alquran-cloud-api.md) ↔ packages/al_quran_api/lib/src/.
  • Widget catalogue (architecture/configs.md, rules) ↔ lib/ui/widgets/.
  • Versions (tooling/fvm-and-sdk.md, platforms/android.md, conventions/release.md) ↔ .fvmrc, pubspec.yaml, android/**/*.kts, .github/workflows/run_test.yml.
  • Commands in AGENTS.md/tooling/ still valid?
  • Feature docs' "Known gaps" — fixed already? Remove.
Show full SKILL.md (156 more words)Show less

Grep every markdown link (text in square brackets followed by a parenthesised path) and verify each relative target exists. AGENTS.md Docs section points to real folders/files. Every folder has an index.md listing its files.

5 — Duplication

Same fact in two places (commands, versions, layer rules, typeIds)? Pick the canonical home, cut elsewhere, link.

6 — Structural rules
FileRule
AGENTS.md< ~100 lines, map only
.agents/rules/*.mddigest + link; has paths: frontmatter
docs/decisions/*.mdappend-only; supersede with a new ADR, never edit history
docs/log.mdnewest first, one line per change, dated
docs/exec-plans/index.mdmatches the files in backlog/active/completed
other docsfirst line after frontmatter states purpose; no TODOs (surface in report)
7 — Obsolete files

Candidates: docs for removed features, superseded pages. Never delete without asking.

Reporting format

### Pass N — <name>
**Fine:** …
**Needs fixing (applying now):** file:line — issue
**Needs confirmation:** …
**Verified against code:** …

Finish with a docs/log.md line summarizing the gardening.

What NOT to do

  • Write new docs unless asked. Add TODOs. Rewrite prose for style. Edit past ADRs. Assume old == stale (check the code).

© mhmzdev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/docs-gardening of mhmzdev/the-holy-quran-app.

Open the folder on GitHubat commit 33edb90

Compare with similar skills

Docs Gardening next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Docs Gardening compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Docs Gardening this skillmhmzdev/the-holy-quran-app889—~1.1kAutomated safety check: PassMIT
Sake Workflowkattouf/Sake116—~935Automated safety check: PassMIT
Claude Code Knowledgedykyi-roman/awesome-claude-code103—~4kAutomated safety check: PassMIT
Project InitBlackBeltTechnology/pi-agent-dashboard316—~3.4kAutomated safety check: PassMIT
Skill CreatorChevey339/kelivo4.2k—~1.3kAutomated safety check: PassAGPL-3.0
Setup Matt Pocock Skillsywwynm/EverythingDone1449 repos~1.7kAutomated safety check: PassGPL-3.0

Similar skills

  • Sake Workflow

    kattouf/Sake

    A skill your agent uses when starting any new task in the Sake project - ensures structured execution with knowledge discovery, quality checks, and organic growth of the project knowledge base…

    116 GitHub stars~935 tokensUpdated 6 mo ago
    Agent WorkflowsAuto-check passed

  • Claude Code Knowledge

    dykyi-roman/awesome-claude-code

    Comprehensive knowledge base for Claude Code formats, patterns, and configuration.

    103 GitHub stars~4k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

  • Project Init

    BlackBeltTechnology/pi-agent-dashboard

    Scaffold an unconfigured directory into a configured pi project.

    316 GitHub stars~3.4k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Skill Creator

    Chevey339/kelivo

    Create or improve skills, turn a conversation into reusable SKILL.md instructions, and validate their behavior.

    4.2k GitHub stars~1.3k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Setup Matt Pocock Skills

    ywwynm/EverythingDone

    Sets up an Agent skills block in AGENTS.md/CLAUDE.md and docs/agents/ so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc…

    144 GitHub starsUsed in 9 repos~1.7k tokens
    Agent WorkflowsAuto-check passed

  • Add Remote Endpoint

    nextcloud/android-library

    A skill your agent uses when adding a new remote/network endpoint (a RemoteOperation / OCSRemoteOperation) to this Nextcloud Android library, or when the user says "add an endpoint", "new remote…

    106 GitHub stars~1.1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from mhmzdev/the-holy-quran-app

  • Brainstorm

    mhmzdev/the-holy-quran-app

    Explore WHAT to build for The Holy Qur'an app through collaborative dialogue before any planning or code.

    889 GitHub stars~845 tokensUpdated 27 days ago
    Auto-check passed

  • Plan

    mhmzdev/the-holy-quran-app

    Turn an idea or brainstorm into an actionable execution plan for The Holy Qur'an app with phases, file changes, and machine-checkable success criteria.

    889 GitHub stars~957 tokensUpdated 27 days ago
    Auto-check passed

  • Review

    mhmzdev/the-holy-quran-app

    Review The Holy Qur'an app code against the project's own conventions — layering (UI → Bloc → Repo → DataProvider), bloc anatomy, Provider tier, configs tokens, class widgets, Hive typeId safety…

    889 GitHub stars~907 tokensUpdated 27 days ago
    Auto-check passed

  • UI Design

    mhmzdev/the-holy-quran-app

    Design Flutter UI screens and widgets for The Holy Qur'an app.

    889 GitHub stars~1.2k tokensUpdated 27 days ago
    Auto-check passed

  • Grill Me

    mhmzdev/the-holy-quran-app

    Stress-test a plan, design, or idea for The Holy Qur'an app before implementation by interrogating it one question at a time — walking the decision tree, resolving dependencies, and surfacing every…

    889 GitHub stars~778 tokensUpdated 27 days ago
    Auto-check passed

  • Refine Approach

    mhmzdev/the-holy-quran-app

    Sharpen an existing brainstorm or execution plan for The Holy Qur'an app — score it for clarity, completeness, specificity, YAGNI, and scope, then improve it in place.

    889 GitHub stars~600 tokensUpdated 27 days ago
    Auto-check passed

Works with

Categories

Questions about Docs Gardening

What does Docs Gardening do?

Audit and maintain The Holy Qur'an app's knowledge base (AGENTS.md, .agents/rules/, docs/ OKF bundle) for staleness, broken cross-links, drift from code, and OKF structural issues. Docs Gardening is an agent skill from mhmzdev/the-holy-quran-app.agents/rules/, docs/ OKF bundle) for staleness, broken cross-links, drift from code, and OKF structural issues.

When should I use Docs Gardening?

Docs Gardening fits situations like: asked to review; clean up the docs.

How do I install Docs Gardening in Claude Code?

Run `npx skills add mhmzdev/the-holy-quran-app --skill docs-gardening -a claude-code`. Or copy the skill folder (.agents/skills/docs-gardening in mhmzdev/the-holy-quran-app) into .claude/skills/docs-gardening in your project. Claude Code loads it when a task matches its description.

How do I install Docs Gardening in Codex?

Run `npx skills add mhmzdev/the-holy-quran-app --skill docs-gardening -a codex`. Or copy the skill folder (.agents/skills/docs-gardening in mhmzdev/the-holy-quran-app) into .agents/skills/docs-gardening in your project. Codex loads it when a task matches its description.

Can I use Docs Gardening in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mhmzdev/the-holy-quran-app --skill docs-gardening -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/docs-gardening, .gemini/skills/docs-gardening, .github/skills/docs-gardening and .opencode/skills/docs-gardening in your project.

What does Docs Gardening need to run?

Going by SKILL.md and its folder, Docs Gardening needs the command-line tools its instructions call (git).

Does Docs Gardening access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Docs Gardening safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Docs Gardening use?

Docs Gardening is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Docs Gardening use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Docs Gardening?

Skills that share tags, products or a category with Docs Gardening: Sake Workflow (kattouf/Sake, 116 stars), Claude Code Knowledge (dykyi-roman/awesome-claude-code, 103 stars), Project Init (BlackBeltTechnology/pi-agent-dashboard, 316 stars) and Skill Creator (Chevey339/kelivo, 4.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Docs Gardening?

mhmzdev (a GitHub user) maintains it in mhmzdev/the-holy-quran-app, which has 889 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on September 10, 2026.

Source: mhmzdev/the-holy-quran-app on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.