‹ The Index

Better Docs

skill

Optimize repository documentation and make AGENTS.md a lean routing file. Use this skill whenever: the user wants to clean up project docs, reorganize documentation, audit AGENTS.md, reduce AGENTS.md bloat, move detailed content into docs/, create a docs/ structure, harvest decisions from old plans, write ADRs from implemented features, deduplicate documentation, remove stale docs, or any request involving "clean up docs", "optimize AGENTS.md", "docs audit", "documentation maintenance", "organize my docs", "lean AGENTS.md", "better docs", "doc inventory", "docs restructure". Also trigger when the user says things like "my AGENTS.md is too long", "docs are a mess", "where should this doc go", or "make AGENTS.md smaller".

Works with: Claude Code (native)  ·  Cursor, Codex CLI (manual)
native: this artifact type is that client's own format

Category: Dev Tools & CI — see all ranked ›

Install (Claude Code):

cp -r better-docs ~/.claude/skills/

Security audit

Not scanned yet. We audit npm-published capabilities for known advisories, install-time scripts and permission surface; this one has no npm package we can resolve, or has not reached the queue.

source ↗  ·  skill:Darmikon/better-docs

Already running this? npx tashan-cli doctor checks your whole config against the Index — how it works ›

Measured 2026-08-05  ·  scorer s5  ·  how  ·  something wrong here?