tribunal-kit 9.0.0 → 9.0.2

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 (722) hide show
  1. package/.agent/ARCHITECTURE.md +2 -2
  2. package/.agent/agents/backend-specialist.md +1 -1
  3. package/.agent/agents/code-archaeologist.md +1 -1
  4. package/.agent/agents/database-architect.md +1 -1
  5. package/.agent/agents/debugger.md +1 -1
  6. package/.agent/agents/devops-engineer.md +1 -1
  7. package/.agent/agents/documentation-writer.md +1 -1
  8. package/.agent/agents/explorer-agent.md +1 -1
  9. package/.agent/agents/game-developer.md +1 -1
  10. package/.agent/agents/minimalist-reviewer.md +1 -1
  11. package/.agent/agents/mobile-developer.md +1 -1
  12. package/.agent/agents/orchestrator.md +1 -1
  13. package/.agent/agents/penetration-tester.md +1 -1
  14. package/.agent/agents/performance-optimizer.md +1 -1
  15. package/.agent/agents/product-manager.md +1 -1
  16. package/.agent/agents/product-owner.md +1 -1
  17. package/.agent/agents/project-planner.md +1 -1
  18. package/.agent/agents/qa-automation-engineer.md +1 -1
  19. package/.agent/agents/seo-specialist.md +1 -1
  20. package/.agent/agents/test-engineer.md +1 -1
  21. package/.agent/config/slash-commands.json +13 -1
  22. package/.agent/config/system-prompt.md +21 -7
  23. package/.agent/routing_index.json +1546 -268
  24. package/.agent/scripts/browser_audit.js +94 -0
  25. package/.agent/scripts/context_compiler.js +9 -0
  26. package/.agent/scripts/prompt_compiler.js +105 -13
  27. package/.agent/skill_topic_map.json +2 -1
  28. package/.agent/skills/12-principles-of-animation/SKILL.md +63 -25
  29. package/.agent/skills/60fps-animation/SKILL.md +68 -24
  30. package/.agent/skills/accessible-animation/SKILL.md +208 -44
  31. package/.agent/skills/adapt/SKILL.md +63 -25
  32. package/.agent/skills/advanced-rag-pipelines/SKILL.md +65 -25
  33. package/.agent/skills/agent-organizer/SKILL.md +60 -31
  34. package/.agent/skills/agentic-patterns/SKILL.md +60 -31
  35. package/.agent/skills/agentic-workflows-2026/SKILL.md +67 -27
  36. package/.agent/skills/ai-app-hardening/SKILL.md +67 -27
  37. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +59 -31
  38. package/.agent/skills/animation-on-scroll/SKILL.md +187 -51
  39. package/.agent/skills/animation-systems/SKILL.md +230 -40
  40. package/.agent/skills/antfu-conventions/SKILL.md +64 -26
  41. package/.agent/skills/api-patterns/SKILL.md +61 -31
  42. package/.agent/skills/api-security-auditor/SKILL.md +59 -31
  43. package/.agent/skills/app-builder/SKILL.md +61 -31
  44. package/.agent/skills/appflow-wireframe/SKILL.md +62 -33
  45. package/.agent/skills/apple-design/SKILL.md +63 -25
  46. package/.agent/skills/architecture/SKILL.md +61 -31
  47. package/.agent/skills/audit-and-fix/SKILL.md +63 -25
  48. package/.agent/skills/authentication-best-practices/SKILL.md +59 -31
  49. package/.agent/skills/backend-security-expert/SKILL.md +61 -31
  50. package/.agent/skills/baseline-ui/SKILL.md +63 -25
  51. package/.agent/skills/bash-linux/SKILL.md +59 -31
  52. package/.agent/skills/behavioral-modes/SKILL.md +60 -31
  53. package/.agent/skills/better-colors/SKILL.md +63 -25
  54. package/.agent/skills/better-typography/SKILL.md +63 -36
  55. package/.agent/skills/better-ui/SKILL.md +64 -24
  56. package/.agent/skills/bolder/SKILL.md +63 -25
  57. package/.agent/skills/brainstorming/SKILL.md +61 -31
  58. package/.agent/skills/browser-audit/SKILL.md +170 -0
  59. package/.agent/skills/browser-native-ai/SKILL.md +64 -26
  60. package/.agent/skills/build-primitive/SKILL.md +63 -25
  61. package/.agent/skills/building-native-ui/SKILL.md +59 -31
  62. package/.agent/skills/cicd-pro/SKILL.md +65 -25
  63. package/.agent/skills/clarify/SKILL.md +63 -25
  64. package/.agent/skills/clean-code/SKILL.md +59 -31
  65. package/.agent/skills/cloud-architect/SKILL.md +65 -25
  66. package/.agent/skills/cobejs/SKILL.md +63 -25
  67. package/.agent/skills/code-review-checklist/SKILL.md +59 -31
  68. package/.agent/skills/codebase-design/SKILL.md +65 -25
  69. package/.agent/skills/colorize/SKILL.md +63 -25
  70. package/.agent/skills/compact-landing/SKILL.md +63 -25
  71. package/.agent/skills/company-logos/SKILL.md +63 -25
  72. package/.agent/skills/config-validator/SKILL.md +59 -31
  73. package/.agent/skills/containerization-pro/SKILL.md +65 -25
  74. package/.agent/skills/context-engineering-pro/SKILL.md +67 -27
  75. package/.agent/skills/create-design-md/SKILL.md +63 -25
  76. package/.agent/skills/critique/SKILL.md +64 -25
  77. package/.agent/skills/csharp-developer/SKILL.md +59 -31
  78. package/.agent/skills/data-validation-schemas/SKILL.md +59 -31
  79. package/.agent/skills/database-design/SKILL.md +61 -31
  80. package/.agent/skills/delight/SKILL.md +63 -25
  81. package/.agent/skills/deployment-procedures/SKILL.md +59 -31
  82. package/.agent/skills/design-lab/SKILL.md +65 -26
  83. package/.agent/skills/devops-engineer/SKILL.md +59 -31
  84. package/.agent/skills/devops-incident-responder/SKILL.md +59 -31
  85. package/.agent/skills/diagnosing-bugs/SKILL.md +64 -27
  86. package/.agent/skills/distill/SKILL.md +63 -25
  87. package/.agent/skills/documentation-templates/SKILL.md +59 -31
  88. package/.agent/skills/domain-modeling/SKILL.md +64 -26
  89. package/.agent/skills/duckdb-analytical-sql/SKILL.md +66 -26
  90. package/.agent/skills/edge-ai-mobile/SKILL.md +66 -26
  91. package/.agent/skills/edge-computing/SKILL.md +59 -31
  92. package/.agent/skills/emil-design-eng/SKILL.md +64 -24
  93. package/.agent/skills/error-resilience/SKILL.md +59 -31
  94. package/.agent/skills/expo-router-v4/SKILL.md +65 -26
  95. package/.agent/skills/extract-design-system/SKILL.md +59 -31
  96. package/.agent/skills/fabel-protocol/SKILL.md +64 -25
  97. package/.agent/skills/fixing-accessibility/SKILL.md +63 -25
  98. package/.agent/skills/fixing-metadata/SKILL.md +63 -25
  99. package/.agent/skills/fixing-motion-performance/SKILL.md +63 -25
  100. package/.agent/skills/framer-motion-expert/SKILL.md +68 -30
  101. package/.agent/skills/frontend-design/SKILL.md +63 -25
  102. package/.agent/skills/frontend-security-expert/SKILL.md +61 -31
  103. package/.agent/skills/game-design-expert/SKILL.md +59 -31
  104. package/.agent/skills/game-engineering-expert/SKILL.md +59 -31
  105. package/.agent/skills/generative-ui-expert/SKILL.md +64 -26
  106. package/.agent/skills/geo-fundamentals/SKILL.md +59 -31
  107. package/.agent/skills/git-pro/SKILL.md +65 -25
  108. package/.agent/skills/github-operations/SKILL.md +59 -31
  109. package/.agent/skills/gpt-taste/SKILL.md +63 -25
  110. package/.agent/skills/gsap-core/SKILL.md +65 -25
  111. package/.agent/skills/gsap-frameworks/SKILL.md +65 -25
  112. package/.agent/skills/gsap-performance/SKILL.md +65 -25
  113. package/.agent/skills/gsap-plugins/SKILL.md +65 -25
  114. package/.agent/skills/gsap-react/SKILL.md +65 -25
  115. package/.agent/skills/gsap-scrolltrigger/SKILL.md +65 -25
  116. package/.agent/skills/gsap-timeline/SKILL.md +65 -25
  117. package/.agent/skills/gsap-utils/SKILL.md +65 -25
  118. package/.agent/skills/harden/SKILL.md +63 -25
  119. package/.agent/skills/harness-protocol/SKILL.md +64 -25
  120. package/.agent/skills/i18n-localization/SKILL.md +59 -31
  121. package/.agent/skills/impeccable/SKILL.md +63 -25
  122. package/.agent/skills/improve-codebase-architecture/SKILL.md +64 -26
  123. package/.agent/skills/improve-ui/SKILL.md +63 -25
  124. package/.agent/skills/intelligent-routing/SKILL.md +63 -23
  125. package/.agent/skills/knowledge-graph/SKILL.md +64 -25
  126. package/.agent/skills/landing-page/SKILL.md +63 -25
  127. package/.agent/skills/lint-and-validate/SKILL.md +59 -31
  128. package/.agent/skills/llm-engineering/SKILL.md +59 -31
  129. package/.agent/skills/local-first/SKILL.md +59 -31
  130. package/.agent/skills/local-first-architecture/SKILL.md +64 -24
  131. package/.agent/skills/lottie-animation/SKILL.md +63 -25
  132. package/.agent/skills/marquee-loop/SKILL.md +63 -25
  133. package/.agent/skills/masked-reveal/SKILL.md +246 -55
  134. package/.agent/skills/mcp-builder/SKILL.md +59 -31
  135. package/.agent/skills/micro-interaction/SKILL.md +255 -61
  136. package/.agent/skills/mobile-design/SKILL.md +61 -31
  137. package/.agent/skills/monorepo-management/SKILL.md +59 -31
  138. package/.agent/skills/morphing-icons/SKILL.md +366 -51
  139. package/.agent/skills/motion-engineering/SKILL.md +64 -26
  140. package/.agent/skills/nextjs-react-expert/SKILL.md +61 -31
  141. package/.agent/skills/nodejs-best-practices/SKILL.md +59 -31
  142. package/.agent/skills/observability/SKILL.md +59 -31
  143. package/.agent/skills/opentelemetry-observability/SKILL.md +66 -26
  144. package/.agent/skills/page-transition-animation/SKILL.md +63 -25
  145. package/.agent/skills/parallel-agents/SKILL.md +60 -31
  146. package/.agent/skills/performance-profiling/SKILL.md +60 -31
  147. package/.agent/skills/plan-writing/SKILL.md +59 -31
  148. package/.agent/skills/platform-engineer/SKILL.md +59 -31
  149. package/.agent/skills/platform-engineering-opentofu/SKILL.md +66 -27
  150. package/.agent/skills/playwright-ai-e2e/SKILL.md +67 -27
  151. package/.agent/skills/playwright-best-practices/SKILL.md +60 -31
  152. package/.agent/skills/polish/SKILL.md +63 -25
  153. package/.agent/skills/powershell-windows/SKILL.md +59 -31
  154. package/.agent/skills/pricing-page/SKILL.md +63 -25
  155. package/.agent/skills/product-aware-heuristics/SKILL.md +63 -25
  156. package/.agent/skills/progressive-blur/SKILL.md +63 -25
  157. package/.agent/skills/project-idioms/SKILL.md +60 -36
  158. package/.agent/skills/property-based-testing/SKILL.md +67 -27
  159. package/.agent/skills/python-patterns/SKILL.md +59 -31
  160. package/.agent/skills/python-pro/SKILL.md +61 -31
  161. package/.agent/skills/quieter/SKILL.md +63 -25
  162. package/.agent/skills/react-doctor/SKILL.md +63 -25
  163. package/.agent/skills/react-specialist/SKILL.md +61 -31
  164. package/.agent/skills/readme-builder/SKILL.md +59 -31
  165. package/.agent/skills/realtime-patterns/SKILL.md +59 -31
  166. package/.agent/skills/red-team-tactics/SKILL.md +59 -31
  167. package/.agent/skills/redesign-skill/SKILL.md +63 -25
  168. package/.agent/skills/review-animations/SKILL.md +64 -26
  169. package/.agent/skills/rust-pro/SKILL.md +61 -31
  170. package/.agent/skills/seo-fundamentals/SKILL.md +59 -31
  171. package/.agent/skills/server-management/SKILL.md +59 -31
  172. package/.agent/skills/shadcn-ui-expert/SKILL.md +59 -31
  173. package/.agent/skills/shape/SKILL.md +64 -25
  174. package/.agent/skills/skill-creator/SKILL.md +66 -24
  175. package/.agent/skills/soft-skill/SKILL.md +63 -25
  176. package/.agent/skills/sounds-on-the-web/SKILL.md +63 -25
  177. package/.agent/skills/sql-pro/SKILL.md +59 -31
  178. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +59 -31
  179. package/.agent/skills/svg-animation/SKILL.md +369 -51
  180. package/.agent/skills/swiftui-expert/SKILL.md +59 -31
  181. package/.agent/skills/swiss-design/SKILL.md +63 -25
  182. package/.agent/skills/system-design-pro/SKILL.md +65 -25
  183. package/.agent/skills/systematic-debugging/SKILL.md +60 -31
  184. package/.agent/skills/tailwind-patterns/SKILL.md +59 -31
  185. package/.agent/skills/taste-skill/SKILL.md +63 -25
  186. package/.agent/skills/tdd-workflow/SKILL.md +66 -25
  187. package/.agent/skills/test-result-analyzer/SKILL.md +59 -32
  188. package/.agent/skills/testing-patterns/SKILL.md +60 -31
  189. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +64 -26
  190. package/.agent/skills/thinking-protocol/SKILL.md +58 -34
  191. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +63 -25
  192. package/.agent/skills/transitions-dev/SKILL.md +63 -25
  193. package/.agent/skills/trend-researcher/SKILL.md +58 -32
  194. package/.agent/skills/typescript-advanced/SKILL.md +59 -32
  195. package/.agent/skills/typeset/SKILL.md +63 -25
  196. package/.agent/skills/ui-reasoning-engine/SKILL.md +63 -25
  197. package/.agent/skills/ui-skill-packs/SKILL.md +64 -24
  198. package/.agent/skills/ui-skills-root/SKILL.md +63 -25
  199. package/.agent/skills/ui-ux-pro-max/SKILL.md +64 -24
  200. package/.agent/skills/ui-ux-researcher/SKILL.md +58 -32
  201. package/.agent/skills/vector-search-pgvector/SKILL.md +66 -26
  202. package/.agent/skills/verification-before-completion/SKILL.md +69 -16
  203. package/.agent/skills/vue-expert/SKILL.md +61 -31
  204. package/.agent/skills/vulnerability-scanner/SKILL.md +61 -31
  205. package/.agent/skills/web-accessibility-auditor/SKILL.md +59 -31
  206. package/.agent/skills/web-design-guidelines/SKILL.md +63 -25
  207. package/.agent/skills/web-quality-audit/SKILL.md +63 -25
  208. package/.agent/skills/webapp-testing/SKILL.md +60 -31
  209. package/.agent/skills/webgpu-performance/SKILL.md +64 -26
  210. package/.agent/skills/whimsy-injector/SKILL.md +58 -32
  211. package/.agent/skills/workflow-optimizer/SKILL.md +58 -31
  212. package/.agent/skills/zero-trust-passkeys/SKILL.md +66 -26
  213. package/.agent/templates/sdd/implementer-prompt.md +10 -1
  214. package/.agent/templates/sdd/re-review-prompt.md +9 -1
  215. package/.agent/templates/sdd/task-reviewer-prompt.md +20 -1
  216. package/.agent/workflows/audit-live.md +52 -0
  217. package/.agent/workflows/compare-web.md +35 -0
  218. package/.agent/workflows/context.md +100 -0
  219. package/.agent/workflows/plan.md +1 -1
  220. package/.agent/workflows/skill-enhancement-engine.md +88 -0
  221. package/.agent/workflows/super-prompt.md +101 -21
  222. package/.agents/skills/12-principles-of-animation/SKILL.md +126 -0
  223. package/.agents/skills/60fps-animation/SKILL.md +164 -0
  224. package/.agents/skills/accessible-animation/SKILL.md +266 -0
  225. package/.agents/skills/adapt/SKILL.md +131 -0
  226. package/.agents/skills/advanced-rag-pipelines/SKILL.md +169 -0
  227. package/.agents/skills/agent-organizer/SKILL.md +192 -0
  228. package/.agents/skills/agentic-patterns/SKILL.md +356 -0
  229. package/.agents/skills/agentic-workflows-2026/SKILL.md +157 -0
  230. package/.agents/skills/ai-app-hardening/SKILL.md +125 -0
  231. package/.agents/skills/ai-prompt-injection-defense/SKILL.md +237 -0
  232. package/.agents/skills/animation-on-scroll/SKILL.md +267 -0
  233. package/.agents/skills/animation-systems/SKILL.md +273 -0
  234. package/.agents/skills/antfu-conventions/SKILL.md +129 -0
  235. package/.agents/skills/api-patterns/SKILL.md +293 -0
  236. package/.agents/skills/api-patterns/scripts/api_validator.py +211 -0
  237. package/.agents/skills/api-security-auditor/SKILL.md +230 -0
  238. package/.agents/skills/app-builder/SKILL.md +610 -0
  239. package/.agents/skills/app-builder/templates/SKILL.md +108 -0
  240. package/.agents/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
  241. package/.agents/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
  242. package/.agents/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
  243. package/.agents/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
  244. package/.agents/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
  245. package/.agents/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
  246. package/.agents/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
  247. package/.agents/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -0
  248. package/.agents/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -0
  249. package/.agents/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -0
  250. package/.agents/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -0
  251. package/.agents/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
  252. package/.agents/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -0
  253. package/.agents/skills/appflow-wireframe/SKILL.md +173 -0
  254. package/.agents/skills/apple-design/SKILL.md +164 -0
  255. package/.agents/skills/architecture/SKILL.md +263 -0
  256. package/.agents/skills/audit-and-fix/SKILL.md +136 -0
  257. package/.agents/skills/authentication-best-practices/SKILL.md +232 -0
  258. package/.agents/skills/backend-security-expert/SKILL.md +148 -0
  259. package/.agents/skills/baseline-ui/SKILL.md +130 -0
  260. package/.agents/skills/bash-linux/SKILL.md +214 -0
  261. package/.agents/skills/behavioral-modes/SKILL.md +275 -0
  262. package/.agents/skills/better-colors/SKILL.md +191 -0
  263. package/.agents/skills/better-typography/SKILL.md +164 -0
  264. package/.agents/skills/better-ui/SKILL.md +193 -0
  265. package/.agents/skills/bolder/SKILL.md +124 -0
  266. package/.agents/skills/brainstorming/SKILL.md +534 -0
  267. package/.agents/skills/browser-audit/SKILL.md +170 -0
  268. package/.agents/skills/browser-native-ai/SKILL.md +147 -0
  269. package/.agents/skills/build-primitive/SKILL.md +125 -0
  270. package/.agents/skills/building-native-ui/SKILL.md +237 -0
  271. package/.agents/skills/cicd-pro/SKILL.md +487 -0
  272. package/.agents/skills/clarify/SKILL.md +130 -0
  273. package/.agents/skills/clean-code/SKILL.md +442 -0
  274. package/.agents/skills/cloud-architect/SKILL.md +484 -0
  275. package/.agents/skills/cobejs/SKILL.md +145 -0
  276. package/.agents/skills/code-review-checklist/SKILL.md +238 -0
  277. package/.agents/skills/codebase-design/SKILL.md +151 -0
  278. package/.agents/skills/colorize/SKILL.md +132 -0
  279. package/.agents/skills/compact-landing/SKILL.md +125 -0
  280. package/.agents/skills/company-logos/SKILL.md +129 -0
  281. package/.agents/skills/config-validator/SKILL.md +200 -0
  282. package/.agents/skills/containerization-pro/SKILL.md +497 -0
  283. package/.agents/skills/context-engineering-pro/SKILL.md +136 -0
  284. package/.agents/skills/create-design-md/SKILL.md +167 -0
  285. package/.agents/skills/critique/SKILL.md +154 -0
  286. package/.agents/skills/csharp-developer/SKILL.md +553 -0
  287. package/.agents/skills/data-validation-schemas/SKILL.md +372 -0
  288. package/.agents/skills/database-design/SKILL.md +294 -0
  289. package/.agents/skills/database-design/scripts/schema_validator.py +172 -0
  290. package/.agents/skills/delight/SKILL.md +121 -0
  291. package/.agents/skills/deployment-procedures/SKILL.md +207 -0
  292. package/.agents/skills/design-lab/SKILL.md +117 -0
  293. package/.agents/skills/devops-engineer/SKILL.md +380 -0
  294. package/.agents/skills/devops-incident-responder/SKILL.md +178 -0
  295. package/.agents/skills/diagnosing-bugs/SKILL.md +247 -0
  296. package/.agents/skills/distill/SKILL.md +120 -0
  297. package/.agents/skills/documentation-templates/SKILL.md +326 -0
  298. package/.agents/skills/domain-modeling/SKILL.md +136 -0
  299. package/.agents/skills/duckdb-analytical-sql/SKILL.md +125 -0
  300. package/.agents/skills/edge-ai-mobile/SKILL.md +116 -0
  301. package/.agents/skills/edge-computing/SKILL.md +218 -0
  302. package/.agents/skills/emil-design-eng/SKILL.md +209 -0
  303. package/.agents/skills/error-resilience/SKILL.md +478 -0
  304. package/.agents/skills/expo-router-v4/SKILL.md +146 -0
  305. package/.agents/skills/extract-design-system/SKILL.md +195 -0
  306. package/.agents/skills/fabel-protocol/SKILL.md +352 -0
  307. package/.agents/skills/fixing-accessibility/SKILL.md +162 -0
  308. package/.agents/skills/fixing-metadata/SKILL.md +158 -0
  309. package/.agents/skills/fixing-motion-performance/SKILL.md +153 -0
  310. package/.agents/skills/framer-motion-expert/SKILL.md +312 -0
  311. package/.agents/skills/frontend-design/SKILL.md +178 -0
  312. package/.agents/skills/frontend-design/scripts/accessibility_checker.py +183 -0
  313. package/.agents/skills/frontend-design/scripts/ux_audit.py +722 -0
  314. package/.agents/skills/frontend-security-expert/SKILL.md +131 -0
  315. package/.agents/skills/game-design-expert/SKILL.md +167 -0
  316. package/.agents/skills/game-engineering-expert/SKILL.md +183 -0
  317. package/.agents/skills/generative-ui-expert/SKILL.md +175 -0
  318. package/.agents/skills/geo-fundamentals/SKILL.md +183 -0
  319. package/.agents/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
  320. package/.agents/skills/git-pro/SKILL.md +476 -0
  321. package/.agents/skills/github-operations/SKILL.md +370 -0
  322. package/.agents/skills/gpt-taste/SKILL.md +125 -0
  323. package/.agents/skills/gsap-core/SKILL.md +352 -0
  324. package/.agents/skills/gsap-frameworks/SKILL.md +243 -0
  325. package/.agents/skills/gsap-performance/SKILL.md +169 -0
  326. package/.agents/skills/gsap-plugins/SKILL.md +516 -0
  327. package/.agents/skills/gsap-react/SKILL.md +288 -0
  328. package/.agents/skills/gsap-scrolltrigger/SKILL.md +387 -0
  329. package/.agents/skills/gsap-timeline/SKILL.md +197 -0
  330. package/.agents/skills/gsap-utils/SKILL.md +374 -0
  331. package/.agents/skills/harden/SKILL.md +130 -0
  332. package/.agents/skills/harness-protocol/SKILL.md +115 -0
  333. package/.agents/skills/i18n-localization/SKILL.md +209 -0
  334. package/.agents/skills/i18n-localization/scripts/i18n_checker.py +241 -0
  335. package/.agents/skills/impeccable/SKILL.md +127 -0
  336. package/.agents/skills/improve-codebase-architecture/SKILL.md +123 -0
  337. package/.agents/skills/improve-ui/SKILL.md +145 -0
  338. package/.agents/skills/intelligent-routing/SKILL.md +283 -0
  339. package/.agents/skills/knowledge-graph/SKILL.md +146 -0
  340. package/.agents/skills/landing-page/SKILL.md +140 -0
  341. package/.agents/skills/lint-and-validate/SKILL.md +299 -0
  342. package/.agents/skills/lint-and-validate/scripts/lint_runner.py +184 -0
  343. package/.agents/skills/lint-and-validate/scripts/type_coverage.py +173 -0
  344. package/.agents/skills/llm-engineering/SKILL.md +435 -0
  345. package/.agents/skills/local-first/SKILL.md +213 -0
  346. package/.agents/skills/local-first-architecture/SKILL.md +137 -0
  347. package/.agents/skills/lottie-animation/SKILL.md +137 -0
  348. package/.agents/skills/marquee-loop/SKILL.md +147 -0
  349. package/.agents/skills/masked-reveal/SKILL.md +305 -0
  350. package/.agents/skills/mcp-builder/SKILL.md +180 -0
  351. package/.agents/skills/micro-interaction/SKILL.md +321 -0
  352. package/.agents/skills/mobile-design/SKILL.md +320 -0
  353. package/.agents/skills/mobile-design/scripts/mobile_audit.py +670 -0
  354. package/.agents/skills/monorepo-management/SKILL.md +370 -0
  355. package/.agents/skills/morphing-icons/SKILL.md +423 -0
  356. package/.agents/skills/motion-engineering/SKILL.md +272 -0
  357. package/.agents/skills/nextjs-react-expert/SKILL.md +293 -0
  358. package/.agents/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
  359. package/.agents/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
  360. package/.agents/skills/nodejs-best-practices/SKILL.md +617 -0
  361. package/.agents/skills/observability/SKILL.md +378 -0
  362. package/.agents/skills/opentelemetry-observability/SKILL.md +125 -0
  363. package/.agents/skills/page-transition-animation/SKILL.md +161 -0
  364. package/.agents/skills/parallel-agents/SKILL.md +185 -0
  365. package/.agents/skills/performance-profiling/SKILL.md +305 -0
  366. package/.agents/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
  367. package/.agents/skills/plan-writing/SKILL.md +202 -0
  368. package/.agents/skills/platform-engineer/SKILL.md +183 -0
  369. package/.agents/skills/platform-engineering-opentofu/SKILL.md +133 -0
  370. package/.agents/skills/playwright-ai-e2e/SKILL.md +126 -0
  371. package/.agents/skills/playwright-best-practices/SKILL.md +224 -0
  372. package/.agents/skills/polish/SKILL.md +114 -0
  373. package/.agents/skills/powershell-windows/SKILL.md +197 -0
  374. package/.agents/skills/pricing-page/SKILL.md +123 -0
  375. package/.agents/skills/product-aware-heuristics/SKILL.md +465 -0
  376. package/.agents/skills/progressive-blur/SKILL.md +155 -0
  377. package/.agents/skills/project-idioms/SKILL.md +166 -0
  378. package/.agents/skills/property-based-testing/SKILL.md +124 -0
  379. package/.agents/skills/python-patterns/SKILL.md +295 -0
  380. package/.agents/skills/python-pro/SKILL.md +380 -0
  381. package/.agents/skills/quieter/SKILL.md +124 -0
  382. package/.agents/skills/react-doctor/SKILL.md +126 -0
  383. package/.agents/skills/react-specialist/SKILL.md +355 -0
  384. package/.agents/skills/readme-builder/SKILL.md +345 -0
  385. package/.agents/skills/realtime-patterns/SKILL.md +358 -0
  386. package/.agents/skills/red-team-tactics/SKILL.md +266 -0
  387. package/.agents/skills/redesign-skill/SKILL.md +121 -0
  388. package/.agents/skills/review-animations/SKILL.md +120 -0
  389. package/.agents/skills/review-animations/STANDARDS.md +87 -0
  390. package/.agents/skills/rust-pro/SKILL.md +727 -0
  391. package/.agents/skills/seo-fundamentals/SKILL.md +214 -0
  392. package/.agents/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
  393. package/.agents/skills/server-management/SKILL.md +253 -0
  394. package/.agents/skills/shadcn-ui-expert/SKILL.md +271 -0
  395. package/.agents/skills/shape/SKILL.md +131 -0
  396. package/.agents/skills/skill-creator/SKILL.md +136 -0
  397. package/.agents/skills/soft-skill/SKILL.md +128 -0
  398. package/.agents/skills/sounds-on-the-web/SKILL.md +151 -0
  399. package/.agents/skills/sql-pro/SKILL.md +699 -0
  400. package/.agents/skills/supabase-postgres-best-practices/SKILL.md +132 -0
  401. package/.agents/skills/svg-animation/SKILL.md +431 -0
  402. package/.agents/skills/swiftui-expert/SKILL.md +239 -0
  403. package/.agents/skills/swiss-design/SKILL.md +119 -0
  404. package/.agents/skills/system-design-pro/SKILL.md +393 -0
  405. package/.agents/skills/systematic-debugging/SKILL.md +198 -0
  406. package/.agents/skills/systematic-debugging/condition-based-waiting.md +115 -0
  407. package/.agents/skills/systematic-debugging/defense-in-depth.md +122 -0
  408. package/.agents/skills/systematic-debugging/root-cause-tracing.md +169 -0
  409. package/.agents/skills/tailwind-patterns/SKILL.md +658 -0
  410. package/.agents/skills/taste-skill/SKILL.md +127 -0
  411. package/.agents/skills/tdd-workflow/SKILL.md +179 -0
  412. package/.agents/skills/test-result-analyzer/SKILL.md +345 -0
  413. package/.agents/skills/testing-patterns/SKILL.md +609 -0
  414. package/.agents/skills/testing-patterns/scripts/test_runner.py +219 -0
  415. package/.agents/skills/thermo-nuclear-code-quality-review/SKILL.md +137 -0
  416. package/.agents/skills/thinking-protocol/SKILL.md +97 -0
  417. package/.agents/skills/to-spring-or-not-to-spring/SKILL.md +118 -0
  418. package/.agents/skills/transitions-dev/SKILL.md +165 -0
  419. package/.agents/skills/trend-researcher/SKILL.md +273 -0
  420. package/.agents/skills/typescript-advanced/SKILL.md +381 -0
  421. package/.agents/skills/typeset/SKILL.md +135 -0
  422. package/.agents/skills/ui-reasoning-engine/SKILL.md +230 -0
  423. package/.agents/skills/ui-skill-packs/SKILL.md +132 -0
  424. package/.agents/skills/ui-skills-root/SKILL.md +144 -0
  425. package/.agents/skills/ui-ux-pro-max/SKILL.md +185 -0
  426. package/.agents/skills/ui-ux-researcher/SKILL.md +274 -0
  427. package/.agents/skills/vector-search-pgvector/SKILL.md +144 -0
  428. package/.agents/skills/verification-before-completion/SKILL.md +178 -0
  429. package/.agents/skills/vue-expert/SKILL.md +334 -0
  430. package/.agents/skills/vulnerability-scanner/SKILL.md +453 -0
  431. package/.agents/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
  432. package/.agents/skills/web-accessibility-auditor/SKILL.md +254 -0
  433. package/.agents/skills/web-design-guidelines/SKILL.md +124 -0
  434. package/.agents/skills/web-quality-audit/SKILL.md +122 -0
  435. package/.agents/skills/webapp-testing/SKILL.md +203 -0
  436. package/.agents/skills/webapp-testing/scripts/playwright_runner.py +173 -0
  437. package/.agents/skills/webgpu-performance/SKILL.md +163 -0
  438. package/.agents/skills/whimsy-injector/SKILL.md +380 -0
  439. package/.agents/skills/workflow-optimizer/SKILL.md +263 -0
  440. package/.agents/skills/zero-trust-passkeys/SKILL.md +156 -0
  441. package/.claude-plugin/marketplace.json +1 -4
  442. package/.hermes-plugin/plugin.yaml +1 -1
  443. package/.kimi-plugin/plugin.json +6 -6
  444. package/.opencode/INSTALL.md +2 -2
  445. package/.opencode/rules.md +258 -0
  446. package/AGENTS.md +91 -0
  447. package/CLAUDE.md +442 -0
  448. package/CONTRIBUTING.md +1 -1
  449. package/README.md +66 -69
  450. package/bin/adapter-install.js +40 -16
  451. package/bin/mcp-server.js +426 -0
  452. package/bin/proxy-server.js +18 -9
  453. package/bin/spawn-agent.js +9 -3
  454. package/bin/wrapper.js +19 -4
  455. package/dist/browser/audit.js +229 -0
  456. package/dist/browser/case_bridge.js +189 -0
  457. package/dist/browser/cdp.js +513 -0
  458. package/dist/browser/compare.js +110 -0
  459. package/dist/browser/discovery.js +140 -0
  460. package/dist/browser/idpi.js +142 -0
  461. package/dist/browser/index.js +89 -0
  462. package/dist/browser/launcher.js +154 -0
  463. package/dist/browser/sentinel.js +202 -0
  464. package/dist/browser/synapse.js +251 -0
  465. package/dist/browser/trimmer.js +210 -0
  466. package/dist/cli.js +70 -48
  467. package/dist/commands/audit-web.js +112 -0
  468. package/dist/commands/browse.js +56 -0
  469. package/dist/commands/compare-web.js +61 -0
  470. package/dist/commands/deconstruct.js +58 -0
  471. package/dist/commands/heal.js +99 -0
  472. package/dist/commands/init.js +10 -1
  473. package/dist/commands/sdd.js +229 -0
  474. package/dist/commands/uninstall.js +12 -0
  475. package/dist/tui/banner.js +1 -1
  476. package/gemini-extension.json +1 -1
  477. package/hooks/hooks-cursor.json +2 -8
  478. package/hooks/hooks.json +2 -8
  479. package/marketplace.json +14 -0
  480. package/package.json +176 -165
  481. package/plugin.json +26 -0
  482. package/scripts/apply-version.js +57 -0
  483. package/scripts/clean-pycache.js +42 -0
  484. package/scripts/context_compiler.js +944 -0
  485. package/scripts/package-cores.js +113 -0
  486. package/scripts/skill_enhancement_engine.js +473 -0
  487. package/scripts/sync-skills.js +61 -0
  488. package/skills/12-principles-of-animation/SKILL.md +126 -0
  489. package/skills/60fps-animation/SKILL.md +164 -0
  490. package/skills/accessible-animation/SKILL.md +266 -0
  491. package/skills/adapt/SKILL.md +131 -0
  492. package/skills/advanced-rag-pipelines/SKILL.md +169 -0
  493. package/skills/agent-organizer/SKILL.md +192 -0
  494. package/skills/agentic-patterns/SKILL.md +356 -0
  495. package/skills/agentic-workflows-2026/SKILL.md +157 -0
  496. package/skills/ai-app-hardening/SKILL.md +125 -0
  497. package/skills/ai-prompt-injection-defense/SKILL.md +237 -0
  498. package/skills/animation-on-scroll/SKILL.md +267 -0
  499. package/skills/animation-systems/SKILL.md +273 -0
  500. package/skills/antfu-conventions/SKILL.md +129 -0
  501. package/skills/api-patterns/SKILL.md +293 -0
  502. package/skills/api-patterns/scripts/api_validator.py +211 -0
  503. package/skills/api-security-auditor/SKILL.md +230 -0
  504. package/skills/app-builder/SKILL.md +610 -0
  505. package/skills/app-builder/templates/SKILL.md +108 -0
  506. package/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
  507. package/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
  508. package/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
  509. package/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
  510. package/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
  511. package/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
  512. package/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
  513. package/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -0
  514. package/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -0
  515. package/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -0
  516. package/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -0
  517. package/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
  518. package/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -0
  519. package/skills/appflow-wireframe/SKILL.md +173 -0
  520. package/skills/apple-design/SKILL.md +164 -0
  521. package/skills/architecture/SKILL.md +263 -0
  522. package/skills/audit-and-fix/SKILL.md +136 -0
  523. package/skills/authentication-best-practices/SKILL.md +232 -0
  524. package/skills/backend-security-expert/SKILL.md +148 -0
  525. package/skills/baseline-ui/SKILL.md +130 -0
  526. package/skills/bash-linux/SKILL.md +214 -0
  527. package/skills/behavioral-modes/SKILL.md +275 -0
  528. package/skills/better-colors/SKILL.md +191 -0
  529. package/skills/better-typography/SKILL.md +164 -0
  530. package/skills/better-ui/SKILL.md +193 -0
  531. package/skills/bolder/SKILL.md +124 -0
  532. package/skills/brainstorming/SKILL.md +534 -0
  533. package/skills/browser-audit/SKILL.md +170 -0
  534. package/skills/browser-native-ai/SKILL.md +147 -0
  535. package/skills/build-primitive/SKILL.md +125 -0
  536. package/skills/building-native-ui/SKILL.md +237 -0
  537. package/skills/cicd-pro/SKILL.md +487 -0
  538. package/skills/clarify/SKILL.md +130 -0
  539. package/skills/clean-code/SKILL.md +442 -0
  540. package/skills/cloud-architect/SKILL.md +484 -0
  541. package/skills/cobejs/SKILL.md +145 -0
  542. package/skills/code-review-checklist/SKILL.md +238 -0
  543. package/skills/codebase-design/SKILL.md +151 -0
  544. package/skills/colorize/SKILL.md +132 -0
  545. package/skills/compact-landing/SKILL.md +125 -0
  546. package/skills/company-logos/SKILL.md +129 -0
  547. package/skills/config-validator/SKILL.md +200 -0
  548. package/skills/containerization-pro/SKILL.md +497 -0
  549. package/skills/context-engineering-pro/SKILL.md +136 -0
  550. package/skills/create-design-md/SKILL.md +167 -0
  551. package/skills/critique/SKILL.md +154 -0
  552. package/skills/csharp-developer/SKILL.md +553 -0
  553. package/skills/data-validation-schemas/SKILL.md +372 -0
  554. package/skills/database-design/SKILL.md +294 -0
  555. package/skills/database-design/scripts/schema_validator.py +172 -0
  556. package/skills/delight/SKILL.md +121 -0
  557. package/skills/deployment-procedures/SKILL.md +207 -0
  558. package/skills/design-lab/SKILL.md +117 -0
  559. package/skills/devops-engineer/SKILL.md +380 -0
  560. package/skills/devops-incident-responder/SKILL.md +178 -0
  561. package/skills/diagnosing-bugs/SKILL.md +247 -0
  562. package/skills/distill/SKILL.md +120 -0
  563. package/skills/documentation-templates/SKILL.md +326 -0
  564. package/skills/domain-modeling/SKILL.md +136 -0
  565. package/skills/duckdb-analytical-sql/SKILL.md +125 -0
  566. package/skills/edge-ai-mobile/SKILL.md +116 -0
  567. package/skills/edge-computing/SKILL.md +218 -0
  568. package/skills/emil-design-eng/SKILL.md +209 -0
  569. package/skills/error-resilience/SKILL.md +478 -0
  570. package/skills/expo-router-v4/SKILL.md +146 -0
  571. package/skills/extract-design-system/SKILL.md +195 -0
  572. package/skills/fabel-protocol/SKILL.md +352 -0
  573. package/skills/fixing-accessibility/SKILL.md +162 -0
  574. package/skills/fixing-metadata/SKILL.md +158 -0
  575. package/skills/fixing-motion-performance/SKILL.md +153 -0
  576. package/skills/framer-motion-expert/SKILL.md +312 -0
  577. package/skills/frontend-design/SKILL.md +178 -0
  578. package/skills/frontend-design/scripts/accessibility_checker.py +183 -0
  579. package/skills/frontend-design/scripts/ux_audit.py +722 -0
  580. package/skills/frontend-security-expert/SKILL.md +131 -0
  581. package/skills/game-design-expert/SKILL.md +167 -0
  582. package/skills/game-engineering-expert/SKILL.md +183 -0
  583. package/skills/generative-ui-expert/SKILL.md +175 -0
  584. package/skills/geo-fundamentals/SKILL.md +183 -0
  585. package/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
  586. package/skills/git-pro/SKILL.md +476 -0
  587. package/skills/github-operations/SKILL.md +370 -0
  588. package/skills/gpt-taste/SKILL.md +125 -0
  589. package/skills/gsap-core/SKILL.md +352 -0
  590. package/skills/gsap-frameworks/SKILL.md +243 -0
  591. package/skills/gsap-performance/SKILL.md +169 -0
  592. package/skills/gsap-plugins/SKILL.md +516 -0
  593. package/skills/gsap-react/SKILL.md +288 -0
  594. package/skills/gsap-scrolltrigger/SKILL.md +387 -0
  595. package/skills/gsap-timeline/SKILL.md +197 -0
  596. package/skills/gsap-utils/SKILL.md +374 -0
  597. package/skills/harden/SKILL.md +130 -0
  598. package/skills/harness-protocol/SKILL.md +115 -0
  599. package/skills/i18n-localization/SKILL.md +209 -0
  600. package/skills/i18n-localization/scripts/i18n_checker.py +241 -0
  601. package/skills/impeccable/SKILL.md +127 -0
  602. package/skills/improve-codebase-architecture/SKILL.md +123 -0
  603. package/skills/improve-ui/SKILL.md +145 -0
  604. package/skills/intelligent-routing/SKILL.md +283 -0
  605. package/skills/knowledge-graph/SKILL.md +146 -0
  606. package/skills/landing-page/SKILL.md +140 -0
  607. package/skills/lint-and-validate/SKILL.md +299 -0
  608. package/skills/lint-and-validate/scripts/lint_runner.py +184 -0
  609. package/skills/lint-and-validate/scripts/type_coverage.py +173 -0
  610. package/skills/llm-engineering/SKILL.md +435 -0
  611. package/skills/local-first/SKILL.md +213 -0
  612. package/skills/local-first-architecture/SKILL.md +137 -0
  613. package/skills/lottie-animation/SKILL.md +137 -0
  614. package/skills/marquee-loop/SKILL.md +147 -0
  615. package/skills/masked-reveal/SKILL.md +305 -0
  616. package/skills/mcp-builder/SKILL.md +180 -0
  617. package/skills/micro-interaction/SKILL.md +321 -0
  618. package/skills/mobile-design/SKILL.md +320 -0
  619. package/skills/mobile-design/scripts/mobile_audit.py +670 -0
  620. package/skills/monorepo-management/SKILL.md +370 -0
  621. package/skills/morphing-icons/SKILL.md +423 -0
  622. package/skills/motion-engineering/SKILL.md +272 -0
  623. package/skills/nextjs-react-expert/SKILL.md +293 -0
  624. package/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
  625. package/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
  626. package/skills/nodejs-best-practices/SKILL.md +617 -0
  627. package/skills/observability/SKILL.md +378 -0
  628. package/skills/opentelemetry-observability/SKILL.md +125 -0
  629. package/skills/page-transition-animation/SKILL.md +161 -0
  630. package/skills/parallel-agents/SKILL.md +185 -0
  631. package/skills/performance-profiling/SKILL.md +305 -0
  632. package/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
  633. package/skills/plan-writing/SKILL.md +202 -0
  634. package/skills/platform-engineer/SKILL.md +183 -0
  635. package/skills/platform-engineering-opentofu/SKILL.md +133 -0
  636. package/skills/playwright-ai-e2e/SKILL.md +126 -0
  637. package/skills/playwright-best-practices/SKILL.md +224 -0
  638. package/skills/polish/SKILL.md +114 -0
  639. package/skills/powershell-windows/SKILL.md +197 -0
  640. package/skills/pricing-page/SKILL.md +123 -0
  641. package/skills/product-aware-heuristics/SKILL.md +465 -0
  642. package/skills/progressive-blur/SKILL.md +155 -0
  643. package/skills/project-idioms/SKILL.md +166 -0
  644. package/skills/property-based-testing/SKILL.md +124 -0
  645. package/skills/python-patterns/SKILL.md +295 -0
  646. package/skills/python-pro/SKILL.md +380 -0
  647. package/skills/quieter/SKILL.md +124 -0
  648. package/skills/react-doctor/SKILL.md +126 -0
  649. package/skills/react-specialist/SKILL.md +355 -0
  650. package/skills/readme-builder/SKILL.md +345 -0
  651. package/skills/realtime-patterns/SKILL.md +358 -0
  652. package/skills/red-team-tactics/SKILL.md +266 -0
  653. package/skills/redesign-skill/SKILL.md +121 -0
  654. package/skills/review-animations/SKILL.md +120 -0
  655. package/skills/review-animations/STANDARDS.md +87 -0
  656. package/skills/rust-pro/SKILL.md +727 -0
  657. package/skills/seo-fundamentals/SKILL.md +214 -0
  658. package/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
  659. package/skills/server-management/SKILL.md +253 -0
  660. package/skills/shadcn-ui-expert/SKILL.md +271 -0
  661. package/skills/shape/SKILL.md +131 -0
  662. package/skills/skill-creator/SKILL.md +136 -0
  663. package/skills/soft-skill/SKILL.md +128 -0
  664. package/skills/sounds-on-the-web/SKILL.md +151 -0
  665. package/skills/sql-pro/SKILL.md +699 -0
  666. package/skills/supabase-postgres-best-practices/SKILL.md +132 -0
  667. package/skills/svg-animation/SKILL.md +431 -0
  668. package/skills/swiftui-expert/SKILL.md +239 -0
  669. package/skills/swiss-design/SKILL.md +119 -0
  670. package/skills/system-design-pro/SKILL.md +393 -0
  671. package/skills/systematic-debugging/SKILL.md +198 -0
  672. package/skills/systematic-debugging/condition-based-waiting.md +115 -0
  673. package/skills/systematic-debugging/defense-in-depth.md +122 -0
  674. package/skills/systematic-debugging/root-cause-tracing.md +169 -0
  675. package/skills/tailwind-patterns/SKILL.md +658 -0
  676. package/skills/taste-skill/SKILL.md +127 -0
  677. package/skills/tdd-workflow/SKILL.md +179 -0
  678. package/skills/test-result-analyzer/SKILL.md +345 -0
  679. package/skills/testing-patterns/SKILL.md +609 -0
  680. package/skills/testing-patterns/scripts/test_runner.py +219 -0
  681. package/skills/thermo-nuclear-code-quality-review/SKILL.md +137 -0
  682. package/skills/thinking-protocol/SKILL.md +97 -0
  683. package/skills/to-spring-or-not-to-spring/SKILL.md +118 -0
  684. package/skills/transitions-dev/SKILL.md +165 -0
  685. package/skills/trend-researcher/SKILL.md +273 -0
  686. package/skills/typescript-advanced/SKILL.md +381 -0
  687. package/skills/typeset/SKILL.md +135 -0
  688. package/skills/ui-reasoning-engine/SKILL.md +230 -0
  689. package/skills/ui-skill-packs/SKILL.md +132 -0
  690. package/skills/ui-skills-root/SKILL.md +144 -0
  691. package/skills/ui-ux-pro-max/SKILL.md +185 -0
  692. package/skills/ui-ux-researcher/SKILL.md +274 -0
  693. package/skills/vector-search-pgvector/SKILL.md +144 -0
  694. package/skills/verification-before-completion/SKILL.md +178 -0
  695. package/skills/vue-expert/SKILL.md +334 -0
  696. package/skills/vulnerability-scanner/SKILL.md +453 -0
  697. package/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
  698. package/skills/web-accessibility-auditor/SKILL.md +254 -0
  699. package/skills/web-design-guidelines/SKILL.md +124 -0
  700. package/skills/web-quality-audit/SKILL.md +122 -0
  701. package/skills/webapp-testing/SKILL.md +203 -0
  702. package/skills/webapp-testing/scripts/playwright_runner.py +173 -0
  703. package/skills/webgpu-performance/SKILL.md +163 -0
  704. package/skills/whimsy-injector/SKILL.md +380 -0
  705. package/skills/workflow-optimizer/SKILL.md +263 -0
  706. package/skills/zero-trust-passkeys/SKILL.md +156 -0
  707. package/.agent/skills/api-patterns/scripts/__pycache__/api_validator.cpython-311.pyc +0 -0
  708. package/.agent/skills/database-design/scripts/__pycache__/schema_validator.cpython-311.pyc +0 -0
  709. package/.agent/skills/frontend-design/scripts/__pycache__/accessibility_checker.cpython-311.pyc +0 -0
  710. package/.agent/skills/frontend-design/scripts/__pycache__/ux_audit.cpython-311.pyc +0 -0
  711. package/.agent/skills/geo-fundamentals/scripts/__pycache__/geo_checker.cpython-311.pyc +0 -0
  712. package/.agent/skills/i18n-localization/scripts/__pycache__/i18n_checker.cpython-311.pyc +0 -0
  713. package/.agent/skills/lint-and-validate/scripts/__pycache__/lint_runner.cpython-311.pyc +0 -0
  714. package/.agent/skills/lint-and-validate/scripts/__pycache__/type_coverage.cpython-311.pyc +0 -0
  715. package/.agent/skills/mobile-design/scripts/__pycache__/mobile_audit.cpython-311.pyc +0 -0
  716. package/.agent/skills/nextjs-react-expert/scripts/__pycache__/convert_rules.cpython-311.pyc +0 -0
  717. package/.agent/skills/nextjs-react-expert/scripts/__pycache__/react_performance_checker.cpython-311.pyc +0 -0
  718. package/.agent/skills/performance-profiling/scripts/__pycache__/lighthouse_audit.cpython-311.pyc +0 -0
  719. package/.agent/skills/seo-fundamentals/scripts/__pycache__/seo_checker.cpython-311.pyc +0 -0
  720. package/.agent/skills/testing-patterns/scripts/__pycache__/test_runner.cpython-311.pyc +0 -0
  721. package/.agent/skills/vulnerability-scanner/scripts/__pycache__/security_scan.cpython-311.pyc +0 -0
  722. package/.agent/skills/webapp-testing/scripts/__pycache__/playwright_runner.cpython-311.pyc +0 -0
