tribunal-kit 5.8.4 → 6.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 (322) hide show
  1. package/.agent/ARCHITECTURE.md +219 -215
  2. package/.agent/agents/accessibility-reviewer.md +66 -151
  3. package/.agent/agents/ai-code-reviewer.md +22 -2
  4. package/.agent/agents/anti-pattern-reviewer.md +99 -0
  5. package/.agent/agents/api-architect.md +19 -2
  6. package/.agent/agents/backend-specialist.md +25 -3
  7. package/.agent/agents/cloud-engineer.md +21 -0
  8. package/.agent/agents/code-archaeologist.md +20 -3
  9. package/.agent/agents/complexity-reviewer.md +22 -2
  10. package/.agent/agents/database-architect.md +24 -3
  11. package/.agent/agents/db-latency-auditor.md +22 -2
  12. package/.agent/agents/debugger.md +19 -3
  13. package/.agent/agents/dependency-reviewer.md +19 -2
  14. package/.agent/agents/devops-engineer.md +24 -3
  15. package/.agent/agents/documentation-writer.md +21 -3
  16. package/.agent/agents/explorer-agent.md +21 -3
  17. package/.agent/agents/frontend-reviewer.md +19 -3
  18. package/.agent/agents/frontend-specialist.md +72 -224
  19. package/.agent/agents/game-developer.md +22 -3
  20. package/.agent/agents/interaction-reviewer.md +118 -0
  21. package/.agent/agents/logic-reviewer.md +18 -3
  22. package/.agent/agents/minimalist-reviewer.md +98 -0
  23. package/.agent/agents/mobile-developer.md +21 -3
  24. package/.agent/agents/mobile-reviewer.md +22 -2
  25. package/.agent/agents/orchestrator.md +19 -3
  26. package/.agent/agents/penetration-tester.md +22 -3
  27. package/.agent/agents/performance-optimizer.md +21 -3
  28. package/.agent/agents/performance-reviewer.md +2 -0
  29. package/.agent/agents/precedence-reviewer.md +19 -5
  30. package/.agent/agents/product-manager.md +20 -3
  31. package/.agent/agents/product-owner.md +22 -1
  32. package/.agent/agents/product-reviewer.md +98 -0
  33. package/.agent/agents/project-planner.md +19 -3
  34. package/.agent/agents/qa-automation-engineer.md +24 -3
  35. package/.agent/agents/resilience-reviewer.md +21 -2
  36. package/.agent/agents/schema-reviewer.md +21 -2
  37. package/.agent/agents/security-auditor.md +7 -1
  38. package/.agent/agents/seo-specialist.md +18 -3
  39. package/.agent/agents/sql-reviewer.md +22 -2
  40. package/.agent/agents/supervisor-agent.md +22 -3
  41. package/.agent/agents/swarm-worker-registry.md +7 -0
  42. package/.agent/agents/system-architect.md +19 -0
  43. package/.agent/agents/test-coverage-reviewer.md +22 -2
  44. package/.agent/agents/test-engineer.md +21 -2
  45. package/.agent/agents/throughput-optimizer.md +22 -2
  46. package/.agent/agents/type-safety-reviewer.md +21 -2
  47. package/.agent/agents/ui-ux-auditor.md +44 -242
  48. package/.agent/agents/ui-visual-auditor.md +99 -0
  49. package/.agent/agents/ux-reviewer.md +104 -0
  50. package/.agent/agents/visual-reviewer.md +98 -0
  51. package/.agent/agents/vitals-reviewer.md +23 -2
  52. package/.agent/history/README.md +53 -0
  53. package/.agent/history/case-law/cases/template-case.json +19 -0
  54. package/.agent/history/integrity_manifest.json +131 -33
  55. package/.agent/history/memory/.memory.idx +1581 -1
  56. package/.agent/history/memory/MEMORY.md +105 -1
  57. package/.agent/routing_index.json +272 -690
  58. package/.agent/rules/GEMINI.md +10 -12
  59. package/.agent/rules/GEMINI_PLANNER.md +84 -0
  60. package/.agent/scripts/_utils.js +28 -7
  61. package/.agent/scripts/case_law_manager.js +2 -0
  62. package/.agent/scripts/context_broker.js +152 -19
  63. package/.agent/scripts/guardrail_engine.js +60 -5
  64. package/.agent/scripts/impact_classifier.js +167 -0
  65. package/.agent/scripts/integrity_manifest.js +10 -4
  66. package/.agent/scripts/marathon_harness.js +10 -1
  67. package/.agent/scripts/minimal_change_engine.js +437 -0
  68. package/.agent/scripts/pipeline_engine.js +856 -0
  69. package/.agent/scripts/skill_evolution.js +36 -21
  70. package/.agent/scripts/socratic_gate_policy.js +60 -0
  71. package/.agent/scripts/swarm_dispatcher.js +65 -6
  72. package/.agent/scripts/token_budget_broker.js +52 -0
  73. package/.agent/scripts/verify_all.js +13 -0
  74. package/.agent/scripts/visual_audit.js +92 -0
  75. package/.agent/skills/12-principles-of-animation/SKILL.md +19 -10
  76. package/.agent/skills/60fps-animation/SKILL.md +19 -10
  77. package/.agent/skills/accessible-animation/SKILL.md +19 -10
  78. package/.agent/skills/adapt/SKILL.md +19 -10
  79. package/.agent/skills/advanced-rag-pipelines/SKILL.md +21 -3
  80. package/.agent/skills/agent-organizer/SKILL.md +21 -7
  81. package/.agent/skills/agentic-patterns/SKILL.md +19 -7
  82. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +21 -7
  83. package/.agent/skills/animation-on-scroll/SKILL.md +19 -10
  84. package/.agent/skills/animation-systems/SKILL.md +19 -10
  85. package/.agent/skills/antfu-conventions/SKILL.md +21 -10
  86. package/.agent/skills/api-patterns/SKILL.md +21 -7
  87. package/.agent/skills/api-patterns/scripts/__pycache__/api_validator.cpython-311.pyc +0 -0
  88. package/.agent/skills/api-security-auditor/SKILL.md +21 -7
  89. package/.agent/skills/app-builder/SKILL.md +21 -7
  90. package/.agent/skills/apple-design/SKILL.md +19 -10
  91. package/.agent/skills/architecture/SKILL.md +21 -7
  92. package/.agent/skills/audit-and-fix/SKILL.md +19 -10
  93. package/.agent/skills/authentication-best-practices/SKILL.md +21 -7
  94. package/.agent/skills/backend-security-expert/SKILL.md +21 -7
  95. package/.agent/skills/baseline-ui/SKILL.md +19 -10
  96. package/.agent/skills/bash-linux/SKILL.md +21 -7
  97. package/.agent/skills/behavioral-modes/SKILL.md +19 -7
  98. package/.agent/skills/better-colors/SKILL.md +31 -14
  99. package/.agent/skills/better-ui/SKILL.md +19 -10
  100. package/.agent/skills/bolder/SKILL.md +19 -10
  101. package/.agent/skills/brainstorming/SKILL.md +17 -7
  102. package/.agent/skills/browser-native-ai/SKILL.md +19 -3
  103. package/.agent/skills/build-primitive/SKILL.md +19 -10
  104. package/.agent/skills/building-native-ui/SKILL.md +21 -7
  105. package/.agent/skills/cicd-pro/SKILL.md +21 -10
  106. package/.agent/skills/clarify/SKILL.md +19 -10
  107. package/.agent/skills/clean-code/SKILL.md +21 -7
  108. package/.agent/skills/cloud-architect/SKILL.md +21 -10
  109. package/.agent/skills/cobejs/SKILL.md +19 -10
  110. package/.agent/skills/code-review-checklist/SKILL.md +21 -7
  111. package/.agent/skills/codebase-design/SKILL.md +21 -10
  112. package/.agent/skills/colorize/SKILL.md +19 -10
  113. package/.agent/skills/compact-landing/SKILL.md +19 -10
  114. package/.agent/skills/company-logos/SKILL.md +19 -10
  115. package/.agent/skills/config-validator/SKILL.md +21 -7
  116. package/.agent/skills/containerization-pro/SKILL.md +21 -10
  117. package/.agent/skills/create-design-md/SKILL.md +19 -10
  118. package/.agent/skills/critique/SKILL.md +19 -10
  119. package/.agent/skills/csharp-developer/SKILL.md +21 -7
  120. package/.agent/skills/data-validation-schemas/SKILL.md +21 -7
  121. package/.agent/skills/database-design/SKILL.md +21 -7
  122. package/.agent/skills/database-design/scripts/__pycache__/schema_validator.cpython-311.pyc +0 -0
  123. package/.agent/skills/delight/SKILL.md +19 -10
  124. package/.agent/skills/deployment-procedures/SKILL.md +21 -7
  125. package/.agent/skills/design-lab/SKILL.md +21 -10
  126. package/.agent/skills/devops-engineer/SKILL.md +21 -7
  127. package/.agent/skills/devops-incident-responder/SKILL.md +21 -7
  128. package/.agent/skills/diagnosing-bugs/SKILL.md +21 -10
  129. package/.agent/skills/distill/SKILL.md +19 -10
  130. package/.agent/skills/documentation-templates/SKILL.md +21 -7
  131. package/.agent/skills/domain-modeling/SKILL.md +21 -10
  132. package/.agent/skills/edge-computing/SKILL.md +21 -7
  133. package/.agent/skills/emil-design-eng/SKILL.md +19 -10
  134. package/.agent/skills/error-resilience/SKILL.md +21 -7
  135. package/.agent/skills/extract-design-system/SKILL.md +21 -7
  136. package/.agent/skills/fabel-protocol/SKILL.md +19 -2
  137. package/.agent/skills/fixing-accessibility/SKILL.md +25 -14
  138. package/.agent/skills/fixing-metadata/SKILL.md +19 -10
  139. package/.agent/skills/fixing-motion-performance/SKILL.md +19 -10
  140. package/.agent/skills/framer-motion-expert/SKILL.md +19 -6
  141. package/.agent/skills/frontend-design/SKILL.md +66 -204
  142. package/.agent/skills/frontend-design/scripts/__pycache__/accessibility_checker.cpython-311.pyc +0 -0
  143. package/.agent/skills/frontend-design/scripts/__pycache__/ux_audit.cpython-311.pyc +0 -0
  144. package/.agent/skills/frontend-security-expert/SKILL.md +21 -7
  145. package/.agent/skills/game-design-expert/SKILL.md +21 -7
  146. package/.agent/skills/game-engineering-expert/SKILL.md +21 -7
  147. package/.agent/skills/generative-ui-expert/SKILL.md +19 -3
  148. package/.agent/skills/geo-fundamentals/SKILL.md +21 -7
  149. package/.agent/skills/geo-fundamentals/scripts/__pycache__/geo_checker.cpython-311.pyc +0 -0
  150. package/.agent/skills/git-pro/SKILL.md +21 -10
  151. package/.agent/skills/github-operations/SKILL.md +21 -7
  152. package/.agent/skills/gpt-taste/SKILL.md +19 -10
  153. package/.agent/skills/gsap-core/SKILL.md +21 -4
  154. package/.agent/skills/gsap-frameworks/SKILL.md +21 -4
  155. package/.agent/skills/gsap-performance/SKILL.md +20 -5
  156. package/.agent/skills/gsap-plugins/SKILL.md +20 -5
  157. package/.agent/skills/gsap-react/SKILL.md +20 -5
  158. package/.agent/skills/gsap-scrolltrigger/SKILL.md +21 -4
  159. package/.agent/skills/gsap-timeline/SKILL.md +20 -5
  160. package/.agent/skills/gsap-utils/SKILL.md +20 -5
  161. package/.agent/skills/harden/SKILL.md +19 -10
  162. package/.agent/skills/harness-protocol/SKILL.md +20 -4
  163. package/.agent/skills/i18n-localization/SKILL.md +21 -7
  164. package/.agent/skills/i18n-localization/scripts/__pycache__/i18n_checker.cpython-311.pyc +0 -0
  165. package/.agent/skills/impeccable/SKILL.md +21 -10
  166. package/.agent/skills/improve-codebase-architecture/SKILL.md +21 -10
  167. package/.agent/skills/improve-ui/SKILL.md +19 -10
  168. package/.agent/skills/intelligent-routing/SKILL.md +19 -7
  169. package/.agent/skills/knowledge-graph/SKILL.md +20 -4
  170. package/.agent/skills/landing-page/SKILL.md +20 -10
  171. package/.agent/skills/lint-and-validate/SKILL.md +21 -7
  172. package/.agent/skills/lint-and-validate/scripts/__pycache__/lint_runner.cpython-311.pyc +0 -0
  173. package/.agent/skills/lint-and-validate/scripts/__pycache__/type_coverage.cpython-311.pyc +0 -0
  174. package/.agent/skills/llm-engineering/SKILL.md +21 -7
  175. package/.agent/skills/local-first/SKILL.md +21 -7
  176. package/.agent/skills/local-first-architecture/SKILL.md +19 -10
  177. package/.agent/skills/lottie-animation/SKILL.md +19 -10
  178. package/.agent/skills/marquee-loop/SKILL.md +19 -10
  179. package/.agent/skills/masked-reveal/SKILL.md +19 -10
  180. package/.agent/skills/mcp-builder/SKILL.md +21 -7
  181. package/.agent/skills/micro-interaction/SKILL.md +19 -10
  182. package/.agent/skills/mobile-design/SKILL.md +21 -6
  183. package/.agent/skills/mobile-design/scripts/__pycache__/mobile_audit.cpython-311.pyc +0 -0
  184. package/.agent/skills/monorepo-management/SKILL.md +21 -7
  185. package/.agent/skills/morphing-icons/SKILL.md +19 -10
  186. package/.agent/skills/motion-engineering/SKILL.md +86 -171
  187. package/.agent/skills/nextjs-react-expert/SKILL.md +19 -7
  188. package/.agent/skills/nextjs-react-expert/scripts/__pycache__/convert_rules.cpython-311.pyc +0 -0
  189. package/.agent/skills/nextjs-react-expert/scripts/__pycache__/react_performance_checker.cpython-311.pyc +0 -0
  190. package/.agent/skills/nodejs-best-practices/SKILL.md +21 -7
  191. package/.agent/skills/observability/SKILL.md +21 -7
  192. package/.agent/skills/page-transition-animation/SKILL.md +19 -10
  193. package/.agent/skills/parallel-agents/SKILL.md +23 -7
  194. package/.agent/skills/performance-profiling/SKILL.md +21 -7
  195. package/.agent/skills/performance-profiling/scripts/__pycache__/lighthouse_audit.cpython-311.pyc +0 -0
  196. package/.agent/skills/plan-writing/SKILL.md +21 -7
  197. package/.agent/skills/platform-engineer/SKILL.md +21 -7
  198. package/.agent/skills/playwright-best-practices/SKILL.md +21 -7
  199. package/.agent/skills/polish/SKILL.md +19 -10
  200. package/.agent/skills/powershell-windows/SKILL.md +21 -7
  201. package/.agent/skills/pricing-page/SKILL.md +19 -10
  202. package/.agent/skills/product-aware-heuristics/SKILL.md +358 -0
  203. package/.agent/skills/progressive-blur/SKILL.md +19 -10
  204. package/.agent/skills/project-idioms/SKILL.md +20 -8
  205. package/.agent/skills/python-patterns/SKILL.md +21 -7
  206. package/.agent/skills/python-pro/SKILL.md +21 -6
  207. package/.agent/skills/quieter/SKILL.md +19 -10
  208. package/.agent/skills/react-doctor/SKILL.md +19 -10
  209. package/.agent/skills/react-specialist/SKILL.md +19 -6
  210. package/.agent/skills/readme-builder/SKILL.md +21 -7
  211. package/.agent/skills/realtime-patterns/SKILL.md +21 -7
  212. package/.agent/skills/red-team-tactics/SKILL.md +21 -7
  213. package/.agent/skills/redesign-skill/SKILL.md +19 -10
  214. package/.agent/skills/review-animations/SKILL.md +21 -10
  215. package/.agent/skills/rust-pro/SKILL.md +21 -7
  216. package/.agent/skills/seo-fundamentals/SKILL.md +21 -7
  217. package/.agent/skills/seo-fundamentals/scripts/__pycache__/seo_checker.cpython-311.pyc +0 -0
  218. package/.agent/skills/server-management/SKILL.md +21 -7
  219. package/.agent/skills/shadcn-ui-expert/SKILL.md +21 -7
  220. package/.agent/skills/shape/SKILL.md +19 -10
  221. package/.agent/skills/skill-creator/SKILL.md +21 -7
  222. package/.agent/skills/soft-skill/SKILL.md +19 -10
  223. package/.agent/skills/sounds-on-the-web/SKILL.md +19 -10
  224. package/.agent/skills/sql-pro/SKILL.md +21 -7
  225. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +21 -7
  226. package/.agent/skills/svg-animation/SKILL.md +19 -10
  227. package/.agent/skills/swiftui-expert/SKILL.md +21 -7
  228. package/.agent/skills/swiss-design/SKILL.md +19 -10
  229. package/.agent/skills/system-design-pro/SKILL.md +21 -9
  230. package/.agent/skills/systematic-debugging/SKILL.md +21 -7
  231. package/.agent/skills/tailwind-patterns/SKILL.md +21 -7
  232. package/.agent/skills/taste-skill/SKILL.md +19 -10
  233. package/.agent/skills/tdd-workflow/SKILL.md +21 -10
  234. package/.agent/skills/test-result-analyzer/SKILL.md +18 -6
  235. package/.agent/skills/testing-patterns/SKILL.md +21 -7
  236. package/.agent/skills/testing-patterns/scripts/__pycache__/test_runner.cpython-311.pyc +0 -0
  237. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +21 -10
  238. package/.agent/skills/thinking-protocol/SKILL.md +20 -8
  239. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +19 -10
  240. package/.agent/skills/transitions-dev/SKILL.md +19 -10
  241. package/.agent/skills/trend-researcher/SKILL.md +17 -6
  242. package/.agent/skills/typescript-advanced/SKILL.md +21 -7
  243. package/.agent/skills/typeset/SKILL.md +19 -10
  244. package/.agent/skills/ui-reasoning-engine/SKILL.md +154 -0
  245. package/.agent/skills/ui-skill-packs/SKILL.md +77 -0
  246. package/.agent/skills/ui-skills-root/SKILL.md +21 -9
  247. package/.agent/skills/ui-ux-pro-max/SKILL.md +62 -583
  248. package/.agent/skills/ui-ux-researcher/SKILL.md +17 -6
  249. package/.agent/skills/vue-expert/SKILL.md +19 -6
  250. package/.agent/skills/vulnerability-scanner/SKILL.md +21 -7
  251. package/.agent/skills/vulnerability-scanner/scripts/__pycache__/security_scan.cpython-311.pyc +0 -0
  252. package/.agent/skills/web-accessibility-auditor/SKILL.md +21 -7
  253. package/.agent/skills/web-design-guidelines/SKILL.md +32 -206
  254. package/.agent/skills/web-quality-audit/SKILL.md +19 -10
  255. package/.agent/skills/webapp-testing/SKILL.md +21 -7
  256. package/.agent/skills/webapp-testing/scripts/__pycache__/playwright_runner.cpython-311.pyc +0 -0
  257. package/.agent/skills/webgpu-performance/SKILL.md +19 -3
  258. package/.agent/skills/whimsy-injector/SKILL.md +20 -10
  259. package/.agent/skills/workflow-optimizer/SKILL.md +16 -6
  260. package/.agent/templates/DESIGN.md +292 -0
  261. package/.agent/templates/design-tokens.json +137 -0
  262. package/.agent/workflows/acf.md +13 -6
  263. package/.agent/workflows/api-tester.md +15 -8
  264. package/.agent/workflows/audit.md +19 -8
  265. package/.agent/workflows/brainstorm.md +14 -9
  266. package/.agent/workflows/changelog.md +14 -8
  267. package/.agent/workflows/create.md +16 -8
  268. package/.agent/workflows/debug.md +15 -10
  269. package/.agent/workflows/deploy.md +16 -8
  270. package/.agent/workflows/enhance.md +15 -10
  271. package/.agent/workflows/fix.md +15 -8
  272. package/.agent/workflows/generate.md +17 -11
  273. package/.agent/workflows/marathon.md +15 -8
  274. package/.agent/workflows/migrate.md +16 -8
  275. package/.agent/workflows/minimal.md +94 -0
  276. package/.agent/workflows/orchestrate.md +15 -8
  277. package/.agent/workflows/performance-benchmarker.md +15 -8
  278. package/.agent/workflows/pipeline.md +155 -0
  279. package/.agent/workflows/plan.md +14 -10
  280. package/.agent/workflows/preview.md +14 -7
  281. package/.agent/workflows/refactor.md +16 -8
  282. package/.agent/workflows/review-ai.md +15 -7
  283. package/.agent/workflows/review.md +15 -7
  284. package/.agent/workflows/session.md +14 -7
  285. package/.agent/workflows/status.md +13 -7
  286. package/.agent/workflows/strengthen-skills.md +15 -6
  287. package/.agent/workflows/super-prompt.md +19 -10
  288. package/.agent/workflows/swarm.md +15 -7
  289. package/.agent/workflows/test.md +15 -8
  290. package/.agent/workflows/tribunal-backend.md +16 -9
  291. package/.agent/workflows/tribunal-database.md +15 -8
  292. package/.agent/workflows/tribunal-frontend.md +26 -11
  293. package/.agent/workflows/tribunal-full.md +29 -14
  294. package/.agent/workflows/tribunal-mobile.md +15 -8
  295. package/.agent/workflows/tribunal-performance.md +15 -8
  296. package/.agent/workflows/tribunal-speed.md +16 -9
  297. package/.agent/workflows/tribunal-ui.md +82 -0
  298. package/.agent/workflows/ui-ux-pro-max.md +51 -107
  299. package/CONTRIBUTING.md +2 -2
  300. package/README.md +5 -5
  301. package/bin/mcp-server.js +126 -76
  302. package/bin/wrapper.js +67 -31
  303. package/dist/cli.js +39 -1
  304. package/dist/commands/compile.js +7 -0
  305. package/dist/commands/context.js +8 -3
  306. package/dist/commands/graph.js +8 -2
  307. package/dist/commands/init.js +37 -2
  308. package/dist/commands/memory.js +119 -68
  309. package/dist/commands/minimal.js +71 -0
  310. package/dist/commands/native.js +228 -0
  311. package/dist/commands/optimize.js +15 -5
  312. package/dist/commands/validate.js +67 -0
  313. package/dist/esm/index.mjs +26 -32
  314. package/dist/mcp/server.js +4 -138
  315. package/dist/utils/fs.js +10 -4
  316. package/dist/utils/helpers.js +10 -1
  317. package/dist/utils/version.js +9 -2
  318. package/mcp_config.json +10 -1
  319. package/package.json +19 -15
  320. package/scripts/benchmark.js +58 -0
  321. package/scripts/sync-version.js +129 -76
  322. package/scripts/visual_audit.js +126 -0
