Skip to content
Skills Library
Programming · Writing

agent-docs-guild

/agent-docs-guild

Run a team of documentation agents that finds the gaps, drafts the pages, gets them reviewed against the code, and sweeps for staleness on a schedule. Use when a codebase has outrun its docs and you need both new coverage and a way to stop pages from rotting.

Repository
AI-SKILLS ↗
Licence
MIT
Last repository change
05.09.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 05.09.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Run a team of documentation agents that finds the gaps, drafts the pages, gets them reviewed against the code, and sweeps for staleness on a schedule. Use when a codebase has outrun its docs and you need both new coverage and a way to stop pages from rotting.

Original author description

Run a team of documentation agents that finds the gaps, drafts the pages, gets them reviewed against the code, and sweeps for staleness on a schedule. Use when a codebase has outrun its docs and you need both new coverage and a way to stop pages from rotting.

How it works

  1. Method
  2. Run it
  3. Signals it works
  4. Boundaries
Original SKILL.md headings · 58 lines, 520 words
SKILL.md preview
---
name: agent-docs-guild
description: Run a team of documentation agents that finds the gaps, drafts the pages, gets them reviewed against the code, and sweeps for staleness on a schedule. Use when a codebase has outrun its docs and you need both new coverage and a way to stop pages from rotting.
---

# Agent docs guild

Docs rot quietly. A feature ships, the page describing the old behavior stays
up, and no one owns the drift. A guild hands each part of the job to its own
agent: one finds what is missing or wrong, one writes, an engineer checks it
against the code, and one sweeps for staleness on a cadence. Coverage and
freshness are separate jobs, so they get separate agents.

## Method

1. **Gap analyst diffs docs against reality.** Compare the documented surface,
   public API, CLI flags, config keys, and user flows, against the code and the
   changelog. Output `gaps.md`, one row per undocumented or contradicted topic,
   ranked by how many users hit it. A missing endpoint outranks a typo.
2. **Drafter writes one page per gap.** Load `technical-writer-role`. Produce a
   `page.md` per topic: what it does, a minimal working example, parameters, and
   failure modes. Pull real signatures and defaults from source instead of
   inventing them.
3. **Technical reviewer verifies against code.** Load `backend-engineer-role` or
   the module owner. The reviewer runs every example and confirms each claim
   maps to current behavior, returning findings anchored to `file:line`. A page
   that reads well but describes stale behavior fails.
4. **Loop draft and review until examples run.** The drafter fixes each finding
   or defends it. Cap at two rounds; a claim neither side can settle escalates
   to the module owner rather than shipping unverified.
5. **Freshness sweeper runs on a schedule.** On a cron cadence, scan merged
   pages for version drift, dead links, and examples that no longer compile
   against `main`. Output `staleness-report.md`: page, symptom, suspected
   cause. It reopens work, it does not fix it.
6. **Route stale pages back as fresh gaps.** Each staleness finding becomes a
   row the gap analyst re-ranks, closing the loop so a shipped page that goes
   stale re-enters the pipeline instead of quietly lying to readers.

## Run it

In Claude Code, run gap, draft, and review as subagents in sequence, one page
per draft subagent to keep contexts small, and fan the drafters out in parallel
when the gaps are independent. Keep `gaps.md` and the pages as files on a docs
branch, and schedule the sweeper as a recurring job that reopens `gaps.md`.
Terminate a cycle when `gaps.md` holds no open rows and every merged page passed
review; the freshness loop never terminates, it recurs. To port, use a CrewAI
sequential Crew with a scheduled kickoff, an AutoGen GroupChat with a reviewer
critic, or a LangGraph graph with a periodic trigger feeding the gap node.

## Signals it works

- Every merged page had its examples executed by the reviewer, not just read.
- Gaps rank by user impact, so the most-hit missing page gets written first.
- A feature that shipped last week already has a gap row or a live page.

## Boundaries

This guild produces reference and task docs, not marketing copy or API design
decisions. It defers tone and information architecture to the project's docs
convention, and it will not publish a page the technical reviewer never cleared.
Whether a topic deserves a page at all stays with the docs owner.

Versions

The database has no other skills named agent-docs-guild.

Database snapshot: 13.11.2026 · package version c0d1393df5b4 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100docs-audit-and-refresh
    Audit the repository's docs/ content against the current codebase, find missing, incorrect, or stale documentation, and refresh the affected pages. Use when the user asks to review docs coverage, find outdated docs, compare docs with the current repo, or fix documentation drift…
  • 100tl-docs-audit
    Audit existing documentation for gaps, staleness, and sync issues. Generates sync reports with actionable findings. Use when reviewing doc coverage, finding outdated docs, or syncing docs with code.
  • 100doc-drift-detector
    Detect documentation drift against code changes, score staleness, validate API docs via AST parsing, and audit link integrity. Use when docs fall out of sync with code, preparing releases, running CI doc gates, or auditing doc accuracy.
  • 90pb-docs-site
    Publish a project's docs as a static HTML manual on GitHub Pages: check that Pages is enabled, bring the wiki up to date, list the doc gaps, build the site, preview it locally and push it after GO. Use for "publish the docs", "docs site", "put the manual on GitHub Pages".
  • 95guild-review
    Two-stage review of per-specialist handoff receipts (spec compliance first, then quality), plus Guild's fresh-context code-review request/response discipline — how a lane solicits a reviewer with crafted context, and how it acts on the findings (triage; push back only with…
  • 100audit-docs
    Audit documentation for drift, staleness, and inconsistency against the actual codebase. Use when user says "audit docs", "check documentation", "docs audit", or "documentation review". Spawns parallel subagents to explore codebase subsystems, then cross-references all…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.