gen-agents-md
CommunityCreate low-maintenance agent root docs with pointer design.
Software Engineering#documentation#agents.md#claude-code#repository-setup#doc-generation#pointer-design#agent-conventions
Authortakaokanbe
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Agent root documentation files like AGENTS.md and CLAUDE.md often become bloated with outdated, redundant explanations that decay over time, leading AI coding agents to ignore critical rules or follow stale guidance that no longer matches the repository state.
Core Features & Use Cases
- Pointer-based doc generation: Creates or rewrites AGENTS.md to reference existing repository files instead of repeating explainable information, eliminating documentation decay.
- Cross-agent compatibility: Migrates existing descriptive CLAUDE.md files to the standardized AGENTS.md + CLAUDE.md symlink structure, compatible with Claude Code and other AI coding agents.
- Strict guardrails: Enforces line count limits (≤50 lines recommended, ≤200 lines maximum) and validates all referenced file paths exist to ensure docs remain usable for agents.
- Use case: Use when setting up a new repository, updating an existing bloated agent doc over 200 lines, or migrating an old descriptive CLAUDE.md to the modern pointer-based format.
Quick Start
Use the gen-agents-md skill to generate a maintainable, pointer-based AGENTS.md for your current code repository.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: gen-agents-md Download link: https://github.com/takaokanbe/dotfiles/archive/main.zip#gen-agents-md Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 537,000+ vetted skills library on demand.