@@ -1,20 +1,31 @@
1
1
  ---
2
2
  name: ui-ux-researcher
3
3
  description: Expert auditor for accessibility, cognitive load, and premium design heuristics.
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
4
7
  skills:
5
8
  - web-design-guidelines
6
9
  - frontend-design
7
10
  - trend-researcher
8
- version: 1.0.0
9
- last-updated: 2026-03-12
10
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
11
- routing:
12
- domain: general
13
- tier: basic
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # UI/UX Researcher Skill
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before conducting UX audits or evaluating cognitive load heuristics, you MUST inspect:
23
+ 1. P0 Safety & Accessibility Gates (Section 49) → Audit contrast ($\ge 4.5:1$), touch target sizes ($\ge 44\times 44\text{px}$), keyboard focus rings, and screen reader labels
24
+ 2. Nielsen 10 Heuristics Alignment (Section 162) → Map all P1 findings explicitly to Nielsen heuristics (H1–H10)
25
+ 3. Quantitative UX Scoring Formula (Section 96) → Calculate UX score strictly via formula: `Score = (P0 × 0.5) + (P1 × 0.3) + (P2 × 0.2)`
26
+
27
+ # UI/UX Researcher Skill
28
+
18
29
  You are an expert UX auditor specializing in accessibility compliance, cognitive load optimization, and premium design heuristics. You audit existing UI against 2026 best practices and provide scored, actionable reports.
