agent-toolkit
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.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/softaworks-agent-toolkit)HTML
<a href="/listings/softaworks-agent-toolkit"><img src="/api/listings/softaworks-agent-toolkit/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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](#-available-skills) for the full list - **Agents** → See [Agents](#agents) (install as `agent-<name>@agent-toolkit`) - **Commands** → See [Slash Commands](#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.
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 926 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "agent-toolkit",
- "owner": {
- "name": "softaworks",
- "url": "https://github.com/softaworks"
- },
- "metadata": {
- "description": "Skills, agents, and commands for AI coding agents - individually selectable",
- "version": "1.0.10"
- },
- "plugins": [
- {
- "name": "codex",
- "description": "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.",
- "source": "./dist/plugins/codex",
- "strict": false,
- "skills": [
- "./skills/codex"
- ],
- "category": "ai-tools",
- "keywords": [
- "ai",
- "code-analysis",
- "gpt",
- "codex",
- "openai"
- ]
- },
- {
- "name": "gemini",
- "description": "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 coding.",
- "source": "./dist/plugins/gemini",
- "strict": false,
- "skills": [
- "./skills/gemini"
- ],
- "category": "ai-tools",
- "keywords": [
- "ai",
- "code-review",
- "large-context",
- "gemini",
- "google"
- ]
- },
- {
- "name": "perplexity",
- "description": "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.",
- "source": "./dist/plugins/perplexity",
- "strict": false,
- "skills": [
- "./skills/perplexity"
- ],
- "category": "ai-tools",
- "keywords": [
- "ai",
- "search",
- "research",
- "perplexity"
- ]
- },
- {
- "name": "agent-md-refactor",
- "description": "Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.",
- "source": "./dist/plugins/agent-md-refactor",
- "strict": false,
- "skills": [
- "./skills/agent-md-refactor"
- ],
- "category": "meta",
- "keywords": [
- "meta",
- "refactor",
- "claude-md",
- "agents-md",
- "documentation"
- ]
- },
- {
- "name": "command-creator",
- "description": "Create Claude Code slash commands. 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.",
- "source": "./dist/plugins/command-creator",
- "strict": false,
- "skills": [
- "./skills/command-creator"
- ],
- "category": "meta",
- "keywords": [
- "meta",
- "commands",
- "slash-commands",
- "claude-code"
- ]
- },
- {
- "name": "plugin-forge",
- "description": "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 plugin.json/marketplace.json manifests.",
- "source": "./dist/plugins/plugin-forge",
- "strict": false,
- "skills": [
- "./skills/plugin-forge"
- ],
- "category": "meta",
- "keywords": [
- "meta",
- "plugins",
- "marketplace",
- "claude-code"
- ]
- },
- {
- "name": "skill-judge",
- "description": "Evaluate Agent Skill design quality against official specifications and best practices. Use when reviewing, auditing, or improving SKILL.md files and skill packages.",
- "source": "./dist/plugins/skill-judge",
- "strict": false,
- "skills": [
- "./skills/skill-judge"
- ],
- "category": "meta",
- "keywords": [
- "meta",
- "skills",
- "quality",
- "review"
- ]
- },
- {
- "name": "backend-to-frontend-handoff-docs",
- "description": "Create API handoff documentation for frontend developers. Use when backend work is complete and needs to be documented for frontend integration.",
- "source": "./dist/plugins/backend-to-frontend-handoff-docs",
- "strict": false,
- "skills": [
- "./skills/backend-to-frontend-handoff-docs"
- ],
- "category": "documentation",
- "keywords": [
- "documentation",
- "api",
- "handoff",
- "frontend",
- "backend"
- ]
- },
- {
- "name": "c4-architecture",
- "description": "Generate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize software structure.",
- "source": "./dist/plugins/c4-architecture",
- "strict": false,
- "skills": [
- "./skills/c4-architecture"
- ],
- "category": "documentation",
- "keywords": [
- "documentation",
- "architecture",
- "c4",
- "mermaid",
- "diagrams"
- ]
- },
- {
- "name": "crafting-effective-readmes",
- "description": "Use when writing or improving README files. Provides templates and guidance matched to your audience and project type.",
- "source": "./dist/plugins/crafting-effective-readmes",
- "strict": false,
- "skills": [
- "./skills/crafting-effective-readmes"
- ],
- "category": "documentation",
- "keywords": [
- "documentation",
- "readme",
- "writing"
- ]
- },
- {
- "name": "draw-io",
- "description": "draw.io diagram creation, editing, and review. Use for .drawio XML editing, PNG conversion, layout adjustment, and AWS icon usage.",
- "source": "./dist/plugins/draw-io",
- "strict": false,
- "skills": [
- "./skills/draw-io"
- ],
- "category": "documentation",
- "keywords": [
- "documentation",
- "diagrams",
- "draw-io",
- "xml"
- ]
- },
- {
- "name": "excalidraw",
- "description": "Use when working with *.excalidraw or *.excalidraw.json files, user mentions diagrams/flowcharts, or requests architecture visualization.",
- "source": "./dist/plugins/excalidraw",
- "strict": false,
- "skills": [
- "./skills/excalidraw"
- ],
- "category": "documentation",
- "keywords": [
- "documentation",
- "diagrams",
- "excalidraw",
- "visualization"
- ]
- },
- {
- "name": "frontend-to-backend-requirements",
- "description": "Document frontend data needs for backend developers. Use when frontend needs to communicate API requirements to backend.",
- "source": "./dist/plugins/frontend-to-backend-requirements",
- "strict": false,
- "skills": [
- "./skills/frontend-to-backend-requirements"
- ],
- "category": "documentation",
- "keywords": [
- "documentation",
- "api",
- "requirements",
- "frontend",
- "backend"
- ]
- },
- {
- "name": "marp-slide",
- "description": "Create professional Marp presentation slides with 7 beautiful themes. Use when users request slide creation, presentations, or Marp documents.",
- "source": "./dist/plugins/marp-slide",
- "strict": false,
- "skills": [
- "./skills/marp-slide"
- ],
- "category": "documentation",
- "keywords": [
- "documentation",
- "presentations",
- "slides",
- "marp"
- ]
- },
- {
- "name": "mermaid-diagrams",
- "description": "Comprehensive guide for creating software diagrams using Mermaid syntax. Use when users need to create, visualize, or document software through diagrams.",
- "source": "./dist/plugins/mermaid-diagrams",
- "strict": false,
- "skills": [
- "./skills/mermaid-diagrams"
- ],
- "category": "documentation",
- "keywords": [
- "documentation",
- "diagrams",
- "mermaid",
- "visualization"
- ]
- },
- {
- "name": "writing-clearly-and-concisely",
- "description": "Use when writing prose humans will read\u2014documentation, commit messages, error messages, explanations, reports, or UI text.",
- "source": "./dist/plugins/writing-clearly-and-concisely",
- "strict": false,
- "skills": [
- "./skills/writing-clearly-and-concisely"
- ],
- "category": "documentation",
- "keywords": [
- "documentation",
- "writing",
- "communication"
- ]
- },
- {
- "name": "design-system-starter",
- "description": "Create and evolve design systems with design tokens, component architecture, accessibility guidelines, and documentation templates.",
- "source": "./dist/plugins/design-system-starter",
- "strict": false,
- "skills": [
- "./skills/design-system-starter"
- ],
- "category": "design-frontend",
- "keywords": [
- "design",
- "frontend",
- "design-system",
- "tokens",
- "accessibility"
- ]
- },
- {
- "name": "mui",
- "description": "Material-UI v7 component library patterns including sx prop styling, theme integration, responsive design, and MUI-specific hooks.",
- "source": "./dist/plugins/mui",
- "strict": false,
- "skills": [
- "./skills/mui"
- ],
- "category": "design-frontend",
- "keywords": [
- "design",
- "frontend",
- "mui",
- "material-ui",
- "react"
- ]
- },
- {
- "name": "openapi-to-typescript",
- "description": "Converts OpenAPI 3.0 JSON/YAML to TypeScript interfaces and type guards. Use when generating types from OpenAPI or creating API interfaces.",
- "source": "./dist/plugins/openapi-to-typescript",
- "strict": false,
- "skills": [
- "./skills/openapi-to-typescript"
- ],
- "category": "design-frontend",
- "keywords": [
- "design",
- "frontend",
- "openapi",
- "typescript",
- "api"
- ]
- },
- {
- "name": "react-dev",
- "description": "Build React components with TypeScript. Covers type-safe patterns for React 18-19 including generic components, proper event typing, and routing integration.",
- "source": "./dist/plugins/react-dev",
- "strict": false,
- "skills": [
- "./skills/react-dev"
- ],
- "category": "design-frontend",
- "keywords": [
- "design",
- "frontend",
- "react",
- "typescript"
- ]
- },
- {
- "name": "react-useeffect",
- "description": "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.",
- "source": "./dist/plugins/react-useeffect",
- "strict": false,
- "skills": [
- "./skills/react-useeffect"
- ],
- "category": "design-frontend",
- "keywords": [
- "design",
- "frontend",
- "react",
- "hooks",
- "useeffect"
- ]
- },
- {
- "name": "database-schema-designer",
- "description": "Design robust, scalable database schemas for SQL and NoSQL databases. Provides normalization guidelines, indexing strategies, migration patterns.",
- "source": "./dist/plugins/database-schema-designer",
- "strict": false,
- "skills": [
- "./skills/database-schema-designer"
- ],
- "category": "development",
- "keywords": [
- "development",
- "database",
- "schema",
- "sql",
- "nosql"
- ]
- },
- {
- "name": "dependency-updater",
- "description": "Smart dependency management for any language. Auto-detects project type, applies safe updates automatically, prompts for major versions.",
- "source": "./dist/plugins/dependency-updater",
- "strict": false,
- "skills": [
- "./skills/dependency-updater"
- ],
- "category": "development",
- "keywords": [
- "development",
- "dependencies",
- "updates",
- "npm",
- "pip"
- ]
- },
- {
- "name": "naming-analyzer",
- "description": "Suggest better variable, function, and class names based on context and conventions.",
- "source": "./dist/plugins/naming-analyzer",
- "strict": false,
- "skills": [
- "./skills/naming-analyzer"
- ],
- "category": "development",
- "keywords": [
- "development",
- "naming",
- "refactoring",
- "code-quality"
- ]
- },
- {
- "name": "reducing-entropy",
- "description": "Manual-only skill for minimizing total codebase size. Only activate when explicitly requested. Measures success by final code amount.",
- "source": "./dist/plugins/reducing-entropy",
- "strict": false,
- "skills": [
- "./skills/reducing-entropy"
- ],
- "category": "development",
- "keywords": [
- "development",
- "refactoring",
- "cleanup",
- "code-size"
- ]
- },
- {
- "name": "session-handoff",
- "description": "Creates comprehensive handoff documents for seamless AI agent session transfers. Use when context window approaches capacity or work session is ending.",
- "source": "./dist/plugins/session-handoff",
- "strict": false,
- "skills": [
- "./skills/session-handoff"
- ],
- "category": "development",
- "keywords": [
- "development",
- "handoff",
- "context",
- "session"
- ]
- },
- {
- "name": "lesson-learned",
- "description": "Analyze recent code changes via git history and extract software engineering lessons. Use when reflecting on work or asking 'what is the lesson here?'",
- "source": "./dist/plugins/lesson-learned",
- "strict": false,
- "skills": [
- "./skills/lesson-learned"
- ],
- "category": "development",
- "keywords": [
- "development",
- "reflection",
- "git",
- "learning",
- "principles"
- ]
- },
- {
- "name": "game-changing-features",
- "description": "Find 10x product opportunities and high-leverage improvements. Use when user wants strategic product thinking or wants to find high-impact features.",
- "source": "./dist/plugins/game-changing-features",
- "strict": false,
- "skills": [
- "./skills/game-changing-features"
- ],
- "category": "planning",
- "keywords": [
- "planning",
- "product",
- "strategy",
- "features"
- ]
- },
- {
- "name": "gepetto",
- "description": "Creates detailed, sectionized implementation plans through research, stakeholder interviews, and multi-LLM review. Use when planning features that need thorough pre-implementation analysis.",
- "source": "./dist/plugins/gepetto",
- "strict": false,
- "skills": [
- "./skills/gepetto"
- ],
- "category": "planning",
- "keywords": [
- "planning",
- "implementation",
- "analysis",
- "research"
- ]
- },
- {
- "name": "requirements-clarity",
- "description": "Clarify ambiguous requirements through focused dialogue before implementation. Use when requirements are unclear or features are complex.",
- "source": "./dist/plugins/requirements-clarity",
- "strict": false,
- "skills": [
- "./skills/requirements-clarity"
- ],
- "category": "planning",
- "keywords": [
- "planning",
- "requirements",
- "clarity",
- "communication"
- ]
- },
- {
- "name": "ship-learn-next",
- "description": "Transform learning content (like YouTube transcripts, articles, tutorials) into actionable implementation plans using the Ship-Learn-Next framework.",
- "source": "./dist/plugins/ship-learn-next",
- "strict": false,
- "skills": [
- "./skills/ship-learn-next"
- ],
- "category": "planning",
- "keywords": [
- "planning",
- "learning",
- "implementation",
- "action-items"
- ]
- },
- {
- "name": "difficult-workplace-conversations",
- "description": "Structured approach to workplace conflicts, performance discussions, and challenging feedback using preparation-delivery-followup framework.",
- "source": "./dist/plugins/difficult-workplace-conversations",
- "strict": false,
- "skills": [
- "./skills/difficult-workplace-conversations"
- ],
- "category": "professional",
- "keywords": [
- "professional",
- "communication",
- "feedback",
- "conflict"
- ]
- },
- {
- "name": "feedback-mastery",
- "description": "Navigate difficult conversations and deliver constructive feedback using structured frameworks. Covers the Preparation-Delivery-Follow-up model and Situation-Behavior-Impact (SBI) technique.",
- "source": "./dist/plugins/feedback-mastery",
- "strict": false,
- "skills": [
- "./skills/feedback-mastery"
- ],
- "category": "professional",
- "keywords": [
- "professional",
- "feedback",
- "communication",
- "sbi"
- ]
- },
- {
- "name": "daily-meeting-update",
- "description": "Interactive daily standup/meeting update generator. Use when user says 'daily', 'standup', 'scrum update', 'status update', or wants to prepare for daily meeting. Conducts interview (yesterday, today, blockers, discussion topics) and optionally pulls activity from GitHub/git/Jira if available and approved by user.",
- "source": "./dist/plugins/daily-meeting-update",
- "strict": false,
- "skills": [
- "./skills/daily-meeting-update"
- ],
- "category": "professional",
- "keywords": [
- "professional",
- "standup",
- "daily",
- "meeting",
- "scrum"
- ]
- },
- {
- "name": "professional-communication",
- "description": "Guide technical communication for software developers. Covers email structure, team messaging etiquette, meeting agendas, and adapting messages for technical vs non-technical audiences.",
- "source": "./dist/plugins/professional-communication",
- "strict": false,
- "skills": [
- "./skills/professional-communication"
- ],
- "category": "professional",
- "keywords": [
- "professional",
- "communication",
- "email",
- "meetings"
- ]
- },
- {
- "name": "qa-test-planner",
- "description": "Generate comprehensive test plans, manual test cases, regression test suites, and bug reports for QA engineers.",
- "source": "./dist/plugins/qa-test-planner",
- "strict": false,
- "skills": [
- "./skills/qa-test-planner"
- ],
- "category": "testing",
- "keywords": [
- "testing",
- "qa",
- "test-plans",
- "regression"
- ]
- },
- {
- "name": "commit-work",
- "description": "Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits).",
- "source": "./dist/plugins/commit-work",
- "strict": false,
- "skills": [
- "./skills/commit-work"
- ],
- "category": "git",
- "keywords": [
- "git",
- "commits",
- "conventional-commits"
- ]
- },
- {
- "name": "datadog-cli",
- "description": "Datadog CLI for searching logs, querying metrics, tracing requests, and managing dashboards. Use when debugging production issues or working with Datadog observability.",
- "source": "./dist/plugins/datadog-cli",
- "strict": false,
- "skills": [
- "./skills/datadog-cli"
- ],
- "category": "utilities",
- "keywords": [
- "utilities",
- "datadog",
- "logging",
- "metrics",
- "observability"
- ]
- },
- {
- "name": "domain-name-brainstormer",
- "description": "Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.).",
- "source": "./dist/plugins/domain-name-brainstormer",
- "strict": false,
- "skills": [
- "./skills/domain-name-brainstormer"
- ],
- "category": "utilities",
- "keywords": [
- "utilities",
- "domains",
- "naming",
- "brainstorming"
- ]
- },
- {
- "name": "humanizer",
- "description": "Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written.",
- "source": "./dist/plugins/humanizer",
- "strict": false,
- "skills": [
- "./skills/humanizer"
- ],
- "category": "utilities",
- "keywords": [
- "utilities",
- "writing",
- "ai-detection",
- "editing"
- ]
- },
- {
- "name": "meme-factory",
- "description": "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.",
- "source": "./dist/plugins/meme-factory",
- "strict": false,
- "skills": [
- "./skills/meme-factory"
- ],
- "category": "utilities",
- "keywords": [
- "utilities",
- "memes",
- "images",
- "social-media"
- ]
- },
- {
- "name": "web-to-markdown",
- "description": "Converts webpage URLs to clean Markdown by calling the local web2md CLI (Puppeteer + Readability), suitable for JS-rendered pages.",
- "source": "./dist/plugins/web-to-markdown",
- "strict": false,
- "skills": [
- "./skills/web-to-markdown"
- ],
- "category": "utilities",
- "keywords": [
- "utilities",
- "web",
- "markdown",
- "conversion"
- ]
- },
- {
- "name": "jira",
- "description": "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\", or issue key patterns.",
- "source": "./dist/plugins/jira",
- "strict": false,
- "skills": [
- "./skills/jira"
- ],
- "category": "utilities",
- "keywords": [
- "utilities",
- "jira",
- "tickets",
- "project-management",
- "atlassian"
- ]
- },
- {
- "name": "agent-ascii-ui-mockup-generator",
- "description": "Visualize UI concepts through ASCII mockups before implementation. Creates multiple ASCII mockup variations for dashboard layouts, forms, and other UI components.",
- "source": "./dist/plugins/agent-ascii-ui-mockup-generator",
- "strict": false,
- "agents": [
- "./agents/ascii-ui-mockup-generator.md"
- ],
- "category": "agents",
- "keywords": [
- "agents",
- "ui",
- "mockups",
- "ascii",
- "visualization"
- ]
- },
- {
- "name": "agent-codebase-pattern-finder",
- "description": "Find similar implementations, usage examples, or existing patterns in the codebase. Provides concrete code examples based on what you're looking for.",
- "source": "./dist/plugins/agent-codebase-pattern-finder",
- "strict": false,
- "agents": [
- "./agents/codebase-pattern-finder.md"
- ],
- "category": "agents",
- "keywords": [
- "agents",
- "codebase",
- "patterns",
- "search"
- ]
- },
- {
- "name": "agent-communication-excellence-coach",
- "description": "Review communication drafts or prepare difficult conversations. Provides email refinement, tone calibration, roleplay practice, and presentation feedback.",
- "source": "./dist/plugins/agent-communication-excellence-coach",
- "strict": false,
- "agents": [
- "./agents/communication-excellence-coach.md"
- ],
- "category": "agents",
- "keywords": [
- "agents",
- "communication",
- "email",
- "coaching"
- ]
- },
- {
- "name": "agent-general-purpose",
- "description": "Default agent for handling complex, multi-step tasks with automatic delegation capabilities.",
- "source": "./dist/plugins/agent-general-purpose",
- "strict": false,
- "agents": [
- "./agents/general-purpose.md"
- ],
- "category": "agents",
- "keywords": [
- "agents",
- "general",
- "delegation",
- "tasks"
- ]
- },
- {
- "name": "agent-mermaid-diagram-specialist",
- "description": "Mermaid diagram specialist for creating flowcharts, sequence diagrams, ERDs, and architecture visualizations.",
- "source": "./dist/plugins/agent-mermaid-diagram-specialist",
- "strict": false,
- "agents": [
- "./agents/mermaid-diagram-specialist.md"
- ],
- "category": "agents",
- "keywords": [
- "agents",
- "mermaid",
- "diagrams",
- "visualization"
- ]
- },
- {
- "name": "agent-ui-ux-designer",
- "description": "Expert UI/UX design critic and advisor who provides research-backed, opinionated feedback on interfaces. Pushes back on bad ideas and cites sources.",
- "source": "./dist/plugins/agent-ui-ux-designer",
- "strict": false,
- "agents": [
- "./agents/ui-ux-designer.md"
- ],
- "category": "agents",
- "keywords": [
- "agents",
- "ui",
- "ux",
- "design",
- "feedback"
- ]
- },
- {
- "name": "command-codex-plan",
- "description": "Create a detailed implementation plan using Codex 5.2 with high reasoning.",
- "source": "./dist/plugins/command-codex-plan",
- "strict": false,
- "commands": [
- "./commands/codex-plan.md"
- ],
- "category": "commands",
- "keywords": [
- "commands",
- "planning",
- "codex",
- "implementation"
- ]
- },
- {
- "name": "command-compose-email",
- "description": "Draft a professional email using the What-Why-How framework. Use when composing emails to colleagues, stakeholders, or leadership.",
- "source": "./dist/plugins/command-compose-email",
- "strict": false,
- "commands": [
- "./commands/compose-email.md"
- ],
- "category": "commands",
- "keywords": [
- "commands",
- "email",
- "communication",
- "professional"
- ]
- },
- {
- "name": "command-explain-changes-mental-model",
- "description": "Build a mental model of changes by splitting them into smaller logical chunks.",
- "source": "./dist/plugins/command-explain-changes-mental-model",
- "strict": false,
- "commands": [
- "./commands/explain-changes-mental-model.md"
- ],
- "category": "commands",
- "keywords": [
- "commands",
- "code-review",
- "understanding",
- "mental-model"
- ]
- },
- {
- "name": "command-explain-pr-changes",
- "description": "Generate comprehensive markdown summary of pull request changes with visual impact analysis.",
- "source": "./dist/plugins/command-explain-pr-changes",
- "strict": false,
- "commands": [
- "./commands/explain-pr-changes.md"
- ],
- "category": "commands",
- "keywords": [
- "commands",
- "git",
- "pull-requests",
- "documentation"
- ]
- },
- {
- "name": "command-sync-branch",
- "description": "Sync feature branch with the latest main branch.",
- "source": "./dist/plugins/command-sync-branch",
- "strict": false,
- "commands": [
- "./commands/sync-branch.md"
- ],
- "category": "commands",
- "keywords": [
- "commands",
- "git",
- "branches",
- "sync"
- ]
- },
- {
- "name": "command-sync-skills-readme",
- "description": "Sync root README.md with current skills inventory from skills/ directory.",
- "source": "./dist/plugins/command-sync-skills-readme",
- "strict": false,
- "commands": [
- "./commands/sync-skills-readme.md"
- ],
- "category": "commands",
- "keywords": [
- "commands",
- "readme",
- "sync",
- "documentation"
- ]
- },
- {
- "name": "command-viral-tweet",
- "description": "Transform a raw tweet idea into an optimized viral post for X. Analyzes engagement drivers and generates 3 optimized versions with posting strategy.",
- "source": "./dist/plugins/command-viral-tweet",
- "strict": false,
- "commands": [
- "./commands/viral-tweet.md"
- ],
- "category": "commands",
- "keywords": [
- "commands",
- "social-media",
- "twitter",
- "x",
- "viral",
- "engagement"
- ]
- }
- ]
- }
README.md · README · 215 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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-<name>@agent-toolkit`)
- - **Commands** → See [Slash Commands](#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
- ```bash
- 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](skills/codex/README.md) | Advanced code analysis with GPT-5.2 |
- | 🤖 AI Tools | [gemini](skills/gemini/README.md) | Large-scale review (200k+ context) |
- | 🤖 AI Tools | [perplexity](skills/perplexity/README.md) | Web search & research |
- | 🔮 Meta | [agent-md-refactor](skills/agent-md-refactor/README.md) | Refactor bloated agent instruction files |
- | 🔮 Meta | [command-creator](skills/command-creator/README.md) | Create Claude Code slash commands |
- | 🔮 Meta | [plugin-forge](skills/plugin-forge/README.md) | Build Claude Code plugins & manifests |
- | 🔮 Meta | [skill-judge](skills/skill-judge/README.md) | Evaluate skill design quality |
- | 📝 Documentation | [backend-to-frontend-handoff-docs](skills/backend-to-frontend-handoff-docs/README.md) | API handoff docs for frontend |
- | 📝 Documentation | [c4-architecture](skills/c4-architecture/README.md) | C4 architecture diagrams with Mermaid |
- | 📝 Documentation | [crafting-effective-readmes](skills/crafting-effective-readmes/README.md) | Write effective README files |
- | 📝 Documentation | [draw-io](skills/draw-io/README.md) | Create & edit draw.io diagrams |
- | 📝 Documentation | [excalidraw](skills/excalidraw/README.md) | Work with Excalidraw diagrams |
- | 📝 Documentation | [frontend-to-backend-requirements](skills/frontend-to-backend-requirements/README.md) | Document API requirements |
- | 📝 Documentation | [marp-slide](skills/marp-slide/README.md) | Professional presentation slides |
- | 📝 Documentation | [mermaid-diagrams](skills/mermaid-diagrams/README.md) | Software diagrams with Mermaid |
- | 📝 Documentation | [writing-clearly-and-concisely](skills/writing-clearly-and-concisely/README.md) | Clear, professional writing |
- | 🎨 Design & Frontend | [design-system-starter](skills/design-system-starter/README.md) | Create design systems |
- | 🎨 Design & Frontend | [mui](skills/mui/README.md) | Material-UI v7 patterns |
- | 🎨 Design & Frontend | [openapi-to-typescript](skills/openapi-to-typescript/README.md) | Convert OpenAPI to TypeScript |
- | 🎨 Design & Frontend | [react-dev](skills/react-dev/README.md) | Type-safe React 18-19 with TypeScript |
- | 🎨 Design & Frontend | [react-useeffect](skills/react-useeffect/README.md) | React useEffect best practices |
- | 🛠️ Development | [database-schema-designer](skills/database-schema-designer/README.md) | Design robust database schemas |
- | 🛠️ Development | [dependency-updater](skills/dependency-updater/README.md) | Smart dependency management |
- | 🛠️ Development | [naming-analyzer](skills/naming-analyzer/README.md) | Suggest better variable/function names |
- | 🛠️ Development | [lesson-learned](skills/lesson-learned/README.md) | Extract SE lessons from recent code changes |
- | 🛠️ Development | [reducing-entropy](skills/reducing-entropy/README.md) | Minimize codebase size |
- | 🛠️ Development | [session-handoff](skills/session-handoff/README.md) | Seamless AI session transfers |
- | 🎯 Planning | [game-changing-features](skills/game-changing-features/README.md) | Find 10x product opportunities |
- | 🎯 Planning | [gepetto](skills/gepetto/README.md) | Detailed implementation planning |
- | 🎯 Planning | [requirements-clarity](skills/requirements-clarity/README.md) | Clarify requirements before coding |
- | 🎯 Planning | [ship-learn-next](skills/ship-learn-next/README.md) | Turn learning into actionable reps |
- | 👔 Professional | [daily-meeting-update](skills/daily-meeting-update/README.md) | Interactive daily standup generator |
- | 👔 Professional | [difficult-workplace-conversations](skills/difficult-workplace-conversations/README.md) | Navigate difficult conversations |
- | 👔 Professional | [feedback-mastery](skills/feedback-mastery/README.md) | Deliver constructive feedback |
- | 👔 Professional | [professional-communication](skills/professional-communication/README.md) | Technical communication guide |
- | 🧪 Testing | [qa-test-planner](skills/qa-test-planner/README.md) | Comprehensive QA test planning |
- | 📦 Git | [commit-work](skills/commit-work/README.md) | High-quality git commits |
- | 🔧 Utilities | [datadog-cli](skills/datadog-cli/README.md) | Debug with Datadog logs & metrics |
- | 🔧 Utilities | [domain-name-brainstormer](skills/domain-name-brainstormer/README.md) | Generate & check domain names |
- | 🔧 Utilities | [humanizer](skills/humanizer/README.md) | Remove AI writing patterns |
- | 🔧 Utilities | [meme-factory](skills/meme-factory/README.md) | Generate memes with API |
- | 🔧 Utilities | [jira](skills/jira/README.md) | Natural language Jira interaction |
- | 🔧 Utilities | [web-to-markdown](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)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.