Doc Hygiene
Keeps the always-read session-start docs (this project's AGENTS.md, Roadmap/WAYS-OF-WORKING.md, Roadmap/LEARNINGS.md, Roadmap/README.md poster) from re-bloating after the one-time de-noise sweep. Use when the product owner asks to "check doc hygiene", "measure LEARNINGS size", "is LEARNINGS bloated again", "run the doc hygiene report", or as the weekly Routine C hygiene pass. Runs scripts/doc-hygiene.mjs, reviews its flagged candidates against the source docs, and emits a dated advisory report. Never edits Roadmap docs — proposals only, the product owner or the builder hand-merges.
Install
npx skills add danybgoode/golden-frijoles --skill doc-hygienegit clone --depth 1 https://github.com/danybgoode/golden-frijoles.git /tmp/golden-frijoles
mkdir -p ~/.claude/skills
cp -r /tmp/golden-frijoles/.claude/skills/doc-hygiene ~/.claude/skills/doc-hygienePersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Doc hygiene — rolling maintenance for the always-read set (Cowork or Claude Code)
> **Running this skill's scripts.** Each `node scripts/<name>.mjs <args>` below means, from the project root:
> `if [ -f scripts/<name>.mjs ]; then node scripts/<name>.mjs <args>; else npx -y @golden-frijoles/kit@0.45.0 <name> <args>; fi`
> The project's own copy always wins. The kit needs no install and copies nothing into the repo. If npx fails on
> the network or the registry (ENOTFOUND, ECONNREFUSED, ETIMEDOUT, E404, a proxy error), report **could not
> look: the kit is unreachable**, not a broken project, and offer to retry online or to copy the script into
> `scripts/`. This covers the scripts the kit carries (`frijoles-kit --list`). Any other `scripts/` command here is
> project tooling: if the project lacks it, say so and stop. Never re-implement a script's logic inline.
> If a script prints `GF-NEEDS-SETTING {"key",…}`, ask the user that question once, save the answer with
> `npx -y @golden-frijoles/kit@0.45.0 config set <key> <value>` (always the kit, never local-wins: a project
> may own an unrelated `scripts/config.mjs`), tell them they can change it later the same way, and run the
> script again if it exited 7.
> **This skill never writes to `Roadmap/LEARNINGS.md` or `Roadmap/README.md`.** It measures, flags
> candidates, and writes ONE new dated report file (`Roadmap/00-ideas/DOC-HYGIENE-REPORT-<date>.md`).Details
- Skill name
doc-hygiene- Repository
- danybgoode/golden-frijoles
- Path
.claude/skills/doc-hygiene/SKILL.md- Repo updated
- 17 November 2026
- Listed in
- karanb192/awesome-claude-skills
FAQ
What does the Doc Hygiene skill do?
Keeps the always-read session-start docs (this project's AGENTS.md, Roadmap/WAYS-OF-WORKING.md, Roadmap/LEARNINGS.md, Roadmap/README.md poster) from re-bloating after the one-time de-noise sweep. Use when the product owner asks to "check doc hygiene", "measure LEARNINGS size", "is LEARNINGS bloated again", "run the doc hygiene report", or as the weekly Routine C hygiene pass. Runs scripts/doc-hygiene.mjs, reviews its flagged candidates against the source docs, and emits a dated advisory report. Never edits Roadmap docs — proposals only, the product owner or the builder hand-merges.
How do I install the Doc Hygiene skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add danybgoode/golden-frijoles --skill doc-hygiene. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Related skills
Babysit PR
danybgoode/golden-frijoles
Advisory PR watch for a single open PR — retries flaky CI (re-runs failed workflow runs) and surfaces merge conflicts via one comment; never merges, never a required check. Use when the product owner asks to "babysit this PR", "check on open PRs", "retry flaky CI", "is this PR stuck", "why isn't this PR moving", or as the nightly ops routine's third step (once per open PR across the project's repos). Runs scripts/babysit-pr.mjs, which does the gh reads, the retry, and the comment post. A clean PR (no conflict, no failing checks) gets NO comment — this tool never adds nightly noise to a healthy
Build Order Sync
danybgoode/golden-frijoles
Regenerates Roadmap/00-ideas/BUILD-ORDER.md when it has drifted from the SSOT (each epic README's frontmatter status:) and opens a claude/ docs PR with the fix — never hand-edits the board. Use when the product owner asks to "sync the build order", "regenerate BUILD-ORDER.md", "check board drift", "is the build-order board stale", "open a build-order PR", or as the nightly ops routine's first step. Runs scripts/build-order-sync.mjs, which does the check, the regen, and (on real drift) the branch/commit/ push/PR — this skill just invokes it and reports the result.
Prose Draft
danybgoode/golden-frijoles
First-draft internal close-out prose (retrospectives, product-poster entries, sprint-wrap summaries) by delegating to a cheap different-family model via the cross-agent rail. Use at sprint/epic close, or when the product owner asks to "draft the retro", "draft the poster entry", "write the sprint wrap". Runs scripts/prose-draft.mjs, which gathers the epic's own docs + git log, applies the house-voice prompt, and prints an advisory draft to stdout. The draft is NEVER committed as-is — the coordinating agent edits it for factual accuracy first (drafts invent plausible-sounding gaps; the output b
Skill Seekers
Converts documentation websites into Claude Skills. Transform existing documentation into structured skills for Claude.
Measuring Orchestration Cost
PapiScholz/symphony
Use when asked whether delegating paid off, whether a run was expensive, or how much a fan-out cost in tokens — and before quoting any cost figure, saving, or percentage for agent work. Also use when writing a cost claim into a report, README, or commit message, or when a session hit a usage limit and you need to explain where the token budget went.
Building Recommendation Systems
jeremylongshore/claude-code-plugins-plus-skills
This skill empowers Claude to construct recommendation systems using collaborative filtering, content-based filtering, or hybrid approaches. It analyzes user preferences, item features, and interaction data to generate personalized recommendations. Use this skill when the user requests to build a recommendation engine, needs help with collaborative filtering, wants to implement content-based filtering, or seeks to rank items based on relevance for a specific user or group of users. It is triggered by requests involving "recommendations", "collaborative filtering", "content-based filtering", "r
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.