19
30
 
20
31
  ## When to Activate
@@ -1,16 +1,29 @@
1
1
  ---
2
2
  name: vue-expert
3
3
  description: Vue 3.5+ Composition API. Script setup, reactive refs, computed, watchers, composables, Pinia, Vue Router 4, Nuxt 4. Use when building Vue/Nuxt applications.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 3.1.0
6
- last-updated: 2026-04-06
7
- routing:
8
- domain: general
9
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - baseline-ui
9
+ - better-ui
10
+ - 60fps-animation
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
10
14
  ---
11
15
 
12
16
  # Vue 3.5+ & Nuxt 4 — Dense Reference
13
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before writing Vue 3.5+ or Nuxt 4 components, you MUST inspect:
23
+ 1. Script Setup Architecture → Use `<script setup lang="ts">` exclusively; ban legacy Options API
24
+ 2. Pinia & Reactivity Rules (Section 133) → Use `storeToRefs(store)` when destructuring Pinia state to preserve reactivity
25
+ 3. Model & Watcher Syntax (Section 42) → Use `defineModel<T>()` (Vue 3.4+) and `watch(() => state.prop, ...)` for primitive watchers
26
+
14
27
  ## Hallucination Traps (Read First)
15
28
 
16
29
  - ❌ Options API (`data()`, `methods:`, `computed:`) → ✅ `<script setup lang="ts">`
