Use this skill when agent-facing docs, memory, or workspace notes feel stale,
duplicated, contradictory, noisy, or hard to navigate.
What to detect
stale notes that no longer match the repo
duplicate facts split across multiple files
contradictions between policy, memory, and current implementation
overly broad claims that should be narrowed or qualified
unlinked or orphaned memory with no clear entry point
raw logs that should be summarized or deleted instead of preserved
Procedure
Start from agent-workspace/index.md and the most likely affected area.
Compare the note against the current repository state.
Collapse duplicates and replace vague claims with smaller grounded ones.
Remove or summarize raw noise that does not deserve durable storage.
Leave links or cross-references so the cleaned note is easier to find next
time.
Quality checklist
The workspace became easier to navigate.
Durable notes still point at real repository evidence.
Contradictions were resolved or clearly called out.
No important context was deleted without being synthesized elsewhere.
The resulting diff is reviewable and justified.
1---2name: doc-gardening3description: Doc Gardening Skill4---5# Doc Gardening Skill67## When to use it89Use this skill when agent-facing docs, memory, or workspace notes feel stale,10duplicated, contradictory, noisy, or hard to navigate.1112## What to detect1314- stale notes that no longer match the repo15- duplicate facts split across multiple files16- contradictions between policy, memory, and current implementation17- overly broad claims that should be narrowed or qualified18- unlinked or orphaned memory with no clear entry point19- raw logs that should be summarized or deleted instead of preserved2021## Procedure22231. Start from `agent-workspace/index.md` and the most likely affected area.242. Compare the note against the current repository state.253. Collapse duplicates and replace vague claims with smaller grounded ones.264. Remove or summarize raw noise that does not deserve durable storage.275. Leave links or cross-references so the cleaned note is easier to find next28 time.2930## Quality checklist3132- The workspace became easier to navigate.33- Durable notes still point at real repository evidence.34- Contradictions were resolved or clearly called out.35- No important context was deleted without being synthesized elsewhere.36- The resulting diff is reviewable and justified.
Run npx skillmds@latest add qredence/doc-gardening in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Doc Gardening Skill It is listed under AI & ML on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Qredence (@qredence) published this skill. Their other Agent Skills are listed on their SkillMD profile.
Qredence