@softspark/ai-toolkit 1.0.0

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 (327) hide show
  1. package/AGENTS.md +412 -0
  2. package/CHANGELOG.md +68 -0
  3. package/LICENSE +21 -0
  4. package/README.md +632 -0
  5. package/action.yml +53 -0
  6. package/app/.claude-plugin/plugin.json +44 -0
  7. package/app/ARCHITECTURE.md +306 -0
  8. package/app/CLAUDE.md.template +23 -0
  9. package/app/agents/ai-engineer.md +128 -0
  10. package/app/agents/backend-specialist.md +193 -0
  11. package/app/agents/business-intelligence.md +54 -0
  12. package/app/agents/chaos-monkey.md +67 -0
  13. package/app/agents/chief-of-staff.md +51 -0
  14. package/app/agents/code-archaeologist.md +127 -0
  15. package/app/agents/code-reviewer.md +184 -0
  16. package/app/agents/command-expert.md +131 -0
  17. package/app/agents/data-analyst.md +205 -0
  18. package/app/agents/data-scientist.md +151 -0
  19. package/app/agents/database-architect.md +317 -0
  20. package/app/agents/debugger.md +238 -0
  21. package/app/agents/devops-implementer.md +194 -0
  22. package/app/agents/documenter.md +364 -0
  23. package/app/agents/explorer-agent.md +145 -0
  24. package/app/agents/fact-checker.md +172 -0
  25. package/app/agents/frontend-specialist.md +209 -0
  26. package/app/agents/game-developer.md +216 -0
  27. package/app/agents/incident-responder.md +226 -0
  28. package/app/agents/infrastructure-architect.md +127 -0
  29. package/app/agents/infrastructure-validator.md +247 -0
  30. package/app/agents/llm-ops-engineer.md +237 -0
  31. package/app/agents/mcp-expert.md +228 -0
  32. package/app/agents/mcp-server-architect.md +195 -0
  33. package/app/agents/mcp-testing-engineer.md +292 -0
  34. package/app/agents/meta-architect.md +58 -0
  35. package/app/agents/ml-engineer.md +136 -0
  36. package/app/agents/mobile-developer.md +190 -0
  37. package/app/agents/night-watchman.md +55 -0
  38. package/app/agents/nlp-engineer.md +154 -0
  39. package/app/agents/orchestrator.md +437 -0
  40. package/app/agents/performance-optimizer.md +254 -0
  41. package/app/agents/predictive-analyst.md +57 -0
  42. package/app/agents/product-manager.md +194 -0
  43. package/app/agents/project-planner.md +287 -0
  44. package/app/agents/prompt-engineer.md +103 -0
  45. package/app/agents/qa-automation-engineer.md +182 -0
  46. package/app/agents/rag-engineer.md +201 -0
  47. package/app/agents/research-synthesizer.md +138 -0
  48. package/app/agents/search-specialist.md +101 -0
  49. package/app/agents/security-architect.md +62 -0
  50. package/app/agents/security-auditor.md +293 -0
  51. package/app/agents/seo-specialist.md +111 -0
  52. package/app/agents/system-governor.md +57 -0
  53. package/app/agents/tech-lead.md +62 -0
  54. package/app/agents/technical-researcher.md +103 -0
  55. package/app/agents/test-engineer.md +264 -0
  56. package/app/constitution.md +38 -0
  57. package/app/hooks/_profile-check.sh +11 -0
  58. package/app/hooks/guard-destructive.sh +74 -0
  59. package/app/hooks/guard-path.sh +73 -0
  60. package/app/hooks/post-tool-use.sh +35 -0
  61. package/app/hooks/pre-compact.sh +31 -0
  62. package/app/hooks/quality-check.sh +22 -0
  63. package/app/hooks/quality-gate.sh +49 -0
  64. package/app/hooks/save-session.sh +24 -0
  65. package/app/hooks/session-end.sh +37 -0
  66. package/app/hooks/session-start.sh +29 -0
  67. package/app/hooks/subagent-start.sh +16 -0
  68. package/app/hooks/subagent-stop.sh +16 -0
  69. package/app/hooks/track-usage.sh +50 -0
  70. package/app/hooks/user-prompt-submit.sh +25 -0
  71. package/app/hooks.json +178 -0
  72. package/app/mcp-defaults.json +23 -0
  73. package/app/output-styles/golden-rules.md +43 -0
  74. package/app/plugins/README.md +19 -0
  75. package/app/plugins/csharp-pack/README.md +11 -0
  76. package/app/plugins/csharp-pack/plugin.json +18 -0
  77. package/app/plugins/enterprise-pack/README.md +16 -0
  78. package/app/plugins/enterprise-pack/hooks/output-style.sh +6 -0
  79. package/app/plugins/enterprise-pack/hooks/status-line.sh +8 -0
  80. package/app/plugins/enterprise-pack/plugin.json +24 -0
  81. package/app/plugins/frontend-pack/README.md +14 -0
  82. package/app/plugins/frontend-pack/plugin.json +22 -0
  83. package/app/plugins/java-pack/README.md +11 -0
  84. package/app/plugins/java-pack/plugin.json +18 -0
  85. package/app/plugins/kotlin-pack/README.md +11 -0
  86. package/app/plugins/kotlin-pack/plugin.json +18 -0
  87. package/app/plugins/memory-pack/README.md +24 -0
  88. package/app/plugins/memory-pack/hooks/observation-capture.sh +67 -0
  89. package/app/plugins/memory-pack/hooks/session-summary.sh +71 -0
  90. package/app/plugins/memory-pack/plugin.json +22 -0
  91. package/app/plugins/memory-pack/scripts/init_db.py +81 -0
  92. package/app/plugins/memory-pack/scripts/strip_private.py +22 -0
  93. package/app/plugins/memory-pack/skills/mem-search/SKILL.md +70 -0
  94. package/app/plugins/research-pack/README.md +14 -0
  95. package/app/plugins/research-pack/plugin.json +22 -0
  96. package/app/plugins/ruby-pack/README.md +11 -0
  97. package/app/plugins/ruby-pack/plugin.json +18 -0
  98. package/app/plugins/rust-pack/README.md +11 -0
  99. package/app/plugins/rust-pack/plugin.json +18 -0
  100. package/app/plugins/security-pack/README.md +15 -0
  101. package/app/plugins/security-pack/plugin.json +23 -0
  102. package/app/plugins/swift-pack/README.md +11 -0
  103. package/app/plugins/swift-pack/plugin.json +18 -0
  104. package/app/rules/claude-toolkit-rules.md +21 -0
  105. package/app/rules/git-conventions.md +5 -0
  106. package/app/rules/quality-gates.md +10 -0
  107. package/app/skills/_lib/__init__.py +1 -0
  108. package/app/skills/_lib/detect_utils.py +150 -0
  109. package/app/skills/agent-creator/SKILL.md +82 -0
  110. package/app/skills/analyze/SKILL.md +92 -0
  111. package/app/skills/analyze/scripts/complexity.py +165 -0
  112. package/app/skills/api-patterns/SKILL.md +305 -0
  113. package/app/skills/app-builder/SKILL.md +187 -0
  114. package/app/skills/architecture-audit/SKILL.md +141 -0
  115. package/app/skills/architecture-decision/SKILL.md +55 -0
  116. package/app/skills/architecture-decision/templates/adr-template.md +36 -0
  117. package/app/skills/biz-scan/SKILL.md +30 -0
  118. package/app/skills/briefing/SKILL.md +27 -0
  119. package/app/skills/build/SKILL.md +97 -0
  120. package/app/skills/build/scripts/detect-build.py +151 -0
  121. package/app/skills/chaos/SKILL.md +32 -0
  122. package/app/skills/ci/SKILL.md +77 -0
  123. package/app/skills/ci/scripts/ci-detect.py +135 -0
  124. package/app/skills/ci/templates/github-actions-node.yml +38 -0
  125. package/app/skills/ci/templates/github-actions-python.yml +42 -0
  126. package/app/skills/ci-cd-patterns/SKILL.md +299 -0
  127. package/app/skills/clean-code/SKILL.md +110 -0
  128. package/app/skills/clean-code/reference/dart.md +18 -0
  129. package/app/skills/clean-code/reference/go.md +23 -0
  130. package/app/skills/clean-code/reference/php.md +32 -0
  131. package/app/skills/clean-code/reference/python.md +180 -0
  132. package/app/skills/clean-code/reference/typescript.md +26 -0
  133. package/app/skills/command-creator/SKILL.md +83 -0
  134. package/app/skills/commit/SKILL.md +98 -0
  135. package/app/skills/commit/scripts/pre-commit-check.py +87 -0
  136. package/app/skills/commit/templates/conventional-commit.md +52 -0
  137. package/app/skills/csharp-patterns/SKILL.md +450 -0
  138. package/app/skills/database-patterns/SKILL.md +297 -0
  139. package/app/skills/debug/SKILL.md +154 -0
  140. package/app/skills/debug/scripts/error-parser.py +187 -0
  141. package/app/skills/debugging-tactics/SKILL.md +136 -0
  142. package/app/skills/deploy/SKILL.md +130 -0
  143. package/app/skills/deploy/scripts/pre_deploy_check.py +171 -0
  144. package/app/skills/deploy/templates/deployment-checklist.md +31 -0
  145. package/app/skills/design-an-interface/SKILL.md +105 -0
  146. package/app/skills/design-engineering/SKILL.md +260 -0
  147. package/app/skills/docker-devops/SKILL.md +303 -0
  148. package/app/skills/docs/SKILL.md +145 -0
  149. package/app/skills/docs/scripts/doc-inventory.py +176 -0
  150. package/app/skills/docs/templates/adr-template.md +36 -0
  151. package/app/skills/docs/templates/readme-template.md +67 -0
  152. package/app/skills/documentation-standards/SKILL.md +191 -0
  153. package/app/skills/ecommerce-patterns/SKILL.md +209 -0
  154. package/app/skills/evaluate/SKILL.md +132 -0
  155. package/app/skills/evolve/SKILL.md +27 -0
  156. package/app/skills/explain/SKILL.md +54 -0
  157. package/app/skills/explain/scripts/dependency-graph.py +215 -0
  158. package/app/skills/explore/SKILL.md +112 -0
  159. package/app/skills/explore/scripts/visualize.py +117 -0
  160. package/app/skills/fix/SKILL.md +78 -0
  161. package/app/skills/fix/scripts/error-classifier.py +191 -0
  162. package/app/skills/flutter-patterns/SKILL.md +254 -0
  163. package/app/skills/git-mastery/SKILL.md +70 -0
  164. package/app/skills/grill-me/SKILL.md +38 -0
  165. package/app/skills/health/SKILL.md +91 -0
  166. package/app/skills/health/scripts/health_check.py +162 -0
  167. package/app/skills/hive-mind/SKILL.md +56 -0
  168. package/app/skills/hook-creator/SKILL.md +107 -0
  169. package/app/skills/index/SKILL.md +74 -0
  170. package/app/skills/instinct-review/SKILL.md +77 -0
  171. package/app/skills/java-patterns/SKILL.md +442 -0
  172. package/app/skills/kotlin-patterns/SKILL.md +446 -0
  173. package/app/skills/lint/SKILL.md +103 -0
  174. package/app/skills/lint/scripts/detect-linters.py +112 -0
  175. package/app/skills/mcp-patterns/SKILL.md +270 -0
  176. package/app/skills/mem-search/SKILL.md +70 -0
  177. package/app/skills/migrate/SKILL.md +90 -0
  178. package/app/skills/migrate/scripts/migration-status.py +195 -0
  179. package/app/skills/migration-patterns/SKILL.md +260 -0
  180. package/app/skills/night-watch/SKILL.md +28 -0
  181. package/app/skills/observability-patterns/SKILL.md +203 -0
  182. package/app/skills/onboard/SKILL.md +76 -0
  183. package/app/skills/orchestrate/SKILL.md +86 -0
  184. package/app/skills/panic/SKILL.md +30 -0
  185. package/app/skills/performance-profiling/SKILL.md +59 -0
  186. package/app/skills/plan/SKILL.md +110 -0
  187. package/app/skills/plan/templates/plan-template.md +40 -0
  188. package/app/skills/plan-writing/SKILL.md +201 -0
  189. package/app/skills/plugin-creator/SKILL.md +78 -0
  190. package/app/skills/pr/SKILL.md +129 -0
  191. package/app/skills/pr/scripts/pr-summary.py +175 -0
  192. package/app/skills/prd-to-issues/SKILL.md +108 -0
  193. package/app/skills/prd-to-plan/SKILL.md +120 -0
  194. package/app/skills/predict/SKILL.md +30 -0
  195. package/app/skills/qa-session/SKILL.md +110 -0
  196. package/app/skills/rag-patterns/SKILL.md +203 -0
  197. package/app/skills/refactor/SKILL.md +124 -0
  198. package/app/skills/refactor/scripts/refactor-scan.py +210 -0
  199. package/app/skills/refactor-plan/SKILL.md +112 -0
  200. package/app/skills/repeat/SKILL.md +149 -0
  201. package/app/skills/research-mastery/SKILL.md +56 -0
  202. package/app/skills/review/SKILL.md +141 -0
  203. package/app/skills/review/scripts/diff-analyzer.py +170 -0
  204. package/app/skills/rollback/SKILL.md +87 -0
  205. package/app/skills/rollback/scripts/rollback_info.py +149 -0
  206. package/app/skills/ruby-patterns/SKILL.md +454 -0
  207. package/app/skills/rust-patterns/SKILL.md +446 -0
  208. package/app/skills/search/SKILL.md +64 -0
  209. package/app/skills/security-patterns/SKILL.md +91 -0
  210. package/app/skills/security-patterns/reference/authentication.md +37 -0
  211. package/app/skills/security-patterns/reference/authorization.md +22 -0
  212. package/app/skills/security-patterns/reference/input-validation.md +30 -0
  213. package/app/skills/security-patterns/reference/oauth-csrf-audit.md +131 -0
  214. package/app/skills/skill-creator/SKILL.md +154 -0
  215. package/app/skills/skill-creator/templates/dashboard/index.html +130 -0
  216. package/app/skills/skill-creator/templates/reasoning-engine/assets/example.json +12 -0
  217. package/app/skills/skill-creator/templates/reasoning-engine/search.py +110 -0
  218. package/app/skills/subagent-development/SKILL.md +225 -0
  219. package/app/skills/subagent-development/reference/code-quality-reviewer-prompt.md +145 -0
  220. package/app/skills/subagent-development/reference/implementer-prompt.md +118 -0
  221. package/app/skills/subagent-development/reference/spec-reviewer-prompt.md +100 -0
  222. package/app/skills/swarm/SKILL.md +81 -0
  223. package/app/skills/swift-patterns/SKILL.md +500 -0
  224. package/app/skills/tdd/SKILL.md +174 -0
  225. package/app/skills/tdd/reference/deep-modules.md +32 -0
  226. package/app/skills/tdd/reference/interface-design.md +32 -0
  227. package/app/skills/tdd/reference/mocking.md +52 -0
  228. package/app/skills/tdd/reference/refactoring.md +10 -0
  229. package/app/skills/tdd/reference/tests.md +59 -0
  230. package/app/skills/teams/SKILL.md +101 -0
  231. package/app/skills/test/SKILL.md +107 -0
  232. package/app/skills/test/scripts/detect-runner.py +113 -0
  233. package/app/skills/testing-patterns/SKILL.md +73 -0
  234. package/app/skills/testing-patterns/reference/flutter-testing.md +33 -0
  235. package/app/skills/testing-patterns/reference/go-testing.md +52 -0
  236. package/app/skills/testing-patterns/reference/php-phpunit.md +39 -0
  237. package/app/skills/testing-patterns/reference/python-pytest.md +228 -0
  238. package/app/skills/testing-patterns/reference/typescript-vitest.md +50 -0
  239. package/app/skills/triage-issue/SKILL.md +120 -0
  240. package/app/skills/typescript-patterns/SKILL.md +256 -0
  241. package/app/skills/ubiquitous-language/SKILL.md +74 -0
  242. package/app/skills/verification-before-completion/SKILL.md +108 -0
  243. package/app/skills/workflow/SKILL.md +250 -0
  244. package/app/skills/write-a-prd/SKILL.md +129 -0
  245. package/app/skills/write-a-prd/reference/visual-companion.md +78 -0
  246. package/app/skills/write-a-prd/scripts/frame-template.html +111 -0
  247. package/app/skills/write-a-prd/scripts/visual-server.cjs +79 -0
  248. package/app/templates/skill/generator/SKILL.md.template +40 -0
  249. package/app/templates/skill/knowledge/SKILL.md.template +52 -0
  250. package/app/templates/skill/linter/SKILL.md.template +34 -0
  251. package/app/templates/skill/reviewer/SKILL.md.template +51 -0
  252. package/app/templates/skill/workflow/SKILL.md.template +49 -0
  253. package/benchmarks/README.md +111 -0
  254. package/benchmarks/ecosystem-dashboard.json +148 -0
  255. package/benchmarks/ecosystem-harvest.json +148 -0
  256. package/benchmarks/results.json +38 -0
  257. package/benchmarks/run.py +351 -0
  258. package/bin/ai-toolkit.js +345 -0
  259. package/kb/best-practices/README.md +11 -0
  260. package/kb/howto/README.md +11 -0
  261. package/kb/procedures/maintenance-sop.md +306 -0
  262. package/kb/reference/agents-catalog.md +124 -0
  263. package/kb/reference/anti-pattern-registry-format.md +221 -0
  264. package/kb/reference/architecture-overview.md +232 -0
  265. package/kb/reference/benchmark-config.md +62 -0
  266. package/kb/reference/ci-integration.md +66 -0
  267. package/kb/reference/claude-ecosystem-benchmark-snapshot.md +80 -0
  268. package/kb/reference/claude-ecosystem-expansion-foundations.md +102 -0
  269. package/kb/reference/commands-catalog.md +21 -0
  270. package/kb/reference/distribution-model.md +63 -0
  271. package/kb/reference/global-install-model.md +56 -0
  272. package/kb/reference/hierarchical-override-pattern.md +200 -0
  273. package/kb/reference/hooks-catalog.md +306 -0
  274. package/kb/reference/integrations.md +88 -0
  275. package/kb/reference/language-packs.md +52 -0
  276. package/kb/reference/merge-friendly-install-model.md +58 -0
  277. package/kb/reference/plugin-pack-conventions.md +151 -0
  278. package/kb/reference/quick-wins-implementation-summary.md +70 -0
  279. package/kb/reference/skill-templates.md +50 -0
  280. package/kb/reference/skills-catalog.md +215 -0
  281. package/kb/reference/skills-unification.md +57 -0
  282. package/kb/reference/stats.md +69 -0
  283. package/kb/reference/sync.md +76 -0
  284. package/kb/troubleshooting/README.md +11 -0
  285. package/llms-full.txt +3068 -0
  286. package/llms.txt +39 -0
  287. package/package.json +75 -0
  288. package/scripts/_common.py +160 -0
  289. package/scripts/add_rule.py +50 -0
  290. package/scripts/benchmark_config.py +127 -0
  291. package/scripts/benchmark_ecosystem.py +288 -0
  292. package/scripts/check_deps.py +260 -0
  293. package/scripts/create_skill.py +118 -0
  294. package/scripts/doctor.py +504 -0
  295. package/scripts/eject.py +113 -0
  296. package/scripts/emission.py +256 -0
  297. package/scripts/evaluate_skills.py +260 -0
  298. package/scripts/frontmatter.py +58 -0
  299. package/scripts/generate_agents_md.py +91 -0
  300. package/scripts/generate_aider_conf.py +51 -0
  301. package/scripts/generate_cline.py +35 -0
  302. package/scripts/generate_copilot.py +30 -0
  303. package/scripts/generate_cursor_rules.py +35 -0
  304. package/scripts/generate_gemini.py +28 -0
  305. package/scripts/generate_llms_txt.py +164 -0
  306. package/scripts/generate_roo_modes.py +80 -0
  307. package/scripts/generate_windsurf.py +35 -0
  308. package/scripts/generator_base.py +140 -0
  309. package/scripts/harvest_ecosystem.py +50 -0
  310. package/scripts/inject_rule_cli.py +101 -0
  311. package/scripts/inject_section_cli.py +47 -0
  312. package/scripts/injection.py +180 -0
  313. package/scripts/install.py +236 -0
  314. package/scripts/install_git_hooks.py +71 -0
  315. package/scripts/install_steps/__init__.py +5 -0
  316. package/scripts/install_steps/ai_tools.py +261 -0
  317. package/scripts/install_steps/hooks.py +90 -0
  318. package/scripts/install_steps/markers.py +79 -0
  319. package/scripts/install_steps/symlinks.py +87 -0
  320. package/scripts/merge-hooks.py +192 -0
  321. package/scripts/plugin.py +642 -0
  322. package/scripts/plugin_schema.py +138 -0
  323. package/scripts/remove_rule.py +58 -0
  324. package/scripts/stats.py +81 -0
  325. package/scripts/sync.py +215 -0
  326. package/scripts/uninstall.py +292 -0
  327. package/scripts/validate.py +700 -0
