Softaworks Agent Skills

Name: agent-toolkit
Author: softaworks

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

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-<name>@agent-toolkit)
Commands → See Slash Commands (install as command-<name>@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

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:

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