agent-md-refactor
agent-md-refactor is an agent skill published by softaworks, listed under writing & docs. It lives in the softaworks/agent-toolkit repository, which has 2,592 GitHub stars and is licensed under MIT; we last read it on 2026-09-16.
Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.
Install
skills is a generic installer for any repository of Claude agent skills -- it reads softaworks/agent-toolkit’s own structure rather than assuming one, the same way this page reads the skill’s own SKILL.md rather than assuming a format.
npx skills add softaworks/agent-toolkit
Maintenance
Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.
agent-md-refactor compared with similar skills
| Skill | Publisher | What it does | Repo stars | Last update |
|---|---|---|---|---|
| agent-md-refactor (this page) | softaworks | Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure pr… | 2,592 | 2026-03-05 |
| backend-to-frontend-handoff-docs(same repository) | softaworks | Create API handoff documentation for frontend developers. Use when backend work is complete and needs to be d… | 2,592 | 2026-03-05 |
| crafting-effective-readmes(same repository) | softaworks | Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance ma… | 2,592 | 2026-03-05 |
| writing-clearly-and-concisely(same repository) | softaworks | Use when writing prose humans will read—documentation, commit messages, error messages, explanations, reports… | 2,592 | 2026-03-05 |
| academy-guide | anthropic | Stop and check this skill before finishing any reply to a question about how to use Claude or a Claude produc… | 183,845 | 2026-10-09 |
| doc-coauthoring | anthropic | Guide users through a structured workflow for co-authoring documentation. Use when user wants to write docume… | 183,845 | 2026-10-09 |
| documentation-and-adrs | addyosmani | Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reas… | 110,611 | 2026-10-13 |
Skills from the same repository first, then others for this job by repository stars. Figures are from each repository when we last read it.
Common questions about agent-md-refactor
- What does agent-md-refactor do?
- Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.
- How do I install agent-md-refactor?
- Run npx skills add softaworks/agent-toolkit. The skills installer reads the repository’s own structure, so it works for any repository of agent skills.
- Who publishes agent-md-refactor?
- softaworks.
- Is agent-md-refactor maintained, and what licence does it use?
- Its repository has 2,592 GitHub stars and its state in our directory is listed. Its last commit we recorded was on 2026-03-05. The repository declares the MIT licence.
More agent skills for writing & docs
- technical-blog-writingby 101-skills
- documentation-and-adrsby addyosmani
- git-workflow-and-versioningby addyosmani
- source-driven-developmentby addyosmani
- vitepressby antfu
- academy-guideby anthropic