- Home
- Skills
- Technical Documentation
- Update AGENTS.md
Update AGENTS.md
Automatically revalidate and fix repo maps by auditing AGENTS.md against source code, wikis, and git history.
Free
Works with the AI Agents you already use
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
| Category | Finding | Source of Truth | Fix Applied |
|---|---|---|---|
| Stale | Auth module path cited as src/auth/ | ls check of src/identity/ | Updated path to src/identity/ |
| Stale | Python version pin at 3.10 | pyproject.toml:14 | Updated pin to 3.12 |
| Missing | New argon2-cffi dependency | pyproject.toml:22 | Added to External Services section |
| Wrong | Link to wiki/pages/auth-flow.md | git 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
- Review the git diff for
AGENTS.mdto confirm the new module descriptions. - Run
make testto ensure the updated documentation doesn't conflict with any docstring linters. - Commit the changes to synchronize the repo map with your recent refactor.
2 stale, 1 missing, 1 wrong → AGENTS.md updated
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.mdagainst 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.mdand 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
- Indexing: The agent reads the entire
AGENTS.mdto map out all claims, paths, and rules. - Scan Phase: It executes
ls,grep, andgit logcommands to verify existence and recent changes. - Conflict Resolution: It prioritizes source code over wiki pages and git logs when sources disagree.
- 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.mdautomatically. - 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
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
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 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