@@ -0,0 +1,166 @@
1
+ ---
2
+ name: project-idioms
3
+ description: Use when >
4
+ version: 5.0.0
5
+ last-updated: 2026-09-13
6
+ skills:
7
+ - clean-code
8
+ - codebase-design
9
+ - fabel-protocol
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/skill_evolution.js
13
+ - .agent/scripts/verify_all.js
14
+ - .agent/scripts/lint_runner.js
15
+ ---
16
+
17
+ # Project Idioms — Auto-Evolved Skill
18
+
19
+ ## Mandatory Pre-Flight Context Inspection
20
+
21
+ Before generating, refactoring, or reviewing code in the `project-idioms` domain, inspect these 5 critical parameters:
22
+
23
+ 1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
24
+ 2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
25
+ 3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
26
+ 4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
27
+ 5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Use when >
32
+ - **DO NOT activate when:** The task falls outside the `project-idioms` domain or is managed by a different dedicated specialist.
33
+
34
+ ## 🔁 Multi-Pass Execution Protocol
35
+
36
+ Execute all non-trivial tasks through this 7-pass cognitive loop:
37
+
38
+ | Pass | Phase | Core Action |
39
+ |:---|:---|:---|
40
+ | **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. |
41
+ | **Pass 2** | **Plan** | Decompose the task into smallest logical steps; map dependencies and required tool calls. |
42
+ | **Pass 3** | **Execute** | Implement the solution with production-grade craft, zero placeholders, and strict typing. |
43
+ | **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. |
44
+ | **Pass 5** | **Attack** | Perform an adversarial review searching for edge-case failures, race conditions, and traps. |
45
+ | **Pass 6** | **Improve** | Eliminate discovered friction, optimize performance, and harden error boundaries. |
46
+ | **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. |
47
+
48
+ ---
49
+
50
+ ## 🛠️ Technical Architecture & Reference Recipes
51
+
52
+ ---
53
+
54
+
55
+ ---
56
+
57
+ > **Authority Level: ABSOLUTE**
58
+ > These idioms were extracted from this project's actual code decisions.
59
+ > They override all generic agent defaults and best practices.
60
+ > Every agent reads this file on activation and adapts its proposals accordingly.
61
+
62
+ ---
63
+
64
+ ## How Idioms Are Born
65
+
66
+ 1. Developer commits code that **differs** from what the AI proposed.
67
+ 2. `skill_evolution.js digest` extracts the architectural delta (semantic filter).
68
+ 3. A minimal LLM prompt (< 500 tokens) identifies the **WHY** behind the change.
69
+ 4. The idiom is recorded here with a stable pattern + reason pair.
70
+ 5. All future code generations must align with these idioms.
71
+
72
+ ---
73
+
74
+ ## Recorded Idioms
75
+
76
+ | ID | Pattern | Why This Project Uses It | Domain | Since |
77
+ | :-- | :------ | :----------------------------------------------------- | :----- | :---- |
78
+ | — | — | _No idioms recorded yet. Run your first digest cycle._ | — | — |
79
+
80
+ ---
81
+
82
+ ## How to Add New Idioms
83
+
84
+ Run after committing or staging a meaningful architectural change:
85
+
86
+ ```bash
87
+ # Analyze staged changes (default)
88
+ node .agent/scripts/skill_evolution.js digest
89
+
90
+ # Preview without writing
91
+ node .agent/scripts/skill_evolution.js digest --dry-run
92
+
93
+ # Analyze last commit instead of staged
94
+ node .agent/scripts/skill_evolution.js digest --head
95
+
96
+ # Check current idiom count and token savings
97
+ node .agent/scripts/skill_evolution.js status
98
+ ```
99
+
100
+ ---
101
+
102
+ ## Enforcement Rules for All Agents
103
+
104
+ ```
105
+ □ Before proposing any code: scan the idiom table above
106
+ □ If your proposal contradicts an idiom → flag it explicitly with:
107
+ "⚠️ Note: My proposal differs from Project Idiom #N. Reason: [explain]"
108
+ □ Never override an idiom silently
109
+ □ When citing an idiom in a review:
110
+ "Per Project Idiom #N: [pattern] — [reason]"
111
+ □ If no idioms yet → proceed with domain-standard approaches
112
+ ```
113
+
114
+ ---
115
+
116
+ ## Digest History
117
+
118
+ Last digest: `never`
119
+ Total cycles: `0`
120
+
121
+ Run `node .agent/scripts/skill_evolution.js status` to see full statistics.
122
+
123
+ ---
124
+
125
+ ## 🚨 Edge-Case & Failure Mode Matrix
126
+
127
+ | Scenario | Risk | Mitigation Strategy |
128
+ |:---|:---|:---|
129
+ | **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
130
+ | **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
131
+ | **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
132
+ | **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
133
+ | **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
134
+
135
+ ---
136
+
137
+ ## 🤖 LLM-Specific Traps Table
138
+
139
+ | Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
140
+ |:---|:---|:---|
141
+ | **Hallucinated Tool Capabilities** | Assuming an external library or CLI command exists without verification | Run a verification check or verify package.json before referencing tools |
142
+ | **Premature Completion Claim** | Declaring a task finished because code was generated without verification | Execute tests, linters, or terminal commands to provide concrete proof |
143
+ | **Context Bloat Dumping** | Pasting entire multi-thousand-line files into prompt context | Extract targeted excerpts, symbols, and signatures to preserve tokens |
144
+
145
+ ---
146
+
147
+ ## 🏛️ Tribunal Verification & Guardrails
148
+
149
+ **Active Reviewers:** `orchestrator` · `agent-organizer` · `logic-reviewer`
150
+ **Slash Command:** `/review` or `/tribunal-full`
151
+
152
+ ### ✅ Pre-Flight Self-Audit Checklist
153
+
154
+ ```
155
+ ✅ Did I deconstruct the root objective before proposing architecture?
156
+ ✅ Did I identify dependencies, bottlenecks, and parallelizable sub-tasks?
157
+ ✅ Did I avoid over-engineering and select the simplest effective pattern?
158
+ ✅ Did I verify assumptions with concrete file reads instead of speculation?
159
+ ✅ Did I establish measurable verification criteria before completion?
160
+ ```
161
+
162
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
163
+
164
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
165
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
166
+ - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.
@@ -0,0 +1,124 @@
1
+ ---
2
+ name: property-based-testing
3
+ description: Use when Generative input invariant testing using fast-check (TS/JS) and hypothesis (Python) to uncover hidden edge cases and boundary failures.
4
+ version: 5.0.0
5
+ last-updated: 2026-09-13
6
+ skills:
7
+ - testing-patterns
8
+ - tdd-workflow
9
+ - clean-code
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/test_runner.js
13
+ - .agent/scripts/inner_loop_validator.js
14
+ - .agent/scripts/lint_runner.js
15
+ - .agent/scripts/verify_all.js
16
+ ---
17
+
18
+ # Property-Based Testing — Invariant Verification
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before generating, refactoring, or reviewing code in the `property-based-testing` domain, inspect these 5 critical parameters:
23
+
24
+ 1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
25
+ 2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
26
+ 3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
27
+ 4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
28
+ 5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
29
+
30
+ ## Activation Boundaries
31
+
32
+ - **Activate when:** Use when Generative input invariant testing using fast-check (TS/JS) and hypothesis (Python) to uncover hidden edge cases and boundary failures.
33
+ - **DO NOT activate when:** The task falls outside the `property-based-testing` domain or is managed by a different dedicated specialist.
34
+
35
+ ## 🔁 Multi-Pass Execution Protocol
36
+
37
+ Execute all non-trivial tasks through this 7-pass cognitive loop:
38
+
39
+ | Pass | Phase | Core Action |
40
+ |:---|:---|:---|
41
+ | **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. |
42
+ | **Pass 2** | **Plan** | Decompose the task into smallest logical steps; map dependencies and required tool calls. |
43
+ | **Pass 3** | **Execute** | Implement the solution with production-grade craft, zero placeholders, and strict typing. |
44
+ | **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. |
45
+ | **Pass 5** | **Attack** | Perform an adversarial review searching for edge-case failures, race conditions, and traps. |
46
+ | **Pass 6** | **Improve** | Eliminate discovered friction, optimize performance, and harden error boundaries. |
47
+ | **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. |
48
+
49
+ ---
50
+
51
+ ## 🛠️ Technical Architecture & Reference Recipes
52
+
53
+ ## Fast-Check Arbitrary Generator & Vitest Invariant Test
54
+
55
+ ```typescript
56
+ import fc from 'fast-check';
57
+ import { test, expect } from 'vitest';
58
+
59
+ function parseAmount(currencyStr: string): number | null {
60
+ const cleaned = currencyStr.replace(/[^0-9.]/g, '');
61
+ const num = parseFloat(cleaned);
62
+ return isNaN(num) ? null : num;
63
+ }
64
+
65
+ test('currency parser invariant: non-negative parsed numbers', () => {
66
+ fc.assert(
67
+ fc.property(fc.tuple(fc.string(), fc.double({ min: 0, max: 1000000 })), ([prefix, val]) => {
68
+ const input = `${prefix}$${val.toFixed(2)}`;
69
+ const parsed = parseAmount(input);
70
+
71
+ if (parsed !== null) {
72
+ expect(parsed).toBeGreaterThanOrEqual(0);
73
+ expect(Number.isFinite(parsed)).toBe(true);
74
+ }
75
+ }),
76
+ { numRuns: 500 }, // Execute 500 generative iterations
77
+ );
78
+ });
79
+ ```
80
+
81
+ ---
82
+
83
+ ## 🚨 Edge-Case & Failure Mode Matrix
84
+
85
+ | Scenario | Risk | Mitigation Strategy |
86
+ |:---|:---|:---|
87
+ | **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
88
+ | **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
89
+ | **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
90
+ | **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
91
+ | **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
92
+
93
+ ---
94
+
95
+ ## 🤖 LLM-Specific Traps Table
96
+
97
+ | Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
98
+ |:---|:---|:---|
99
+ | **Testing Implementation Details** | Asserting on private component state or internal helper functions | Assert on observable user behaviors, DOM roles, and network outcomes |
100
+ | **Flaky Async Assertion** | Using arbitrary setTimeout delays before asserting on asynchronous state | Use waitFor or findBy queries that poll with timeout bounds |
101
+ | **Shared Mutable State** | Reusing database records across concurrent test runners | Isolate test databases per worker or execute in rolled-back transactions |
102
+
103
+ ---
104
+
105
+ ## 🏛️ Tribunal Verification & Guardrails
106
+
107
+ **Active Reviewers:** `test-engineer` · `qa-automation-engineer` · `logic-reviewer`
108
+ **Slash Command:** `/review` or `/tribunal-full`
109
+
110
+ ### ✅ Pre-Flight Self-Audit Checklist
111
+
112
+ ```
113
+ ✅ Do tests follow behavioral GIVEN/WHEN/THEN specifications?
114
+ ✅ Are happy path, failure paths, and boundary conditions (0, null, max) covered?
115
+ ✅ Are test mocks isolated and reset between successive suites?
116
+ ✅ Do E2E locators rely on stable ARIA attributes instead of brittle CSS selectors?
117
+ ✅ Did I verify test suite passes without flaky race conditions?
118
+ ```
119
+
120
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
121
+
122
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
123
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
124
+ - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.
@@ -0,0 +1,295 @@
1
+ ---
2
+ name: python-patterns
3
+ description: Use when Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Teaches thinking, not copying.
4
+ version: 5.0.0
5
+ last-updated: 2026-09-13
6
+ skills:
7
+ - python-pro
8
+ - clean-code
9
+ - data-validation-schemas
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
+ ---
15
+
16
+ # Python Development Principles
17
+
18
+ ## Mandatory Pre-Flight Context Inspection
19
+
20
+ Before generating, refactoring, or reviewing code in the `python-patterns` domain, inspect these 5 critical parameters:
21
+
22
+ 1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
23
+ 2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
24
+ 3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
25
+ 4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
26
+ 5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
27
+
28
+ ## Activation Boundaries
29
+
30
+ - **Activate when:** Use when Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Teaches thinking, not copying.
31
+ - **DO NOT activate when:** The task falls outside the `python-patterns` domain or is managed by a different dedicated specialist.
32
+
33
+ ## 🔁 Multi-Pass Execution Protocol
34
+
35
+ Execute all non-trivial tasks through this 7-pass cognitive loop:
36
+
37
+ | Pass | Phase | Core Action |
38
+ |:---|:---|:---|
39
+ | **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. |
40
+ | **Pass 2** | **Plan** | Decompose the task into smallest logical steps; map dependencies and required tool calls. |
41
+ | **Pass 3** | **Execute** | Implement the solution with production-grade craft, zero placeholders, and strict typing. |
42
+ | **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. |
43
+ | **Pass 5** | **Attack** | Perform an adversarial review searching for edge-case failures, race conditions, and traps. |
44
+ | **Pass 6** | **Improve** | Eliminate discovered friction, optimize performance, and harden error boundaries. |
45
+ | **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. |
46
+
47
+ ---
48
+
49
+ ## 🛠️ Technical Architecture & Reference Recipes
50
+
51
+ ---
52
+
53
+
54
+ ## Hallucination Traps (Read First)
55
+
56
+ - ❌ Using `dict` for structured data when a dataclass/Pydantic model exists -> ✅ Dicts have no type safety; use typed models
57
+ - ❌ Catching bare `except:` or `except Exception:` -> ✅ Catch specific exceptions; bare except swallows KeyboardInterrupt and SystemExit
58
+ - ❌ Using `os.path` for path operations -> ✅ Use `pathlib.Path` for modern, readable path manipulation
59
+
60
+ ---
61
+
62
+ ---
63
+
64
+ ## Framework Selection
65
+
66
+ | Use Case | Recommended | When to Use |
67
+ | ---------------------------- | -------------- | -------------------------------------------- |
68
+ | REST API, general-purpose | FastAPI | Type-safe, async, auto-docs via OpenAPI |
69
+ | REST API, batteries-included | Django + DRF | Rapid development, ORM included, admin panel |
70
+ | Microservice / minimal API | Flask | Simple, no overhead, full control |
71
+ | Data pipeline / ETL | No framework | Standard library + pandas/polars as needed |
72
+ | CLI tool | Click or Typer | Better than argparse for complex CLIs |
73
+ | Async task queue | Celery + Redis | Background jobs, scheduled tasks |
74
+
75
+ **Decision question:** Does this need an ORM, admin panel, and auth out of the box? → Django. Does it need type-safe inputs with automatic validation? → FastAPI. Is it small and needs nothing? → Flask.
76
+
77
+ ---
78
+
79
+ ## Type Hints (Required on All New Code)
80
+
81
+ Python type hints are not optional — they are documentation that also enables static analysis.
82
+
83
+ ```python
84
+ # ❌ No type hints
85
+ def create_user(email, role):
86
+ ...
87
+
88
+ # ✅ Typed
89
+ from typing import Literal
90
+
91
+ def create_user(email: str, role: Literal["admin", "user"] = "user") -> dict[str, str]:
92
+ ...
93
+ ```
94
+
95
+ **Rules:**
96
+
97
+ - All function parameters and return values must be typed
98
+ - Use `from __future__ import annotations` for forward references
99
+ - Run `mypy` or `pyright` as part of CI — type errors fail the build
100
+
101
+ ---
102
+
103
+ ## Project Structure
104
+
105
+ ```
106
+ src/
107
+ api/ Route definitions (thin — parse and delegate)
108
+ services/ Business logic (no HTTP awareness)
109
+ repositories/ Database access (no business logic)
110
+ models/ Pydantic models + SQLAlchemy models
111
+ lib/ Shared utilities
112
+ config.py Settings via pydantic-settings
113
+
114
+ tests/
115
+ unit/ Isolated function tests
116
+ integration/ Database and external service tests
117
+
118
+ pyproject.toml — single source of truth for deps, linting, test config
119
+ ```
120
+
121
+ ---
122
+
123
+ ## Async Patterns
124
+
125
+ FastAPI uses async by default. Know when to use it and when not to.
126
+
127
+ ```python
128
+ # ✅ Use async for I/O-bound operations
129
+ @app.get("/users/{user_id}")
130
+ async def get_user(user_id: str, db: AsyncSession = Depends(get_db)):
131
+ return await user_service.find_by_id(db, user_id)
132
+
133
+ # ✅ Use sync for CPU-bound operations (or offload to thread pool)
134
+ import asyncio
135
+ from concurrent.futures import ThreadPoolExecutor
136
+
137
+ executor = ThreadPoolExecutor()
138
+
139
+ @app.post("/process")
140
+ async def process_image(file: UploadFile):
141
+ loop = asyncio.get_event_loop()
142
+ result = await loop.run_in_executor(executor, cpu_intensive_work, file)
143
+ return result
144
+ ```
145
+
146
+ **Never:** `time.sleep()` inside an async function — use `await asyncio.sleep()` instead.
147
+
148
+ ---
149
+
150
+ ## Error Handling
151
+
152
+ ```python
153
+ # Custom exception hierarchy
154
+ class AppError(Exception):
155
+ def __init__(self, message: str, code: str, status_code: int = 400):
156
+ self.message = message
157
+ self.code = code
158
+ self.status_code = status_code
159
+ super().__init__(message)
160
+
161
+ class NotFoundError(AppError):
162
+ def __init__(self, resource: str, id: str):
163
+ super().__init__(f"{resource} {id} not found", "NOT_FOUND", 404)
164
+
165
+ class ValidationError(AppError):
166
+ def __init__(self, message: str):
167
+ super().__init__(message, "VALIDATION_FAILED", 400)
168
+
169
+ # FastAPI exception handler
170
+ @app.exception_handler(AppError)
171
+ async def app_error_handler(request: Request, exc: AppError):
172
+ return JSONResponse(
173
+ status_code=exc.status_code,
174
+ content={"error": exc.message, "code": exc.code}
175
+ )
176
+ ```
177
+
178
+ ---
179
+
180
+ ## Dependency Management
181
+
182
+ Use `pyproject.toml` with `uv` or `poetry`:
183
+
184
+ ```toml
185
+ [project]
186
+ name = "my-service"
187
+ version = "0.1.0"
188
+ requires-python = ">=3.11"
189
+
190
+ dependencies = [
191
+ "fastapi>=0.110",
192
+ "pydantic>=2.0",
193
+ "sqlalchemy[asyncio]>=2.0",
194
+ "asyncpg>=0.29",
195
+ ]
196
+
197
+ [project.optional-dependencies]
198
+ dev = [
199
+ "pytest>=7.0",
200
+ "pytest-asyncio>=0.23",
201
+ "mypy>=1.0",
202
+ "ruff>=0.3",
203
+ ]
204
+ ```
205
+
206
+ **Never use `requirements.txt` for production projects** — no lock file, no version bounds, no dev/prod separation.
207
+
208
+ ---
209
+
210
+ ## Code Quality Tools
211
+
212
+ ```bash
213
+ # Linting + formatting (replaces black + flake8 + isort)
214
+ ruff check . --fix
215
+ ruff format .
216
+
217
+ # Type checking
218
+ mypy src/
219
+
220
+ # Testing
221
+ pytest tests/ -v --tb=short
222
+
223
+ # Pre-commit (runs all of the above)
224
+ pre-commit run --all-files
225
+ ```
226
+
227
+ Configure all tools in `pyproject.toml` — not `.flake8`, `.mypy.ini`, and `.ruff.toml` separately.
228
+
229
+ ---
230
+
231
+ ## Output Format
232
+
233
+ When this skill produces or reviews code, structure your output as follows:
234
+
235
+ ```
236
+ ━━━ Python Patterns Report ━━━━━━━━━━━━━━━━━━━━━━━━
237
+ Skill: Python Patterns
238
+ Language: [detected language / framework]
239
+ Scope: [N files · N functions]
240
+ ─────────────────────────────────────────────────
241
+ ✅ Passed: [checks that passed, or "All clean"]
242
+ ⚠️ Warnings: [non-blocking issues, or "None"]
243
+ ❌ Blocked: [blocking issues requiring fix, or "None"]
244
+ ─────────────────────────────────────────────────
245
+ VBC status: PENDING → VERIFIED
246
+ Evidence: [test output / lint pass / compile success]
247
+ ```
248
+
249
+ **VBC (Verification-Before-Completion) is mandatory.**
250
+ Do not mark status as VERIFIED until concrete terminal evidence is provided.
251
+
252
+ ---
253
+
254
+ ## 🚨 Edge-Case & Failure Mode Matrix
255
+
256
+ | Scenario | Risk | Mitigation Strategy |
257
+ |:---|:---|:---|
258
+ | **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
259
+ | **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
260
+ | **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
261
+ | **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
262
+ | **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
263
+
264
+ ---
265
+
266
+ ## 🤖 LLM-Specific Traps Table
267
+
268
+ | Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
269
+ |:---|:---|:---|
270
+ | **Unchecked Payload Cast** | Casting request bodies to TypeScript types without runtime schema validation | Parse request payloads through Zod/Pydantic schemas before business logic |
271
+ | **Silent Error Swallowing** | Catching errors with empty catch blocks or logging without rethrowing | Propagate structured errors with status codes and contextual stack traces |
272
+ | **Unparameterized Query** | Concatenating user inputs into SQL/Prisma query strings | Always use parameterized bindings or type-safe ORM query builders |
273
+
274
+ ---
275
+
276
+ ## 🏛️ Tribunal Verification & Guardrails
277
+
278
+ **Active Reviewers:** `logic-reviewer` · `security-auditor` · `api-architect` · `resilience-reviewer`
279
+ **Slash Command:** `/review` or `/tribunal-full`
280
+
281
+ ### ✅ Pre-Flight Self-Audit Checklist
282
+
283
+ ```
284
+ ✅ Are all inputs and boundary payloads validated against schemas (Zod/Pydantic)?
285
+ ✅ Are SQL and database queries parameterized with zero string concatenation?
286
+ ✅ Are error boundaries and timeout/retry policies explicitly declared?
287
+ ✅ Are authentication checks performed before business logic execution?
288
+ ✅ Did I verify that imported dependencies exist in package.json/requirements.txt?
289
+ ```
290
+
291
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
292
+
293
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
294
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
295
+ - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.