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, AdaL, 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

---

🤖 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:

/plugin marketplace add softaworks/agent-toolkit
/plugin install codex@agent-toolkit

Agents

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

Agent	Description
ascii-ui-mockup-generator	Visualize UI concepts through ASCII mockups
codebase-pattern-finder	Find similar implementations and patterns
communication-excellence-coach	Email refinement, tone calibration, roleplay
general-purpose	Default agent for complex multi-step tasks
mermaid-diagram-specialist	Create flowcharts, sequence diagrams, ERDs
ui-ux-designer	Research-backed UI/UX design feedback

Slash Commands

Reusable workflows invoked with /command-name:

Command	Description
/codex-plan	Create implementation plans using Codex 5.2
/compose-email	Draft professional emails
/explain-changes-mental-model	Build mental model of code changes
/explain-pr-changes	Generate PR summaries
/sync-branch	Sync feature branch with main
/sync-skills-readme	Update README skills table
/viral-tweet	Optimize tweet ideas for X engagement

---

📖 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:

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

---

📄 License

MIT

---

🔗 Links

• Agent Skills Format
• Claude Code Documentation
• GitHub Repository