crafting-effective-readmes

Softaworks Agent Skills

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, etc.)

Register as Plugin Marketplace

Run the following commands in Claude Code:

/plugin marketplace add softaworks/agent-toolkit
/plugin

Install Plugins

Option 1: Via Browse UI

1. Switch to Marketplaces tab (use arrow keys or Tab)
2. Select agent-toolkit, press Enter
3. Browse and select the plugin(s) you want to install
4. 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-<name>@agent-toolkit)
• Commands → See Slash Commands (install as command-<name>@agent-toolkit)

Update Plugins

To update plugins to the latest version:

1. Run /plugin in Claude Code
2. Switch to Marketplaces tab
3. Select agent-toolkit
4. 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

Category	Skill	Description
🤖 AI Tools	codex	Advanced code analysis with GPT-5.2
🤖 AI Tools	gemini	Large-scale review (200k+ context)
🤖 AI Tools	perplexity	Web search & research
🔮 Meta	agent-md-refactor	Refactor bloated agent instruction files
🔮 Meta	command-creator	Create Claude Code slash commands
🔮 Meta	plugin-forge	Build Claude Code plugins & manifests
🔮 Meta	skill-judge	Evaluate skill design quality
📝 Documentation	backend-to-frontend-handoff-docs	API handoff docs for frontend
📝 Documentation	c4-architecture	C4 architecture diagrams with Mermaid
📝 Documentation	crafting-effective-readmes	Write effective README files
📝 Documentation	draw-io	Create & edit draw.io diagrams
📝 Documentation	excalidraw	Work with Excalidraw diagrams
📝 Documentation	frontend-to-backend-requirements	Document API requirements
📝 Documentation	marp-slide	Professional presentation slides
📝 Documentation	mermaid-diagrams	Software diagrams with Mermaid
📝 Documentation	writing-clearly-and-concisely	Clear, professional writing
🎨 Design & Frontend	design-system-starter	Create design systems
🎨 Design & Frontend	mui	Material-UI v7 patterns
🎨 Design & Frontend	openapi-to-typescript	Convert OpenAPI to TypeScript
🎨 Design & Frontend	react-dev	Type-safe React 18-19 with TypeScript
🎨 Design & Frontend	react-useeffect	React useEffect best practices