agent-toolkit-cli 1.0.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (310) hide show
  1. agent_toolkit/__init__.py +4 -0
  2. agent_toolkit/__main__.py +3 -0
  3. agent_toolkit/_paths.py +64 -0
  4. agent_toolkit/cli/__init__.py +0 -0
  5. agent_toolkit/cli/doctor.py +453 -0
  6. agent_toolkit/cli/install.py +445 -0
  7. agent_toolkit/cli/main.py +66 -0
  8. agent_toolkit/cli/mcp.py +418 -0
  9. agent_toolkit/cli/plugin.py +213 -0
  10. agent_toolkit/cli/skills.py +421 -0
  11. agent_toolkit/loop/__init__.py +0 -0
  12. agent_toolkit/loop/gh_gate.py +626 -0
  13. agent_toolkit/loop/runner.py +1548 -0
  14. agent_toolkit/runner/__init__.py +0 -0
  15. agent_toolkit/runner/dispatcher.py +164 -0
  16. agent_toolkit/runner/policy.py +345 -0
  17. agent_toolkit/runner/providers/__init__.py +21 -0
  18. agent_toolkit/runner/providers/anthropic_provider.py +109 -0
  19. agent_toolkit/runner/providers/base.py +53 -0
  20. agent_toolkit/runner/providers/ollama_provider.py +108 -0
  21. agent_toolkit/runner/providers/openai_provider.py +105 -0
  22. agent_toolkit/runner/providers/opencode_provider.py +127 -0
  23. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/architect/AGENT.md +30 -0
  24. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/assistant/AGENT.md +59 -0
  25. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/build-error-resolver/AGENT.md +30 -0
  26. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/client-workflow-bootstrap/AGENT.md +60 -0
  27. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/code-reviewer/AGENT.md +49 -0
  28. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/database-reviewer/AGENT.md +44 -0
  29. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/docs-lookup/AGENT.md +28 -0
  30. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/e2e-runner/AGENT.md +38 -0
  31. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/performance-optimizer/AGENT.md +52 -0
  32. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/planner/AGENT.md +41 -0
  33. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/refactor-cleaner/AGENT.md +43 -0
  34. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/reference-lookup/AGENT.md +33 -0
  35. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/security-reviewer/AGENT.md +47 -0
  36. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/tdd-guide/AGENT.md +58 -0
  37. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/tech-assistant/AGENT.md +11 -0
  38. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/typescript-reviewer/AGENT.md +61 -0
  39. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/catalogs/agent-catalog.yaml +202 -0
  40. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/catalogs/loop-catalog.yaml +165 -0
  41. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/catalogs/skill-catalog.yaml +699 -0
  42. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/catalogs/skills-layout.json +337 -0
  43. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/changelog-drafter/loop.yaml +40 -0
  44. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/ci-sweeper/loop.yaml +53 -0
  45. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/daily-triage/loop.yaml +47 -0
  46. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/dep-sweeper/loop.yaml +46 -0
  47. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/issue-triage/loop.yaml +40 -0
  48. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/oss-daily-briefing/loop.yaml +65 -0
  49. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/oss-pr-monitor/loop.yaml +85 -0
  50. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/oss-triage/loop.yaml +67 -0
  51. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/post-merge-cleanup/loop.yaml +44 -0
  52. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/pr-babysitter/loop.yaml +46 -0
  53. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/clickup/README.md +45 -0
  54. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/clickup/config.template.json +7 -0
  55. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/clickup/wrapper.sh +23 -0
  56. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/figma/README.md +56 -0
  57. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/figma/config.template.json +9 -0
  58. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/github/README.md +11 -0
  59. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/github/config.template.json +7 -0
  60. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/github/wrapper.sh +23 -0
  61. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/linear/README.md +49 -0
  62. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/linear/config.template.json +10 -0
  63. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/notion/README.md +7 -0
  64. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/notion/config.template.json +7 -0
  65. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/notion/wrapper.sh +23 -0
  66. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/slack/README.md +8 -0
  67. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/slack/config.template.json +8 -0
  68. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/slack/wrapper.sh +23 -0
  69. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/CLAUDE.md +66 -0
  70. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/assistant.md +59 -0
  71. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/build-error-resolver.md +30 -0
  72. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/client-workflow-bootstrap.md +60 -0
  73. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/contribution-planner.md +39 -0
  74. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/database-reviewer.md +44 -0
  75. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/docs-lookup.md +28 -0
  76. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/e2e-runner.md +38 -0
  77. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/performance-optimizer.md +52 -0
  78. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/planner.md +41 -0
  79. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/refactor-cleaner.md +43 -0
  80. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/reference-lookup.md +33 -0
  81. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/security-reviewer.md +47 -0
  82. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/tdd-guide.md +58 -0
  83. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/typescript-reviewer.md +61 -0
  84. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/settings.json +87 -0
  85. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/copilot/copilot-instructions.md +15 -0
  86. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/README.md +33 -0
  87. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/architect.mdc +23 -0
  88. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/assistant.mdc +25 -0
  89. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/build-error-resolver.mdc +20 -0
  90. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/code-reviewer.mdc +21 -0
  91. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/database-reviewer.mdc +29 -0
  92. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/docs-lookup.mdc +15 -0
  93. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/e2e-runner.mdc +30 -0
  94. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/performance-optimizer.mdc +27 -0
  95. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/planner.mdc +28 -0
  96. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/refactor-cleaner.mdc +26 -0
  97. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/reference-lookup.mdc +20 -0
  98. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/security-reviewer.mdc +20 -0
  99. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/tdd-guide.mdc +26 -0
  100. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/typescript-reviewer.mdc +28 -0
  101. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/architect.md +30 -0
  102. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/assistant.md +52 -0
  103. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/build-error-resolver.md +31 -0
  104. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/client-workflow-bootstrap.md +66 -0
  105. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/code-reviewer.md +47 -0
  106. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/contribution-planner.md +44 -0
  107. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/database-reviewer.md +43 -0
  108. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/docs-lookup.md +28 -0
  109. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/e2e-runner.md +33 -0
  110. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/performance-optimizer.md +34 -0
  111. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/planner.md +27 -0
  112. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/refactor-cleaner.md +27 -0
  113. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/reference-lookup.md +27 -0
  114. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/security-reviewer.md +27 -0
  115. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/tdd-guide.md +27 -0
  116. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/typescript-reviewer.md +30 -0
  117. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/opencode.json +37 -0
  118. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/architect/skill.md +5 -0
  119. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/assistant/skill.md +3 -0
  120. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/code-reviewer/skill.md +5 -0
  121. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/planner/skill.md +3 -0
  122. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/security-reviewer/skill.md +3 -0
  123. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/memories/global_rules.md +74 -0
  124. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/architect.mdc +23 -0
  125. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/build-error-resolver.mdc +20 -0
  126. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/code-reviewer.mdc +21 -0
  127. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/database-reviewer.mdc +29 -0
  128. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/docs-lookup.mdc +15 -0
  129. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/e2e-runner.mdc +30 -0
  130. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/performance-optimizer.mdc +27 -0
  131. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/planner.mdc +28 -0
  132. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/refactor-cleaner.mdc +26 -0
  133. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/security-reviewer.mdc +20 -0
  134. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/tdd-guide.mdc +26 -0
  135. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/typescript-reviewer.mdc +28 -0
  136. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/assistant/SKILL.md +213 -0
  137. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/assistant/references/AGENTS_TEMPLATE.md +0 -0
  138. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/assistant/references/ORCHESTRATION.md +0 -0
  139. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/assistant/references/REPO_INSPECTION.md +0 -0
  140. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/dev-companion/SKILL.md +65 -0
  141. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/dev-companion/references/LOOP_GUARDRAILS.md +0 -0
  142. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/onboarding/SKILL.md +119 -0
  143. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/output-handshake/SKILL.md +24 -0
  144. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/pr-fallback/SKILL.md +33 -0
  145. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/pr-fallback/references/pr-body-default.md +0 -0
  146. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/workspace-knowledge-sync/SKILL.md +141 -0
  147. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/data/dbt-validation/SKILL.md +41 -0
  148. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/data/snowflake-validation/SKILL.md +38 -0
  149. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/adr/SKILL.md +46 -0
  150. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/adr/references/default-template.md +0 -0
  151. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/adr/references/example-001-graphql-adoption.md +66 -0
  152. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/agreement/SKILL.md +23 -0
  153. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/agreement/references/default-template.md +0 -0
  154. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/agreement/references/example-api-versioning.md +29 -0
  155. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/bug/SKILL.md +25 -0
  156. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/bug/references/default-template.md +0 -0
  157. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/bug/references/example-search-filter-bug.md +58 -0
  158. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/decision-log/SKILL.md +27 -0
  159. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/decision-log/references/default-template.md +0 -0
  160. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/decision-log/references/example-repository-pattern.md +27 -0
  161. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/development-workflow/SKILL.md +33 -0
  162. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/development-workflow/references/default-template.md +0 -0
  163. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/development-workflow/references/default-workflow-checklist.md +44 -0
  164. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/epic/SKILL.md +21 -0
  165. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/epic/references/default-template.md +0 -0
  166. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/epic/references/example-unified-dashboard.md +40 -0
  167. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/incident/SKILL.md +23 -0
  168. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/incident/references/default-template.md +0 -0
  169. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/incident/references/example-payment-outage.md +62 -0
  170. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/management-unit-assessment/SKILL.md +105 -0
  171. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/management-unit-assessment/references/default-template.md +0 -0
  172. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/management-unit-assessment/references/example-team-assessment.md +126 -0
  173. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/meeting-minutes/SKILL.md +24 -0
  174. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/meeting-minutes/references/default-template.md +0 -0
  175. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/meeting-minutes/references/example-weekly-sync.md +72 -0
  176. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/planning/SKILL.md +30 -0
  177. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/planning/references/default-template.md +0 -0
  178. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/planning/references/example-sprint-planning.md +62 -0
  179. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/prd/SKILL.md +44 -0
  180. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/prd/references/default-template.md +0 -0
  181. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/prd/references/example-unified-api.md +71 -0
  182. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment/SKILL.md +90 -0
  183. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment/references/default-template.md +0 -0
  184. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment/references/example-platform-assessment.md +122 -0
  185. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment-evidence/SKILL.md +88 -0
  186. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment-evidence/references/default-template.md +0 -0
  187. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment-evidence/references/example-evidence-map.md +46 -0
  188. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/spike/SKILL.md +23 -0
  189. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/spike/references/default-template.md +0 -0
  190. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/spike/references/example-graphql-federation.md +79 -0
  191. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/task/SKILL.md +20 -0
  192. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/task/references/default-template.md +0 -0
  193. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/task/references/example-nav-system.md +33 -0
  194. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/technical-unit-assessment/SKILL.md +58 -0
  195. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/technical-unit-assessment/references/default-template.md +0 -0
  196. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/technical-unit-assessment/references/example-frontend-assessment.md +112 -0
  197. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/technical-unit-assessment/references/indicator-groups.md +65 -0
  198. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/trd/SKILL.md +47 -0
  199. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/trd/references/default-template.md +0 -0
  200. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/trd/references/example-api-migration.md +122 -0
  201. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/user-story/SKILL.md +20 -0
  202. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/user-story/references/default-template.md +0 -0
  203. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/user-story/references/example-advanced-filtering.md +37 -0
  204. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/work-item/SKILL.md +30 -0
  205. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/work-item/references/default-template.md +0 -0
  206. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/work-item/references/example-routing-dashboard.md +23 -0
  207. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/workflow-client-bootstrap/SKILL.md +148 -0
  208. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/workflow-client-bootstrap/questions.yaml +165 -0
  209. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/workflow-generic-project/SKILL.md +78 -0
  210. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/LICENSE.txt +2 -0
  211. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/NOTICE.txt +25 -0
  212. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/SKILL.md +95 -0
  213. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/references/figma-mcp-config.md +82 -0
  214. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/references/figma-tools-and-prompts.md +34 -0
  215. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/LICENSE.txt +2 -0
  216. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/NOTICE.txt +18 -0
  217. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/SKILL.md +350 -0
  218. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/references/mapping-checklist.md +7 -0
  219. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/scripts/normalize_node_id.py +25 -0
  220. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/LICENSE.txt +2 -0
  221. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/NOTICE.txt +19 -0
  222. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/SKILL.md +550 -0
  223. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/references/rule-template.md +15 -0
  224. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/scripts/check_agents_md.sh +9 -0
  225. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-new-file/LICENSE.txt +2 -0
  226. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-new-file/NOTICE.txt +17 -0
  227. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-new-file/SKILL.md +69 -0
  228. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-implement-design/LICENSE.txt +2 -0
  229. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-implement-design/NOTICE.txt +19 -0
  230. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-implement-design/SKILL.md +264 -0
  231. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/SKILL.md +60 -0
  232. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/charts.csv +26 -0
  233. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/colors.csv +97 -0
  234. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/icons.csv +101 -0
  235. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/landing.csv +31 -0
  236. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/products.csv +97 -0
  237. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/react-performance.csv +45 -0
  238. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/astro.csv +54 -0
  239. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  240. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  241. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  242. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  243. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  244. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  245. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  246. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/react.csv +54 -0
  247. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  248. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  249. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  250. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  251. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/styles.csv +68 -0
  252. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/typography.csv +58 -0
  253. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  254. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  255. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/web-interface.csv +31 -0
  256. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/references/pre-delivery-checklist.md +39 -0
  257. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/references/search-reference.md +44 -0
  258. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/references/ui-rules.md +35 -0
  259. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/scripts/core.py +253 -0
  260. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/scripts/design_system.py +1067 -0
  261. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/scripts/search.py +114 -0
  262. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-address-comments/LICENSE.txt +202 -0
  263. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-address-comments/NOTICE.txt +20 -0
  264. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-address-comments/SKILL.md +69 -0
  265. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-address-comments/scripts/fetch_comments.py +237 -0
  266. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-contribution-planner/SKILL.md +157 -0
  267. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-contribution-planner/scripts/inspect_contributions.py +800 -0
  268. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-fix-ci/LICENSE.txt +201 -0
  269. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-fix-ci/NOTICE.txt +20 -0
  270. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-fix-ci/SKILL.md +71 -0
  271. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-fix-ci/scripts/inspect_pr_checks.py +509 -0
  272. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/github-cli-workflow/SKILL.md +49 -0
  273. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gitlab-cli-workflow/SKILL.md +44 -0
  274. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/workflow-client-bootstrap/SKILL.md +14 -0
  275. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/workflow-generic-project/SKILL.md +14 -0
  276. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/clickup-cli/SKILL.md +75 -0
  277. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/clickup-cli/references/docs-management.md +57 -0
  278. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/clickup-cli/references/task-management.md +131 -0
  279. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/clickup-cli/references/time-tracking.md +38 -0
  280. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/linear/LICENSE.txt +202 -0
  281. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/linear/NOTICE.txt +23 -0
  282. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/linear/SKILL.md +131 -0
  283. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/slack-assistant/SKILL.md +134 -0
  284. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/slack-cli/SKILL.md +105 -0
  285. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/slack-cli/references/INSTALLATION.md +42 -0
  286. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/loops/loop-runner/SKILL.md +90 -0
  287. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/ops/docs-generator/SKILL.md +81 -0
  288. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/ops/llm-cost-advisor/SKILL.md +83 -0
  289. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/ops/triage/SKILL.md +117 -0
  290. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/LICENSE.txt +201 -0
  291. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/NOTICE.txt +27 -0
  292. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/SKILL.md +142 -0
  293. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/assets/experiment-template.ipynb +110 -0
  294. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/assets/tutorial-template.ipynb +107 -0
  295. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/references/experiment-patterns.md +10 -0
  296. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/references/notebook-structure.md +17 -0
  297. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/references/quality-checklist.md +11 -0
  298. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/references/tutorial-patterns.md +9 -0
  299. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/scripts/new_notebook.py +130 -0
  300. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/LICENSE.txt +201 -0
  301. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/NOTICE.txt +29 -0
  302. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/SKILL.md +151 -0
  303. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/references/cli.md +116 -0
  304. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/references/workflows.md +98 -0
  305. agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/scripts/executable_playwright_cli.sh +25 -0
  306. agent_toolkit_cli-1.0.3.dist-info/METADATA +411 -0
  307. agent_toolkit_cli-1.0.3.dist-info/RECORD +310 -0
  308. agent_toolkit_cli-1.0.3.dist-info/WHEEL +4 -0
  309. agent_toolkit_cli-1.0.3.dist-info/entry_points.txt +2 -0
  310. agent_toolkit_cli-1.0.3.dist-info/licenses/LICENSE +21 -0
