doc-gardening

Audit repository documentation against code and apply targeted fixes.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/devinitive-team/mirage --skill doc-gardening
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-gardening
Source: https://github.com/devinitive-team/mirage/tree/main/.agents/skills/doc-gardening
Command: npx skills add https://github.com/devinitive-team/mirage --skill doc-gardening

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Ensures repository documentation matches code changes by auditing and correcting discrepancies, facilitating better documentation and maintenance practices.

Core Features & Use Cases

  • Documentation Alignment: Identifies discrepancies between documentation and code to ensure consistency.
  • Automated Fixes: Performs targeted corrections and updates documentation where code changes are detected.
  • Use Case: Ideal for developers needing to reconcile outdated or inconsistent documentation after making changes to the codebase.

Quick Start

Run the doc-gardening command to automate documentation cleanup based on the latest code changes.

Frequently Asked Questions about doc-gardening

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

FAQPage Schema
How do I find and fix outdated documentation in my codebase?

To fix outdated repository documentation, run automated audits to detect discrepancies between your docs and the codebase, then apply targeted corrections to resolve the mismatches and ensure consistency.

What is documentation reconciliation and how does it work?

Documentation reconciliation is the process of identifying mismatches between code changes and existing repository documentation. It works by running automated audits against the codebase to detect inconsistencies and applying targeted fixes to align the docs.

When do I need to audit my repository documentation?

You need to audit your repository documentation after making changes to the codebase. This ensures that your documentation remains accurate and up-to-date, preventing discrepancies that lead to maintenance issues and developer confusion.

Can I automate documentation updates after code changes?

Yes, you can automate documentation updates by running a command that performs documentation cleanup based on the latest code changes. It automatically applies targeted corrections to keep your repository docs aligned with the codebase.

What's the best way to maintain documentation consistency in a repository?

The best way to maintain documentation consistency is through regular automated audits that detect discrepancies between your docs and codebase. Applying targeted fixes ensures your documentation matches your code changes accurately.

Why does my repository documentation not match the current code?

Your repository documentation may not match the current code because documentation updates were not applied after code changes. Running automated audits and targeted fixes resolves these discrepancies and restores consistency.