archibate $ARGUMENTS Audit this doc for over-description. The reader is a capable agent that can reason from naming and read referenced code. Flag and propose to trim: rationale repeated >1×; rules / tag-sets / lists restated across sections; justifying parentheticals after self-evident statements; defensive prose against dead or hypothetical workflows; behavior the code self-documents; symbol explanations the naming makes obvious. Bias toward trimming — keep only what changes behavior or removes real ambiguity.
Doc Detrim
Audit agent-facing documentation (CLAUDE.md, SKILL.md, AGENTS.md, prompt markdown, agent reference doc, memory pages) for over-description and propose trims. Use proactively after writing or editing any agent-facing doc, or when the user says "trim this doc", "audit doc bloat", "this is over-explained".
Doc Detrim by archibate · 4e77b0c
npx skillmds@latest add archibate/doc-detrim File contents
---name: doc-detrimdescription: Audit agent-facing documentation (CLAUDE.md, SKILL.md, AGENTS.md, prompt markdown, agent reference doc, memory pages) for over-description and propose trims. Use proactively after writing or editing any agent-facing doc, or when the user says "trim this doc", "audit doc bloat", "this is over-explained".---$ARGUMENTSAudit this doc for over-description. The reader is a capable agent that can reason from naming and read referenced code. Flag and propose to trim: rationale repeated >1×; rules / tag-sets / lists restated across sections; justifying parentheticals after self-evident statements; defensive prose against dead or hypothetical workflows; behavior the code self-documents; symbol explanations the naming makes obvious. Bias toward trimming — keep only what changes behavior or removes real ambiguity.
archibate/dotfiles-codex/tree/main/skills/archibate/doc-detrim commit 4e77b0c65e
Frequently asked questions
Run npx skillmds@latest add archibate/doc-detrim 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.
Audit agent-facing documentation (CLAUDE.md, SKILL.md, AGENTS.md, prompt markdown, agent reference doc, memory pages) for over-description and propose trims. Use proactively after writing or editing any agent-facing doc, or when the user says "trim this doc", "audit doc bloat", "this is over-explained". It is listed under AI & ML on SkillMD.
This skill has not completed SkillMD's automated safety review yet. 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.
archibate (@archibate) published this skill. Their other Agent Skills are listed on their SkillMD profile.