--- slug: "agent-toolkit-agent-toolkit" source_type: "readme" source_url: "https://cdn.jsdelivr.net/gh/softaworks/agent-toolkit@main/README.md" repo: "https://github.com/softaworks/agent-toolkit" source_file: "README.md" branch: "main" --- # Softaworks Agent Skills Opinionated skills shared by [@leonardocouy](https://github.com/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](https://agentskills.io/) format. --- ## ๐Ÿงญ Quick Navigation **[๐Ÿš€ Installation](#-installation)** โ€ข **[๐Ÿ“š Available Skills](#-available-skills)** โ€ข **[๐Ÿค– Agents & Commands](#-agents--commands)** โ€ข **[๐Ÿ“– Skill Structure](#-skill-structure)** โ€ข **[๐Ÿค Contributing](#-contributing)** โ€ข **[๐Ÿ“„ License](#-license)** โ€ข **[๐Ÿ”— Links](#-links)** --- ## ๐Ÿš€ Installation ### Quick Install (Recommended) ```bash 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: ```bash /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** ```bash # 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](#-available-skills) for the full list - **Agents** โ†’ See [Agents](#agents) (install as `agent-@agent-toolkit`) - **Commands** โ†’ See [Slash Commands](#slash-commands) (install as `command-@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 ```bash cp -r skills/ ~/.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](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/codex/README.md) | Advanced code analysis with GPT-5.2 | | ๐Ÿค– AI Tools | [gemini](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/gemini/README.md) | Large-scale review (200k+ context) | | ๐Ÿค– AI Tools | [perplexity](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/perplexity/README.md) | Web search & research | | ๐Ÿ”ฎ Meta | [agent-md-refactor](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/agent-md-refactor/README.md) | Refactor bloated agent instruction files | | ๐Ÿ”ฎ Meta | [command-creator](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/command-creator/README.md) | Create Claude Code slash commands | | ๐Ÿ”ฎ Meta | [plugin-forge](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/plugin-forge/README.md) | Build Claude Code plugins & manifests | | ๐Ÿ”ฎ Meta | [skill-judge](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/skill-judge/README.md) | Evaluate skill design quality | | ๐Ÿ“ Documentation | [backend-to-frontend-handoff-docs](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/backend-to-frontend-handoff-docs/README.md) | API handoff docs for frontend | | ๐Ÿ“ Documentation | [c4-architecture](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/c4-architecture/README.md) | C4 architecture diagrams with Mermaid | | ๐Ÿ“ Documentation | [crafting-effective-readmes](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/crafting-effective-readmes/README.md) | Write effective README files | | ๐Ÿ“ Documentation | [draw-io](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/draw-io/README.md) | Create & edit draw.io diagrams | | ๐Ÿ“ Documentation | [excalidraw](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/excalidraw/README.md) | Work with Excalidraw diagrams | | ๐Ÿ“ Documentation | [frontend-to-backend-requirements](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/frontend-to-backend-requirements/README.md) | Document API requirements | | ๐Ÿ“ Documentation | [marp-slide](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/marp-slide/README.md) | Professional presentation slides | | ๐Ÿ“ Documentation | [mermaid-diagrams](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/mermaid-diagrams/README.md) | Software diagrams with Mermaid | | ๐Ÿ“ Documentation | [writing-clearly-and-concisely](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/writing-clearly-and-concisely/README.md) | Clear, professional writing | | ๐ŸŽจ Design & Frontend | [design-system-starter](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/design-system-starter/README.md) | Create design systems | | ๐ŸŽจ Design & Frontend | [mui](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/mui/README.md) | Material-UI v7 patterns | | ๐ŸŽจ Design & Frontend | [openapi-to-typescript](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/openapi-to-typescript/README.md) | Convert OpenAPI to TypeScript | | ๐ŸŽจ Design & Frontend | [react-dev](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/react-dev/README.md) | Type-safe React 18-19 with TypeScript | | ๐ŸŽจ Design & Frontend | [react-useeffect](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/react-useeffect/README.md) | React useEffect best practices | | ๐Ÿ› ๏ธ Development | [database-schema-designer](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/database-schema-designer/README.md) | Design robust database schemas | | ๐Ÿ› ๏ธ Development | [dependency-updater](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/dependency-updater/README.md) | Smart dependency management | | ๐Ÿ› ๏ธ Development | [naming-analyzer](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/naming-analyzer/README.md) | Suggest better variable/function names | | ๐Ÿ› ๏ธ Development | [lesson-learned](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/lesson-learned/README.md) | Extract SE lessons from recent code changes | | ๐Ÿ› ๏ธ Development | [reducing-entropy](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/reducing-entropy/README.md) | Minimize codebase size | | ๐Ÿ› ๏ธ Development | [session-handoff](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/session-handoff/README.md) | Seamless AI session transfers | | ๐ŸŽฏ Planning | [game-changing-features](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/game-changing-features/README.md) | Find 10x product opportunities | | ๐ŸŽฏ Planning | [gepetto](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/gepetto/README.md) | Detailed implementation planning | | ๐ŸŽฏ Planning | [requirements-clarity](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/requirements-clarity/README.md) | Clarify requirements before coding | | ๐ŸŽฏ Planning | [ship-learn-next](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/ship-learn-next/README.md) | Turn learning into actionable reps | | ๐Ÿ‘” Professional | [daily-meeting-update](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/daily-meeting-update/README.md) | Interactive daily standup generator | | ๐Ÿ‘” Professional | [difficult-workplace-conversations](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/difficult-workplace-conversations/README.md) | Navigate difficult conversations | | ๐Ÿ‘” Professional | [feedback-mastery](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/feedback-mastery/README.md) | Deliver constructive feedback | | ๐Ÿ‘” Professional | [professional-communication](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/professional-communication/README.md) | Technical communication guide | | ๐Ÿงช Testing | [qa-test-planner](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/qa-test-planner/README.md) | Comprehensive QA test planning | | ๐Ÿ“ฆ Git | [commit-work](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/commit-work/README.md) | High-quality git commits | | ๐Ÿ”ง Utilities | [datadog-cli](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/datadog-cli/README.md) | Debug with Datadog logs & metrics | | ๐Ÿ”ง Utilities | [domain-name-brainstormer](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/domain-name-brainstormer/README.md) | Generate & check domain names | | ๐Ÿ”ง Utilities | [humanizer](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/humanizer/README.md) | Remove AI writing patterns | | ๐Ÿ”ง Utilities | [meme-factory](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/meme-factory/README.md) | Generate memes with API | | ๐Ÿ”ง Utilities | [jira](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/jira/README.md) | Natural language Jira interaction | | ๐Ÿ”ง Utilities | [web-to-markdown](https://github.com/softaworks/agent-toolkit/blob/HEAD/skills/web-to-markdown/README.md) | Convert webpages to Markdown | --- ## ๐Ÿค– Agents & Commands > **Requires [Claude Code CLI](https://docs.anthropic.com/claude-code)** โ€” These agents and commands are exclusive to Claude Code users. > > For full access, add the marketplace and install plugins: > ```bash > /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](https://agentskills.io/) 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](https://agentskills.io/) - [Claude Code Documentation](https://docs.anthropic.com/claude/docs) - [GitHub Repository](https://github.com/softaworks/agent-toolkit)