package/app/skills/write-a-prd/scripts/frame-template.html ADDED
@@ -0,0 +1,111 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>ai-toolkit Visual Companion</title>
7
+ <style>
8
+ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
9
+
10
+ body {
11
+ background: #1a1a2e;
12
+ color: #eee;
13
+ font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
14
+ line-height: 1.6;
15
+ min-height: 100vh;
16
+ }
17
+
18
+ header {
19
+ background: #16213e;
20
+ border-bottom: 1px solid #0f3460;
21
+ padding: 12px 24px;
22
+ text-align: center;
23
+ }
24
+
25
+ header h1 {
26
+ font-size: 1rem;
27
+ font-weight: 600;
28
+ color: #a8b2d1;
29
+ letter-spacing: 0.02em;
30
+ }
31
+
32
+ main {
33
+ max-width: 900px;
34
+ margin: 0 auto;
35
+ padding: 32px 24px;
36
+ }
37
+
38
+ #content {
39
+ background: #16213e;
40
+ border: 1px solid #0f3460;
41
+ border-radius: 8px;
42
+ padding: 24px;
43
+ min-height: 200px;
44
+ transition: opacity 150ms ease-out;
45
+ }
46
+
47
+ #content img { max-width: 100%; height: auto; border-radius: 4px; }
48
+ #content table { border-collapse: collapse; width: 100%; }
49
+ #content th, #content td { border: 1px solid #0f3460; padding: 8px 12px; text-align: left; }
50
+ #content th { background: #1a1a2e; }
51
+ #content pre { background: #0d1117; padding: 16px; border-radius: 4px; overflow-x: auto; }
52
+ #content code { font-family: "SF Mono", "Fira Code", monospace; font-size: 0.9em; }
53
+ #content h1, #content h2, #content h3 { margin: 16px 0 8px; color: #ccd6f6; }
54
+ #content ul, #content ol { padding-left: 24px; }
55
+ #content li { margin: 4px 0; }
56
+
57
+ .status {
58
+ text-align: center;
59
+ padding: 8px;
60
+ font-size: 0.75rem;
61
+ color: #4a5568;
62
+ }
63
+
64
+ .status .dot {
65
+ display: inline-block;
66
+ width: 6px;
67
+ height: 6px;
68
+ border-radius: 50%;
69
+ background: #48bb78;
70
+ margin-right: 4px;
71
+ vertical-align: middle;
72
+ }
73
+ </style>
74
+ </head>
75
+ <body>
76
+ <header>
77
+ <h1>ai-toolkit Visual Companion</h1>
78
+ </header>
79
+ <main>
80
+ <div id="content">
81
+ <p>Waiting for content...</p>
82
+ </div>
83
+ </main>
84
+ <div class="status"><span class="dot"></span>Connected</div>
85
+ <script>
86
+ (function () {
87
+ var contentEl = document.getElementById("content");
88
+ var lastHtml = "";
89
+
90
+ function poll() {
91
+ fetch("/content")
92
+ .then(function (res) { return res.json(); })
93
+ .then(function (data) {
94
+ if (data.html && data.html !== lastHtml) {
95
+ lastHtml = data.html;
96
+ contentEl.style.opacity = "0";
97
+ setTimeout(function () {
98
+ contentEl.innerHTML = data.html;
99
+ contentEl.style.opacity = "1";
100
+ }, 80);
101
+ }
102
+ })
103
+ .catch(function () {});
104
+ }
105
+
106
+ setInterval(poll, 2000);
107
+ poll();
108
+ })();
109
+ </script>
110
+ </body>
111
+ </html>
package/app/skills/write-a-prd/scripts/visual-server.cjs ADDED
@@ -0,0 +1,79 @@
1
+ "use strict";
2
+
3
+ const http = require("http");
4
+ const fs = require("fs");
5
+ const path = require("path");
6
+
7
+ const IDLE_TIMEOUT_MS = 30 * 60 * 1000;
8
+ const FALLBACK_PORT = 38888;
9
+
10
+ let currentContent = "<p>Waiting for content...</p>";
11
+ let idleTimer = null;
12
+
13
+ function resetIdleTimer() {
14
+ if (idleTimer) clearTimeout(idleTimer);
15
+ idleTimer = setTimeout(() => {
16
+ console.log("Idle timeout reached. Shutting down.");
17
+ process.exit(0);
18
+ }, IDLE_TIMEOUT_MS);
19
+ }
20
+
21
+ const templatePath = path.join(__dirname, "frame-template.html");
22
+ const templateHtml = fs.readFileSync(templatePath, "utf-8");
23
+
24
+ const server = http.createServer((req, res) => {
25
+ resetIdleTimer();
26
+
27
+ if (req.method === "GET" && (req.url === "/" || req.url === "/index.html")) {
28
+ res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
29
+ res.end(templateHtml);
30
+ return;
31
+ }
32
+
33
+ if (req.method === "GET" && req.url === "/content") {
34
+ res.writeHead(200, { "Content-Type": "application/json" });
35
+ res.end(JSON.stringify({ html: currentContent }));
36
+ return;
37
+ }
38
+
39
+ if (req.method === "POST" && req.url === "/update") {
40
+ let body = "";
41
+ req.on("data", (chunk) => { body += chunk; });
42
+ req.on("end", () => {
43
+ try {
44
+ const data = JSON.parse(body);
45
+ if (typeof data.html === "string") {
46
+ currentContent = data.html;
47
+ res.writeHead(200, { "Content-Type": "application/json" });
48
+ res.end(JSON.stringify({ ok: true }));
49
+ } else {
50
+ res.writeHead(400, { "Content-Type": "application/json" });
51
+ res.end(JSON.stringify({ error: "Missing 'html' field" }));
52
+ }
53
+ } catch {
54
+ res.writeHead(400, { "Content-Type": "application/json" });
55
+ res.end(JSON.stringify({ error: "Invalid JSON" }));
56
+ }
57
+ });
58
+ return;
59
+ }
60
+
61
+ res.writeHead(404, { "Content-Type": "text/plain" });
62
+ res.end("Not Found");
63
+ });
64
+
65
+ server.listen(0, () => {
66
+ const port = server.address().port;
67
+ console.log(`Visual companion ready at http://localhost:${port}`);
68
+ resetIdleTimer();
69
+ });
70
+
71
+ server.on("error", () => {
72
+ server.listen(FALLBACK_PORT, () => {
73
+ console.log(`Visual companion ready at http://localhost:${FALLBACK_PORT}`);
74
+ resetIdleTimer();
75
+ });
76
+ });
77
+
78
+ process.on("SIGINT", () => process.exit(0));
79
+ process.on("SIGTERM", () => process.exit(0));
package/app/templates/skill/generator/SKILL.md.template ADDED
@@ -0,0 +1,40 @@
1
+ ---
2
+ name: {{NAME}}
3
+ description: "{{DESCRIPTION}}"
4
+ effort: medium
5
+ disable-model-invocation: true
6
+ argument-hint: "[type or target]"
7
+ allowed-tools: Read, Write, Bash, Glob
8
+ ---
9
+
10
+ # {{NAME}}
11
+
12
+ $ARGUMENTS
13
+
14
+ Generate output files based on project analysis.
15
+
16
+ ## Usage
17
+
18
+ ```
19
+ /{{NAME}} [type]
20
+ ```
21
+
22
+ ## What This Command Does
23
+
24
+ 1. **Scans** the project structure and existing files
25
+ 2. **Analyzes** patterns and conventions in use
26
+ 3. **Generates** output following project conventions
27
+ 4. **Writes** files to the appropriate locations
28
+
29
+ ## Output Targets
30
+
31
+ | Type | Output | Description |
32
+ |------|--------|-------------|
33
+ | default | stdout | Print to console |
34
+
35
+ ## Rules
36
+
37
+ - Follow existing project conventions and patterns
38
+ - Never overwrite files without user confirmation
39
+ - Use project's existing formatting and style
40
+ - Include comments only where logic is non-obvious
package/app/templates/skill/knowledge/SKILL.md.template ADDED
@@ -0,0 +1,52 @@
1
+ ---
2
+ name: {{NAME}}
3
+ description: "{{DESCRIPTION}}"
4
+ effort: medium
5
+ user-invocable: false
6
+ ---
7
+
8
+ # {{NAME}}
9
+
10
+ ## Core Principles
11
+
12
+ ### 1. Principle One
13
+ Description and code example.
14
+
15
+ ```
16
+ // Example code
17
+ ```
18
+
19
+ ### 2. Principle Two
20
+ Description and code example.
21
+
22
+ ```
23
+ // Example code
24
+ ```
25
+
26
+ ### 3. Principle Three
27
+ Description and code example.
28
+
29
+ ```
30
+ // Example code
31
+ ```
32
+
33
+ ## Common Patterns
34
+
35
+ ### Pattern A
36
+ When to use, how to implement, example.
37
+
38
+ ### Pattern B
39
+ When to use, how to implement, example.
40
+
41
+ ## Anti-Patterns
42
+
43
+ | Anti-Pattern | Problem | Better Approach |
44
+ |-------------|---------|----------------|
45
+ | Example | Why it's bad | What to do instead |
46
+
47
+ ## Quick Reference
48
+
49
+ | Concept | Usage | Example |
50
+ |---------|-------|---------|
51
+ | Concept A | When | `code` |
52
+ | Concept B | When | `code` |
package/app/templates/skill/linter/SKILL.md.template ADDED
@@ -0,0 +1,34 @@
1
+ ---
2
+ name: {{NAME}}
3
+ description: "{{DESCRIPTION}}"
4
+ effort: low
5
+ disable-model-invocation: true
6
+ argument-hint: "[path or file]"
7
+ allowed-tools: Bash, Read, Grep
8
+ ---
9
+
10
+ # {{NAME}}
11
+
12
+ $ARGUMENTS
13
+
14
+ Run linting checks on the specified target.
15
+
16
+ ## Usage
17
+
18
+ ```
19
+ /{{NAME}} [path]
20
+ ```
21
+
22
+ ## What This Command Does
23
+
24
+ 1. **Detects** project type and available linters
25
+ 2. **Runs** appropriate linting tool
26
+ 3. **Reports** issues with file paths and line numbers
27
+ 4. **Suggests** auto-fixes where available
28
+
29
+ ## Rules
30
+
31
+ - Always run linters with the project's existing configuration
32
+ - Report issues grouped by severity (error, warning, info)
33
+ - Suggest `--fix` flag when auto-fixable issues are found
34
+ - Never modify files without explicit user approval
package/app/templates/skill/reviewer/SKILL.md.template ADDED
@@ -0,0 +1,51 @@
1
+ ---
2
+ name: {{NAME}}
3
+ description: "{{DESCRIPTION}}"
4
+ effort: high
5
+ argument-hint: "[target: file, branch, or PR]"
6
+ agent: code-reviewer
7
+ context: fork
8
+ allowed-tools: Read, Grep, Glob, Bash
9
+ ---
10
+
11
+ # {{NAME}}
12
+
13
+ $ARGUMENTS
14
+
15
+ Review code for quality, patterns, and potential issues.
16
+
17
+ ## Usage
18
+
19
+ ```
20
+ /{{NAME}} [target]
21
+ ```
22
+
23
+ ## What This Command Does
24
+
25
+ 1. **Identifies** changed files and scope of review
26
+ 2. **Analyzes** code quality, patterns, and potential issues
27
+ 3. **Reports** findings with severity and actionable suggestions
28
+ 4. **Summarizes** overall assessment
29
+
30
+ ## Review Checklist
31
+
32
+ - [ ] Code correctness and logic
33
+ - [ ] Error handling completeness
34
+ - [ ] Naming conventions and readability
35
+ - [ ] Test coverage for changes
36
+ - [ ] Security considerations
37
+ - [ ] Performance implications
38
+
39
+ ## Output Format
40
+
41
+ For each finding:
42
+ ```
43
+ [SEVERITY] file:line — Description
44
+ Suggestion: ...
45
+ ```
46
+
47
+ ## Rules
48
+
49
+ - Focus on issues that matter, not style nitpicks
50
+ - Suggest specific fixes, not vague advice
51
+ - Acknowledge good patterns when found
package/app/templates/skill/workflow/SKILL.md.template ADDED
@@ -0,0 +1,49 @@
1
+ ---
2
+ name: {{NAME}}
3
+ description: "{{DESCRIPTION}}"
4
+ effort: max
5
+ argument-hint: "[type] [task description]"
6
+ agent: orchestrator
7
+ context: fork
8
+ model: opus
9
+ ---
10
+
11
+ # {{NAME}}
12
+
13
+ $ARGUMENTS
14
+
15
+ Coordinate a multi-phase workflow with specialized agents.
16
+
17
+ ## Usage
18
+
19
+ ```
20
+ /{{NAME}} [type] [description]
21
+ ```
22
+
23
+ ## What This Command Does
24
+
25
+ 1. **Analyzes** the task and selects appropriate workflow type
26
+ 2. **Plans** phases and agent assignments
27
+ 3. **Executes** each phase with the assigned agent
28
+ 4. **Validates** output at each phase gate
29
+ 5. **Synthesizes** results into a final deliverable
30
+
31
+ ## Workflow Phases
32
+
33
+ ### Phase 1: Analysis
34
+ - Understand requirements and constraints
35
+ - Identify affected files and components
36
+
37
+ ### Phase 2: Implementation
38
+ - Execute the core task
39
+ - Validate each change against requirements
40
+
41
+ ### Phase 3: Verification
42
+ - Run tests and validation
43
+ - Review output quality
44
+
45
+ ## Rules
46
+
47
+ - Each phase must complete before the next begins
48
+ - Escalate blockers to the user immediately
49
+ - Never skip the verification phase
package/benchmarks/README.md ADDED
@@ -0,0 +1,111 @@
1
+ # ai-toolkit Benchmarks
2
+
3
+ Structured benchmarks to measure the toolkit's impact on developer productivity.
4
+
5
+ ## Methodology
6
+
7
+ Each benchmark task is run twice:
8
+ 1. **Without toolkit**: Vanilla Claude Code, no agents or skills
9
+ 2. **With toolkit**: ai-toolkit installed with standard profile
10
+
11
+ Metrics captured:
12
+ - **Time to first useful output** (seconds)
13
+ - **Number of tool calls** (fewer = more precise)
14
+ - **Task completion rate** (% of success criteria met)
15
+ - **User corrections needed** (0 = perfect, higher = worse)
16
+
17
+ Each task is run 3 times per condition, results averaged.
18
+
19
+ ## Benchmark Tasks
20
+
21
+ ### B1: Debug a multi-file bug
22
+
23
+ **Task:** Given a FastAPI application with a broken authentication middleware (JWT validation fails silently), identify root cause and propose fix.
24
+
25
+ **Success criteria:**
26
+ - [ ] Identifies the exact line causing the issue
27
+ - [ ] Explains why it fails
28
+ - [ ] Proposes correct fix
29
+ - [ ] Fix passes type checking
30
+
31
+ ### B2: Code review
32
+
33
+ **Task:** Review a 200-line Python module with 3 intentional issues (SQL injection, missing error handling, N+1 query).
34
+
35
+ **Success criteria:**
36
+ - [ ] Finds SQL injection vulnerability
37
+ - [ ] Finds missing error handling
38
+ - [ ] Finds N+1 query
39
+ - [ ] No false positives
40
+
41
+ ### B3: Refactor to clean code
42
+
43
+ **Task:** Refactor a 150-line function with 4 responsibilities into smaller, well-named functions.
44
+
45
+ **Success criteria:**
46
+ - [ ] Single responsibility per function
47
+ - [ ] Clear function names
48
+ - [ ] No behavior change
49
+ - [ ] Tests still pass
50
+
51
+ ### B4: Generate tests
52
+
53
+ **Task:** Generate unit tests for a payment processing module with 5 methods.
54
+
55
+ **Success criteria:**
56
+ - [ ] All 5 methods covered
57
+ - [ ] Edge cases included
58
+ - [ ] Tests are runnable (no syntax errors)
59
+ - [ ] Mocks external dependencies
60
+
61
+ ### B5: Generate documentation
62
+
63
+ **Task:** Generate README, API docs, and inline docstrings for a 3-file Flask microservice.
64
+
65
+ **Success criteria:**
66
+ - [ ] README covers install, usage, API
67
+ - [ ] All public endpoints documented
68
+ - [ ] Docstrings on all public functions
69
+ - [ ] Examples are accurate
70
+
71
+ ## Running Benchmarks
72
+
73
+ ```bash
74
+ python3 benchmarks/run.py [task-id]
75
+ python3 scripts/benchmark_ecosystem.py --offline
76
+ python3 scripts/benchmark_ecosystem.py --dashboard-json --out benchmarks/ecosystem-dashboard.json
77
+ python3 scripts/harvest_ecosystem.py --offline
78
+
79
+ # Examples:
80
+ python3 benchmarks/run.py B1 # run single benchmark
81
+ python3 benchmarks/run.py all # run all 5 benchmarks
82
+ python3 benchmarks/run.py --report # print last results
83
+ ```
84
+
85
+ ## Ecosystem Benchmark Artifacts
86
+
87
+ - `benchmarks/ecosystem-dashboard.json` — curated summary with freshness, comparison matrix, and repo metrics
88
+ - `benchmarks/ecosystem-harvest.json` — machine-readable harvest for roadmap / changelog reuse
89
+
90
+ Use `scripts/benchmark_ecosystem.py` for curated reports and `scripts/harvest_ecosystem.py` for repeatable JSON harvesting.
91
+
92
+ ## Results
93
+
94
+ **Run date:** 2026-03-26 · **Model:** claude-sonnet-4-6
95
+
96
+ | Benchmark | With Toolkit | Tool Calls | Without Toolkit | Tool Calls |
97
+ |-----------|-------------|------------|-----------------|------------|
98
+ | B1: Debug (FastAPI JWT) | 4/4 ✓ | 1 | 4/4 ✓ | 1 |
99
+ | B2: Review (SQL/N+1/error) | 4/4 ✓ | 1 | 4/4 ✓ | 1 |
100
+ | B3: Refactor (god function) | 4/4 ✓ | 1 | 4/4 ✓ | 2 |
101
+ | B4: Test gen (payments) | 4/4 ✓ | 1 | 4/4 ✓ | 8* |
102
+ | B5: Docs (Flask API) | 4/4 ✓ | 3 | 4/4 ✓ | 10 |
103
+ | **TOTAL** | **20/20** | **avg 1.4** | **20/20** | **avg 4.4** |
104
+
105
+ *B4 vanilla found existing test file from prior run — tool call count inflated.
106
+
107
+ **Finding:** Same accuracy on isolated single-file tasks. Toolkit delivers **3.1× fewer tool calls** on complex tasks (B4/B5). Real gains expected on multi-file, multi-step real-world scenarios where agent specialization and skill context compound.
108
+
109
+ ---
110
+
111
+ *Run `./benchmarks/run.sh all` then `./benchmarks/run.sh --report` to see results.*
package/benchmarks/ecosystem-dashboard.json ADDED
@@ -0,0 +1,148 @@
1
+ {
2
+ "generated_at": "2026-03-28T09:37:52Z",
3
+ "mode": "offline",
4
+ "snapshot_date": "2026-03-28",
5
+ "freshness": {
6
+ "stale_threshold_days": 30,
7
+ "age_days": 0,
8
+ "status": "fresh"
9
+ },
10
+ "summary": {
11
+ "repo_count": 6,
12
+ "stars_total": 206035,
13
+ "categories": [
14
+ "cross-tool",
15
+ "ecosystem-scale",
16
+ "hooks-reference",
17
+ "meta-tooling",
18
+ "official",
19
+ "practical-showcase"
20
+ ],
21
+ "official_repo": "anthropics/claude-code"
22
+ },
23
+ "comparison_matrix": [
24
+ {
25
+ "pattern": "plugin-manifest-support",
26
+ "current_state": "implemented",
27
+ "benchmark_signal": "official Claude Code plugin layout",
28
+ "priority": "high",
29
+ "evidence": [
30
+ "anthropics/claude-code"
31
+ ]
32
+ },
33
+ {
34
+ "pattern": "creator-workflows",
35
+ "current_state": "implemented",
36
+ "benchmark_signal": "meta-tooling for commands, hooks, agents, plugins",
37
+ "priority": "high",
38
+ "evidence": [
39
+ "anthropics/claude-code",
40
+ "alirezarezvani/claude-code-skill-factory"
41
+ ]
42
+ },
43
+ {
44
+ "pattern": "lifecycle-breadth",
45
+ "current_state": "implemented",
46
+ "benchmark_signal": "prompt governance, post-tool feedback, subagent hooks, session end",
47
+ "priority": "high",
48
+ "evidence": [
49
+ "disler/claude-code-hooks-mastery",
50
+ "ChrisWiles/claude-code-showcase"
51
+ ]
52
+ },
53
+ {
54
+ "pattern": "plugin-packs",
55
+ "current_state": "implemented-experimental",
56
+ "benchmark_signal": "modular domain packaging",
57
+ "priority": "medium",
58
+ "evidence": [
59
+ "anthropics/claude-code",
60
+ "affaan-m/everything-claude-code"
61
+ ]
62
+ },
63
+ {
64
+ "pattern": "benchmark-harvesting",
65
+ "current_state": "implemented",
66
+ "benchmark_signal": "repeatable evidence for docs and roadmap decisions",
67
+ "priority": "medium",
68
+ "evidence": [
69
+ "anthropics/claude-code",
70
+ "codeaholicguy/ai-devkit"
71
+ ]
72
+ }
73
+ ],
74
+ "repos": [
75
+ {
76
+ "repo": "anthropics/claude-code",
77
+ "category": "official",
78
+ "stars": 83535,
79
+ "updated_at": "2026-03-27T16:50:16Z",
80
+ "commands_md": 18,
81
+ "agents_md": 15,
82
+ "skills": 10,
83
+ "hook_settings_files": 5,
84
+ "notes": "Official Claude Code repo with plugin layout, development kits, and modular commands/agents/hooks.",
85
+ "source": "snapshot"
86
+ },
87
+ {
88
+ "repo": "affaan-m/everything-claude-code",
89
+ "category": "ecosystem-scale",
90
+ "stars": 111863,
91
+ "updated_at": "2026-03-27T16:55:18Z",
92
+ "commands_md": 271,
93
+ "agents_md": 152,
94
+ "skills": 397,
95
+ "hook_settings_files": 2,
96
+ "notes": "Large ecosystem catalog. High inspiration value, high discoverability-debt risk.",
97
+ "source": "snapshot"
98
+ },
99
+ {
100
+ "repo": "ChrisWiles/claude-code-showcase",
101
+ "category": "practical-showcase",
102
+ "stars": 5593,
103
+ "updated_at": "2026-03-27T13:13:35Z",
104
+ "commands_md": 6,
105
+ "agents_md": 2,
106
+ "skills": 6,
107
+ "hook_settings_files": 1,
108
+ "notes": "Practical edit-time hooks, branch safety, formatting, and testing patterns.",
109
+ "source": "snapshot"
110
+ },
111
+ {
112
+ "repo": "disler/claude-code-hooks-mastery",
113
+ "category": "hooks-reference",
114
+ "stars": 3421,
115
+ "updated_at": "2026-03-27T15:49:11Z",
116
+ "commands_md": 21,
117
+ "agents_md": 19,
118
+ "skills": 0,
119
+ "hook_settings_files": 1,
120
+ "notes": "Strong reference for lifecycle breadth, status lines, and operational hook patterns.",
121
+ "source": "snapshot"
122
+ },
123
+ {
124
+ "repo": "codeaholicguy/ai-devkit",
125
+ "category": "cross-tool",
126
+ "stars": 985,
127
+ "updated_at": "2026-03-27T00:00:00Z",
128
+ "commands_md": 0,
129
+ "agents_md": 0,
130
+ "skills": 0,
131
+ "hook_settings_files": 0,
132
+ "notes": "Cross-tool toolkit positioning benchmark.",
133
+ "source": "snapshot"
134
+ },
135
+ {
136
+ "repo": "alirezarezvani/claude-code-skill-factory",
137
+ "category": "meta-tooling",
138
+ "stars": 638,
139
+ "updated_at": "2026-03-27T00:00:00Z",
140
+ "commands_md": 0,
141
+ "agents_md": 0,
142
+ "skills": 0,
143
+ "hook_settings_files": 0,
144
+ "notes": "Skill/agent/prompt factory inspiration for creator workflows.",
145
+ "source": "snapshot"
146
+ }
147
+ ]
148
+ }