Skip to content
Back to search

agent-toolkit

MarketplaceWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/softaworks-agent-toolkit/badge.svg)](/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)

  1. {
  2. "name": "agent-toolkit",
  3. "owner": {
  4. "name": "softaworks",
  5. "url": "https://github.com/softaworks"
  6. },
  7. "metadata": {
  8. "description": "Skills, agents, and commands for AI coding agents - individually selectable",
  9. "version": "1.0.10"
  10. },
  11. "plugins": [
  12. {
  13. "name": "codex",
  14. "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.",
  15. "source": "./dist/plugins/codex",
  16. "strict": false,
  17. "skills": [
  18. "./skills/codex"
  19. ],
  20. "category": "ai-tools",
  21. "keywords": [
  22. "ai",
  23. "code-analysis",
  24. "gpt",
  25. "codex",
  26. "openai"
  27. ]
  28. },
  29. {
  30. "name": "gemini",
  31. "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.",
  32. "source": "./dist/plugins/gemini",
  33. "strict": false,
  34. "skills": [
  35. "./skills/gemini"
  36. ],
  37. "category": "ai-tools",
  38. "keywords": [
  39. "ai",
  40. "code-review",
  41. "large-context",
  42. "gemini",
  43. "google"
  44. ]
  45. },
  46. {
  47. "name": "perplexity",
  48. "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.",
  49. "source": "./dist/plugins/perplexity",
  50. "strict": false,
  51. "skills": [
  52. "./skills/perplexity"
  53. ],
  54. "category": "ai-tools",
  55. "keywords": [
  56. "ai",
  57. "search",
  58. "research",
  59. "perplexity"
  60. ]
  61. },
  62. {
  63. "name": "agent-md-refactor",
  64. "description": "Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.",
  65. "source": "./dist/plugins/agent-md-refactor",
  66. "strict": false,
  67. "skills": [
  68. "./skills/agent-md-refactor"
  69. ],
  70. "category": "meta",
  71. "keywords": [
  72. "meta",
  73. "refactor",
  74. "claude-md",
  75. "agents-md",
  76. "documentation"
  77. ]
  78. },
  79. {
  80. "name": "command-creator",
  81. "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.",
  82. "source": "./dist/plugins/command-creator",
  83. "strict": false,
  84. "skills": [
  85. "./skills/command-creator"
  86. ],
  87. "category": "meta",
  88. "keywords": [
  89. "meta",
  90. "commands",
  91. "slash-commands",
  92. "claude-code"
  93. ]
  94. },
  95. {
  96. "name": "plugin-forge",
  97. "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.",
  98. "source": "./dist/plugins/plugin-forge",
  99. "strict": false,
  100. "skills": [
  101. "./skills/plugin-forge"
  102. ],
  103. "category": "meta",
  104. "keywords": [
  105. "meta",
  106. "plugins",
  107. "marketplace",
  108. "claude-code"
  109. ]
  110. },
  111. {
  112. "name": "skill-judge",
  113. "description": "Evaluate Agent Skill design quality against official specifications and best practices. Use when reviewing, auditing, or improving SKILL.md files and skill packages.",
  114. "source": "./dist/plugins/skill-judge",
  115. "strict": false,
  116. "skills": [
  117. "./skills/skill-judge"
  118. ],
  119. "category": "meta",
  120. "keywords": [
  121. "meta",
  122. "skills",
  123. "quality",
  124. "review"
  125. ]
  126. },
  127. {
  128. "name": "backend-to-frontend-handoff-docs",
  129. "description": "Create API handoff documentation for frontend developers. Use when backend work is complete and needs to be documented for frontend integration.",
  130. "source": "./dist/plugins/backend-to-frontend-handoff-docs",
  131. "strict": false,
  132. "skills": [
  133. "./skills/backend-to-frontend-handoff-docs"
  134. ],
  135. "category": "documentation",
  136. "keywords": [
  137. "documentation",
  138. "api",
  139. "handoff",
  140. "frontend",
  141. "backend"
  142. ]
  143. },
  144. {
  145. "name": "c4-architecture",
  146. "description": "Generate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize software structure.",
  147. "source": "./dist/plugins/c4-architecture",
  148. "strict": false,
  149. "skills": [
  150. "./skills/c4-architecture"
  151. ],
  152. "category": "documentation",
  153. "keywords": [
  154. "documentation",
  155. "architecture",
  156. "c4",
  157. "mermaid",
  158. "diagrams"
  159. ]
  160. },
  161. {
  162. "name": "crafting-effective-readmes",
  163. "description": "Use when writing or improving README files. Provides templates and guidance matched to your audience and project type.",
  164. "source": "./dist/plugins/crafting-effective-readmes",
  165. "strict": false,
  166. "skills": [
  167. "./skills/crafting-effective-readmes"
  168. ],
  169. "category": "documentation",
  170. "keywords": [
  171. "documentation",
  172. "readme",
  173. "writing"
  174. ]
  175. },
  176. {
  177. "name": "draw-io",
  178. "description": "draw.io diagram creation, editing, and review. Use for .drawio XML editing, PNG conversion, layout adjustment, and AWS icon usage.",
  179. "source": "./dist/plugins/draw-io",
  180. "strict": false,
  181. "skills": [
  182. "./skills/draw-io"
  183. ],
  184. "category": "documentation",
  185. "keywords": [
  186. "documentation",
  187. "diagrams",
  188. "draw-io",
  189. "xml"
  190. ]
  191. },
  192. {
  193. "name": "excalidraw",
  194. "description": "Use when working with *.excalidraw or *.excalidraw.json files, user mentions diagrams/flowcharts, or requests architecture visualization.",
  195. "source": "./dist/plugins/excalidraw",
  196. "strict": false,
  197. "skills": [
  198. "./skills/excalidraw"
  199. ],
  200. "category": "documentation",
  201. "keywords": [
  202. "documentation",
  203. "diagrams",
  204. "excalidraw",
  205. "visualization"
  206. ]
  207. },
  208. {
  209. "name": "frontend-to-backend-requirements",
  210. "description": "Document frontend data needs for backend developers. Use when frontend needs to communicate API requirements to backend.",
  211. "source": "./dist/plugins/frontend-to-backend-requirements",
  212. "strict": false,
  213. "skills": [
  214. "./skills/frontend-to-backend-requirements"
  215. ],
  216. "category": "documentation",
  217. "keywords": [
  218. "documentation",
  219. "api",
  220. "requirements",
  221. "frontend",
  222. "backend"
  223. ]
  224. },
  225. {
  226. "name": "marp-slide",
  227. "description": "Create professional Marp presentation slides with 7 beautiful themes. Use when users request slide creation, presentations, or Marp documents.",
  228. "source": "./dist/plugins/marp-slide",
  229. "strict": false,
  230. "skills": [
  231. "./skills/marp-slide"
  232. ],
  233. "category": "documentation",
  234. "keywords": [
  235. "documentation",
  236. "presentations",
  237. "slides",
  238. "marp"
  239. ]
  240. },
  241. {
  242. "name": "mermaid-diagrams",
  243. "description": "Comprehensive guide for creating software diagrams using Mermaid syntax. Use when users need to create, visualize, or document software through diagrams.",
  244. "source": "./dist/plugins/mermaid-diagrams",
  245. "strict": false,
  246. "skills": [
  247. "./skills/mermaid-diagrams"
  248. ],
  249. "category": "documentation",
  250. "keywords": [
  251. "documentation",
  252. "diagrams",
  253. "mermaid",
  254. "visualization"
  255. ]
  256. },
  257. {
  258. "name": "writing-clearly-and-concisely",
  259. "description": "Use when writing prose humans will read\u2014documentation, commit messages, error messages, explanations, reports, or UI text.",
  260. "source": "./dist/plugins/writing-clearly-and-concisely",
  261. "strict": false,
  262. "skills": [
  263. "./skills/writing-clearly-and-concisely"
  264. ],
  265. "category": "documentation",
  266. "keywords": [
  267. "documentation",
  268. "writing",
  269. "communication"
  270. ]
  271. },
  272. {
  273. "name": "design-system-starter",
  274. "description": "Create and evolve design systems with design tokens, component architecture, accessibility guidelines, and documentation templates.",
  275. "source": "./dist/plugins/design-system-starter",
  276. "strict": false,
  277. "skills": [
  278. "./skills/design-system-starter"
  279. ],
  280. "category": "design-frontend",
  281. "keywords": [
  282. "design",
  283. "frontend",
  284. "design-system",
  285. "tokens",
  286. "accessibility"
  287. ]
  288. },
  289. {
  290. "name": "mui",
  291. "description": "Material-UI v7 component library patterns including sx prop styling, theme integration, responsive design, and MUI-specific hooks.",
  292. "source": "./dist/plugins/mui",
  293. "strict": false,
  294. "skills": [
  295. "./skills/mui"
  296. ],
  297. "category": "design-frontend",
  298. "keywords": [
  299. "design",
  300. "frontend",
  301. "mui",
  302. "material-ui",
  303. "react"
  304. ]
  305. },
  306. {
  307. "name": "openapi-to-typescript",
  308. "description": "Converts OpenAPI 3.0 JSON/YAML to TypeScript interfaces and type guards. Use when generating types from OpenAPI or creating API interfaces.",
  309. "source": "./dist/plugins/openapi-to-typescript",
  310. "strict": false,
  311. "skills": [
  312. "./skills/openapi-to-typescript"
  313. ],
  314. "category": "design-frontend",
  315. "keywords": [
  316. "design",
  317. "frontend",
  318. "openapi",
  319. "typescript",
  320. "api"
  321. ]
  322. },
  323. {
  324. "name": "react-dev",
  325. "description": "Build React components with TypeScript. Covers type-safe patterns for React 18-19 including generic components, proper event typing, and routing integration.",
  326. "source": "./dist/plugins/react-dev",
  327. "strict": false,
  328. "skills": [
  329. "./skills/react-dev"
  330. ],
  331. "category": "design-frontend",
  332. "keywords": [
  333. "design",
  334. "frontend",
  335. "react",
  336. "typescript"
  337. ]
  338. },
  339. {
  340. "name": "react-useeffect",
  341. "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.",
  342. "source": "./dist/plugins/react-useeffect",
  343. "strict": false,
  344. "skills": [
  345. "./skills/react-useeffect"
  346. ],
  347. "category": "design-frontend",
  348. "keywords": [
  349. "design",
  350. "frontend",
  351. "react",
  352. "hooks",
  353. "useeffect"
  354. ]
  355. },
  356. {
  357. "name": "database-schema-designer",
  358. "description": "Design robust, scalable database schemas for SQL and NoSQL databases. Provides normalization guidelines, indexing strategies, migration patterns.",
  359. "source": "./dist/plugins/database-schema-designer",
  360. "strict": false,
  361. "skills": [
  362. "./skills/database-schema-designer"
  363. ],
  364. "category": "development",
  365. "keywords": [
  366. "development",
  367. "database",
  368. "schema",
  369. "sql",
  370. "nosql"
  371. ]
  372. },
  373. {
  374. "name": "dependency-updater",
  375. "description": "Smart dependency management for any language. Auto-detects project type, applies safe updates automatically, prompts for major versions.",
  376. "source": "./dist/plugins/dependency-updater",
  377. "strict": false,
  378. "skills": [
  379. "./skills/dependency-updater"
  380. ],
  381. "category": "development",
  382. "keywords": [
  383. "development",
  384. "dependencies",
  385. "updates",
  386. "npm",
  387. "pip"
  388. ]
  389. },
  390. {
  391. "name": "naming-analyzer",
  392. "description": "Suggest better variable, function, and class names based on context and conventions.",
  393. "source": "./dist/plugins/naming-analyzer",
  394. "strict": false,
  395. "skills": [
  396. "./skills/naming-analyzer"
  397. ],
  398. "category": "development",
  399. "keywords": [
  400. "development",
  401. "naming",
  402. "refactoring",
  403. "code-quality"
  404. ]
  405. },
  406. {
  407. "name": "reducing-entropy",
  408. "description": "Manual-only skill for minimizing total codebase size. Only activate when explicitly requested. Measures success by final code amount.",
  409. "source": "./dist/plugins/reducing-entropy",
  410. "strict": false,
  411. "skills": [
  412. "./skills/reducing-entropy"
  413. ],
  414. "category": "development",
  415. "keywords": [
  416. "development",
  417. "refactoring",
  418. "cleanup",
  419. "code-size"
  420. ]
  421. },
  422. {
  423. "name": "session-handoff",
  424. "description": "Creates comprehensive handoff documents for seamless AI agent session transfers. Use when context window approaches capacity or work session is ending.",
  425. "source": "./dist/plugins/session-handoff",
  426. "strict": false,
  427. "skills": [
  428. "./skills/session-handoff"
  429. ],
  430. "category": "development",
  431. "keywords": [
  432. "development",
  433. "handoff",
  434. "context",
  435. "session"
  436. ]
  437. },
  438. {
  439. "name": "lesson-learned",
  440. "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?'",
  441. "source": "./dist/plugins/lesson-learned",
  442. "strict": false,
  443. "skills": [
  444. "./skills/lesson-learned"
  445. ],
  446. "category": "development",
  447. "keywords": [
  448. "development",
  449. "reflection",
  450. "git",
  451. "learning",
  452. "principles"
  453. ]
  454. },
  455. {
  456. "name": "game-changing-features",
  457. "description": "Find 10x product opportunities and high-leverage improvements. Use when user wants strategic product thinking or wants to find high-impact features.",
  458. "source": "./dist/plugins/game-changing-features",
  459. "strict": false,
  460. "skills": [
  461. "./skills/game-changing-features"
  462. ],
  463. "category": "planning",
  464. "keywords": [
  465. "planning",
  466. "product",
  467. "strategy",
  468. "features"
  469. ]
  470. },
  471. {
  472. "name": "gepetto",
  473. "description": "Creates detailed, sectionized implementation plans through research, stakeholder interviews, and multi-LLM review. Use when planning features that need thorough pre-implementation analysis.",
  474. "source": "./dist/plugins/gepetto",
  475. "strict": false,
  476. "skills": [
  477. "./skills/gepetto"
  478. ],
  479. "category": "planning",
  480. "keywords": [
  481. "planning",
  482. "implementation",
  483. "analysis",
  484. "research"
  485. ]
  486. },
  487. {
  488. "name": "requirements-clarity",
  489. "description": "Clarify ambiguous requirements through focused dialogue before implementation. Use when requirements are unclear or features are complex.",
  490. "source": "./dist/plugins/requirements-clarity",
  491. "strict": false,
  492. "skills": [
  493. "./skills/requirements-clarity"
  494. ],
  495. "category": "planning",
  496. "keywords": [
  497. "planning",
  498. "requirements",
  499. "clarity",
  500. "communication"
  501. ]
  502. },
  503. {
  504. "name": "ship-learn-next",
  505. "description": "Transform learning content (like YouTube transcripts, articles, tutorials) into actionable implementation plans using the Ship-Learn-Next framework.",
  506. "source": "./dist/plugins/ship-learn-next",
  507. "strict": false,
  508. "skills": [
  509. "./skills/ship-learn-next"
  510. ],
  511. "category": "planning",
  512. "keywords": [
  513. "planning",
  514. "learning",
  515. "implementation",
  516. "action-items"
  517. ]
  518. },
  519. {
  520. "name": "difficult-workplace-conversations",
  521. "description": "Structured approach to workplace conflicts, performance discussions, and challenging feedback using preparation-delivery-followup framework.",
  522. "source": "./dist/plugins/difficult-workplace-conversations",
  523. "strict": false,
  524. "skills": [
  525. "./skills/difficult-workplace-conversations"
  526. ],
  527. "category": "professional",
  528. "keywords": [
  529. "professional",
  530. "communication",
  531. "feedback",
  532. "conflict"
  533. ]
  534. },
  535. {
  536. "name": "feedback-mastery",
  537. "description": "Navigate difficult conversations and deliver constructive feedback using structured frameworks. Covers the Preparation-Delivery-Follow-up model and Situation-Behavior-Impact (SBI) technique.",
  538. "source": "./dist/plugins/feedback-mastery",
  539. "strict": false,
  540. "skills": [
  541. "./skills/feedback-mastery"
  542. ],
  543. "category": "professional",
  544. "keywords": [
  545. "professional",
  546. "feedback",
  547. "communication",
  548. "sbi"
  549. ]
  550. },
  551. {
  552. "name": "daily-meeting-update",
  553. "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.",
  554. "source": "./dist/plugins/daily-meeting-update",
  555. "strict": false,
  556. "skills": [
  557. "./skills/daily-meeting-update"
  558. ],
  559. "category": "professional",
  560. "keywords": [
  561. "professional",
  562. "standup",
  563. "daily",
  564. "meeting",
  565. "scrum"
  566. ]
  567. },
  568. {
  569. "name": "professional-communication",
  570. "description": "Guide technical communication for software developers. Covers email structure, team messaging etiquette, meeting agendas, and adapting messages for technical vs non-technical audiences.",
  571. "source": "./dist/plugins/professional-communication",
  572. "strict": false,
  573. "skills": [
  574. "./skills/professional-communication"
  575. ],
  576. "category": "professional",
  577. "keywords": [
  578. "professional",
  579. "communication",
  580. "email",
  581. "meetings"
  582. ]
  583. },
  584. {
  585. "name": "qa-test-planner",
  586. "description": "Generate comprehensive test plans, manual test cases, regression test suites, and bug reports for QA engineers.",
  587. "source": "./dist/plugins/qa-test-planner",
  588. "strict": false,
  589. "skills": [
  590. "./skills/qa-test-planner"
  591. ],
  592. "category": "testing",
  593. "keywords": [
  594. "testing",
  595. "qa",
  596. "test-plans",
  597. "regression"
  598. ]
  599. },
  600. {
  601. "name": "commit-work",
  602. "description": "Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits).",
  603. "source": "./dist/plugins/commit-work",
  604. "strict": false,
  605. "skills": [
  606. "./skills/commit-work"
  607. ],
  608. "category": "git",
  609. "keywords": [
  610. "git",
  611. "commits",
  612. "conventional-commits"
  613. ]
  614. },
  615. {
  616. "name": "datadog-cli",
  617. "description": "Datadog CLI for searching logs, querying metrics, tracing requests, and managing dashboards. Use when debugging production issues or working with Datadog observability.",
  618. "source": "./dist/plugins/datadog-cli",
  619. "strict": false,
  620. "skills": [
  621. "./skills/datadog-cli"
  622. ],
  623. "category": "utilities",
  624. "keywords": [
  625. "utilities",
  626. "datadog",
  627. "logging",
  628. "metrics",
  629. "observability"
  630. ]
  631. },
  632. {
  633. "name": "domain-name-brainstormer",
  634. "description": "Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.).",
  635. "source": "./dist/plugins/domain-name-brainstormer",
  636. "strict": false,
  637. "skills": [
  638. "./skills/domain-name-brainstormer"
  639. ],
  640. "category": "utilities",
  641. "keywords": [
  642. "utilities",
  643. "domains",
  644. "naming",
  645. "brainstorming"
  646. ]
  647. },
  648. {
  649. "name": "humanizer",
  650. "description": "Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written.",
  651. "source": "./dist/plugins/humanizer",
  652. "strict": false,
  653. "skills": [
  654. "./skills/humanizer"
  655. ],
  656. "category": "utilities",
  657. "keywords": [
  658. "utilities",
  659. "writing",
  660. "ai-detection",
  661. "editing"
  662. ]
  663. },
  664. {
  665. "name": "meme-factory",
  666. "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.",
  667. "source": "./dist/plugins/meme-factory",
  668. "strict": false,
  669. "skills": [
  670. "./skills/meme-factory"
  671. ],
  672. "category": "utilities",
  673. "keywords": [
  674. "utilities",
  675. "memes",
  676. "images",
  677. "social-media"
  678. ]
  679. },
  680. {
  681. "name": "web-to-markdown",
  682. "description": "Converts webpage URLs to clean Markdown by calling the local web2md CLI (Puppeteer + Readability), suitable for JS-rendered pages.",
  683. "source": "./dist/plugins/web-to-markdown",
  684. "strict": false,
  685. "skills": [
  686. "./skills/web-to-markdown"
  687. ],
  688. "category": "utilities",
  689. "keywords": [
  690. "utilities",
  691. "web",
  692. "markdown",
  693. "conversion"
  694. ]
  695. },
  696. {
  697. "name": "jira",
  698. "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.",
  699. "source": "./dist/plugins/jira",
  700. "strict": false,
  701. "skills": [
  702. "./skills/jira"
  703. ],
  704. "category": "utilities",
  705. "keywords": [
  706. "utilities",
  707. "jira",
  708. "tickets",
  709. "project-management",
  710. "atlassian"
  711. ]
  712. },
  713. {
  714. "name": "agent-ascii-ui-mockup-generator",
  715. "description": "Visualize UI concepts through ASCII mockups before implementation. Creates multiple ASCII mockup variations for dashboard layouts, forms, and other UI components.",
  716. "source": "./dist/plugins/agent-ascii-ui-mockup-generator",
  717. "strict": false,
  718. "agents": [
  719. "./agents/ascii-ui-mockup-generator.md"
  720. ],
  721. "category": "agents",
  722. "keywords": [
  723. "agents",
  724. "ui",
  725. "mockups",
  726. "ascii",
  727. "visualization"
  728. ]
  729. },
  730. {
  731. "name": "agent-codebase-pattern-finder",
  732. "description": "Find similar implementations, usage examples, or existing patterns in the codebase. Provides concrete code examples based on what you're looking for.",
  733. "source": "./dist/plugins/agent-codebase-pattern-finder",
  734. "strict": false,
  735. "agents": [
  736. "./agents/codebase-pattern-finder.md"
  737. ],
  738. "category": "agents",
  739. "keywords": [
  740. "agents",
  741. "codebase",
  742. "patterns",
  743. "search"
  744. ]
  745. },
  746. {
  747. "name": "agent-communication-excellence-coach",
  748. "description": "Review communication drafts or prepare difficult conversations. Provides email refinement, tone calibration, roleplay practice, and presentation feedback.",
  749. "source": "./dist/plugins/agent-communication-excellence-coach",
  750. "strict": false,
  751. "agents": [
  752. "./agents/communication-excellence-coach.md"
  753. ],
  754. "category": "agents",
  755. "keywords": [
  756. "agents",
  757. "communication",
  758. "email",
  759. "coaching"
  760. ]
  761. },
  762. {
  763. "name": "agent-general-purpose",
  764. "description": "Default agent for handling complex, multi-step tasks with automatic delegation capabilities.",
  765. "source": "./dist/plugins/agent-general-purpose",
  766. "strict": false,
  767. "agents": [
  768. "./agents/general-purpose.md"
  769. ],
  770. "category": "agents",
  771. "keywords": [
  772. "agents",
  773. "general",
  774. "delegation",
  775. "tasks"
  776. ]
  777. },
  778. {
  779. "name": "agent-mermaid-diagram-specialist",
  780. "description": "Mermaid diagram specialist for creating flowcharts, sequence diagrams, ERDs, and architecture visualizations.",
  781. "source": "./dist/plugins/agent-mermaid-diagram-specialist",
  782. "strict": false,
  783. "agents": [
  784. "./agents/mermaid-diagram-specialist.md"
  785. ],
  786. "category": "agents",
  787. "keywords": [
  788. "agents",
  789. "mermaid",
  790. "diagrams",
  791. "visualization"
  792. ]
  793. },
  794. {
  795. "name": "agent-ui-ux-designer",
  796. "description": "Expert UI/UX design critic and advisor who provides research-backed, opinionated feedback on interfaces. Pushes back on bad ideas and cites sources.",
  797. "source": "./dist/plugins/agent-ui-ux-designer",
  798. "strict": false,
  799. "agents": [
  800. "./agents/ui-ux-designer.md"
  801. ],
  802. "category": "agents",
  803. "keywords": [
  804. "agents",
  805. "ui",
  806. "ux",
  807. "design",
  808. "feedback"
  809. ]
  810. },
  811. {
  812. "name": "command-codex-plan",
  813. "description": "Create a detailed implementation plan using Codex 5.2 with high reasoning.",
  814. "source": "./dist/plugins/command-codex-plan",
  815. "strict": false,
  816. "commands": [
  817. "./commands/codex-plan.md"
  818. ],
  819. "category": "commands",
  820. "keywords": [
  821. "commands",
  822. "planning",
  823. "codex",
  824. "implementation"
  825. ]
  826. },
  827. {
  828. "name": "command-compose-email",
  829. "description": "Draft a professional email using the What-Why-How framework. Use when composing emails to colleagues, stakeholders, or leadership.",
  830. "source": "./dist/plugins/command-compose-email",
  831. "strict": false,
  832. "commands": [
  833. "./commands/compose-email.md"
  834. ],
  835. "category": "commands",
  836. "keywords": [
  837. "commands",
  838. "email",
  839. "communication",
  840. "professional"
  841. ]
  842. },
  843. {
  844. "name": "command-explain-changes-mental-model",
  845. "description": "Build a mental model of changes by splitting them into smaller logical chunks.",
  846. "source": "./dist/plugins/command-explain-changes-mental-model",
  847. "strict": false,
  848. "commands": [
  849. "./commands/explain-changes-mental-model.md"
  850. ],
  851. "category": "commands",
  852. "keywords": [
  853. "commands",
  854. "code-review",
  855. "understanding",
  856. "mental-model"
  857. ]
  858. },
  859. {
  860. "name": "command-explain-pr-changes",
  861. "description": "Generate comprehensive markdown summary of pull request changes with visual impact analysis.",
  862. "source": "./dist/plugins/command-explain-pr-changes",
  863. "strict": false,
  864. "commands": [
  865. "./commands/explain-pr-changes.md"
  866. ],
  867. "category": "commands",
  868. "keywords": [
  869. "commands",
  870. "git",
  871. "pull-requests",
  872. "documentation"
  873. ]
  874. },
  875. {
  876. "name": "command-sync-branch",
  877. "description": "Sync feature branch with the latest main branch.",
  878. "source": "./dist/plugins/command-sync-branch",
  879. "strict": false,
  880. "commands": [
  881. "./commands/sync-branch.md"
  882. ],
  883. "category": "commands",
  884. "keywords": [
  885. "commands",
  886. "git",
  887. "branches",
  888. "sync"
  889. ]
  890. },
  891. {
  892. "name": "command-sync-skills-readme",
  893. "description": "Sync root README.md with current skills inventory from skills/ directory.",
  894. "source": "./dist/plugins/command-sync-skills-readme",
  895. "strict": false,
  896. "commands": [
  897. "./commands/sync-skills-readme.md"
  898. ],
  899. "category": "commands",
  900. "keywords": [
  901. "commands",
  902. "readme",
  903. "sync",
  904. "documentation"
  905. ]
  906. },
  907. {
  908. "name": "command-viral-tweet",
  909. "description": "Transform a raw tweet idea into an optimized viral post for X. Analyzes engagement drivers and generates 3 optimized versions with posting strategy.",
  910. "source": "./dist/plugins/command-viral-tweet",
  911. "strict": false,
  912. "commands": [
  913. "./commands/viral-tweet.md"
  914. ],
  915. "category": "commands",
  916. "keywords": [
  917. "commands",
  918. "social-media",
  919. "twitter",
  920. "x",
  921. "viral",
  922. "engagement"
  923. ]
  924. }
  925. ]
  926. }
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)

  1. # Softaworks Agent Skills
  2. 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.
  3. Skills follow the [Agent Skills](https://agentskills.io/) format.
  4. ---
  5. ## 🧭 Quick Navigation
  6. **[🚀 Installation](#-installation)** • **[📚 Available Skills](#-available-skills)** • **[🤖 Agents & Commands](#-agents--commands)** • **[📖 Skill Structure](#-skill-structure)** • **[🤝 Contributing](#-contributing)** • **[📄 License](#-license)** • **[🔗 Links](#-links)**
  7. ---
  8. ## 🚀 Installation
  9. ### Quick Install (Recommended)
  10. ```bash
  11. npx skills add softaworks/agent-toolkit
  12. ```
  13. This method works with multiple AI coding agents (Claude Code, Codex, Cursor, AdaL, etc.)
  14. ### Register as Plugin Marketplace
  15. Run the following commands in Claude Code:
  16. ```bash
  17. /plugin marketplace add softaworks/agent-toolkit
  18. /plugin
  19. ```
  20. ### Install Plugins
  21. **Option 1: Via Browse UI**
  22. 1. Switch to **Marketplaces** tab (use arrow keys or Tab)
  23. 2. Select **agent-toolkit**, press Enter
  24. 3. Browse and select the plugin(s) you want to install
  25. 4. Select **Install now**
  26. **Option 2: Direct Install**
  27. ```bash
  28. # Install specific skill
  29. /plugin install codex@agent-toolkit
  30. /plugin install humanizer@agent-toolkit
  31. # Install specific agent
  32. /plugin install agent-codebase-pattern-finder@agent-toolkit
  33. # Install specific command
  34. /plugin install command-codex-plan@agent-toolkit
  35. ```
  36. **Option 3: Ask the Agent**
  37. Simply tell Claude Code:
  38. > Please install Skills from github.com/softaworks/agent-toolkit
  39. ### Available Plugins
  40. Each skill, agent, and command is an individual plugin that can be installed separately:
  41. - **Skills** → See [Available Skills](#-available-skills) for the full list
  42. - **Agents** → See [Agents](#agents) (install as `agent-<name>@agent-toolkit`)
  43. - **Commands** → See [Slash Commands](#slash-commands) (install as `command-<name>@agent-toolkit`)
  44. ### Update Plugins
  45. To update plugins to the latest version:
  46. 1. Run `/plugin` in Claude Code
  47. 2. Switch to **Marketplaces** tab
  48. 3. Select **agent-toolkit**
  49. 4. Choose **Update marketplace**
  50. You can also **Enable auto-update** to get the latest versions automatically.
  51. ### Manual Installation
  52. **For Claude Code (Manual)** — Skills only
  53. ```bash
  54. cp -r skills/<skill-name> ~/.claude/skills/
  55. ```
  56. **For claude.ai** — Skills only
  57. Add skills to project knowledge or paste SKILL.md contents into the conversation.
  58. ---
  59. ## 📚 Available Skills
  60. | Category | Skill | Description |
  61. |----------|-------|-------------|
  62. | 🤖 AI Tools | [codex](skills/codex/README.md) | Advanced code analysis with GPT-5.2 |
  63. | 🤖 AI Tools | [gemini](skills/gemini/README.md) | Large-scale review (200k+ context) |
  64. | 🤖 AI Tools | [perplexity](skills/perplexity/README.md) | Web search & research |
  65. | 🔮 Meta | [agent-md-refactor](skills/agent-md-refactor/README.md) | Refactor bloated agent instruction files |
  66. | 🔮 Meta | [command-creator](skills/command-creator/README.md) | Create Claude Code slash commands |
  67. | 🔮 Meta | [plugin-forge](skills/plugin-forge/README.md) | Build Claude Code plugins & manifests |
  68. | 🔮 Meta | [skill-judge](skills/skill-judge/README.md) | Evaluate skill design quality |
  69. | 📝 Documentation | [backend-to-frontend-handoff-docs](skills/backend-to-frontend-handoff-docs/README.md) | API handoff docs for frontend |
  70. | 📝 Documentation | [c4-architecture](skills/c4-architecture/README.md) | C4 architecture diagrams with Mermaid |
  71. | 📝 Documentation | [crafting-effective-readmes](skills/crafting-effective-readmes/README.md) | Write effective README files |
  72. | 📝 Documentation | [draw-io](skills/draw-io/README.md) | Create & edit draw.io diagrams |
  73. | 📝 Documentation | [excalidraw](skills/excalidraw/README.md) | Work with Excalidraw diagrams |
  74. | 📝 Documentation | [frontend-to-backend-requirements](skills/frontend-to-backend-requirements/README.md) | Document API requirements |
  75. | 📝 Documentation | [marp-slide](skills/marp-slide/README.md) | Professional presentation slides |
  76. | 📝 Documentation | [mermaid-diagrams](skills/mermaid-diagrams/README.md) | Software diagrams with Mermaid |
  77. | 📝 Documentation | [writing-clearly-and-concisely](skills/writing-clearly-and-concisely/README.md) | Clear, professional writing |
  78. | 🎨 Design & Frontend | [design-system-starter](skills/design-system-starter/README.md) | Create design systems |
  79. | 🎨 Design & Frontend | [mui](skills/mui/README.md) | Material-UI v7 patterns |
  80. | 🎨 Design & Frontend | [openapi-to-typescript](skills/openapi-to-typescript/README.md) | Convert OpenAPI to TypeScript |
  81. | 🎨 Design & Frontend | [react-dev](skills/react-dev/README.md) | Type-safe React 18-19 with TypeScript |
  82. | 🎨 Design & Frontend | [react-useeffect](skills/react-useeffect/README.md) | React useEffect best practices |
  83. | 🛠️ Development | [database-schema-designer](skills/database-schema-designer/README.md) | Design robust database schemas |
  84. | 🛠️ Development | [dependency-updater](skills/dependency-updater/README.md) | Smart dependency management |
  85. | 🛠️ Development | [naming-analyzer](skills/naming-analyzer/README.md) | Suggest better variable/function names |
  86. | 🛠️ Development | [lesson-learned](skills/lesson-learned/README.md) | Extract SE lessons from recent code changes |
  87. | 🛠️ Development | [reducing-entropy](skills/reducing-entropy/README.md) | Minimize codebase size |
  88. | 🛠️ Development | [session-handoff](skills/session-handoff/README.md) | Seamless AI session transfers |
  89. | 🎯 Planning | [game-changing-features](skills/game-changing-features/README.md) | Find 10x product opportunities |
  90. | 🎯 Planning | [gepetto](skills/gepetto/README.md) | Detailed implementation planning |
  91. | 🎯 Planning | [requirements-clarity](skills/requirements-clarity/README.md) | Clarify requirements before coding |
  92. | 🎯 Planning | [ship-learn-next](skills/ship-learn-next/README.md) | Turn learning into actionable reps |
  93. | 👔 Professional | [daily-meeting-update](skills/daily-meeting-update/README.md) | Interactive daily standup generator |
  94. | 👔 Professional | [difficult-workplace-conversations](skills/difficult-workplace-conversations/README.md) | Navigate difficult conversations |
  95. | 👔 Professional | [feedback-mastery](skills/feedback-mastery/README.md) | Deliver constructive feedback |
  96. | 👔 Professional | [professional-communication](skills/professional-communication/README.md) | Technical communication guide |
  97. | 🧪 Testing | [qa-test-planner](skills/qa-test-planner/README.md) | Comprehensive QA test planning |
  98. | 📦 Git | [commit-work](skills/commit-work/README.md) | High-quality git commits |
  99. | 🔧 Utilities | [datadog-cli](skills/datadog-cli/README.md) | Debug with Datadog logs & metrics |
  100. | 🔧 Utilities | [domain-name-brainstormer](skills/domain-name-brainstormer/README.md) | Generate & check domain names |
  101. | 🔧 Utilities | [humanizer](skills/humanizer/README.md) | Remove AI writing patterns |
  102. | 🔧 Utilities | [meme-factory](skills/meme-factory/README.md) | Generate memes with API |
  103. | 🔧 Utilities | [jira](skills/jira/README.md) | Natural language Jira interaction |
  104. | 🔧 Utilities | [web-to-markdown](skills/web-to-markdown/README.md) | Convert webpages to Markdown |
  105. ---
  106. ## 🤖 Agents & Commands
  107. > **Requires [Claude Code CLI](https://docs.anthropic.com/claude-code)** — These agents and commands are exclusive to Claude Code users.
  108. >
  109. > For full access, add the marketplace and install plugins:
  110. > ```bash
  111. > /plugin marketplace add softaworks/agent-toolkit
  112. > /plugin install codex@agent-toolkit
  113. > ```
  114. ### Agents
  115. Specialized sub-agents that Claude Code can delegate tasks to:
  116. | Agent | Description |
  117. |-------|-------------|
  118. | ascii-ui-mockup-generator | Visualize UI concepts through ASCII mockups |
  119. | codebase-pattern-finder | Find similar implementations and patterns |
  120. | communication-excellence-coach | Email refinement, tone calibration, roleplay |
  121. | general-purpose | Default agent for complex multi-step tasks |
  122. | mermaid-diagram-specialist | Create flowcharts, sequence diagrams, ERDs |
  123. | ui-ux-designer | Research-backed UI/UX design feedback |
  124. ### Slash Commands
  125. Reusable workflows invoked with `/command-name`:
  126. | Command | Description |
  127. |---------|-------------|
  128. | `/codex-plan` | Create implementation plans using Codex 5.2 |
  129. | `/compose-email` | Draft professional emails |
  130. | `/explain-changes-mental-model` | Build mental model of code changes |
  131. | `/explain-pr-changes` | Generate PR summaries |
  132. | `/sync-branch` | Sync feature branch with main |
  133. | `/sync-skills-readme` | Update README skills table |
  134. | `/viral-tweet` | Optimize tweet ideas for X engagement |
  135. ---
  136. ## 📖 Skill Structure
  137. Each skill contains:
  138. - `SKILL.md` - Detailed instructions for the agent (with YAML frontmatter)
  139. - `README.md` - User-friendly documentation with examples
  140. - `scripts/` - Helper scripts for automation (optional)
  141. - `references/` - Supporting documentation (optional)
  142. ---
  143. ## 🤝 Contributing
  144. Contributions are welcome! When adding new skills:
  145. 1. Follow the [Agent Skills](https://agentskills.io/) format
  146. 2. Include both `SKILL.md` (for agents) and `README.md` (for users)
  147. 3. Add YAML frontmatter to `SKILL.md` with `name:` and `description:` fields
  148. 4. Update this README.md with a link to your skill
  149. ---
  150. ## 📄 License
  151. MIT
  152. ---
  153. ## 🔗 Links
  154. - [Agent Skills Format](https://agentskills.io/)
  155. - [Claude Code Documentation](https://docs.anthropic.com/claude/docs)
  156. - [GitHub Repository](https://github.com/softaworks/agent-toolkit)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.