A curated collection of packaged skills and commands that extend Claude and other AI coding agents with capabilities for development, documentation, planning, and professional workflows. Skills are installable plugins covering code analysis, architecture design, testing, communication, and specialized agent roles.
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.
README
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
- 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
/pluginin 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 examplesscripts/- 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) andREADME.md(for users) - Add YAML frontmatter to
SKILL.mdwithname:anddescription:fields - Update this README.md with a link to your skill
📄 License
MIT
🔗 Links
43 skills in this repo
Plugin marketplaceRefactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.
/plugin marketplace add softaworks/agent-toolkit
/plugin install agent-md-refactor
Create API handoff documentation for frontend developers. Use when backend work is complete and needs to be documented for frontend integration, or user says 'create handoff', 'document API', 'frontend handoff', or 'API documentation'.
/plugin marketplace add softaworks/agent-toolkit
/plugin install backend-to-frontend-handoff-docs
Generate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize software structure, create C4 diagrams, or generate context/container/component/dep...
/plugin marketplace add softaworks/agent-toolkit
/plugin install c4-architecture
Use when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing. Uses GPT-5.2 by default for state-of-the-art software engineering.
/plugin marketplace add softaworks/agent-toolkit
/plugin install codex
This skill should be used when creating a Claude Code slash command. Use when users ask to "create a command", "make a slash command", "add a command", or want to document a workflow as a reusable command. Essential for creating optimized,...
/plugin marketplace add softaworks/agent-toolkit
/plugin install command-creator
Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits). Use when the user asks to commit, craft a commit message, stage changes, or split...
/plugin marketplace add softaworks/agent-toolkit
/plugin install commit-work
Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to your audience and project type.
/plugin marketplace add softaworks/agent-toolkit
/plugin install crafting-effective-readmes
Interactive daily standup/meeting update generator. Use when user says 'daily', 'standup', 'scrum update', 'status update', 'what did I do yesterday', 'prepare for meeting', 'morning update', or 'team sync'. Pulls activity from GitHub, Jira...
/plugin marketplace add softaworks/agent-toolkit
/plugin install daily-meeting-update
Design robust, scalable database schemas for SQL and NoSQL databases. Provides normalization guidelines, indexing strategies, migration patterns, constraint design, and performance optimization. Ensures data integrity, query performance, an...
/plugin marketplace add softaworks/agent-toolkit
/plugin install database-schema-designer
Datadog CLI for searching logs, querying metrics, tracing requests, and managing dashboards. Use this when debugging production issues or working with Datadog observability.
/plugin marketplace add softaworks/agent-toolkit
/plugin install datadog-cli
Smart dependency management for any language. Auto-detects project type, applies safe updates automatically, prompts for major versions, diagnoses and fixes dependency issues.
/plugin marketplace add softaworks/agent-toolkit
/plugin install dependency-updater
Create and evolve design systems with design tokens, component architecture, accessibility guidelines, and documentation templates. Ensures consistent, scalable, and accessible UI across products.
/plugin marketplace add softaworks/agent-toolkit
/plugin install design-system-starter
Structured approach to workplace conflicts, performance discussions, and challenging feedback using preparation-delivery-followup framework. Use when preparing for tough conversations, addressing conflicts, giving critical feedback, or navi...
/plugin marketplace add softaworks/agent-toolkit
/plugin install difficult-workplace-conversations
Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.). Saves hours of brainstorming and manual checking.
/plugin marketplace add softaworks/agent-toolkit
/plugin install domain-name-brainstormer
draw.io diagram creation, editing, and review. Use for .drawio XML editing, PNG conversion, layout adjustment, and AWS icon usage.
/plugin marketplace add softaworks/agent-toolkit
/plugin install draw-io
Use when working with *.excalidraw or *.excalidraw.json files, user mentions diagrams/flowcharts, or requests architecture visualization - delegates all Excalidraw operations to subagents to prevent context exhaustion from verbose JSON (sin...
/plugin marketplace add softaworks/agent-toolkit
/plugin install excalidraw
Navigate difficult conversations and deliver constructive feedback using structured frameworks. Covers the Preparation-Delivery-Follow-up model and Situation-Behavior-Impact (SBI) feedback technique. Use when preparing for difficult convers...
/plugin marketplace add softaworks/agent-toolkit
/plugin install feedback-mastery
Document frontend data needs for backend developers. Use when frontend needs to communicate API requirements to backend, or user says 'backend requirements', 'what data do I need', 'API requirements', or is describing data needs for a UI.
/plugin marketplace add softaworks/agent-toolkit
/plugin install frontend-to-backend-requirements
Find 10x product opportunities and high-leverage improvements. Use when user wants strategic product thinking, mentions '10x', wants to find high-impact features, or says 'what would make this 10x better', 'product strategy', or 'what shoul...
/plugin marketplace add softaworks/agent-toolkit
/plugin install game-changing-features
Use when the user asks to run Gemini CLI for code review, plan review, or big context (>200k) processing. Ideal for comprehensive analysis requiring large context windows. Uses Gemini 3 Pro by default for state-of-the-art reasoning and codi...
/plugin marketplace add softaworks/agent-toolkit
/plugin install gemini
Creates detailed, sectionized implementation plans through research, stakeholder interviews, and multi-LLM review. Use when planning features that need thorough pre-implementation analysis.
/plugin marketplace add softaworks/agent-toolkit
/plugin install gepetto
Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflat...
/plugin marketplace add softaworks/agent-toolkit
/plugin install humanizer
Use when the user mentions Jira issues (e.g., "PROJ-123"), asks about tickets, wants to create/view/update issues, check sprint status, or manage their Jira workflow. Triggers on keywords like "jira", "issue", "ticket", "sprint", "backlog",...
/plugin marketplace add softaworks/agent-toolkit
/plugin install jira
Analyze recent code changes via git history and extract software engineering lessons. Use when the user asks 'what is the lesson here?', 'what can I learn from this?', 'engineering takeaway', 'what did I just learn?', 'reflect on this code'...
/plugin marketplace add softaworks/agent-toolkit
/plugin install lesson-learned
Create professional Marp presentation slides with 7 beautiful themes (default, minimal, colorful, dark, gradient, tech, business). Use when users request slide creation, presentations, or Marp documents. Supports custom themes, image layout...
/plugin marketplace add softaworks/agent-toolkit
/plugin install marp-slide
Generate memes using the memegen.link API. Use when users request memes, want to add humor to content, or need visual aids for social media. Supports 100+ popular templates with custom text and styling.
/plugin marketplace add softaworks/agent-toolkit
/plugin install meme-factory
Comprehensive guide for creating software diagrams using Mermaid syntax. Use when users need to create, visualize, or document software through diagrams including class diagrams (domain modeling, object-oriented design), sequence diagrams (...
/plugin marketplace add softaworks/agent-toolkit
/plugin install mermaid-diagrams
Material-UI v7 component library patterns including sx prop styling, theme integration, responsive design, and MUI-specific hooks. Use when working with MUI components, styling with sx prop, theme customization, or MUI utilities.
/plugin marketplace add softaworks/agent-toolkit
/plugin install mui
Suggest better variable, function, and class names based on context and conventions.
/plugin marketplace add softaworks/agent-toolkit
/plugin install naming-analyzer
Converts OpenAPI 3.0 JSON/YAML to TypeScript interfaces and type guards. This skill should be used when the user asks to generate types from OpenAPI, convert schema to TS, create API interfaces, or generate TypeScript types from an API spec...
/plugin marketplace add softaworks/agent-toolkit
/plugin install openapi-to-typescript
Web search and research using Perplexity AI. Use when user says "search", "find", "look up", "ask", "research", or "what's the latest" for generic queries. NOT for library/framework docs (use Context7) or workspace questions.
/plugin marketplace add softaworks/agent-toolkit
/plugin install perplexity
Create and manage Claude Code plugins with proper structure, manifests, and marketplace integration. Use when creating plugins for a marketplace, adding plugin components (commands, agents, hooks), bumping plugin versions, or working with p...
/plugin marketplace add softaworks/agent-toolkit
/plugin install plugin-forge
Guide technical communication for software developers. Covers email structure, team messaging etiquette, meeting agendas, and adapting messages for technical vs non-technical audiences. Use when drafting professional messages, preparing mee...
/plugin marketplace add softaworks/agent-toolkit
/plugin install professional-communication
Generate comprehensive test plans, manual test cases, regression test suites, and bug reports for QA engineers. Includes Figma MCP integration for design validation.
/plugin marketplace add softaworks/agent-toolkit
/plugin install qa-test-planner
This skill should be used when building React components with TypeScript, typing hooks, handling events, or when React TypeScript, React 19, Server Components are mentioned. Covers type-safe patterns for React 18-19 including generic compon...
/plugin marketplace add softaworks/agent-toolkit
/plugin install react-dev
React useEffect best practices from official docs. Use when writing/reviewing useEffect, useState for derived values, data fetching, or state synchronization. Teaches when NOT to use Effect and better alternatives.
/plugin marketplace add softaworks/agent-toolkit
/plugin install react-useeffect
Manual-only skill for minimizing total codebase size. Only activate when explicitly requested by user. Measures success by final code amount, not effort. Bias toward deletion.
/plugin marketplace add softaworks/agent-toolkit
/plugin install reducing-entropy
Clarify ambiguous requirements through focused dialogue before implementation. Use when requirements are unclear, features are complex (>2 days), or involve cross-team coordination. Ask two core questions - Why? (YAGNI check) and Simpler? (...
/plugin marketplace add softaworks/agent-toolkit
/plugin install requirements-clarity
Creates comprehensive handoff documents for seamless AI agent session transfers. Triggered when: (1) user requests handoff/memory/context save, (2) context window approaches capacity, (3) major task milestone completed, (4) work session end...
/plugin marketplace add softaworks/agent-toolkit
/plugin install session-handoff
Transform learning content (like YouTube transcripts, articles, tutorials) into actionable implementation plans using the Ship-Learn-Next framework. Use when user wants to turn advice, lessons, or educational content into concrete action st...
/plugin marketplace add softaworks/agent-toolkit
/plugin install ship-learn-next
Evaluate Agent Skill design quality against official specifications and best practices. Use when reviewing, auditing, or improving SKILL.md files and skill packages. Provides multi-dimensional scoring and actionable improvement suggestions.
/plugin marketplace add softaworks/agent-toolkit
/plugin install skill-judge
Use ONLY when the user explicitly says: 'use the skill web-to-markdown ...' (or 'use a skill web-to-markdown ...'). Converts webpage URLs to clean Markdown by calling the local web2md CLI (Puppeteer + Readability), suitable for JS-rendered...
/plugin marketplace add softaworks/agent-toolkit
/plugin install web-to-markdown
Use when writing prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Applies Strunk's timeless rules for clearer, stronger, more professional writing.
/plugin marketplace add softaworks/agent-toolkit
/plugin install writing-clearly-and-concisely
Comments (0)
Sign in to join the discussion.
No comments yet
Be the first to share your take.