garden-docs

Audit repository Markdown files against current code and produce citation-backed punch lists.

4|1|Updated May 20, 2026
One-click install
npx skills add https://github.com/concordance-co/xenon --skill garden-docs-concordance-co
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: garden-docs
Source: https://github.com/concordance-co/xenon/tree/main/.agents/skills/garden-docs
Command: npx skills add https://github.com/concordance-co/xenon --skill garden-docs-concordance-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Force a focused pass over repo documentation to catch drift, bloat, and stale claims by cross-checking against current code, producing a structured punch list grounded in evidence.

Core Features & Use Cases

  • Thorough inventory of in-scope Markdown files to surface gaps, redundancies, and outdated claims.
  • Per-file checks for dead references, layout-claim drift, cross-document contradictions, and documentation bloat.
  • Generated, citation-backed punch list with actionable remediation steps and suggested owners.

Quick Start

Run the garden-docs audit to inventory in-scope Markdown files, identify dead references and layout drift, and produce a prioritized punch list with citations.

Frequently Asked Questions about garden-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit markdown documentation for drift against current code?

A documentation drift audit cross-checks in-scope markdown files like AGENTS.md against current code to surface dead references, layout-claim drift, and contradictions. It generates a citation-backed punch list with actionable remediation steps and suggested owners for each file.

What is documentation drift and how do I identify stale repo docs?

Documentation drift happens when markdown claims become outdated relative to current code. An audit identifies stale repo docs by inventorying in-scope markdown files, cross-checking them against the codebase, and surfacing dead references, layout-claim drift, and cross-document contradictions.

Can I automatically generate a punch list for fixing documentation bloat?

Yes, you can generate a punch list for documentation bloat by running a focused audit across in-scope markdown files. The audit evaluates files for redundancies and outdated claims, producing a citation-backed punch list with actionable remediation steps and suggested owners.

Does the documentation audit work with specific repository layouts and markdown structures?

The documentation audit works with specific repository layouts by applying checks across in-scope markdown files including AGENTS.md, methodology, operations, platform, and workspace docs. It identifies layout-claim drift, dead references, and contradictions while honoring documented procedures and anti-patterns.

What is the best way to find dead references in repository markdown files?

The best way to find dead references in repository markdown files is to run a documentation audit that cross-checks in-scope markdown against current code. The audit surfaces dead references and cross-document contradictions, producing a citation-backed punch list with actionable remediation steps.