Skill

Agent Md Refactor

Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic…

Type: Skill
Repository: softaworks/agent-toolkit
GitHub stars: 2.5k
License: MIT
Repo last updated: Mar 5, 2026
Source file: README.md

What Agent Md Refactor is

Agent Md Refactor is a skill published in the softaworks/agent-toolkit repository on GitHub, which has about 2.5k stars. The repository describes itself as: “A curated collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.”

A skill is a folder with a SKILL.md file: frontmatter with a name and a description, followed by instructions Claude follows. Claude loads a skill automatically when a task matches its description, and you can also run it directly with a slash and its name.

Skills work in Claude Code and in Claude Cowork, which makes Agent Md Refactor a portable way to give Claude the same method everywhere.

How to install Agent Md Refactor

Claude Code

Download the agent-md-refactor folder from the repository.
Save it as ~/.claude/skills/<skill-name>/SKILL.md for all projects, or .claude/skills/<skill-name>/SKILL.md for one project.
Claude loads it automatically when a task matches; you can also run it with / and its name.

Claude Cowork

Zip the skill folder so SKILL.md sits at the top level of the folder.
Open Customize → Skills, click +, then upload the ZIP.
Start a task that matches the description, or call it by name with /.

New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.

Inside the source file

An excerpt from README.md, shared under the repository's MIT license. Read the full file on GitHub.

Opinionated skills shared by @leonardocouy for improving daily work efficiency with Claude Code. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.

Skills follow the Agent Skills format.

🧭 Quick Navigation

🚀 Installation • 📚 Available Skills • 🤖 Agents & Commands • 📖 Skill Structure • 🤝 Contributing • 📄 License • 🔗 Links

🚀 Installation

Quick Install (Recommended)

npx skills add softaworks/agent-toolkit

This method works with multiple AI coding agents (Claude Code, Codex, Cursor, AdaL, etc.)

Run the following commands in Claude Code:

/plugin marketplace add softaworks/agent-toolkit
/plugin

Install Plugins

Option 1: Via Browse UI

Switch to Marketplaces tab (use arrow keys or Tab)
Select agent-toolkit, press Enter
Browse and select the plugin(s) you want to install
Select Install now

Option 2: Direct Install

# Install specific skill
/plugin install codex@agent-toolkit
/plugin install humanizer@agent-toolkit

# Install specific agent
/plugin install agent-codebase-pattern-finder@agent-toolkit

# Install specific command
/plugin install command-codex-plan@agent-toolkit

Option 3: Ask the Agent

Simply tell Claude Code:

> Please install Skills from github.com/softaworks/agent-toolkit

Available Plugins

Each skill, agent, and command is an individual plugin that can be installed separately:

Skills → See Available Skills for the full list
Agents → See Agents (install as agent- @agent-toolkit)
Commands → See Slash Commands (install as command- @agent-toolkit)

Update Plugins

To update plugins to the latest version:

Run /plugin in Claude Code
Switch to Marketplaces tab
Select agent-toolkit
Choose Update marketplace

You can also Enable auto-update to get the latest versions automatically.

Manual Installation

For Claude Code (Manual) — Skills only

cp -r skills/<skill-name> ~/.claude/skills/

For claude.ai — Skills only

Add skills to project knowledge or paste SKILL.md contents into the conversation.

📚 Available Skills

🤖 Agents & Commands

> Requires Claude Code CLI — These agents and commands are exclusive to Claude Code users. > > For full access, add the marketplace and install plugins: > bash > /plugin marketplace add softaworks/agent-toolkit > /plugin install codex@agent-toolkit >

Agents

Specialized sub-agents that Claude Code can delegate tasks to:

Slash Commands

Reusable workflows invoked with /command-name:

📖 Skill Structure

Each skill contains:

SKILL.md - Detailed instructions for the agent (with YAML frontmatter)
README.md - User-friendly documentation with examples
scripts/ - Helper scripts for automation (optional)
references/ - Supporting documentation (optional)

🤝 Contributing

Contributions are welcome! When adding new skills:

Follow the Agent Skills format
Include both SKILL.md (for agents) and README.md (for users)
Add YAML frontmatter to SKILL.md with name: and description: fields
Update this README.md with a link to your skill

📄 License

MIT

🔗 Links

Agent Skills Format
Claude Code Documentation
GitHub Repository

Before you install

Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
Try it in a test project or a copy of your files before pointing it at real work.
Pin the version you tested, and review changes before updating.
Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.

FAQ

What is Agent Md Refactor?

Agent Md Refactor is a skill for Claude Code and Claude Cowork from the softaworks/agent-toolkit repository on GitHub. Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic…

How do I install Agent Md Refactor in Claude Code?

Download the agent-md-refactor folder from the repository. Save it as ~/.claude/skills/<skill-name>/SKILL.md for all projects, or .claude/skills/<skill-name>/SKILL.md for one project. Claude loads it automatically when a task matches; you can also run it with / and its name.

Can I use Agent Md Refactor in Claude Cowork?

Zip the skill folder so SKILL.md sits at the top level of the folder. Open Customize → Skills, click +, then upload the ZIP. Start a task that matches the description, or call it by name with /.

Is Agent Md Refactor safe to install?

It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.

Similar resources

Browse all skills, subagents, and plugins →

Listing data comes from the public GitHub repository and was last checked in September 2026. Excerpts are © their authors and shared under MIT. This directory is independent and not affiliated with Anthropic or the resource's authors.