{
  "markdown": "# Softaworks Agent Skills\n\nOpinionated 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.\n\nSkills follow the [Agent Skills](https://agentskills.io/) format.\n\n---\n\n## 🧭 Quick Navigation\n\n**[🚀 Installation](#-installation)** • **[📚 Available Skills](#-available-skills)** • **[🤖 Agents & Commands](#-agents--commands)** • **[📖 Skill Structure](#-skill-structure)** • **[🤝 Contributing](#-contributing)** • **[📄 License](#-license)** • **[🔗 Links](#-links)**\n\n---\n\n## 🚀 Installation\n\n### Quick Install (Recommended)\n\n```bash\nnpx skills add softaworks/agent-toolkit\n```\n\nThis method works with multiple AI coding agents (Claude Code, Codex, Cursor, AdaL, etc.)\n\n### Register as Plugin Marketplace\n\nRun the following commands in Claude Code:\n\n```bash\n/plugin marketplace add softaworks/agent-toolkit\n/plugin\n```\n\n### Install Plugins\n\n**Option 1: Via Browse UI**\n\n1. Switch to **Marketplaces** tab (use arrow keys or Tab)\n2. Select **agent-toolkit**, press Enter\n3. Browse and select the plugin(s) you want to install\n4. Select **Install now**\n\n**Option 2: Direct Install**\n\n```bash\n# Install specific skill\n/plugin install codex@agent-toolkit\n/plugin install humanizer@agent-toolkit\n\n# Install specific agent\n/plugin install agent-codebase-pattern-finder@agent-toolkit\n\n# Install specific command\n/plugin install command-codex-plan@agent-toolkit\n```\n\n**Option 3: Ask the Agent**\n\nSimply tell Claude Code:\n\n> Please install Skills from github.com/softaworks/agent-toolkit\n\n### Available Plugins\n\nEach skill, agent, and command is an individual plugin that can be installed separately:\n\n- **Skills** → See [Available Skills](#-available-skills) for the full list\n- **Agents** → See [Agents](#agents) (install as `agent-<name>@agent-toolkit`)\n- **Commands** → See [Slash Commands](#slash-commands) (install as `command-<name>@agent-toolkit`)\n\n### Update Plugins\n\nTo update plugins to the latest version:\n\n1. Run `/plugin` in Claude Code\n2. Switch to **Marketplaces** tab\n3. Select **agent-toolkit**\n4. Choose **Update marketplace**\n\nYou can also **Enable auto-update** to get the latest versions automatically.\n\n### Manual Installation\n\n**For Claude Code (Manual)** — Skills only\n```bash\ncp -r skills/<skill-name> ~/.claude/skills/\n```\n\n**For claude.ai** — Skills only\n\nAdd skills to project knowledge or paste SKILL.md contents into the conversation.\n\n---\n\n## 📚 Available Skills\n\n| Category | Skill | Description |\n|----------|-------|-------------|\n| 🤖 AI Tools | [codex](skills/codex/README.md) | Advanced code analysis with GPT-5.2 |\n| 🤖 AI Tools | [gemini](skills/gemini/README.md) | Large-scale review (200k+ context) |\n| 🤖 AI Tools | [perplexity](skills/perplexity/README.md) | Web search & research |\n| 🔮 Meta | [agent-md-refactor](skills/agent-md-refactor/README.md) | Refactor bloated agent instruction files |\n| 🔮 Meta | [command-creator](skills/command-creator/README.md) | Create Claude Code slash commands |\n| 🔮 Meta | [plugin-forge](skills/plugin-forge/README.md) | Build Claude Code plugins & manifests |\n| 🔮 Meta | [skill-judge](skills/skill-judge/README.md) | Evaluate skill design quality |\n| 📝 Documentation | [backend-to-frontend-handoff-docs](skills/backend-to-frontend-handoff-docs/README.md) | API handoff docs for frontend |\n| 📝 Documentation | [c4-architecture](skills/c4-architecture/README.md) | C4 architecture diagrams with Mermaid |\n| 📝 Documentation | [crafting-effective-readmes](skills/crafting-effective-readmes/README.md) | Write effective README files |\n| 📝 Documentation | [draw-io](skills/draw-io/README.md) | Create & edit draw.io diagrams |\n| 📝 Documentation | [excalidraw](skills/excalidraw/README.md) | Work with Excalidraw diagrams |\n| 📝 Documentation | [frontend-to-backend-requirements](skills/frontend-to-backend-requirements/README.md) | Document API requirements |\n| 📝 Documentation | [marp-slide](skills/marp-slide/README.md) | Professional presentation slides |\n| 📝 Documentation | [mermaid-diagrams](skills/mermaid-diagrams/README.md) | Software diagrams with Mermaid |\n| 📝 Documentation | [writing-clearly-and-concisely](skills/writing-clearly-and-concisely/README.md) | Clear, professional writing |\n| 🎨 Design & Frontend | [design-system-starter](skills/design-system-starter/README.md) | Create design systems |\n| 🎨 Design & Frontend | [mui](skills/mui/README.md) | Material-UI v7 patterns |\n| 🎨 Design & Frontend | [openapi-to-typescript](skills/openapi-to-typescript/README.md) | Convert OpenAPI to TypeScript |\n| 🎨 Design & Frontend | [react-dev](skills/react-dev/README.md) | Type-safe React 18-19 with TypeScript |\n| 🎨 Design & Frontend | [react-useeffect](skills/react-useeffect/README.md) | React useEffect best practices |\n| 🛠️ Development | [database-schema-designer](skills/database-schema-designer/README.md) | Design robust database schemas |\n| 🛠️ Development | [dependency-updater](skills/dependency-updater/README.md) | Smart dependency management |\n| 🛠️ Development | [naming-analyzer](skills/naming-analyzer/README.md) | Suggest better variable/function names |\n| 🛠️ Development | [lesson-learned](skills/lesson-learned/README.md) | Extract SE lessons from recent code changes |\n| 🛠️ Development | [reducing-entropy](skills/reducing-entropy/README.md) | Minimize codebase size |\n| 🛠️ Development | [session-handoff](skills/session-handoff/README.md) | Seamless AI session transfers |\n| 🎯 Planning | [game-changing-features](skills/game-changing-features/README.md) | Find 10x product opportunities |\n| 🎯 Planning | [gepetto](skills/gepetto/README.md) | Detailed implementation planning |\n| 🎯 Planning | [requirements-clarity](skills/requirements-clarity/README.md) | Clarify requirements before coding |\n| 🎯 Planning | [ship-learn-next](skills/ship-learn-next/README.md) | Turn learning into actionable reps |\n| 👔 Professional | [daily-meeting-update](skills/daily-meeting-update/README.md) | Interactive daily standup generator |\n| 👔 Professional | [difficult-workplace-conversations](skills/difficult-workplace-conversations/README.md) | Navigate difficult conversations |\n| 👔 Professional | [feedback-mastery](skills/feedback-mastery/README.md) | Deliver constructive feedback |\n| 👔 Professional | [professional-communication](skills/professional-communication/README.md) | Technical communication guide |\n| 🧪 Testing | [qa-test-planner](skills/qa-test-planner/README.md) | Comprehensive QA test planning |\n| 📦 Git | [commit-work](skills/commit-work/README.md) | High-quality git commits |\n| 🔧 Utilities | [datadog-cli](skills/datadog-cli/README.md) | Debug with Datadog logs & metrics |\n| 🔧 Utilities | [domain-name-brainstormer](skills/domain-name-brainstormer/README.md) | Generate & check domain names |\n| 🔧 Utilities | [humanizer](skills/humanizer/README.md) | Remove AI writing patterns |\n| 🔧 Utilities | [meme-factory](skills/meme-factory/README.md) | Generate memes with API |\n| 🔧 Utilities | [jira](skills/jira/README.md) | Natural language Jira interaction |\n| 🔧 Utilities | [web-to-markdown](skills/web-to-markdown/README.md) | Convert webpages to Markdown |\n\n---\n\n## 🤖 Agents & Commands\n\n> **Requires [Claude Code CLI](https://docs.anthropic.com/claude-code)** — These agents and commands are exclusive to Claude Code users.\n>\n> For full access, add the marketplace and install plugins:\n> ```bash\n> /plugin marketplace add softaworks/agent-toolkit\n> /plugin install codex@agent-toolkit\n> ```\n\n### Agents\n\nSpecialized sub-agents that Claude Code can delegate tasks to:\n\n| Agent | Description |\n|-------|-------------|\n| ascii-ui-mockup-generator | Visualize UI concepts through ASCII mockups |\n| codebase-pattern-finder | Find similar implementations and patterns |\n| communication-excellence-coach | Email refinement, tone calibration, roleplay |\n| general-purpose | Default agent for complex multi-step tasks |\n| mermaid-diagram-specialist | Create flowcharts, sequence diagrams, ERDs |\n| ui-ux-designer | Research-backed UI/UX design feedback |\n\n### Slash Commands\n\nReusable workflows invoked with `/command-name`:\n\n| Command | Description |\n|---------|-------------|\n| `/codex-plan` | Create implementation plans using Codex 5.2 |\n| `/compose-email` | Draft professional emails |\n| `/explain-changes-mental-model` | Build mental model of code changes |\n| `/explain-pr-changes` | Generate PR summaries |\n| `/sync-branch` | Sync feature branch with main |\n| `/sync-skills-readme` | Update README skills table |\n| `/viral-tweet` | Optimize tweet ideas for X engagement |\n\n---\n\n## 📖 Skill Structure\n\nEach skill contains:\n- `SKILL.md` - Detailed instructions for the agent (with YAML frontmatter)\n- `README.md` - User-friendly documentation with examples\n- `scripts/` - Helper scripts for automation (optional)\n- `references/` - Supporting documentation (optional)\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! When adding new skills:\n\n1. Follow the [Agent Skills](https://agentskills.io/) format\n2. Include both `SKILL.md` (for agents) and `README.md` (for users)\n3. Add YAML frontmatter to `SKILL.md` with `name:` and `description:` fields\n4. Update this README.md with a link to your skill\n\n---\n\n## 📄 License\n\nMIT\n\n---\n\n## 🔗 Links\n\n- [Agent Skills Format](https://agentskills.io/)\n- [Claude Code Documentation](https://docs.anthropic.com/claude/docs)\n- [GitHub Repository](https://github.com/softaworks/agent-toolkit)\n",
  "bytes": 9580,
  "sha": "411194e82f63ce7df0f67c83e72f696f44a3f61ddb8b77bbe23957e7fe05e1f0",
  "repo_slug": "softaworks/agent-toolkit",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_softaworks_agent_toolkit_game_changing_f_7db36771/readme"
}