Does it only check the README.md file?

No, it ensures consistency across the entire documentation stack, including marketplace.json, SYNC-STATUS.md, INSTALL_TEMPLATE.md, and specific knowledge templates.

When does this skill activate?

It auto-activates whenever you work with documentation files or use keywords like 'readme', 'docs', 'commit', 'sync', or when adding/removing skills and agents.

Why is consistency important for AI agents?

Accurate documentation ensures that AI agents have the correct context and don't attempt to invoke skills, tools, or commands that no longer exist in the codebase.

Can I use this for automated testing?

Yes, this skill is part of a 4-layer defense system that includes pytest-based automated checks that can be enforced during CI/CD to prevent merging inconsistent docs.

What is documentation drift?

Documentation drift occurs when a project's README or supporting documents become outdated as the codebase evolves, leading to incorrect metrics, broken links, or references to deprecated features.

Documentation Consistency Enforcement

Name: Documentation Consistency Enforcement
Author: akaszubski

byakaszubski

•

Content Management

Prevents documentation drift by automatically synchronizing README.md metrics with the actual codebase state.

Documentation Consistency Enforcement is a critical utility for autonomous development environments that ensures your project documentation never falls out of sync with your code. It acts as a multi-layered defense system, automatically verifying that counts for skills, agents, and commands match reality across all documentation files, including READMEs and marketplace manifests. By auto-activating during commits and doc updates, it eliminates user confusion caused by outdated information and ensures that every referenced skill actually exists within the repository.

Key Features

01Auto-activation triggered by documentation and commit keywords

0210 GitHub stars

03Real-time documentation drift prevention and monitoring

04Automated skill, agent, and command count verification

05Seamless integration with CI/CD testing and pre-commit hooks

06Multi-file synchronization across README.md and marketplace.json

Use Cases

01Maintaining accurate counts of project components in large, fast-moving repositories

02Standardizing documentation updates during autonomous development cycles

03Preventing broken links and references to non-existent tools in documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add akaszubski/autonomous-dev consistency-enforcement

For use in Claude.ai and ChatGPT

Download Skill