@@ -1,19 +1,33 @@
1
1
  ---
2
2
  name: vulnerability-scanner
3
3
  description: Security vulnerability analysis mastery. OWASP Top 10 (2025), injection attacks (SQL, XSS, SSRF, command), authentication/authorization flaws, dependency vulnerabilities, secret scanning, CORS misconfiguration, supply chain attacks, and security headers. Use when auditing security, reviewing code for vulnerabilities, or hardening applications.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 3.1.0
6
- last-updated: 2026-04-06
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- routing:
9
- domain: general
10
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - backend-security-expert
9
+ - frontend-security-expert
10
+ - api-security-auditor
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
13
16
  # Vulnerability Scanner — Security Analysis Mastery
14
17
 
15
18
  ---
16
19
 
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before scanning codebases for security vulnerabilities, you MUST inspect:
23
+ 1. SQL Injection Vectors (Section 39) → Ban template literal interpolation in SQL queries (`SELECT ... WHERE id = ${id}`); require parameterized queries
24
+ 2. Explicit JWT Algorithms (Section 121) → Verify `jwt.verify(token, secret, { algorithms: ["HS256"] })` specifies explicit algorithms to prevent "None" attacks
25
+ 3. SSRF Domain Allowlist (Section 87) → Validate external request URLs against a strict domain allowlist and block private IP ranges (169.254.169.254, 127.0.0.1)
26
+
27
+ # Vulnerability Scanner — Security Analysis Mastery
28
+
29
+ ---
30
+
17
31
  ## OWASP Top 10 (2025)
