agent-md-refactor
✓Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation. Use when (1) agent context files are too large or unwieldy, (2) need to separate project context from executable skills, (3) want to create modular documentation structure, (4) refactoring existing documentation for better organization, or (5) creating new agent context documentation from scratch.
Installation
SKILL.md
This skill helps you refactor large, monolithic agent instruction files (AGENTS.md, CLAUDE.md, etc.) into a well-structured, modular documentation system following progressive disclosure principles.
AGENTS.md (Project Context) Purpose: Defines WHAT the project is and HOW it's structured
SKILLS.md (Agent Capabilities) Purpose: Defines WHAT the agent CAN DO and HOW to execute tasks
Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation. Use when (1) agent context files are too large or unwieldy, (2) need to separate project context from executable skills, (3) want to create modular documentation structure, (4) refactoring existing documentation for better organization, or (5) creating new agent context documentation from scratch. Source: agnosticsix/agent-md-template.
Facts (cite-ready)
Stable fields and commands for AI/search citations.
- Install command
npx skills add https://github.com/agnosticsix/agent-md-template --skill agent-md-refactor- Category
- </>Dev Tools
- Verified
- ✓
- First Seen
- 2026-02-03
- Updated
- 2026-02-18
Quick answers
What is agent-md-refactor?
Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation. Use when (1) agent context files are too large or unwieldy, (2) need to separate project context from executable skills, (3) want to create modular documentation structure, (4) refactoring existing documentation for better organization, or (5) creating new agent context documentation from scratch. Source: agnosticsix/agent-md-template.
How do I install agent-md-refactor?
Open your terminal or command line tool (Terminal, iTerm, Windows Terminal, etc.) Copy and run this command: npx skills add https://github.com/agnosticsix/agent-md-template --skill agent-md-refactor Once installed, the skill will be automatically configured in your AI coding environment and ready to use in Claude Code or Cursor
Where is the source repository?
https://github.com/agnosticsix/agent-md-template
Details
- Category
- </>Dev Tools
- Source
- skills.sh
- First Seen
- 2026-02-03