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	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
🛠️ Development	database-schema-designer	Design robust database schemas
🛠️ Development	dependency-updater	Smart dependency management
🛠️ Development	naming-analyzer	Suggest better variable/function names
🛠️ Development	lesson-learned	Extract SE lessons from recent code changes
🛠️ Development	reducing-entropy	Minimize codebase size
🛠️ Development	session-handoff	Seamless AI session transfers
🎯 Planning	game-changing-features	Find 10x product opportunities
🎯 Planning	gepetto	Detailed implementation planning
🎯 Planning	requirements-clarity	Clarify requirements before coding
🎯 Planning	ship-learn-next	Turn learning into actionable reps
👔 Professional	daily-meeting-update	Interactive daily standup generator
👔 Professional	difficult-workplace-conversations	Navigate difficult conversations
👔 Professional	feedback-mastery	Deliver constructive feedback
👔 Professional	professional-communication	Technical communication guide
🧪 Testing	qa-test-planner	Comprehensive QA test planning
📦 Git	commit-work	High-quality git commits
🔧 Utilities	datadog-cli	Debug with Datadog logs & metrics
🔧 Utilities	domain-name-brainstormer	Generate & check domain names
🔧 Utilities	humanizer	Remove AI writing patterns
🔧 Utilities	meme-factory	Generate memes with API
🔧 Utilities	jira	Natural language Jira interaction
🔧 Utilities	web-to-markdown	Convert webpages to Markdown

---

🤖 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