18
32
 
19
33
  ```
@@ -1,15 +1,29 @@
1
1
  ---
2
2
  name: web-accessibility-auditor
3
3
  description: Web Accessibility (a11y) mastery. WCAG 2.2 AA standards, semantic HTML, ARIA attributes, keyboard navigation, focus management, screen reader compatibility, color contrast, and dynamic content announcements. Use when building UI components or auditing frontend code for accessibility compliance.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 2.0.0
6
- last-updated: 2026-04-02
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- routing:
9
- domain: general
10
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - fixing-accessibility
9
+ - audit-and-fix
10
+ - build-primitive
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
16
+ # Web Accessibility (a11y) — Inclusive UI Mastery
17
+
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before auditing accessibility or building UI components, you MUST inspect:
23
+ 1. Native Semantic HTML First Rule (Section 28) → Use native `<button>`, `<a>`, `<label>` elements; ban adding `role="button"` to non-interactive `<div>` tags
24
+ 2. Keyboard Focus Visibility (Section 61) → Preserve `:focus-visible` outlines; ban global outline removal (`*:focus { outline: none; }`)
25
+ 3. Explicit Form Label Linking (Section 129) → Explicitly link inputs to `<label>` via `id`/`for` attributes; ban using `placeholder` as a label replacement
26
+
13
27
  ## Hallucination Traps (Read First)
14
28
 
15
29
  - ❌ Adding `role='button'` to a `<div>` instead of using `<button>` -> ✅ Native HTML elements have built-in keyboard and screen reader support
@@ -1,234 +1,60 @@
1
1
  ---
2
2
  name: web-design-guidelines
3
- description: Review UI code for Next-Generation Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 1.0.0
6
- last-updated: 2026-03-12
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- routing:
9
- domain: general
10
- tier: basic
3
+ description: Enforces next-generation web interface guidelines, covering APCA contrast thresholds, Core Web Vitals, and sustainable battery-efficient UI rendering.
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - baseline-ui
8
+ - better-colors
9
+ - 60fps-animation
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
13
- ## Hallucination Traps (Read First)
14
-
15
- - ❌ Designing mobile-last (desktop first, then shrinking) -> ✅ Design mobile-first, then enhance for larger screens
16
- - ❌ Using more than 2-3 font families -> ✅ Stick to 1-2 font families maximum; more creates visual noise
17
- - ❌ Ignoring touch target sizes on mobile -> ✅ Minimum 44x44px touch targets (Apple HIG) / 48x48dp (Material Design)
18
-
19
- ---
20
-
21
- # Next-Gen Web Interface Review Guidelines (Pro-Max Level)
22
-
23
- ---
24
-
25
- ## Review Trigger
26
-
27
- Load this skill when asked to:
28
-
29
- - Review or audit a UI
30
- - Check accessibility compliance (WCAG 3.0 / APCA)
31
- - Improve UX & Cognitive Safety
32
- - Check a site against best practices
16
+ # Web Design Guidelines — Core Web Vitals & Sustainable UI
33
17
 
34
18
  ---
35
19
 
36
- ## Extreme Review Categories
37
-
38
- ### 1. Neuro-Inclusivity & Accessibility (WCAG 3.0 APCA Base)
39
-
40
- Non-negotiable baseline for any public interface in 2026+:
41
-
42
- | Check | How to Verify |
43
- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
44
- | **APCA Contrast** | Ensure Lc (Lightness Contrast) is > 75 for body text, > 60 for large text. (Do not rely solely on old WCAG 2.1 4.5:1 math). |
45
- | **Cognitive Safety** | Check if `prefers-reduced-motion` is respected. No infinite spinning loaders. |
46
- | **Keyboard Fluidity** | Tab order must follow visual order. Focus states cannot be just a 1px dotted line; use `outline: 2px solid var(--focus-color); outline-offset: 2px;`. |
47
- | **Semantic AI Context** | Images must have `alt` tags, but complex charts need full `<details>` breakdowns for screen readers and AI agents crawling the site. |
48
- | **Interaction Buffers** | Are touch targets mathematically ≥48px (Fitts' Law)? |
49
-
50
- ### 2. Extreme Core Web Vitals (CWV)
51
-
52
- Drop the old 2022 standards. The new baseline for premium web:
53
-
54
- | Metric | Premium Target | Common Failures |
55
- | ----------------------------------- | -------------- | ---------------------------------------------------------------------------------------------------- |
56
- | **LCP** (Largest Contentful Paint) | **< 1.5s** | Missing `fetchpriority="high"` on hero images. Heavy client-side React rendering blocking the paint. |
57
- | **INP** (Interaction to Next Paint) | **< 100ms** | Main thread blocked by React hydrate. Use `startTransition` or Web Workers for heavy JS. |
58
- | **CLS** (Cumulative Layout Shift) | **0.00** | Missing `width` and `height` on images. Late-loading web fonts (use `font-display: optional`). |
59
-
60
- ### 3. Energy Efficiency & Sustainability
61
-
62
- Code has a carbon footprint and a battery cost.
20
+ ## Mandatory Pre-Flight Context Inspection
63
21
 
64
- - **OLED Pure Black:** Does the dark mode use `#000` or `#010101` to physically turn off pixels?
65
- - **Animation Tax:** Are animations using CPU-heavy properties (`margin`, `width`) instead of GPU-accelerated ones (`transform`, `opacity`)?
66
- - **Asset Weight:** Are images AVIF/WebP? Are fonts subsetted Variable Fonts?
22
+ Before enforcing web design guidelines or reviewing UI code, you MUST inspect:
23
+ 1. APCA Contrast Thresholds (Section 14) Require Lc > 75 for body text, Lc > 60 for headings, Lc > 45 for controls/borders
24
+ 2. Core Web Vitals Targets (Section 23) Ensure LCP < 1.5s (fetchpriority="high"), INP < 100ms, and CLS = 0.00 (explicit aspect-ratio)
25
+ 3. Compositor-Only Motion (Section 30) → Restrict animations strictly to `transform` and `opacity` to avoid layout reflows
67
26
 