@@ -0,0 +1,550 @@
1
+ ---
2
+ name: figma-create-design-system-rules
3
+ description: Generates custom design system rules for the user's codebase. Use when user says "create design system rules", "generate rules for my project", "set up design rules", "customize design system guidelines", or wants to establish project-specific conventions for Figma-to-code workflows. Requires Figma MCP server connection.
4
+ ---
5
+
6
+ # Create Design System Rules
7
+
8
+ ## Overview
9
+
10
+ This skill helps you generate custom design system rules tailored to your project's specific needs. These rules guide AI coding agents to produce consistent, high-quality code when implementing Figma designs, ensuring that your team's conventions, component patterns, and architectural decisions are followed automatically.
11
+
12
+ ### Supported Rule Files
13
+
14
+ | Agent | Rule File |
15
+ |-------|-----------|
16
+ | Claude Code | `AGENTS.md` (or `CLAUDE.md` symlink) |
17
+ | opencode | `AGENTS.md` (or `CLAUDE.md` symlink) |
18
+ | Cursor | `.cursor/rules/figma-design-system.mdc` |
19
+ | Gemini CLI | `GEMINI.md` (or symlink to `AGENTS.md`) |
20
+ | GitHub Copilot | `.github/copilot-instructions.md` (or symlink to `AGENTS.md`) |
21
+ | Windsurf | `.windsurfrules` |
22
+
23
+ > agent-toolkit convention: prefer a single `AGENTS.md` and symlink the tool-specific
24
+ > files to it. See the workstation `AGENTS.md` portability table for details.
25
+
26
+ ## What Are Design System Rules?
27
+
28
+ Design system rules are project-level instructions that encode the "unwritten knowledge" of your codebase - the kind of expertise that experienced developers know and would pass on to new team members:
29
+
30
+ - Which layout primitives and components to use
31
+ - Where component files should be located
32
+ - How components should be named and structured
33
+ - What should never be hardcoded
34
+ - How to handle design tokens and styling
35
+ - Project-specific architectural patterns
36
+
37
+ Once defined, these rules dramatically reduce repetitive prompting and ensure consistent output across all Figma implementation tasks.
38
+
39
+ ## Prerequisites
40
+
41
+ - Figma MCP server must be connected and accessible
42
+ - Access to the project codebase for analysis
43
+ - Understanding of your team's component conventions (or willingness to establish them)
44
+
45
+ ## When to Use This Skill
46
+
47
+ Use this skill when:
48
+
49
+ - Starting a new project that will use Figma designs
50
+ - Onboarding an AI coding agent to an existing project with established patterns
51
+ - Standardizing Figma-to-code workflows across your team
52
+ - Updating or refining existing design system conventions
53
+ - Users explicitly request: "create design system rules", "set up Figma guidelines", "customize rules for my project"
54
+
55
+ ## Required Workflow
56
+
57
+ **Follow these steps in order. Do not skip steps.**
58
+
59
+ ### Step 1: Run the Create Design System Rules Tool
60
+
61
+ Call the Figma MCP server's `create_design_system_rules` tool to get the foundational prompt and template.
62
+
63
+ **Parameters:**
64
+
65
+ - `clientLanguages`: Comma-separated list of languages used in the project (e.g., "typescript,javascript", "python", "javascript")
66
+ - `clientFrameworks`: Framework being used (e.g., "react", "vue", "svelte", "angular", "unknown")
67
+
68
+ This tool returns guidance and a template for creating design system rules.
69
+
70
+ Structure your design system rules following the template format provided in the tool's response.
71
+
72
+ ### Step 2: Analyze the Codebase
73
+
74
+ Before finalizing rules, analyze the project to understand existing patterns:
75
+
76
+ **Component Organization:**
77
+
78
+ - Where are UI components located? (e.g., `src/components/`, `app/ui/`, `lib/components/`)
79
+ - Is there a dedicated design system directory?
80
+ - How are components organized? (by feature, by type, flat structure)
81
+
82
+ **Styling Approach:**
83
+
84
+ - What CSS framework or approach is used? (Tailwind, CSS Modules, styled-components, etc.)
85
+ - Where are design tokens defined? (CSS variables, theme files, config files)
86
+ - Are there existing color, typography, or spacing tokens?
87
+
88
+ **Component Patterns:**
89
+
90
+ - What naming conventions are used? (PascalCase, kebab-case, prefixes)
91
+ - How are component props typically structured?
92
+ - Are there common composition patterns?
93
+
94
+ **Architecture Decisions:**
95
+
96
+ - How is state management handled?
97
+ - What routing system is used?
98
+ - Are there specific import patterns or path aliases?
99
+
100
+ ### Step 3: Generate Project-Specific Rules
101
+
102
+ Based on your codebase analysis, create a comprehensive set of rules. Include:
103
+
104
+ #### General Component Rules
105
+
106
+ ```markdown
107
+ - IMPORTANT: Always use components from `[YOUR_PATH]` when possible
108
+ - Place new UI components in `[COMPONENT_DIRECTORY]`
109
+ - Follow `[NAMING_CONVENTION]` for component names
110
+ - Components must export as `[EXPORT_PATTERN]`
111
+ ```
112
+
113
+ #### Styling Rules
114
+
115
+ ```markdown
116
+ - Use `[CSS_FRAMEWORK/APPROACH]` for styling
117
+ - Design tokens are defined in `[TOKEN_LOCATION]`
118
+ - IMPORTANT: Never hardcode colors - always use tokens from `[TOKEN_FILE]`
119
+ - Spacing values must use the `[SPACING_SYSTEM]` scale
120
+ - Typography follows the scale defined in `[TYPOGRAPHY_LOCATION]`
121
+ ```
122
+
123
+ #### Figma MCP Integration Rules
124
+
125
+ ```markdown
126
+ ## Figma MCP Integration Rules
127
+
128
+ These rules define how to translate Figma inputs into code for this project and must be followed for every Figma-driven change.
129
+
130
+ ### Required Flow (do not skip)
131
+
132
+ 1. Run get_design_context first to fetch the structured representation for the exact node(s)
133
+ 2. If the response is too large or truncated, run get_metadata to get the high-level node map, then re-fetch only the required node(s) with get_design_context
134
+ 3. Run get_screenshot for a visual reference of the node variant being implemented
135
+ 4. Only after you have both get_design_context and get_screenshot, download any assets needed and start implementation
136
+ 5. Translate the output (usually React + Tailwind) into this project's conventions, styles, and framework
137
+ 6. Validate against Figma for 1:1 look and behavior before marking complete
138
+
139
+ ### Implementation Rules
140
+
141
+ - Treat the Figma MCP output (React + Tailwind) as a representation of design and behavior, not as final code style
142
+ - Replace Tailwind utility classes with `[YOUR_STYLING_APPROACH]` when applicable
143
+ - Reuse existing components from `[COMPONENT_PATH]` instead of duplicating functionality
144
+ - Use the project's color system, typography scale, and spacing tokens consistently
145
+ - Respect existing routing, state management, and data-fetch patterns
146
+ - Strive for 1:1 visual parity with the Figma design
147
+ - Validate the final UI against the Figma screenshot for both look and behavior
148
+ ```
149
+
150
+ #### Asset Handling Rules
151
+
152
+ ```markdown
153
+ ## Asset Handling
154
+
155
+ - The Figma MCP server provides an assets endpoint which can serve image and SVG assets
156
+ - IMPORTANT: If the Figma MCP server returns a localhost source for an image or SVG, use that source directly
157
+ - IMPORTANT: DO NOT import/add new icon packages - all assets should be in the Figma payload
158
+ - IMPORTANT: DO NOT use or create placeholders if a localhost source is provided
159
+ - Store downloaded assets in `[ASSET_DIRECTORY]`
160
+ ```
161
+
162
+ #### Project-Specific Conventions
163
+
164
+ ```markdown
165
+ ## Project-Specific Conventions
166
+
167
+ - [Add any unique architectural patterns]
168
+ - [Add any special import requirements]
169
+ - [Add any testing requirements]
170
+ - [Add any accessibility standards]
171
+ - [Add any performance considerations]
172
+ ```
173
+
174
+ ### Step 4: Save Rules to the Appropriate Rule File
175
+
176
+ Detect which AI coding agent the user is working with and save the generated rules to the corresponding file:
177
+
178
+ | Agent | Rule File | Notes |
179
+ |-------|-----------|-------|
180
+ | Claude Code | `AGENTS.md` in project root (or `CLAUDE.md` symlinked) | Markdown format. Can also use `.claude/rules/figma-design-system.md` for modular organization. Append as a new section if the file already exists. |
181
+ | opencode | `AGENTS.md` in project root (or `CLAUDE.md` symlinked) | Markdown format. Append as a new section if the file already exists. |
182
+ | Cursor | `.cursor/rules/figma-design-system.mdc` | Markdown with YAML frontmatter (`description`, `globs`, `alwaysApply`). |
183
+ | Gemini CLI | `GEMINI.md` in project root (or symlinked to `AGENTS.md`) | Markdown format. |
184
+ | GitHub Copilot | `.github/copilot-instructions.md` (or symlinked to `AGENTS.md`) | Markdown format. |
185
+ | Windsurf | `.windsurfrules` | Plain text or markdown. |
186
+
187
+ agent-toolkit convention: prefer a single `AGENTS.md` and symlink the tool-specific
188
+ files to it. See the workstation `AGENTS.md` portability table for details.
189
+
190
+ If unsure which agent the user is working with, check for existing rule files
191
+ in the project or ask the user.
192
+
193
+ For Cursor, wrap the rules with YAML frontmatter:
194
+
195
+ ```markdown
196
+ ---
197
+ description: Rules for implementing Figma designs using the Figma MCP server. Covers component organization, styling conventions, design tokens, asset handling, and the required Figma-to-code workflow.
198
+ globs: "src/components/**"
199
+ alwaysApply: false
200
+ ---
201
+
202
+ [Generated rules here]
203
+ ```
204
+
205
+ Customize the `globs` pattern to match the directories where Figma-derived code will live in the project (e.g., `"src/**/*.tsx"` or `["src/components/**", "src/pages/**"]`).
206
+
207
+ After saving, the rules will be automatically loaded by the agent and applied to all Figma implementation tasks.
208
+
209
+ ### Step 5: Validate and Iterate
210
+
211
+ After creating rules:
212
+
213
+ 1. Test with a simple Figma component implementation
214
+ 2. Verify the agent follows the rules correctly
215
+ 3. Refine any rules that aren't working as expected
216
+ 4. Share with team members for feedback
217
+ 5. Update rules as the project evolves
218
+
219
+ ## Rule Categories and Examples
220
+
221
+ ### Essential Rules (Always Include)
222
+
223
+ **Component Discovery:**
224
+
225
+ ```markdown
226
+ - UI components are located in `src/components/ui/`
227
+ - Feature components are in `src/components/features/`
228
+ - Layout primitives are in `src/components/layout/`
229
+ ```
230
+
231
+ **Design Token Usage:**
232
+
233
+ ```markdown
234
+ - Colors are defined as CSS variables in `src/styles/tokens.css`
235
+ - Never hardcode hex colors - use `var(--color-*)` tokens
236
+ - Spacing uses the 4px base scale: `--space-1` (4px), `--space-2` (8px), etc.
237
+ ```
238
+
239
+ **Styling Approach:**
240
+
241
+ ```markdown
242
+ - Use Tailwind utility classes for styling
243
+ - Custom styles go in component-level CSS modules
244
+ - Theme customization is in `tailwind.config.js`
245
+ ```
246
+
247
+ ### Recommended Rules (Highly Valuable)
248
+
249
+ **Component Patterns:**
250
+
251
+ ```markdown
252
+ - All components must accept a `className` prop for composition
253
+ - Variant props should use union types: `variant: 'primary' | 'secondary'`
254
+ - Icon components should accept `size` and `color` props
255
+ ```
256
+
257
+ **Import Conventions:**
258
+
259
+ ```markdown
260
+ - Use path aliases: `@/components`, `@/styles`, `@/utils`
261
+ - Group imports: React, third-party, internal, types
262
+ - No relative imports beyond parent directory
263
+ ```
264
+
265
+ **Code Quality:**
266
+
267
+ ```markdown
268
+ - Add JSDoc comments for exported components
269
+ - Include PropTypes or TypeScript types for all props
270
+ - Extract magic numbers to named constants
271
+ ```
272
+
273
+ ### Optional Rules (Project-Specific)
274
+
275
+ **Accessibility:**
276
+
277
+ ```markdown
278
+ - All interactive elements must have aria-labels
279
+ - Color contrast must meet WCAG AA standards
280
+ - Keyboard navigation required for all interactions
281
+ ```
282
+
283
+ **Performance:**
284
+
285
+ ```markdown
286
+ - Lazy load images with the `Image` component from `@/components/Image`
287
+ - Use React.memo for components that receive complex props
288
+ - Icons should be SVG components, not icon fonts
289
+ ```
290
+
291
+ **Testing:**
292
+
293
+ ```markdown
294
+ - Include unit tests for new components in `__tests__/` directory
295
+ - Use Testing Library queries (getByRole, getByLabelText)
296
+ - Test all interactive states and variants
297
+ ```
298
+
299
+ ## Examples
300
+
301
+ ### Example 1: React + Tailwind Project
302
+
303
+ User says: "Create design system rules for my React project"
304
+
305
+ **Actions:**
306
+
307
+ 1. Run `create_design_system_rules(clientLanguages="typescript,javascript", clientFrameworks="react")`
308
+ 2. Analyze codebase structure
309
+ 3. Generate rules:
310
+
311
+ ```markdown
312
+ # Figma MCP Integration Rules
313
+
314
+ ## Component Organization
315
+
316
+ - UI components are in `src/components/ui/`
317
+ - Page components are in `src/app/`
318
+ - Use Tailwind for styling
319
+
320
+ ## Figma Implementation Flow
321
+
322
+ 1. Run get_design_context for the node
323
+ 2. Run get_screenshot for visual reference
324
+ 3. Map Figma colors to Tailwind colors defined in `tailwind.config.js`
325
+ 4. Reuse components from `src/components/ui/` when possible
326
+ 5. Validate against screenshot before completing
327
+
328
+ ## Styling Rules
329
+
330
+ - IMPORTANT: Use Tailwind utility classes, not inline styles
331
+ - Colors are defined in `tailwind.config.js` theme.colors
332
+ - Spacing uses Tailwind's default scale
333
+ - Custom components go in `src/components/ui/`
334
+
335
+ ## Asset Rules
336
+
337
+ - IMPORTANT: Use localhost sources from Figma MCP server directly
338
+ - Store static assets in `public/assets/`
339
+ - DO NOT install new icon libraries
340
+ ```
341
+
342
+ 4. Save to the appropriate rule file for the user's agent
343
+ 5. Test with a simple button implementation
344
+
345
+ **Result:** The agent now consistently follows the project's conventions when implementing Figma designs.
346
+
347
+ ### Example 2: Vue + Custom CSS Project
348
+
349
+ User says: "Set up Figma rules for my Vue app"
350
+
351
+ **Actions:**
352
+
353
+ 1. Run `create_design_system_rules(clientLanguages="typescript,javascript", clientFrameworks="vue")`
354
+ 2. Discover that project uses CSS modules and a custom design token system
355
+ 3. Generate rules:
356
+
357
+ ```markdown
358
+ # Figma MCP Integration Rules
359
+
360
+ ## Component Organization
361
+
362
+ - Components are in `src/components/`
363
+ - Composables are in `src/composables/`
364
+ - Vue SFC structure: <script setup>, <template>, <style scoped>
365
+
366
+ ## Design Tokens
367
+
368
+ - IMPORTANT: All colors defined in `src/styles/tokens.css` as CSS variables
369
+ - Use `var(--color-primary)`, `var(--color-secondary)`, etc.
370
+ - Spacing: `var(--space-xs)` through `var(--space-xl)`
371
+ - Typography: `var(--text-sm)` through `var(--text-2xl)`
372
+
373
+ ## Figma Implementation Flow
374
+
375
+ 1. Run get_design_context and get_screenshot
376
+ 2. Translate React output to Vue 3 Composition API
377
+ 3. Map Figma colors to CSS variables in `src/styles/tokens.css`
378
+ 4. Use CSS Modules for component styles
379
+ 5. Check for existing components in `src/components/` before creating new ones
380
+
381
+ ## Styling Rules
382
+
383
+ - Use CSS Modules (`.module.css` files)
384
+ - IMPORTANT: Reference design tokens, never hardcode values
385
+ - Scoped styles with CSS modules
386
+ ```
387
+
388
+ 4. Save to the appropriate rule file for the user's agent
389
+ 5. Validate with a card component
390
+
391
+ **Result:** The agent now correctly translates Figma designs to Vue components using the project's design token system.
392
+
393
+ ### Example 3: Design System Team
394
+
395
+ User says: "Generate rules for our design system library"
396
+
397
+ **Actions:**
398
+
399
+ 1. Run `create_design_system_rules(clientLanguages="typescript", clientFrameworks="react")`
400
+ 2. Analyze the monorepo structure with design system package
401
+ 3. Generate comprehensive rules:
402
+
403
+ ```markdown
404
+ # Design System Rules
405
+
406
+ ## Repository Structure
407
+
408
+ - Design system components: `packages/design-system/src/components/`
409
+ - Documentation: `packages/docs/`
410
+ - Design tokens: `packages/tokens/src/`
411
+
412
+ ## Component Development
413
+
414
+ - IMPORTANT: All components must be in `packages/design-system/src/components/`
415
+ - Component file structure: `ComponentName/index.tsx`, `ComponentName.stories.tsx`, `ComponentName.test.tsx`
416
+ - Export all components from `packages/design-system/src/index.ts`
417
+
418
+ ## Design Tokens
419
+
420
+ - Colors: `packages/tokens/src/colors.ts`
421
+ - Typography: `packages/tokens/src/typography.ts`
422
+ - Spacing: `packages/tokens/src/spacing.ts`
423
+ - IMPORTANT: Never hardcode values - import from tokens package
424
+
425
+ ## Documentation Requirements
426
+
427
+ - Add Storybook story for every component
428
+ - Include JSDoc with @example
429
+ - Document all props with descriptions
430
+ - Add accessibility notes
431
+
432
+ ## Figma Integration
433
+
434
+ 1. Get design context and screenshot from Figma
435
+ 2. Map Figma tokens to design system tokens
436
+ 3. Create or extend component in design system package
437
+ 4. Add Storybook stories showing all variants
438
+ 5. Validate against Figma screenshot
439
+ 6. Update documentation
440
+ ```
441
+
442
+ 4. Save to the appropriate rule file and share with team
443
+ 5. Add to team documentation
444
+
445
+ **Result:** Entire team follows consistent patterns when adding components from Figma to the design system.
446
+
447
+ ## Best Practices
448
+
449
+ ### Start Simple, Iterate
450
+
451
+ Don't try to capture every rule upfront. Start with the most important conventions and add rules as you encounter inconsistencies.
452
+
453
+ ### Be Specific
454
+
455
+ Instead of: "Use the design system"
456
+ Write: "Always use Button components from `src/components/ui/Button.tsx` with variant prop ('primary' | 'secondary' | 'ghost')"
457
+
458
+ ### Make Rules Actionable
459
+
460
+ Each rule should tell the agent exactly what to do, not just what to avoid.
461
+
462
+ Good: "Colors are defined in `src/theme/colors.ts` - import and use these constants"
463
+ Bad: "Don't hardcode colors"
464
+
465
+ ### Use IMPORTANT for Critical Rules
466
+
467
+ Prefix rules that must never be violated with "IMPORTANT:" to ensure the agent prioritizes them.
468
+
469
+ ```markdown
470
+ - IMPORTANT: Never expose API keys in client-side code
471
+ - IMPORTANT: Always sanitize user input before rendering
472
+ ```
473
+
474
+ ### Document the Why
475
+
476
+ When rules seem arbitrary, explain the reasoning:
477
+
478
+ ```markdown
479
+ - Place all data-fetching in server components (reduces client bundle size and improves performance)
480
+ - Use absolute imports with `@/` alias (makes refactoring easier and prevents broken relative paths)
481
+ ```
482
+
483
+ ## Common Issues and Solutions
484
+
485
+ ### Issue: The agent isn't following the rules
486
+
487
+ **Cause:** Rules may be too vague or not properly loaded by the agent.
488
+ **Solution:**
489
+
490
+ - Make rules more specific and actionable
491
+ - Verify rules are saved in the correct configuration file
492
+ - Restart your agent or IDE to reload rules
493
+ - Add "IMPORTANT:" prefix to critical rules
494
+
495
+ ### Issue: Rules conflict with each other
496
+
497
+ **Cause:** Contradictory or overlapping rules.
498
+ **Solution:**
499
+
500
+ - Review all rules for conflicts
501
+ - Establish a clear priority hierarchy
502
+ - Remove redundant rules
503
+ - Consolidate related rules into single, clear statements
504
+
505
+ ### Issue: Too many rules increase latency
506
+
507
+ **Cause:** Excessive rules increase context size and processing time.
508
+ **Solution:**
509
+
510
+ - Focus on the 20% of rules that solve 80% of consistency issues
511
+ - Remove overly specific rules that rarely apply
512
+ - Combine related rules
513
+ - Use progressive disclosure (basic rules first, advanced rules in linked files)
514
+
515
+ ### Issue: Rules become outdated as project evolves
516
+
517
+ **Cause:** Codebase changes but rules don't.
518
+ **Solution:**
519
+
520
+ - Schedule periodic rule reviews (monthly or quarterly)
521
+ - Update rules when architectural decisions change
522
+ - Version control your rule files
523
+ - Document rule changes in commit messages
524
+
525
+ ## Understanding Design System Rules
526
+
527
+ Design system rules transform how AI coding agents work with your Figma designs:
528
+
529
+ **Before rules:**
530
+
531
+ - The agent makes assumptions about component structure
532
+ - Inconsistent styling approaches across implementations
533
+ - Hardcoded values that don't match design tokens
534
+ - Components created in random locations
535
+ - Repetitive explanations of project conventions
536
+
537
+ **After rules:**
538
+
539
+ - The agent automatically follows your conventions
540
+ - Consistent component structure and styling
541
+ - Proper use of design tokens from the start
542
+ - Components organized correctly
543
+ - Zero repetitive prompting
544
+
545
+ The time invested in creating good rules pays off exponentially across every Figma implementation task.
546
+
547
+ ## Additional Resources
548
+
549
+ - [Figma MCP Server Documentation](https://developers.figma.com/docs/figma-mcp-server/)
550
+ - [Figma Variables and Design Tokens](https://help.figma.com/hc/en-us/articles/15339657135383-Guide-to-variables-in-Figma)
@@ -0,0 +1,15 @@
1
+ # Rule Template Skeleton
2
+
3
+ ## Figma MCP Integration Rules
4
+
5
+ - Required flow (`get_design_context` -> `get_screenshot`)
6
+ - Implementation conventions for this repo
7
+ - Asset handling
8
+ - Validation requirements
9
+
10
+ ## Project-Specific Conventions
11
+
12
+ - Components path(s)
13
+ - Token source(s)
14
+ - Styling system
15
+ - Testing and accessibility expectations
@@ -0,0 +1,9 @@
1
+ #!/usr/bin/env bash
2
+ # Draft helper: report whether AGENTS.md exists at repo root.
3
+ set -euo pipefail
4
+
5
+ if [[ -f AGENTS.md ]]; then
6
+ echo "AGENTS.md found"
7
+ else
8
+ echo "AGENTS.md not found"
9
+ fi
@@ -0,0 +1,2 @@
1
+ Use of these Figma skills and related files ("Materials") is governed by the Figma Developer Terms (available at https://www.figma.com/legal/developer-terms/). By accessing, downloading, or using these Materials — including through automated systems or AI agents — you agree to the Figma Developer Terms.
2
+ These Materials are currently offered as a Beta feature. Figma may modify, suspend, or discontinue them at any time without notice.
@@ -0,0 +1,17 @@
1
+ figma-create-new-file (agent-toolkit distribution)
2
+ ============================================
3
+
4
+ This skill is derived from the OpenAI "skills" repository, originally licensed
5
+ under the Apache License 2.0:
6
+
7
+ https://github.com/openai/skills (skills/.curated/figma-create-new-file)
8
+
9
+ Modifications by agent-toolkit S.A. for distribution via agent-toolkit:
10
+
11
+ - Removed the `agents/openai.yaml` manifest and `maintainers.yml` in favor of
12
+ the agent-toolkit `skill.json` schema.
13
+ - Updated cross-references to point to the opt-in `figma-use` pack (see
14
+ `docs/SKILLS.md`) since it is not bundled by default.
15
+ - Dropped vendor logo assets (`assets/figma*`).
16
+
17
+ Original LICENSE.txt is preserved in this directory.
@@ -0,0 +1,69 @@
1
+ ---
2
+ name: figma-create-new-file
3
+ description: Create a new blank Figma file. Use when the user wants to create a new Figma design or FigJam file, or when you need a new file before calling use_figma. Handles plan resolution via whoami if needed. Usage — /figma-create-new-file [editorType] [fileName] (e.g. /figma-create-new-file figjam My Whiteboard)
4
+ ---
5
+
6
+ # create_new_file — Create a New Figma File
7
+
8
+ Use the `create_new_file` MCP tool to create a new blank Figma file in the user's drafts folder. This is typically used before `use_figma` when you need a fresh file to work with.
9
+
10
+ ## Skill Arguments
11
+
12
+ This skill accepts optional arguments: `/figma-create-new-file [editorType] [fileName]`
13
+
14
+ - **editorType**: `design` (default) or `figjam`
15
+ - **fileName**: Name for the new file (defaults to "Untitled")
16
+
17
+ Examples:
18
+ - `/figma-create-new-file` — creates a design file named "Untitled"
19
+ - `/figma-create-new-file figjam My Whiteboard` — creates a FigJam file named "My Whiteboard"
20
+ - `/figma-create-new-file design My New Design` — creates a design file named "My New Design"
21
+
22
+ Parse the arguments from the skill invocation. If editorType is not provided, default to `"design"`. If fileName is not provided, default to `"Untitled"`.
23
+
24
+ ## Workflow
25
+
26
+ ### Step 1: Resolve the planKey
27
+
28
+ The `create_new_file` tool requires a `planKey` parameter. Follow this decision tree:
29
+
30
+ 1. **User already provided a planKey** (e.g. from a previous `whoami` call or in their prompt) → use it directly, skip to Step 2.
31
+
32
+ 2. **No planKey available** → call the `whoami` tool. The response contains a `plans` array. Each plan has a `key`, `name`, `seat`, and `tier`.
33
+
34
+ - **Single plan**: use its `key` field automatically.
35
+ - **Multiple plans**: ask the user which team or organization they want to create the file in, then use the corresponding plan's `key`.
36
+
37
+ ### Step 2: Call create_new_file
38
+
39
+ Call the `create_new_file` tool with:
40
+
41
+ | Parameter | Required | Description |
42
+ |-------------|----------|-------------|
43
+ | `planKey` | Yes | The plan key from Step 1 |
44
+ | `fileName` | Yes | Name for the new file |
45
+ | `editorType`| Yes | `"design"` or `"figjam"` |
46
+
47
+ Example:
48
+ ```json
49
+ {
50
+ "planKey": "team:123456",
51
+ "fileName": "My New Design",
52
+ "editorType": "design"
53
+ }
54
+ ```
55
+
56
+ ### Step 3: Use the result
57
+
58
+ The tool returns:
59
+ - `file_key` — the key of the newly created file
60
+ - `file_url` — a direct URL to open the file in Figma
61
+
62
+ Use the `file_key` for subsequent tool calls like `use_figma`.
63
+
64
+ ## Important Notes
65
+
66
+ - The file is created in the user's **drafts folder** for the selected plan.
67
+ - Only `"design"` and `"figjam"` editor types are supported.
68
+ - If `use_figma` is your next step, install and load the opt-in `figma-use`
69
+ pack first (see `docs/SKILLS.md`).
@@ -0,0 +1,2 @@
1
+ Use of these Figma skills and related files ("Materials") is governed by the Figma Developer Terms (available at https://www.figma.com/legal/developer-terms/). By accessing, downloading, or using these Materials — including through automated systems or AI agents — you agree to the Figma Developer Terms.
2
+ These Materials are currently offered as a Beta feature. Figma may modify, suspend, or discontinue them at any time without notice.
@@ -0,0 +1,19 @@
1
+ figma-implement-design (agent-toolkit distribution)
2
+ =============================================
3
+
4
+ This skill is derived from the OpenAI "skills" repository, originally licensed
5
+ under the Apache License 2.0:
6
+
7
+ https://github.com/openai/skills (skills/.curated/figma-implement-design)
8
+
9
+ Modifications by agent-toolkit S.A. for distribution via agent-toolkit:
10
+
11
+ - Removed the `agents/openai.yaml` manifest in favor of the agent-toolkit
12
+ `skill.json` schema.
13
+ - Rewrote cross-references to mark `figma-use` and `figma-generate-design` as
14
+ opt-in packs (see `docs/SKILLS.md`) since they are not bundled by default.
15
+ - Reordered the agent rule guidance to mention `AGENTS.md` first (agent-toolkit
16
+ convention).
17
+ - Dropped vendor logo assets (`assets/figma*`).
18
+
19
+ Original LICENSE.txt is preserved in this directory.