agent-md-refactor
Refactors bloated AI agent instruction files into a modular, organized structure using progressive disclosure.
Install
npx skills add https://github.com/softaworks/agent-toolkit --skill agent-md-refactorStats
| Total installs | 3,497 |
| Weekly installs | 573 |
| GitHub stars | 1.2K |
| First seen | Jan 20, 2026 |
| Source | @softaworks/agent-toolkit |
Summary
- Analyzes existing AGENTS.md, CLAUDE.md, or similar files to identify contradictions, extract essentials, and categorize remaining instructions across 3–8 focused topic files
- Keeps root file minimal (under 50 lines) with only universal project info and links to detailed guidelines organized by topic (TypeScript, testing, code style, git workflow, architecture)
- Flags redundant, vague, or outdated instructions for deletion and provides templates for both root and linked files to ensure consistency
- Follows a five-phase process: find contradictions, identify essentials, group remaining content, create file structure, and prune unnecessary instructions
Tags
Related skills
| Skill | Installs | vs agent-md-refactor |
|---|---|---|
| c4-architecture | 3,458 | -39 |
| context-driven-development | 3,652 | +155 |
| session-handoff | 3,472 | -25 |
| on-call-handoff-patterns | 3,294 | -203 |
| track-management | 3,303 | -194 |
FAQ
- How many installs does agent-md-refactor have?
- agent-md-refactor has 3,497 total installs and 573 installs this week.
- Where is agent-md-refactor hosted?
- agent-md-refactor is published by @softaworks/agent-toolkit at https://github.com/softaworks/agent-toolkit.
- How many GitHub stars does agent-md-refactor have?
- agent-md-refactor has 1.2K GitHub stars.
- When was agent-md-refactor first indexed?
- OrangeBot.AI first indexed agent-md-refactor on Jan 20, 2026.
- How do I install agent-md-refactor?
- Run: npx skills add https://github.com/softaworks/agent-toolkit --skill agent-md-refactor