68
- ### 4. Visual Design Quality (Pro-Max)
69
-
70
- Evaluate these brutally honestly:
71
-
72
- - **Mathematical Spacing:** Does spacing follow a strict scale (e.g., 4, 8, 16, 24, 32) or is it a mess of arbitrary pixels?
73
- - **Fluid Typography:** Is text using `clamp()` to scale, or does it awkwardly jump at breakpoints?
74
- - **The "Purple Ban":** Is the site heavily relying on deep purple/violet as a primary color? (Flag this as an overused AI-generated cliché).
75
- - **Z-Axis Depth:** Are shadows realistic (multi-layered CSS shadows) or flat and cheap (`box-shadow: 0 4px 6px #000`)?
76
- - **Micro-Interactions:** Do buttons scale down slightly on `:active`? Do elements use spring-physics easing (`cubic-bezier(0.34, 1.56, 0.64, 1)`)?
77
-
78
- ### 5. AI & Streaming UX
79
-
80
- - **Zero-Wait States:** If the app is waiting for an LLM/Server response, does it show a static spinner (BAD) or stream the skeleton/content (GOOD)?
81
- - **Optimistic UI:** Do likes/saves update the UI _instantly_ before the server confirms?
27
+ This skill defines performance, accessibility, and rendering efficiency guidelines.
82
28
 
83
29
  ---
84
30
 
85
- ## Common Review Findings
86
-
87
- | Finding | Severity | Fix |
88
- | ------------------------------- | --------- | --------------------------------------------- |
89
- | Missing/Weak focus styles | High | Add visible `:focus-visible` with offset |
90
- | `margin`/`padding` animated | High | Change to `transform: translate()` |
91
- | Touch targets under 48px | High | Increase padding/min-height |
92
- | Layout shifts on load (CLS > 0) | High | Pre-allocate space for async content/images |
93
- | Linear CSS transitions | Medium | Upgrade to spring-based `cubic-bezier` curves |
94
- | Purple as primary color | Low/Brand | Rethink palette — overused AI design cliché |
95
-
96
- ---
97
-
98
- ## Audit Format Template
99
-
100
- When reporting a UI review, use this exact brutal structure:
101
-
102
- ```markdown
103
- ## UI/UX Pro-Max Review: [Component/Page Name]
104
-
105
- ### ♿ Neuro-Inclusivity & A11y
106
-
107
- - [BLOCKER] [Finding with specific element and fix]
108
- - [WARN] [Finding]
109
-
110
- ### ⚡ Performance & Energy (CWV)
111
-
112
- - [Finding]
113
-
114
- ### 🎨 Visual & Spatial Quality
115
-
116
- - [Finding]
117
-
118
- ### 🛠️ Interaction & Physics
31
+ ## 1. APCA Contrast Guidelines (WCAG 3.0 Base)
119
32
 
120
- - [Finding]
121
-
122
- ### Summary
123
-
124
- X blockers, Y warnings, Z suggestions.
125
- Recommended action before shipping: [specific steps]
126
- ```
33
+ APCA calculates lightness contrast mathematically based on font size and background luminance.
34
+ * **Body Text:** Lc > 75 is required for body text readability.
35
+ * **Headings:** Lc > 60 is required for headings.
36
+ * **Controls/Borders:** Lc > 45 is required for visual divider borders and focus rings.
127
37
 
