What is 'doc drift' in this context?

Doc drift occurs when repository documentation becomes outdated compared to actual code behavior or when contradictory information exists in multiple locations.

Is the documentation structured for AI agents?

Yes, one of the primary goals is to ensure documentation is easy for both humans and LLMs to follow by maintaining clear entry points and authoritative truth.

Does it support project planning workflows?

Yes, it includes a specific workflow for managing active plans, detailed implementation files, and archived or rejected plans within a standardized folder structure.

How does it verify tool capability claims?

It audits claims against local CLI behavior and audited evidence rather than just trusting vendor adapter files or configuration templates.

How does this skill handle root README files?

It keeps root READMEs thin and easy to scan, serving primarily as fast-find entry points while moving detailed 'current truth' to the docs/ directory.

Documentation Steward

Name: Documentation Steward
Author: flatrick

byflatrick

0•

Gestión de Contenido

Maintains repository documentation by synchronizing core truths, preventing content drift, and optimizing layouts for both humans and AI agents.

The Documentation Steward skill ensures that repository documentation remains accurate, organized, and high-quality. It systematically audits Markdown files to eliminate stale claims and 'doc drift,' enforcing a strict taxonomy where the root README remains concise while the docs/ directory serves as the definitive source of truth. By aligning tool capability claims with audited evidence and managing the lifecycle of project plans from active development to archive, this skill creates a coherent knowledge base that is equally accessible to developers and large language models.

Características Principales

01Standardized taxonomy enforcement for root and sub-directory organization

02Propagates authoritative truth from core docs to runtime prompt assets

03Automated documentation drift auditing and resolution

040 GitHub stars

05Synchronization of tool capability claims with audited CLI evidence

06Lifecycle management for active, archived, and rejected project plans

Casos de Uso

01Organizing project roadmaps and architectural plans into a standardized directory structure

02Validating that documentation matches actual CLI behavior and specific versioning

03Auditing a repository to remove outdated instructions and redundant root README content

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add flatrick/mdt documentation-steward

For use in Claude.ai and ChatGPT