Update AGENTS.md

    1

    Automatically revalidate and fix repo maps by auditing AGENTS.md against source code, wikis, and git history.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    Update AGENTS.md

    Example session with this skill installed

    Run the AGENTS.md maintenance check. I just moved the auth modules and updated the Python version in pyproject.toml.

    • Read your context and instructions
    • Compiled the update agents md

    I have audited AGENTS.md against the current codebase, wiki, and git history. I identified 2 stale items and 1 missing entry based on your recent changes to the auth modules and pyproject.toml.

    Updated AGENTS.md Diff Summary

    CategoryFindingSource of TruthFix Applied
    StaleAuth module path cited as src/auth/ls check of src/identity/Updated path to src/identity/
    StalePython version pin at 3.10pyproject.toml:14Updated pin to 3.12
    MissingNew argon2-cffi dependencypyproject.toml:22Added to External Services section
    WrongLink to wiki/pages/auth-flow.mdgit log --stat (renamed)Updated link to wiki/pages/identity-provider.md

    AGENTS.md Update Preview

    
    ## Project Stack
    - **Language**: Python 3.12
    - **Core Framework**: FastAPI
    - **Security**: Argon2-cffi for password hashing
    
    ## Module Map
    - `src/identity/`: Handles user authentication, JWT issuance, and RBAC.
    - `src/api/`: Public REST endpoints.
    

    Next steps

    1. Review the git diff for AGENTS.md to confirm the new module descriptions.
    2. Run make test to ensure the updated documentation doesn't conflict with any docstring linters.
    3. Commit the changes to synchronize the repo map with your recent refactor.

    2 stale, 1 missing, 1 wrong → AGENTS.md updated

    Updated AGENTS.md

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Outdated repository documentation leads to developer friction and broken CI/CD pipelines. This skill audits your AGENTS.md file against the actual state of the codebase, wiki, and git history to ensure documentation reflects reality.

    What it does

    • Validates claims by cross-referencing AGENTS.md against source code, module paths, and tool configurations.
    • Audits conventions to ensure naming rules, architecture patterns, and "forbidden" lists match current repository enforcement.
    • Synchronizes wiki pages by extracting facts from wiki/INDEX.md and linked pages to resolve documentation drift.
    • Analyzes git history to catch recent renames, dependency bumps, or tool deprecations not yet reflected in the map.
    • Auto-applies fixes directly to the file while maintaining the existing voice and structure.

    How it works

    1. Indexing: The agent reads the entire AGENTS.md to map out all claims, paths, and rules.
    2. Scan Phase: It executes ls, grep, and git log commands to verify existence and recent changes.
    3. Conflict Resolution: It prioritizes source code over wiki pages and git logs when sources disagree.
    4. Patching: It classifies drift into stale, missing, or wrong categories and applies the updates.

    Frameworks & tools

    This skill utilizes standard Unix utilities like ls, grep, and git. It is designed for repositories using Python (pyproject.toml), Make, and pre-commit configurations, but adapts to any stack by reading core project files and wiki directories.

    Why this beats prompting it yourself

    Writing a manual prompt to check every single path and git commit is prone to hallucination. This skill follows a strict source-of-truth priority and requires hard evidence from the file system before suggesting a change, ensuring your repo map remains a reliable engineering asset.

    Use cases

    • Keep repo maps accurate after a large refactor or module migration.
    • Onboard new developers with documentation that actually matches the code.
    • Sync internal project wikis with the root AGENTS.md automatically.
    • Detect "forbidden" patterns in code that haven't been added to the project rules.

    Known limitations

    Does not edit source code or wiki pages. Discrepancies between code and wiki that lack clear git history require manual resolution.

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Technical Documentation.

    Cannot edit code or wiki files. Only updates AGENTS.md. Conflicts without clear git history are flagged for human review rather than auto-fixed.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before buying a skill.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free to use

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 20 days ago

    • Free with an Agensi account

    Software
    Git

    Permissions

    Terminal / Shell
    Read Files
    Write Files
    Listed20 days ago

    What's inside

    Frequently Asked Questions

    This skill automates the tedious task of keeping your repository's AGENTS.md map in sync with your actual codebase, wiki, and git history, preventing "documentation rot" that leads to broken CI/CD pipelines and developer confusion.

    While it is optimized for Python, Make, and pre-commit workflows, the skill is framework-agnostic and works by scanning standard Unix file systems and git logs to audit documentation claims.

    The skill follows a strict "source-of-truth" hierarchy, prioritizing the actual source code and file system over wiki pages or git history to ensure every update is backed by hard evidence.

    No, this skill is designed for safety and only applies patches to the AGENTS.md file; it will identify discrepancies in your source code or wiki but will not modify them.

    By purchasing this skill, you receive the production-ready agent instructions, the logic for the multi-phase indexing and scanning workflow, and lifetime access to any future updates and refinements.

    New in Technical Documentation

    Free