128
38
  ---
129
39
 
130
- ## Output Format
131
-
132
- When this skill produces a recommendation or design decision, structure your output as:
133
-
134
- ```
135
- ━━━ Web Design Guidelines Recommendation ━━━━━━━━━━━━━━━━
136
- Decision: [what was chosen / proposed]
137
- Rationale: [why — one concise line]
138
- Trade-offs: [what is consciously accepted]
139
- Next action: [concrete next step for the user]
140
- ─────────────────────────────────────────────────
141
- Pre-Flight: ✅ All checks passed
142
- or ❌ [blocking item that must be resolved first]
143
- ```
40
+ ## 2. Core Web Vitals (CWV)
41
+ * **Largest Contentful Paint (LCP < 1.5s):** Hero banners and images must use the `fetchpriority="high"` tag. Avoid blocking layout paints with heavy JS scripts.
42
+ * **Interaction to Next Paint (INP < 100ms):** Enforce main-thread speed. Wrap heavy operations in `startTransition` or React's deferred values.
43
+ * **Cumulative Layout Shift (CLS = 0.00):** Image nodes must declare explicit width/height dimensions or aspect-ratios. Pre-allocate spaces for dynamic elements.
144
44
 
145
45
  ---
146
46
 
147
- ---
148
-
149
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
150
-
151
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
152
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
153
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
154
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
155
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
47
+ ## 3. Sustainable & Battery-Efficient UI
48
+ * **Compositor Properties:** Transitions and animations must only animate `transform` and `opacity`. Animating properties like `margin`, `width`, `height`, or `top` triggers layout reflows and wastes CPU cycles.
49
+ * **OLED Blacks:** For dark luxury themes, base backgrounds must use OLED-friendly blacks (`oklch(0.08 0.005 250)` or `#000000`) to physically turn off pixels on compatible screens.
50
+ * **Font Subsetting:** Self-host typography files and use variable fonts to minimize network payloads.
51
+ * **Image Formats:** Serve images exclusively in AVIF or WebP formats.
156
52
 
157
53
  ---
158
54
 
159
- **Slash command: `/review` or `/tribunal-full`**
160
- **Active reviewers: `logic-reviewer` · `security-auditor`**
161
-
162
- ### ❌ Forbidden AI Tropes
163
-
164
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
165
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
166
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
167
-
168
- Review these questions before confirming output:
169
-
170
- ```
171
- ✅ Did I rely ONLY on real, verified tools and methods?
172
- ✅ Is this solution appropriately scoped to the user's constraints?
173
- ✅ Did I handle potential failure modes and edge cases?
174
- ✅ Have I avoided generic boilerplate that doesn't add value?
175
- ```
176
-
177
- ### 🛑 Verification-Before-Completion (VBC) Protocol
178
-
179
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
180
-
181
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
182
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
183
-
184
55
  ## Pre-Flight Checklist
185
-
186
56
  - [ ] Have I reviewed the user's specific constraints and requests?
187
57
  - [ ] Have I checked the environment for relevant existing implementations?
188
58
 
189
59
  ## VBC Protocol (Verification-Before-Completion)
190
-
191
60
  You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
192
-
193
- ---
194
-
195
- ## 🤖 LLM-Specific Traps
196
-
197
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
198
-
199
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
200
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
201
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
202
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
203
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
204
-
205
- ---
206
-
207
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
208
-
209
- **Slash command: `/review` or `/tribunal-full`**
210
- **Active reviewers: `logic-reviewer` · `security-auditor`**
211
-
212
- ### ❌ Forbidden AI Tropes
213
-
214
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
215
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
216
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
217
-
218
- ### ✅ Pre-Flight Self-Audit
219
-
220
- Review these questions before confirming output:
221
-
222
- ```
223
- ✅ Did I rely ONLY on real, verified tools and methods?
224
- ✅ Is this solution appropriately scoped to the user's constraints?
225
- ✅ Did I handle potential failure modes and edge cases?
226
- ✅ Have I avoided generic boilerplate that doesn't add value?
227
- ```
228
-
229
- ### 🛑 Verification-Before-Completion (VBC) Protocol
230
-
231
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
232
-
233
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
234
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: web-quality-audit
3
3
  description: Web quality auditing skill for Lighthouse-style analysis across Performance, Accessibility, Best Practices, and SEO signals.
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Full-Stack Web Quality & Lighthouse Signals
9
- tier: pro
10
- co-requires: [web-accessibility-auditor, fixing-metadata, performance-profiling]
11
- trigger-signals:
12
- strong: [web-quality-audit, Lighthouse audit, Core Web Vitals audit, web quality report, LCP CLS INP audit]
13
- weak: [quality audit, site audit]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - web-design-guidelines
8
+ - fixing-accessibility
9
+ - fixing-metadata
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # Web Quality Audit — Lighthouse & Core Web Vitals
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before executing web quality audits or Lighthouse-style evaluations, you MUST inspect:
23
+ 1. Core Web Vitals Benchmarks (Section 24) → LCP $\le 2.5\text{s}$, INP $\le 200\text{ms}$, CLS $\le 0.1$
24
+ 2. Layout Shift Prevention (Section 27) → Enforce explicit `width`/`height` or aspect-ratio declarations on all media tags
25
+ 3. Async Script Loading (Section 46) → Enforce `async` or `defer` attributes on all third-party script tags in `<head>`
26
+
18
27
  Conduct a comprehensive multi-pillar web quality audit covering Performance, Accessibility, Best Practices, and SEO signals.
19
28
 
20
29
  ---
@@ -1,15 +1,29 @@
1
1
  ---
2
2
  name: webapp-testing
3
3
  description: Comprehensive Web Application Testing strategy. Test Pyramid, Vitest/Jest for unit logic, React Testing Library for component integrity, MSW (Mock Service Worker) for API layer simulation, and visual regression. Use when setting up testing environments or defining global test strategies across a web stack.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 2.0.0
6
- last-updated: 2026-04-02
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- routing:
9
- domain: general
10
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - testing-patterns
9
+ - playwright-best-practices
10
+ - tdd-workflow
11
+ scripts-binding:
12
+ - .agent/scripts/test_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
16
+ # Webapp Testing — Full Stack Pipeline Mastery
17
+
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before building web application test suites or configuring component mocks, you MUST inspect:
23
+ 1. Testing Trophy Allocation (Section 27) → Prioritize Integration tests (60% RTL + MSW) over pure Unit (20%) or E2E (10%)
24
+ 2. MSW Network Interception Rule (Section 40) → Intercept HTTP network calls via MSW (`setupServer`); ban mocking library clients like `axios.get.mockResolvedValue`
25
+ 3. Decouple Business Logic from React (Section 99) → Extract complex calculations into pure testable functions outside React components
26
+
13
27
  ## Hallucination Traps (Read First)
14
28
 
15
29
  - ❌ Mocking everything in integration tests -> ✅ Integration tests verify real interactions; mock only external services (APIs, DBs)
@@ -1,13 +1,29 @@
1
1
  ---
2
2
  name: webgpu-performance
3
3
  description: High-performance browser graphics and compute mastery. Transitioning from WebGL to WebGPU API, WGSL compute shaders, explicit GPU memory management, and browser-side tensor calculations.
4
- routing:
5
- domain: general
6
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - 60fps-animation
9
+ - fixing-motion-performance
10
+ - motion-engineering
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
7
14
  ---
8
15
 
9
16
  # WebGPU Performance Mastery
10
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before implementing WebGPU shaders or pipelines, you MUST inspect:
23
+ 1. Feature Detection (Section 64) → Always feature-detect WebGPU with `if (!navigator.gpu)` and provide WebGL fallback
24
+ 2. WGSL Buffer Alignment (Section 17) → Pad WGSL structs strictly to 16-byte boundaries (`vec4<f32>`) to prevent memory corruption
25
+ 3. Async Buffer Mapping (Section 68) → Use `mapAsync(GPUMapMode.READ)` to read GPU buffers without main-thread blocking
26
+
11
27
  You are an expert in writing low-level, high-performance browser graphics and compute pipelines using WebGPU and WGSL (WebGPU Shading Language). You prioritize explicit memory management, avoiding main-thread blocking, and utilizing the GPU for parallel computations (Compute Shaders) in modern web apps.
12
28
 
13
29
  ## 1. Core Principles
@@ -1,19 +1,29 @@
1
1
  ---
2
2
  name: whimsy-injector
3
3
  description: Micro-delight generator for frontend interfaces. Suggests and implements subtle animations, playful transitions, and interaction polish across any frontend stack.
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
4
7
  skills:
5
- - frontend-design
6
- - trend-researcher
7
- - ui-ux-researcher
8
- version: 1.0.0
9
- last-updated: 2026-03-12
10
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
11
- routing:
12
- domain: general
13
- tier: basic
8
+ - delight
9
+ - micro-interaction
10
+ - 60fps-animation
11
+ - accessible-animation
12
+ scripts-binding:
13
+ - .agent/scripts/lint_runner.js
14
+ - .agent/scripts/verify_all.js
14
15
  ---
15
16
 
16
- # Whimsy Injector Skill
17
+ # Whimsy Injector Skill — Micro-Delight Generator
18
+
19
+ ---
20
+
21
+ ## Mandatory Pre-Flight Context Inspection
22
+
23
+ Before injecting micro-animations or interaction polish, you MUST inspect:
24
+ 1. `package.json` → Check installed motion dependencies (`framer-motion`, `gsap`, `@vueuse/motion`, CSS-only)
25
+ 2. Whimsy Quota Rules (Section 228) → Max 3 distinct animation types per page; keep CLS impact at ZERO
26
+ 3. Duration Constraints (Section 238) → Keep hover interactions $\le 150\text{ms}$ and entrance animations $\le 300\text{ms}$
17
27
 
18
28
  You are a specialized agent for injecting "micro-delights" into user interfaces — small, tasteful animations and interaction polish that make an app feel alive and premium. You work across all frontend stacks: vanilla CSS, React, Vue, Svelte, Angular, and static HTML.
19
29
 
@@ -1,19 +1,29 @@
1
1
  ---
2
2
  name: workflow-optimizer
3
3
  description: Analyzes agent tool-calling patterns and task execution efficiency to suggest process improvements.
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
4
6
  skills:
5
7
  - parallel-agents
6
8
  - plan-writing
7
- version: 1.0.0
8
- last-updated: 2026-03-12
9
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
10
- routing:
11
- domain: general
12
- tier: basic
9
+ - fabel-protocol
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/verify_all.js
13
+ - .agent/scripts/checklist.js
13
14
  ---
14
15
 
15
16
  # Workflow Optimizer Skill
16
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before analyzing tool-calling logs or task efficiency, you MUST inspect:
23
+ 1. Tool Call Pattern Analysis table (Section 1) → Classify redundant reads, serial bottlenecks, and context dumps
24
+ 2. Parallelism Opportunity Detection (Section 2) → Verify read/write dependency rules for batch tool calls
25
+ 3. Efficiency Score formula (Section 105) → Compute actual vs optimal call ratios accurately
26
+
17
27
  You are a specialized agent for analyzing and optimizing the efficiency of AI agent workflows, task execution loops, and tool-calling patterns. You act as a "meta-debugger" — debugging the _process_, not the _code_.
18
28
 
19
29
  ## When to Activate