tribunal-kit 9.2.3 → 9.2.5

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 (1505) hide show
  1. package/.agent/.manifest.json +78 -78
  2. package/.agent/.shared/ui-ux-pro-max/README.md +4 -4
  3. package/.agent/.tribunal/session.jsonl +15 -0
  4. package/.agent/ADRs/ADR-001-system-architecture-intelligence.md +49 -0
  5. package/.agent/ARCHITECTURE.md +63 -63
  6. package/.agent/agents/accessibility-reviewer.md +109 -109
  7. package/.agent/agents/agent-shield-auditor.md +18 -0
  8. package/.agent/agents/ai-code-reviewer.md +223 -223
  9. package/.agent/agents/anti-pattern-reviewer.md +104 -104
  10. package/.agent/agents/api-architect.md +89 -89
  11. package/.agent/agents/architecture-auditor.md +195 -0
  12. package/.agent/agents/backend-specialist.md +242 -242
  13. package/.agent/agents/cloud-engineer.md +120 -120
  14. package/.agent/agents/code-archaeologist.md +186 -186
  15. package/.agent/agents/complexity-reviewer.md +76 -76
  16. package/.agent/agents/database-architect.md +206 -206
  17. package/.agent/agents/db-latency-auditor.md +237 -237
  18. package/.agent/agents/debugger.md +215 -215
  19. package/.agent/agents/dependency-reviewer.md +124 -124
  20. package/.agent/agents/devops-engineer.md +240 -240
  21. package/.agent/agents/documentation-writer.md +228 -228
  22. package/.agent/agents/explorer-agent.md +186 -186
  23. package/.agent/agents/frontend-reviewer.md +195 -195
  24. package/.agent/agents/frontend-specialist.md +122 -122
  25. package/.agent/agents/game-developer.md +68 -68
  26. package/.agent/agents/harness-manager.md +49 -0
  27. package/.agent/agents/human-gate-negotiator.md +22 -0
  28. package/.agent/agents/interaction-reviewer.md +123 -123
  29. package/.agent/agents/kernel-scheduler.md +56 -0
  30. package/.agent/agents/logic-reviewer.md +147 -147
  31. package/.agent/agents/memory-archivist.md +37 -0
  32. package/.agent/agents/minimalist-reviewer.md +104 -104
  33. package/.agent/agents/mobile-developer.md +216 -216
  34. package/.agent/agents/mobile-reviewer.md +180 -180
  35. package/.agent/agents/orchestrator.md +268 -263
  36. package/.agent/agents/penetration-tester.md +180 -180
  37. package/.agent/agents/performance-optimizer.md +202 -202
  38. package/.agent/agents/performance-reviewer.md +180 -180
  39. package/.agent/agents/pipeline-reviewer.md +144 -144
  40. package/.agent/agents/precedence-reviewer.md +266 -266
  41. package/.agent/agents/product-manager.md +167 -167
  42. package/.agent/agents/product-owner.md +103 -103
  43. package/.agent/agents/product-reviewer.md +103 -103
  44. package/.agent/agents/project-planner.md +181 -176
  45. package/.agent/agents/qa-automation-engineer.md +244 -244
  46. package/.agent/agents/resilience-reviewer.md +108 -108
  47. package/.agent/agents/schema-reviewer.md +87 -87
  48. package/.agent/agents/security-auditor.md +204 -199
  49. package/.agent/agents/seo-specialist.md +213 -213
  50. package/.agent/agents/sql-reviewer.md +180 -180
  51. package/.agent/agents/supervisor-agent.md +202 -202
  52. package/.agent/agents/swarm-worker-contracts.md +170 -170
  53. package/.agent/agents/swarm-worker-registry.md +99 -99
  54. package/.agent/agents/system-architect.md +260 -105
  55. package/.agent/agents/test-coverage-reviewer.md +181 -181
  56. package/.agent/agents/test-engineer.md +138 -138
  57. package/.agent/agents/throughput-optimizer.md +316 -316
  58. package/.agent/agents/type-safety-reviewer.md +202 -202
  59. package/.agent/agents/ui-ux-auditor.md +80 -80
  60. package/.agent/agents/ui-visual-auditor.md +102 -102
  61. package/.agent/agents/ux-reviewer.md +109 -109
  62. package/.agent/agents/visual-reviewer.md +103 -103
  63. package/.agent/agents/vitals-reviewer.md +245 -245
  64. package/.agent/config/claude.json +18 -18
  65. package/.agent/config/plugin.json +102 -102
  66. package/.agent/config/slash-commands.json +115 -115
  67. package/.agent/config/specialist-registry.json +415 -415
  68. package/.agent/config/system-prompt.md +258 -258
  69. package/.agent/history/arch-mapper-cache.json +6712 -0
  70. package/.agent/history/architecture.idx.json +5746 -0
  71. package/.agent/mcp_config.json +32 -32
  72. package/.agent/patterns/generator.md +11 -11
  73. package/.agent/patterns/inversion.md +14 -14
  74. package/.agent/patterns/pipeline.md +11 -11
  75. package/.agent/patterns/reviewer.md +15 -15
  76. package/.agent/patterns/tool-wrapper.md +11 -11
  77. package/.agent/plans/implementation_plan.md +48 -0
  78. package/.agent/plans/task.md +35 -0
  79. package/.agent/routing_index.json +2060 -2060
  80. package/.agent/rules/GEMINI.md +437 -437
  81. package/.agent/rules/GEMINI_PLANNER.md +82 -82
  82. package/.agent/rules/kernel.md +86 -86
  83. package/.agent/scripts/_colors.js +210 -210
  84. package/.agent/scripts/_utils.js +373 -377
  85. package/.agent/scripts/architecture_mapper.js +625 -0
  86. package/.agent/scripts/ast_context_loader.js +137 -137
  87. package/.agent/scripts/auto_preview.js +203 -203
  88. package/.agent/scripts/browser_audit.js +102 -102
  89. package/.agent/scripts/bundle_analyzer.js +287 -287
  90. package/.agent/scripts/case_law_manager.js +887 -887
  91. package/.agent/scripts/checklist.js +300 -300
  92. package/.agent/scripts/cicd_validator.js +305 -305
  93. package/.agent/scripts/context_broker.js +962 -962
  94. package/.agent/scripts/context_compiler.js +1143 -1112
  95. package/.agent/scripts/contract_engine.js +402 -402
  96. package/.agent/scripts/dependency_analyzer.js +313 -313
  97. package/.agent/scripts/graph_builder.js +384 -384
  98. package/.agent/scripts/graph_visualizer.js +390 -390
  99. package/.agent/scripts/graph_zoom.js +181 -181
  100. package/.agent/scripts/guardrail_engine.js +785 -785
  101. package/.agent/scripts/harness_manager.js +60 -0
  102. package/.agent/scripts/impact_classifier.js +192 -192
  103. package/.agent/scripts/inner_loop_validator.js +472 -472
  104. package/.agent/scripts/integrity_manifest.js +484 -484
  105. package/.agent/scripts/lint_runner.js +218 -218
  106. package/.agent/scripts/marathon_harness.js +986 -986
  107. package/.agent/scripts/mcp_server.js +181 -0
  108. package/.agent/scripts/memory_archivist.js +97 -0
  109. package/.agent/scripts/memory_consolidator.js +37 -0
  110. package/.agent/scripts/memory_engine.js +782 -742
  111. package/.agent/scripts/minify_context.js +111 -111
  112. package/.agent/scripts/minimal_change_engine.js +445 -445
  113. package/.agent/scripts/mutation_runner.js +307 -305
  114. package/.agent/scripts/payload_schemas.js +164 -164
  115. package/.agent/scripts/pipeline_engine.js +906 -891
  116. package/.agent/scripts/prompt_compiler.js +272 -272
  117. package/.agent/scripts/schema_validator.js +326 -326
  118. package/.agent/scripts/security_scan.js +390 -390
  119. package/.agent/scripts/session_logger.js +115 -0
  120. package/.agent/scripts/session_manager.js +299 -289
  121. package/.agent/scripts/signal_detector.js +175 -175
  122. package/.agent/scripts/skill_evolution.js +997 -997
  123. package/.agent/scripts/skill_integrator.js +304 -304
  124. package/.agent/scripts/socratic_gate_policy.js +63 -63
  125. package/.agent/scripts/strengthen_skills.js +199 -199
  126. package/.agent/scripts/swarm_dispatcher.js +983 -906
  127. package/.agent/scripts/syscall_registry.js +105 -0
  128. package/.agent/scripts/test_runner.js +209 -209
  129. package/.agent/scripts/token_budget_broker.js +165 -165
  130. package/.agent/scripts/trace_engine.js +126 -126
  131. package/.agent/scripts/verify_all.js +276 -276
  132. package/.agent/scripts/visual_audit.js +87 -87
  133. package/.agent/skill_topic_map.json +314 -287
  134. package/.agent/skills/12-principles-of-animation/SKILL.md +51 -51
  135. package/.agent/skills/60fps-animation/SKILL.md +91 -91
  136. package/.agent/skills/accessible-animation/SKILL.md +189 -189
  137. package/.agent/skills/adapt/SKILL.md +56 -56
  138. package/.agent/skills/adr-generation/SKILL.md +57 -0
  139. package/.agent/skills/advanced-rag-pipelines/SKILL.md +94 -94
  140. package/.agent/skills/agent-organizer/SKILL.md +117 -117
  141. package/.agent/skills/agent-syscall-guidelines/SKILL.md +25 -0
  142. package/.agent/skills/agentic-patterns/SKILL.md +281 -281
  143. package/.agent/skills/agentic-workflows-2026/SKILL.md +91 -83
  144. package/.agent/skills/agentshield-security/SKILL.md +26 -0
  145. package/.agent/skills/ai-app-hardening/SKILL.md +51 -51
  146. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +162 -162
  147. package/.agent/skills/animation-on-scroll/SKILL.md +196 -196
  148. package/.agent/skills/animation-systems/SKILL.md +198 -198
  149. package/.agent/skills/antfu-conventions/SKILL.md +54 -54
  150. package/.agent/skills/api-patterns/SKILL.md +218 -218
  151. package/.agent/skills/api-security-auditor/SKILL.md +155 -155
  152. package/.agent/skills/app-builder/SKILL.md +535 -535
  153. package/.agent/skills/app-builder/templates/SKILL.md +108 -108
  154. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  155. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  156. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  157. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  158. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  159. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  160. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  161. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -126
  162. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -127
  163. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -172
  164. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -139
  165. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  166. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -122
  167. package/.agent/skills/appflow-wireframe/SKILL.md +96 -96
  168. package/.agent/skills/apple-design/SKILL.md +89 -89
  169. package/.agent/skills/architecture/SKILL.md +188 -188
  170. package/.agent/skills/architecture-drift/SKILL.md +45 -0
  171. package/.agent/skills/audit-and-fix/SKILL.md +100 -100
  172. package/.agent/skills/authentication-best-practices/SKILL.md +157 -157
  173. package/.agent/skills/autonomous-execution/SKILL.md +76 -0
  174. package/.agent/skills/backend-security-expert/SKILL.md +73 -73
  175. package/.agent/skills/baseline-ui/SKILL.md +55 -55
  176. package/.agent/skills/bash-linux/SKILL.md +139 -139
  177. package/.agent/skills/behavioral-modes/SKILL.md +200 -200
  178. package/.agent/skills/better-colors/SKILL.md +116 -116
  179. package/.agent/skills/better-typography/SKILL.md +90 -90
  180. package/.agent/skills/better-ui/SKILL.md +130 -130
  181. package/.agent/skills/bolder/SKILL.md +49 -49
  182. package/.agent/skills/brainstorming/SKILL.md +460 -460
  183. package/.agent/skills/browser-audit/SKILL.md +102 -102
  184. package/.agent/skills/browser-native-ai/SKILL.md +72 -72
  185. package/.agent/skills/build-primitive/SKILL.md +50 -50
  186. package/.agent/skills/building-native-ui/SKILL.md +162 -162
  187. package/.agent/skills/cicd-pro/SKILL.md +412 -412
  188. package/.agent/skills/clarify/SKILL.md +55 -55
  189. package/.agent/skills/clean-code/SKILL.md +367 -367
  190. package/.agent/skills/cloud-architect/SKILL.md +409 -409
  191. package/.agent/skills/cobejs/SKILL.md +70 -70
  192. package/.agent/skills/code-review-checklist/SKILL.md +163 -163
  193. package/.agent/skills/codebase-design/SKILL.md +76 -76
  194. package/.agent/skills/colorize/SKILL.md +57 -57
  195. package/.agent/skills/compact-landing/SKILL.md +50 -50
  196. package/.agent/skills/company-logos/SKILL.md +54 -54
  197. package/.agent/skills/config-validator/SKILL.md +125 -125
  198. package/.agent/skills/containerization-pro/SKILL.md +422 -422
  199. package/.agent/skills/context-engineering-pro/SKILL.md +69 -62
  200. package/.agent/skills/create-design-md/SKILL.md +92 -92
  201. package/.agent/skills/critique/SKILL.md +79 -79
  202. package/.agent/skills/csharp-developer/SKILL.md +478 -478
  203. package/.agent/skills/data-validation-schemas/SKILL.md +297 -297
  204. package/.agent/skills/database-design/SKILL.md +219 -219
  205. package/.agent/skills/delight/SKILL.md +46 -46
  206. package/.agent/skills/deployment-procedures/SKILL.md +132 -132
  207. package/.agent/skills/design-lab/SKILL.md +42 -42
  208. package/.agent/skills/devops-engineer/SKILL.md +305 -305
  209. package/.agent/skills/devops-incident-responder/SKILL.md +103 -103
  210. package/.agent/skills/diagnosing-bugs/SKILL.md +172 -172
  211. package/.agent/skills/distill/SKILL.md +45 -45
  212. package/.agent/skills/documentation-templates/SKILL.md +251 -251
  213. package/.agent/skills/domain-modeling/SKILL.md +61 -61
  214. package/.agent/skills/duckdb-analytical-sql/SKILL.md +51 -51
  215. package/.agent/skills/edge-ai-mobile/SKILL.md +42 -42
  216. package/.agent/skills/edge-computing/SKILL.md +143 -143
  217. package/.agent/skills/emil-design-eng/SKILL.md +134 -134
  218. package/.agent/skills/error-resilience/SKILL.md +403 -403
  219. package/.agent/skills/expo-router-v4/SKILL.md +72 -72
  220. package/.agent/skills/extract-design-system/SKILL.md +120 -120
  221. package/.agent/skills/fabel-protocol/SKILL.md +282 -277
  222. package/.agent/skills/failure-mode-analysis/SKILL.md +48 -0
  223. package/.agent/skills/fixing-accessibility/SKILL.md +87 -87
  224. package/.agent/skills/fixing-metadata/SKILL.md +83 -83
  225. package/.agent/skills/fixing-motion-performance/SKILL.md +78 -78
  226. package/.agent/skills/framer-motion-expert/SKILL.md +237 -237
  227. package/.agent/skills/frontend-design/SKILL.md +103 -103
  228. package/.agent/skills/frontend-security-expert/SKILL.md +56 -56
  229. package/.agent/skills/game-design-expert/SKILL.md +92 -92
  230. package/.agent/skills/game-engineering-expert/SKILL.md +108 -108
  231. package/.agent/skills/generative-ui-expert/SKILL.md +100 -100
  232. package/.agent/skills/geo-fundamentals/SKILL.md +108 -108
  233. package/.agent/skills/git-pro/SKILL.md +401 -401
  234. package/.agent/skills/github-operations/SKILL.md +295 -295
  235. package/.agent/skills/gpt-taste/SKILL.md +50 -50
  236. package/.agent/skills/graph-engineering/SKILL.md +28 -0
  237. package/.agent/skills/gsap-core/SKILL.md +277 -277
  238. package/.agent/skills/gsap-frameworks/SKILL.md +168 -168
  239. package/.agent/skills/gsap-performance/SKILL.md +94 -94
  240. package/.agent/skills/gsap-plugins/SKILL.md +441 -441
  241. package/.agent/skills/gsap-react/SKILL.md +213 -213
  242. package/.agent/skills/gsap-scrolltrigger/SKILL.md +312 -312
  243. package/.agent/skills/gsap-timeline/SKILL.md +122 -122
  244. package/.agent/skills/gsap-utils/SKILL.md +299 -299
  245. package/.agent/skills/harden/SKILL.md +55 -55
  246. package/.agent/skills/harness-protocol/SKILL.md +48 -40
  247. package/.agent/skills/hf-cli/SKILL.md +239 -0
  248. package/.agent/skills/hf-cloud-aws-context-discovery/SKILL.md +74 -0
  249. package/.agent/skills/hf-cloud-python-env-setup/SKILL.md +90 -0
  250. package/.agent/skills/hf-cloud-python-env-setup/requirements.txt +17 -0
  251. package/.agent/skills/hf-cloud-python-env-setup/scripts/check_versions.py +29 -0
  252. package/.agent/skills/hf-cloud-python-env-setup/scripts/setup_env.py +143 -0
  253. package/.agent/skills/hf-cloud-sagemaker-deployment-planner/SKILL.md +90 -0
  254. package/.agent/skills/hf-cloud-sagemaker-iam-preflight/SKILL.md +102 -0
  255. package/.agent/skills/hf-cloud-sagemaker-iam-preflight/references/minimum-permissions.json +47 -0
  256. package/.agent/skills/hf-cloud-sagemaker-iam-preflight/references/trust-policy.json +12 -0
  257. package/.agent/skills/hf-cloud-sagemaker-iam-preflight/scripts/check_role.py +184 -0
  258. package/.agent/skills/hf-cloud-sagemaker-iam-preflight/scripts/create_role.py +118 -0
  259. package/.agent/skills/hf-cloud-sagemaker-production-defaults/SKILL.md +419 -0
  260. package/.agent/skills/hf-cloud-sagemaker-production-defaults/references/deployment-template.md +59 -0
  261. package/.agent/skills/hf-cloud-sagemaker-production-defaults/scripts/_common.py +148 -0
  262. package/.agent/skills/hf-cloud-sagemaker-production-defaults/scripts/deploy.py +327 -0
  263. package/.agent/skills/hf-cloud-sagemaker-production-defaults/scripts/deploy_async.py +434 -0
  264. package/.agent/skills/hf-cloud-sagemaker-production-defaults/scripts/deploy_ic.py +506 -0
  265. package/.agent/skills/hf-cloud-sagemaker-production-defaults/scripts/invoke_endpoint.py +180 -0
  266. package/.agent/skills/hf-cloud-sagemaker-production-defaults/scripts/teardown.py +246 -0
  267. package/.agent/skills/hf-cloud-serving-image-selection/SKILL.md +220 -0
  268. package/.agent/skills/hf-cloud-serving-image-selection/references/model-to-image.md +111 -0
  269. package/.agent/skills/hf-cloud-serving-image-selection/scripts/mirror_image.py +145 -0
  270. package/.agent/skills/hf-mem/SKILL.md +79 -0
  271. package/.agent/skills/huggingface-best/SKILL.md +134 -0
  272. package/.agent/skills/huggingface-community-evals/SKILL.md +207 -0
  273. package/.agent/skills/huggingface-community-evals/examples/.env.example +3 -0
  274. package/.agent/skills/huggingface-community-evals/examples/USAGE_EXAMPLES.md +101 -0
  275. package/.agent/skills/huggingface-community-evals/scripts/inspect_eval_uv.py +104 -0
  276. package/.agent/skills/huggingface-community-evals/scripts/inspect_vllm_uv.py +306 -0
  277. package/.agent/skills/huggingface-community-evals/scripts/lighteval_vllm_uv.py +297 -0
  278. package/.agent/skills/huggingface-datasets/SKILL.md +107 -0
  279. package/.agent/skills/huggingface-gradio/SKILL.md +298 -0
  280. package/.agent/skills/huggingface-gradio/examples.md +613 -0
  281. package/.agent/skills/huggingface-llm-trainer/SKILL.md +738 -0
  282. package/.agent/skills/huggingface-llm-trainer/references/gguf_conversion.md +296 -0
  283. package/.agent/skills/huggingface-llm-trainer/references/hardware_guide.md +283 -0
  284. package/.agent/skills/huggingface-llm-trainer/references/hub_saving.md +364 -0
  285. package/.agent/skills/huggingface-llm-trainer/references/local_training_macos.md +231 -0
  286. package/.agent/skills/huggingface-llm-trainer/references/reliability_principles.md +371 -0
  287. package/.agent/skills/huggingface-llm-trainer/references/trackio_guide.md +191 -0
  288. package/.agent/skills/huggingface-llm-trainer/references/training_methods.md +150 -0
  289. package/.agent/skills/huggingface-llm-trainer/references/training_patterns.md +203 -0
  290. package/.agent/skills/huggingface-llm-trainer/references/troubleshooting.md +282 -0
  291. package/.agent/skills/huggingface-llm-trainer/references/unsloth.md +313 -0
  292. package/.agent/skills/huggingface-llm-trainer/scripts/convert_to_gguf.py +424 -0
  293. package/.agent/skills/huggingface-llm-trainer/scripts/dataset_inspector.py +417 -0
  294. package/.agent/skills/huggingface-llm-trainer/scripts/estimate_cost.py +150 -0
  295. package/.agent/skills/huggingface-llm-trainer/scripts/hf_benchmarks.py +659 -0
  296. package/.agent/skills/huggingface-llm-trainer/scripts/train_dpo_example.py +106 -0
  297. package/.agent/skills/huggingface-llm-trainer/scripts/train_grpo_example.py +89 -0
  298. package/.agent/skills/huggingface-llm-trainer/scripts/train_sft_example.py +122 -0
  299. package/.agent/skills/huggingface-llm-trainer/scripts/unsloth_sft_example.py +512 -0
  300. package/.agent/skills/huggingface-local-models/SKILL.md +113 -0
  301. package/.agent/skills/huggingface-local-models/references/hardware.md +38 -0
  302. package/.agent/skills/huggingface-local-models/references/hub-discovery.md +178 -0
  303. package/.agent/skills/huggingface-local-models/references/quantization.md +256 -0
  304. package/.agent/skills/huggingface-lora-space-builder/SKILL.md +394 -0
  305. package/.agent/skills/huggingface-lora-space-builder/references/adapting-to-the-lora.md +113 -0
  306. package/.agent/skills/huggingface-lora-space-builder/references/base-models/krea-2.md +63 -0
  307. package/.agent/skills/huggingface-lora-space-builder/references/base-models/ltx.md +205 -0
  308. package/.agent/skills/huggingface-lora-space-builder/references/base-models/qwen-image.md +144 -0
  309. package/.agent/skills/huggingface-lora-space-builder/references/creative-mode.md +262 -0
  310. package/.agent/skills/huggingface-lora-space-builder/references/tasks.md +124 -0
  311. package/.agent/skills/huggingface-lora-space-builder/references/zerogpu-and-publishing.md +196 -0
  312. package/.agent/skills/huggingface-paper-publisher/SKILL.md +624 -0
  313. package/.agent/skills/huggingface-paper-publisher/examples/example_usage.md +326 -0
  314. package/.agent/skills/huggingface-paper-publisher/references/quick_reference.md +216 -0
  315. package/.agent/skills/huggingface-paper-publisher/scripts/paper_manager.py +606 -0
  316. package/.agent/skills/huggingface-paper-publisher/templates/arxiv.md +299 -0
  317. package/.agent/skills/huggingface-paper-publisher/templates/ml-report.md +358 -0
  318. package/.agent/skills/huggingface-paper-publisher/templates/modern.md +319 -0
  319. package/.agent/skills/huggingface-paper-publisher/templates/standard.md +201 -0
  320. package/.agent/skills/huggingface-papers/SKILL.md +239 -0
  321. package/.agent/skills/huggingface-spaces/README.md +9 -0
  322. package/.agent/skills/huggingface-spaces/SKILL.md +242 -0
  323. package/.agent/skills/huggingface-spaces/references/3d-cuda-extensions.md +109 -0
  324. package/.agent/skills/huggingface-spaces/references/3d-generation.md +98 -0
  325. package/.agent/skills/huggingface-spaces/references/3d-gsplat.md +53 -0
  326. package/.agent/skills/huggingface-spaces/references/3d-models.md +227 -0
  327. package/.agent/skills/huggingface-spaces/references/3d-outputs.md +114 -0
  328. package/.agent/skills/huggingface-spaces/references/buckets.md +89 -0
  329. package/.agent/skills/huggingface-spaces/references/debugging.md +236 -0
  330. package/.agent/skills/huggingface-spaces/references/gradio.md +200 -0
  331. package/.agent/skills/huggingface-spaces/references/grants.md +63 -0
  332. package/.agent/skills/huggingface-spaces/references/inference-providers.md +97 -0
  333. package/.agent/skills/huggingface-spaces/references/known-errors.md +232 -0
  334. package/.agent/skills/huggingface-spaces/references/requirements.md +169 -0
  335. package/.agent/skills/huggingface-spaces/references/zerogpu.md +349 -0
  336. package/.agent/skills/huggingface-tool-builder/SKILL.md +120 -0
  337. package/.agent/skills/huggingface-tool-builder/references/baseline_hf_api.py +57 -0
  338. package/.agent/skills/huggingface-tool-builder/references/baseline_hf_api.sh +40 -0
  339. package/.agent/skills/huggingface-tool-builder/references/baseline_hf_api.tsx +57 -0
  340. package/.agent/skills/huggingface-tool-builder/references/find_models_by_paper.sh +230 -0
  341. package/.agent/skills/huggingface-tool-builder/references/hf_enrich_models.sh +96 -0
  342. package/.agent/skills/huggingface-tool-builder/references/hf_model_card_frontmatter.sh +188 -0
  343. package/.agent/skills/huggingface-tool-builder/references/hf_model_papers_auth.sh +171 -0
  344. package/.agent/skills/huggingface-trackio/SKILL.md +142 -0
  345. package/.agent/skills/huggingface-trackio/references/alerts.md +196 -0
  346. package/.agent/skills/huggingface-trackio/references/logging_metrics.md +212 -0
  347. package/.agent/skills/huggingface-trackio/references/retrieving_metrics.md +251 -0
  348. package/.agent/skills/huggingface-vision-trainer/SKILL.md +593 -0
  349. package/.agent/skills/huggingface-vision-trainer/references/finetune_sam2_trainer.md +254 -0
  350. package/.agent/skills/huggingface-vision-trainer/references/hub_saving.md +618 -0
  351. package/.agent/skills/huggingface-vision-trainer/references/image_classification_training_notebook.md +279 -0
  352. package/.agent/skills/huggingface-vision-trainer/references/object_detection_training_notebook.md +700 -0
  353. package/.agent/skills/huggingface-vision-trainer/references/reliability_principles.md +310 -0
  354. package/.agent/skills/huggingface-vision-trainer/references/timm_trainer.md +91 -0
  355. package/.agent/skills/huggingface-vision-trainer/scripts/dataset_inspector.py +814 -0
  356. package/.agent/skills/huggingface-vision-trainer/scripts/estimate_cost.py +217 -0
  357. package/.agent/skills/huggingface-vision-trainer/scripts/image_classification_training.py +383 -0
  358. package/.agent/skills/huggingface-vision-trainer/scripts/object_detection_training.py +710 -0
  359. package/.agent/skills/huggingface-vision-trainer/scripts/sam_segmentation_training.py +382 -0
  360. package/.agent/skills/huggingface-zerogpu/SKILL.md +289 -0
  361. package/.agent/skills/huggingface-zerogpu/references/concurrency.md +79 -0
  362. package/.agent/skills/huggingface-zerogpu/references/cuda-and-deps.md +66 -0
  363. package/.agent/skills/huggingface-zerogpu/references/how-quota-works.md +74 -0
  364. package/.agent/skills/huggingface-zerogpu/references/how-zerogpu-works.md +50 -0
  365. package/.agent/skills/human-gate-negotiation/SKILL.md +30 -0
  366. package/.agent/skills/i18n-localization/SKILL.md +134 -134
  367. package/.agent/skills/impeccable/SKILL.md +52 -52
  368. package/.agent/skills/improve-codebase-architecture/SKILL.md +48 -48
  369. package/.agent/skills/improve-ui/SKILL.md +70 -70
  370. package/.agent/skills/intelligent-routing/SKILL.md +204 -198
  371. package/.agent/skills/knowledge-graph/SKILL.md +71 -71
  372. package/.agent/skills/landing-page/SKILL.md +65 -65
  373. package/.agent/skills/lint-and-validate/SKILL.md +224 -224
  374. package/.agent/skills/llm-engineering/SKILL.md +360 -360
  375. package/.agent/skills/local-first/SKILL.md +138 -138
  376. package/.agent/skills/local-first-architecture/SKILL.md +62 -62
  377. package/.agent/skills/lottie-animation/SKILL.md +62 -62
  378. package/.agent/skills/marquee-loop/SKILL.md +72 -72
  379. package/.agent/skills/masked-reveal/SKILL.md +230 -230
  380. package/.agent/skills/mcp-builder/SKILL.md +105 -105
  381. package/.agent/skills/micro-interaction/SKILL.md +253 -253
  382. package/.agent/skills/mobile-design/SKILL.md +245 -245
  383. package/.agent/skills/monorepo-management/SKILL.md +295 -295
  384. package/.agent/skills/morphing-icons/SKILL.md +348 -348
  385. package/.agent/skills/motion-engineering/SKILL.md +197 -197
  386. package/.agent/skills/nextjs-react-expert/SKILL.md +218 -218
  387. package/.agent/skills/nodejs-best-practices/SKILL.md +542 -542
  388. package/.agent/skills/observability/SKILL.md +303 -303
  389. package/.agent/skills/opentelemetry-observability/SKILL.md +51 -51
  390. package/.agent/skills/page-transition-animation/SKILL.md +86 -86
  391. package/.agent/skills/parallel-agents/SKILL.md +110 -110
  392. package/.agent/skills/performance-profiling/SKILL.md +230 -230
  393. package/.agent/skills/plan-writing/SKILL.md +127 -127
  394. package/.agent/skills/platform-engineer/SKILL.md +108 -108
  395. package/.agent/skills/platform-engineering-opentofu/SKILL.md +59 -59
  396. package/.agent/skills/playwright-ai-e2e/SKILL.md +52 -52
  397. package/.agent/skills/playwright-best-practices/SKILL.md +149 -149
  398. package/.agent/skills/polish/SKILL.md +39 -39
  399. package/.agent/skills/powershell-windows/SKILL.md +122 -122
  400. package/.agent/skills/pricing-page/SKILL.md +48 -48
  401. package/.agent/skills/product-aware-heuristics/SKILL.md +390 -390
  402. package/.agent/skills/progressive-blur/SKILL.md +80 -80
  403. package/.agent/skills/project-idioms/SKILL.md +91 -91
  404. package/.agent/skills/property-based-testing/SKILL.md +50 -50
  405. package/.agent/skills/python-patterns/SKILL.md +220 -220
  406. package/.agent/skills/python-pro/SKILL.md +305 -305
  407. package/.agent/skills/quieter/SKILL.md +49 -49
  408. package/.agent/skills/react-doctor/SKILL.md +51 -51
  409. package/.agent/skills/react-specialist/SKILL.md +280 -280
  410. package/.agent/skills/readme-builder/SKILL.md +270 -270
  411. package/.agent/skills/realtime-patterns/SKILL.md +283 -283
  412. package/.agent/skills/red-team-tactics/SKILL.md +191 -191
  413. package/.agent/skills/redesign-skill/SKILL.md +46 -46
  414. package/.agent/skills/review-animations/SKILL.md +45 -45
  415. package/.agent/skills/review-animations/STANDARDS.md +87 -87
  416. package/.agent/skills/rust-pro/SKILL.md +652 -652
  417. package/.agent/skills/semantic-filesystem-navigation/SKILL.md +24 -0
  418. package/.agent/skills/seo-fundamentals/SKILL.md +139 -139
  419. package/.agent/skills/server-management/SKILL.md +178 -178
  420. package/.agent/skills/session-log-interrogation/SKILL.md +29 -0
  421. package/.agent/skills/shadcn-ui-expert/SKILL.md +196 -196
  422. package/.agent/skills/shape/SKILL.md +56 -56
  423. package/.agent/skills/skill-creator/SKILL.md +177 -177
  424. package/.agent/skills/soft-skill/SKILL.md +53 -53
  425. package/.agent/skills/sounds-on-the-web/SKILL.md +76 -76
  426. package/.agent/skills/sql-pro/SKILL.md +624 -624
  427. package/.agent/skills/subagent-driven-development/SKILL.md +32 -0
  428. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +57 -57
  429. package/.agent/skills/svg-animation/SKILL.md +356 -356
  430. package/.agent/skills/swiftui-expert/SKILL.md +164 -164
  431. package/.agent/skills/swiss-design/SKILL.md +44 -44
  432. package/.agent/skills/system-design-pro/SKILL.md +188 -318
  433. package/.agent/skills/systematic-debugging/SKILL.md +129 -124
  434. package/.agent/skills/systematic-debugging/condition-based-waiting.md +120 -120
  435. package/.agent/skills/systematic-debugging/defense-in-depth.md +128 -128
  436. package/.agent/skills/systematic-debugging/root-cause-tracing.md +183 -183
  437. package/.agent/skills/tailwind-patterns/SKILL.md +583 -583
  438. package/.agent/skills/taste-skill/SKILL.md +52 -52
  439. package/.agent/skills/tdd-workflow/SKILL.md +105 -105
  440. package/.agent/skills/test-result-analyzer/SKILL.md +270 -270
  441. package/.agent/skills/testing-patterns/SKILL.md +534 -534
  442. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +62 -62
  443. package/.agent/skills/thinking-protocol/SKILL.md +21 -21
  444. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +43 -43
  445. package/.agent/skills/train-sentence-transformers/SKILL.md +109 -0
  446. package/.agent/skills/train-sentence-transformers/references/base_model_selection.md +79 -0
  447. package/.agent/skills/train-sentence-transformers/references/dataset_formats.md +128 -0
  448. package/.agent/skills/train-sentence-transformers/references/evaluators_cross_encoder.md +116 -0
  449. package/.agent/skills/train-sentence-transformers/references/evaluators_multi_vector_encoder.md +101 -0
  450. package/.agent/skills/train-sentence-transformers/references/evaluators_sentence_transformer.md +151 -0
  451. package/.agent/skills/train-sentence-transformers/references/evaluators_sparse_encoder.md +121 -0
  452. package/.agent/skills/train-sentence-transformers/references/hardware_guide.md +105 -0
  453. package/.agent/skills/train-sentence-transformers/references/hf_jobs_execution.md +173 -0
  454. package/.agent/skills/train-sentence-transformers/references/losses_cross_encoder.md +137 -0
  455. package/.agent/skills/train-sentence-transformers/references/losses_multi_vector_encoder.md +100 -0
  456. package/.agent/skills/train-sentence-transformers/references/losses_sentence_transformer.md +246 -0
  457. package/.agent/skills/train-sentence-transformers/references/losses_sparse_encoder.md +106 -0
  458. package/.agent/skills/train-sentence-transformers/references/model_architectures.md +178 -0
  459. package/.agent/skills/train-sentence-transformers/references/prompts_and_instructions.md +160 -0
  460. package/.agent/skills/train-sentence-transformers/references/training_args.md +270 -0
  461. package/.agent/skills/train-sentence-transformers/references/troubleshooting.md +225 -0
  462. package/.agent/skills/train-sentence-transformers/scripts/mine_hard_negatives.py +199 -0
  463. package/.agent/skills/train-sentence-transformers/scripts/train_cross_encoder_distillation_example.py +254 -0
  464. package/.agent/skills/train-sentence-transformers/scripts/train_cross_encoder_example.py +253 -0
  465. package/.agent/skills/train-sentence-transformers/scripts/train_cross_encoder_listwise_example.py +282 -0
  466. package/.agent/skills/train-sentence-transformers/scripts/train_multi_vector_encoder_example.py +240 -0
  467. package/.agent/skills/train-sentence-transformers/scripts/train_sentence_transformer_distillation_example.py +303 -0
  468. package/.agent/skills/train-sentence-transformers/scripts/train_sentence_transformer_example.py +227 -0
  469. package/.agent/skills/train-sentence-transformers/scripts/train_sentence_transformer_make_multilingual_example.py +308 -0
  470. package/.agent/skills/train-sentence-transformers/scripts/train_sentence_transformer_matryoshka_example.py +212 -0
  471. package/.agent/skills/train-sentence-transformers/scripts/train_sentence_transformer_multi_dataset_example.py +258 -0
  472. package/.agent/skills/train-sentence-transformers/scripts/train_sentence_transformer_static_embedding_example.py +273 -0
  473. package/.agent/skills/train-sentence-transformers/scripts/train_sentence_transformer_with_lora_example.py +275 -0
  474. package/.agent/skills/train-sentence-transformers/scripts/train_sparse_encoder_distillation_example.py +262 -0
  475. package/.agent/skills/train-sentence-transformers/scripts/train_sparse_encoder_example.py +237 -0
  476. package/.agent/skills/transformers-js/SKILL.md +692 -0
  477. package/.agent/skills/transformers-js/references/CACHE.md +339 -0
  478. package/.agent/skills/transformers-js/references/CONFIGURATION.md +438 -0
  479. package/.agent/skills/transformers-js/references/EXAMPLES.md +620 -0
  480. package/.agent/skills/transformers-js/references/MODEL_ARCHITECTURES.md +167 -0
  481. package/.agent/skills/transformers-js/references/MODEL_REGISTRY.md +197 -0
  482. package/.agent/skills/transformers-js/references/PIPELINE_OPTIONS.md +557 -0
  483. package/.agent/skills/transformers-js/references/TEXT_GENERATION.md +315 -0
  484. package/.agent/skills/transitions-dev/SKILL.md +90 -90
  485. package/.agent/skills/trend-researcher/SKILL.md +198 -198
  486. package/.agent/skills/tribunal-instincts-memory/SKILL.md +31 -0
  487. package/.agent/skills/trl-training/SKILL.md +318 -0
  488. package/.agent/skills/typescript-advanced/SKILL.md +306 -306
  489. package/.agent/skills/typeset/SKILL.md +60 -60
  490. package/.agent/skills/ui-reasoning-engine/SKILL.md +155 -155
  491. package/.agent/skills/ui-skill-packs/SKILL.md +57 -57
  492. package/.agent/skills/ui-skills-root/SKILL.md +69 -69
  493. package/.agent/skills/ui-ux-pro-max/SKILL.md +110 -110
  494. package/.agent/skills/ui-ux-researcher/SKILL.md +199 -199
  495. package/.agent/skills/vector-search-pgvector/SKILL.md +70 -70
  496. package/.agent/skills/verification-before-completion/SKILL.md +107 -107
  497. package/.agent/skills/vue-expert/SKILL.md +259 -259
  498. package/.agent/skills/vulnerability-scanner/SKILL.md +378 -378
  499. package/.agent/skills/web-accessibility-auditor/SKILL.md +179 -179
  500. package/.agent/skills/web-design-guidelines/SKILL.md +49 -49
  501. package/.agent/skills/web-quality-audit/SKILL.md +47 -47
  502. package/.agent/skills/webapp-testing/SKILL.md +128 -128
  503. package/.agent/skills/webgpu-performance/SKILL.md +88 -88
  504. package/.agent/skills/whimsy-injector/SKILL.md +305 -305
  505. package/.agent/skills/workflow-optimizer/SKILL.md +188 -188
  506. package/.agent/skills/zero-trust-passkeys/SKILL.md +82 -82
  507. package/.agent/templates/DESIGN.md +843 -843
  508. package/.agent/templates/design-tokens.json +140 -140
  509. package/.agent/templates/sdd/implementer-prompt.md +62 -62
  510. package/.agent/templates/sdd/re-review-prompt.md +36 -36
  511. package/.agent/templates/sdd/task-reviewer-prompt.md +78 -78
  512. package/.agent/workflows/acf.md +153 -153
  513. package/.agent/workflows/api-tester.md +189 -189
  514. package/.agent/workflows/assimilate.md +21 -0
  515. package/.agent/workflows/audit-live.md +53 -53
  516. package/.agent/workflows/audit.md +172 -167
  517. package/.agent/workflows/brainstorm.md +157 -157
  518. package/.agent/workflows/changelog.md +152 -152
  519. package/.agent/workflows/compare-web.md +35 -35
  520. package/.agent/workflows/context.md +102 -102
  521. package/.agent/workflows/contract.md +79 -79
  522. package/.agent/workflows/create.md +182 -182
  523. package/.agent/workflows/debug.md +201 -201
  524. package/.agent/workflows/deploy.md +215 -215
  525. package/.agent/workflows/enhance.md +165 -165
  526. package/.agent/workflows/fix-ci.md +94 -94
  527. package/.agent/workflows/fix.md +149 -149
  528. package/.agent/workflows/generate.md +216 -211
  529. package/.agent/workflows/htop.md +22 -0
  530. package/.agent/workflows/marathon.md +291 -286
  531. package/.agent/workflows/migrate.md +198 -198
  532. package/.agent/workflows/minimal.md +101 -101
  533. package/.agent/workflows/orchestrate.md +205 -205
  534. package/.agent/workflows/performance-benchmarker.md +148 -148
  535. package/.agent/workflows/pipeline.md +165 -165
  536. package/.agent/workflows/plan.md +206 -206
  537. package/.agent/workflows/preview.md +116 -116
  538. package/.agent/workflows/refactor.md +207 -207
  539. package/.agent/workflows/resume.md +20 -0
  540. package/.agent/workflows/review-ai.md +139 -139
  541. package/.agent/workflows/review.md +155 -155
  542. package/.agent/workflows/sdd.md +137 -137
  543. package/.agent/workflows/session.md +135 -135
  544. package/.agent/workflows/skill-enhancement-engine.md +84 -84
  545. package/.agent/workflows/status.md +112 -112
  546. package/.agent/workflows/strengthen-skills.md +174 -174
  547. package/.agent/workflows/super-prompt.md +146 -146
  548. package/.agent/workflows/swarm.md +218 -218
  549. package/.agent/workflows/team-mode.md +22 -0
  550. package/.agent/workflows/test.md +224 -224
  551. package/.agent/workflows/tribunal-backend.md +149 -149
  552. package/.agent/workflows/tribunal-cicd.md +109 -109
  553. package/.agent/workflows/tribunal-database.md +142 -142
  554. package/.agent/workflows/tribunal-frontend.md +157 -157
  555. package/.agent/workflows/tribunal-full.md +156 -156
  556. package/.agent/workflows/tribunal-mobile.md +142 -142
  557. package/.agent/workflows/tribunal-performance.md +149 -149
  558. package/.agent/workflows/tribunal-speed.md +222 -222
  559. package/.agent/workflows/tribunal-ui.md +97 -97
  560. package/.agent/workflows/ui-ux-pro-max.md +103 -103
  561. package/.agents/skills/12-principles-of-animation/SKILL.md +51 -51
  562. package/.agents/skills/60fps-animation/SKILL.md +91 -91
  563. package/.agents/skills/accessible-animation/SKILL.md +189 -189
  564. package/.agents/skills/adapt/SKILL.md +56 -56
  565. package/.agents/skills/adr-generation/SKILL.md +57 -0
  566. package/.agents/skills/advanced-rag-pipelines/SKILL.md +94 -94
  567. package/.agents/skills/agent-organizer/SKILL.md +117 -117
  568. package/.agents/skills/agent-syscall-guidelines/SKILL.md +25 -0
  569. package/.agents/skills/agentic-patterns/SKILL.md +281 -281
  570. package/.agents/skills/agentic-workflows-2026/SKILL.md +91 -83
  571. package/.agents/skills/agentshield-security/SKILL.md +26 -0
  572. package/.agents/skills/ai-app-hardening/SKILL.md +51 -51
  573. package/.agents/skills/ai-prompt-injection-defense/SKILL.md +162 -162
  574. package/.agents/skills/animation-on-scroll/SKILL.md +196 -196
  575. package/.agents/skills/animation-systems/SKILL.md +198 -198
  576. package/.agents/skills/antfu-conventions/SKILL.md +54 -54
  577. package/.agents/skills/api-patterns/SKILL.md +218 -218
  578. package/.agents/skills/api-security-auditor/SKILL.md +155 -155
  579. package/.agents/skills/app-builder/SKILL.md +535 -535
  580. package/.agents/skills/app-builder/templates/SKILL.md +108 -108
  581. package/.agents/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  582. package/.agents/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  583. package/.agents/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  584. package/.agents/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  585. package/.agents/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  586. package/.agents/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  587. package/.agents/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  588. package/.agents/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -126
  589. package/.agents/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -127
  590. package/.agents/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -172
  591. package/.agents/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -139
  592. package/.agents/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  593. package/.agents/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -122
  594. package/.agents/skills/appflow-wireframe/SKILL.md +96 -96
  595. package/.agents/skills/apple-design/SKILL.md +89 -89
  596. package/.agents/skills/architecture/SKILL.md +188 -188
  597. package/.agents/skills/architecture-drift/SKILL.md +45 -0
  598. package/.agents/skills/audit-and-fix/SKILL.md +100 -100
  599. package/.agents/skills/authentication-best-practices/SKILL.md +157 -157
  600. package/.agents/skills/autonomous-execution/SKILL.md +76 -0
  601. package/.agents/skills/backend-security-expert/SKILL.md +73 -73
  602. package/.agents/skills/baseline-ui/SKILL.md +55 -55
  603. package/.agents/skills/bash-linux/SKILL.md +139 -139
  604. package/.agents/skills/behavioral-modes/SKILL.md +200 -200
  605. package/.agents/skills/better-colors/SKILL.md +116 -116
  606. package/.agents/skills/better-typography/SKILL.md +90 -90
  607. package/.agents/skills/better-ui/SKILL.md +130 -130
  608. package/.agents/skills/bolder/SKILL.md +49 -49
  609. package/.agents/skills/brainstorming/SKILL.md +460 -460
  610. package/.agents/skills/browser-audit/SKILL.md +102 -102
  611. package/.agents/skills/browser-native-ai/SKILL.md +72 -72
  612. package/.agents/skills/build-primitive/SKILL.md +50 -50
  613. package/.agents/skills/building-native-ui/SKILL.md +162 -162
  614. package/.agents/skills/cicd-pro/SKILL.md +412 -412
  615. package/.agents/skills/clarify/SKILL.md +55 -55
  616. package/.agents/skills/clean-code/SKILL.md +367 -367
  617. package/.agents/skills/cloud-architect/SKILL.md +409 -409
  618. package/.agents/skills/cobejs/SKILL.md +70 -70
  619. package/.agents/skills/code-review-checklist/SKILL.md +163 -163
  620. package/.agents/skills/codebase-design/SKILL.md +76 -76
  621. package/.agents/skills/colorize/SKILL.md +57 -57
  622. package/.agents/skills/compact-landing/SKILL.md +50 -50
  623. package/.agents/skills/company-logos/SKILL.md +54 -54
  624. package/.agents/skills/config-validator/SKILL.md +125 -125
  625. package/.agents/skills/containerization-pro/SKILL.md +422 -422
  626. package/.agents/skills/context-engineering-pro/SKILL.md +69 -62
  627. package/.agents/skills/create-design-md/SKILL.md +92 -92
  628. package/.agents/skills/critique/SKILL.md +79 -79
  629. package/.agents/skills/csharp-developer/SKILL.md +478 -478
  630. package/.agents/skills/data-validation-schemas/SKILL.md +297 -297
  631. package/.agents/skills/database-design/SKILL.md +219 -219
  632. package/.agents/skills/delight/SKILL.md +46 -46
  633. package/.agents/skills/deployment-procedures/SKILL.md +132 -132
  634. package/.agents/skills/design-lab/SKILL.md +42 -42
  635. package/.agents/skills/devops-engineer/SKILL.md +305 -305
  636. package/.agents/skills/devops-incident-responder/SKILL.md +103 -103
  637. package/.agents/skills/diagnosing-bugs/SKILL.md +172 -172
  638. package/.agents/skills/distill/SKILL.md +45 -45
  639. package/.agents/skills/documentation-templates/SKILL.md +251 -251
  640. package/.agents/skills/domain-modeling/SKILL.md +61 -61
  641. package/.agents/skills/duckdb-analytical-sql/SKILL.md +51 -51
  642. package/.agents/skills/edge-ai-mobile/SKILL.md +42 -42
  643. package/.agents/skills/edge-computing/SKILL.md +143 -143
  644. package/.agents/skills/emil-design-eng/SKILL.md +134 -134
  645. package/.agents/skills/error-resilience/SKILL.md +403 -403
  646. package/.agents/skills/expo-router-v4/SKILL.md +72 -72
  647. package/.agents/skills/extract-design-system/SKILL.md +120 -120
  648. package/.agents/skills/fabel-protocol/SKILL.md +282 -277
  649. package/.agents/skills/failure-mode-analysis/SKILL.md +48 -0
  650. package/.agents/skills/fixing-accessibility/SKILL.md +87 -87
  651. package/.agents/skills/fixing-metadata/SKILL.md +83 -83
  652. package/.agents/skills/fixing-motion-performance/SKILL.md +78 -78
  653. package/.agents/skills/framer-motion-expert/SKILL.md +237 -237
  654. package/.agents/skills/frontend-design/SKILL.md +103 -103
  655. package/.agents/skills/frontend-security-expert/SKILL.md +56 -56
  656. package/.agents/skills/game-design-expert/SKILL.md +92 -92
  657. package/.agents/skills/game-engineering-expert/SKILL.md +108 -108
  658. package/.agents/skills/generative-ui-expert/SKILL.md +100 -100
  659. package/.agents/skills/geo-fundamentals/SKILL.md +108 -108
  660. package/.agents/skills/git-pro/SKILL.md +401 -401
  661. package/.agents/skills/github-operations/SKILL.md +295 -295
  662. package/.agents/skills/gpt-taste/SKILL.md +50 -50
  663. package/.agents/skills/graph-engineering/SKILL.md +28 -0
  664. package/.agents/skills/gsap-core/SKILL.md +277 -277
  665. package/.agents/skills/gsap-frameworks/SKILL.md +168 -168
  666. package/.agents/skills/gsap-performance/SKILL.md +94 -94
  667. package/.agents/skills/gsap-plugins/SKILL.md +441 -441
  668. package/.agents/skills/gsap-react/SKILL.md +213 -213
  669. package/.agents/skills/gsap-scrolltrigger/SKILL.md +312 -312
  670. package/.agents/skills/gsap-timeline/SKILL.md +122 -122
  671. package/.agents/skills/gsap-utils/SKILL.md +299 -299
  672. package/.agents/skills/harden/SKILL.md +55 -55
  673. package/.agents/skills/harness-protocol/SKILL.md +48 -40
  674. package/.agents/skills/hf-cli/SKILL.md +239 -0
  675. package/.agents/skills/hf-cloud-aws-context-discovery/SKILL.md +74 -0
  676. package/.agents/skills/hf-cloud-python-env-setup/SKILL.md +90 -0
  677. package/.agents/skills/hf-cloud-python-env-setup/requirements.txt +17 -0
  678. package/.agents/skills/hf-cloud-python-env-setup/scripts/check_versions.py +29 -0
  679. package/.agents/skills/hf-cloud-python-env-setup/scripts/setup_env.py +143 -0
  680. package/.agents/skills/hf-cloud-sagemaker-deployment-planner/SKILL.md +90 -0
  681. package/.agents/skills/hf-cloud-sagemaker-iam-preflight/SKILL.md +102 -0
  682. package/.agents/skills/hf-cloud-sagemaker-iam-preflight/references/minimum-permissions.json +47 -0
  683. package/.agents/skills/hf-cloud-sagemaker-iam-preflight/references/trust-policy.json +12 -0
  684. package/.agents/skills/hf-cloud-sagemaker-iam-preflight/scripts/check_role.py +184 -0
  685. package/.agents/skills/hf-cloud-sagemaker-iam-preflight/scripts/create_role.py +118 -0
  686. package/.agents/skills/hf-cloud-sagemaker-production-defaults/SKILL.md +419 -0
  687. package/.agents/skills/hf-cloud-sagemaker-production-defaults/references/deployment-template.md +59 -0
  688. package/.agents/skills/hf-cloud-sagemaker-production-defaults/scripts/_common.py +148 -0
  689. package/.agents/skills/hf-cloud-sagemaker-production-defaults/scripts/deploy.py +327 -0
  690. package/.agents/skills/hf-cloud-sagemaker-production-defaults/scripts/deploy_async.py +434 -0
  691. package/.agents/skills/hf-cloud-sagemaker-production-defaults/scripts/deploy_ic.py +506 -0
  692. package/.agents/skills/hf-cloud-sagemaker-production-defaults/scripts/invoke_endpoint.py +180 -0
  693. package/.agents/skills/hf-cloud-sagemaker-production-defaults/scripts/teardown.py +246 -0
  694. package/.agents/skills/hf-cloud-serving-image-selection/SKILL.md +220 -0
  695. package/.agents/skills/hf-cloud-serving-image-selection/references/model-to-image.md +111 -0
  696. package/.agents/skills/hf-cloud-serving-image-selection/scripts/mirror_image.py +145 -0
  697. package/.agents/skills/hf-mem/SKILL.md +79 -0
  698. package/.agents/skills/huggingface-best/SKILL.md +134 -0
  699. package/.agents/skills/huggingface-community-evals/SKILL.md +207 -0
  700. package/.agents/skills/huggingface-community-evals/examples/.env.example +3 -0
  701. package/.agents/skills/huggingface-community-evals/examples/USAGE_EXAMPLES.md +101 -0
  702. package/.agents/skills/huggingface-community-evals/scripts/inspect_eval_uv.py +104 -0
  703. package/.agents/skills/huggingface-community-evals/scripts/inspect_vllm_uv.py +306 -0
  704. package/.agents/skills/huggingface-community-evals/scripts/lighteval_vllm_uv.py +297 -0
  705. package/.agents/skills/huggingface-datasets/SKILL.md +107 -0
  706. package/.agents/skills/huggingface-gradio/SKILL.md +298 -0
  707. package/.agents/skills/huggingface-gradio/examples.md +613 -0
  708. package/.agents/skills/huggingface-llm-trainer/SKILL.md +738 -0
  709. package/.agents/skills/huggingface-llm-trainer/references/gguf_conversion.md +296 -0
  710. package/.agents/skills/huggingface-llm-trainer/references/hardware_guide.md +283 -0
  711. package/.agents/skills/huggingface-llm-trainer/references/hub_saving.md +364 -0
  712. package/.agents/skills/huggingface-llm-trainer/references/local_training_macos.md +231 -0
  713. package/.agents/skills/huggingface-llm-trainer/references/reliability_principles.md +371 -0
  714. package/.agents/skills/huggingface-llm-trainer/references/trackio_guide.md +191 -0
  715. package/.agents/skills/huggingface-llm-trainer/references/training_methods.md +150 -0
  716. package/.agents/skills/huggingface-llm-trainer/references/training_patterns.md +203 -0
  717. package/.agents/skills/huggingface-llm-trainer/references/troubleshooting.md +282 -0
  718. package/.agents/skills/huggingface-llm-trainer/references/unsloth.md +313 -0
  719. package/.agents/skills/huggingface-llm-trainer/scripts/convert_to_gguf.py +424 -0
  720. package/.agents/skills/huggingface-llm-trainer/scripts/dataset_inspector.py +417 -0
  721. package/.agents/skills/huggingface-llm-trainer/scripts/estimate_cost.py +150 -0
  722. package/.agents/skills/huggingface-llm-trainer/scripts/hf_benchmarks.py +659 -0
  723. package/.agents/skills/huggingface-llm-trainer/scripts/train_dpo_example.py +106 -0
  724. package/.agents/skills/huggingface-llm-trainer/scripts/train_grpo_example.py +89 -0
  725. package/.agents/skills/huggingface-llm-trainer/scripts/train_sft_example.py +122 -0
  726. package/.agents/skills/huggingface-llm-trainer/scripts/unsloth_sft_example.py +512 -0
  727. package/.agents/skills/huggingface-local-models/SKILL.md +113 -0
  728. package/.agents/skills/huggingface-local-models/references/hardware.md +38 -0
  729. package/.agents/skills/huggingface-local-models/references/hub-discovery.md +178 -0
  730. package/.agents/skills/huggingface-local-models/references/quantization.md +256 -0
  731. package/.agents/skills/huggingface-lora-space-builder/SKILL.md +394 -0
  732. package/.agents/skills/huggingface-lora-space-builder/references/adapting-to-the-lora.md +113 -0
  733. package/.agents/skills/huggingface-lora-space-builder/references/base-models/krea-2.md +63 -0
  734. package/.agents/skills/huggingface-lora-space-builder/references/base-models/ltx.md +205 -0
  735. package/.agents/skills/huggingface-lora-space-builder/references/base-models/qwen-image.md +144 -0
  736. package/.agents/skills/huggingface-lora-space-builder/references/creative-mode.md +262 -0
  737. package/.agents/skills/huggingface-lora-space-builder/references/tasks.md +124 -0
  738. package/.agents/skills/huggingface-lora-space-builder/references/zerogpu-and-publishing.md +196 -0
  739. package/.agents/skills/huggingface-paper-publisher/SKILL.md +624 -0
  740. package/.agents/skills/huggingface-paper-publisher/examples/example_usage.md +326 -0
  741. package/.agents/skills/huggingface-paper-publisher/references/quick_reference.md +216 -0
  742. package/.agents/skills/huggingface-paper-publisher/scripts/paper_manager.py +606 -0
  743. package/.agents/skills/huggingface-paper-publisher/templates/arxiv.md +299 -0
  744. package/.agents/skills/huggingface-paper-publisher/templates/ml-report.md +358 -0
  745. package/.agents/skills/huggingface-paper-publisher/templates/modern.md +319 -0
  746. package/.agents/skills/huggingface-paper-publisher/templates/standard.md +201 -0
  747. package/.agents/skills/huggingface-papers/SKILL.md +239 -0
  748. package/.agents/skills/huggingface-spaces/README.md +9 -0
  749. package/.agents/skills/huggingface-spaces/SKILL.md +242 -0
  750. package/.agents/skills/huggingface-spaces/references/3d-cuda-extensions.md +109 -0
  751. package/.agents/skills/huggingface-spaces/references/3d-generation.md +98 -0
  752. package/.agents/skills/huggingface-spaces/references/3d-gsplat.md +53 -0
  753. package/.agents/skills/huggingface-spaces/references/3d-models.md +227 -0
  754. package/.agents/skills/huggingface-spaces/references/3d-outputs.md +114 -0
  755. package/.agents/skills/huggingface-spaces/references/buckets.md +89 -0
  756. package/.agents/skills/huggingface-spaces/references/debugging.md +236 -0
  757. package/.agents/skills/huggingface-spaces/references/gradio.md +200 -0
  758. package/.agents/skills/huggingface-spaces/references/grants.md +63 -0
  759. package/.agents/skills/huggingface-spaces/references/inference-providers.md +97 -0
  760. package/.agents/skills/huggingface-spaces/references/known-errors.md +232 -0
  761. package/.agents/skills/huggingface-spaces/references/requirements.md +169 -0
  762. package/.agents/skills/huggingface-spaces/references/zerogpu.md +349 -0
  763. package/.agents/skills/huggingface-tool-builder/SKILL.md +120 -0
  764. package/.agents/skills/huggingface-tool-builder/references/baseline_hf_api.py +57 -0
  765. package/.agents/skills/huggingface-tool-builder/references/baseline_hf_api.sh +40 -0
  766. package/.agents/skills/huggingface-tool-builder/references/baseline_hf_api.tsx +57 -0
  767. package/.agents/skills/huggingface-tool-builder/references/find_models_by_paper.sh +230 -0
  768. package/.agents/skills/huggingface-tool-builder/references/hf_enrich_models.sh +96 -0
  769. package/.agents/skills/huggingface-tool-builder/references/hf_model_card_frontmatter.sh +188 -0
  770. package/.agents/skills/huggingface-tool-builder/references/hf_model_papers_auth.sh +171 -0
  771. package/.agents/skills/huggingface-trackio/SKILL.md +142 -0
  772. package/.agents/skills/huggingface-trackio/references/alerts.md +196 -0
  773. package/.agents/skills/huggingface-trackio/references/logging_metrics.md +212 -0
  774. package/.agents/skills/huggingface-trackio/references/retrieving_metrics.md +251 -0
  775. package/.agents/skills/huggingface-vision-trainer/SKILL.md +593 -0
  776. package/.agents/skills/huggingface-vision-trainer/references/finetune_sam2_trainer.md +254 -0
  777. package/.agents/skills/huggingface-vision-trainer/references/hub_saving.md +618 -0
  778. package/.agents/skills/huggingface-vision-trainer/references/image_classification_training_notebook.md +279 -0
  779. package/.agents/skills/huggingface-vision-trainer/references/object_detection_training_notebook.md +700 -0
  780. package/.agents/skills/huggingface-vision-trainer/references/reliability_principles.md +310 -0
  781. package/.agents/skills/huggingface-vision-trainer/references/timm_trainer.md +91 -0
  782. package/.agents/skills/huggingface-vision-trainer/scripts/dataset_inspector.py +814 -0
  783. package/.agents/skills/huggingface-vision-trainer/scripts/estimate_cost.py +217 -0
  784. package/.agents/skills/huggingface-vision-trainer/scripts/image_classification_training.py +383 -0
  785. package/.agents/skills/huggingface-vision-trainer/scripts/object_detection_training.py +710 -0
  786. package/.agents/skills/huggingface-vision-trainer/scripts/sam_segmentation_training.py +382 -0
  787. package/.agents/skills/huggingface-zerogpu/SKILL.md +289 -0
  788. package/.agents/skills/huggingface-zerogpu/references/concurrency.md +79 -0
  789. package/.agents/skills/huggingface-zerogpu/references/cuda-and-deps.md +66 -0
  790. package/.agents/skills/huggingface-zerogpu/references/how-quota-works.md +74 -0
  791. package/.agents/skills/huggingface-zerogpu/references/how-zerogpu-works.md +50 -0
  792. package/.agents/skills/human-gate-negotiation/SKILL.md +30 -0
  793. package/.agents/skills/i18n-localization/SKILL.md +134 -134
  794. package/.agents/skills/impeccable/SKILL.md +52 -52
  795. package/.agents/skills/improve-codebase-architecture/SKILL.md +48 -48
  796. package/.agents/skills/improve-ui/SKILL.md +70 -70
  797. package/.agents/skills/intelligent-routing/SKILL.md +204 -198
  798. package/.agents/skills/knowledge-graph/SKILL.md +71 -71
  799. package/.agents/skills/landing-page/SKILL.md +65 -65
  800. package/.agents/skills/lint-and-validate/SKILL.md +224 -224
  801. package/.agents/skills/llm-engineering/SKILL.md +360 -360
  802. package/.agents/skills/local-first/SKILL.md +138 -138
  803. package/.agents/skills/local-first-architecture/SKILL.md +62 -62
  804. package/.agents/skills/lottie-animation/SKILL.md +62 -62
  805. package/.agents/skills/marquee-loop/SKILL.md +72 -72
  806. package/.agents/skills/masked-reveal/SKILL.md +230 -230
  807. package/.agents/skills/mcp-builder/SKILL.md +105 -105
  808. package/.agents/skills/micro-interaction/SKILL.md +253 -253
  809. package/.agents/skills/mobile-design/SKILL.md +245 -245
  810. package/.agents/skills/monorepo-management/SKILL.md +295 -295
  811. package/.agents/skills/morphing-icons/SKILL.md +348 -348
  812. package/.agents/skills/motion-engineering/SKILL.md +197 -197
  813. package/.agents/skills/nextjs-react-expert/SKILL.md +218 -218
  814. package/.agents/skills/nodejs-best-practices/SKILL.md +542 -542
  815. package/.agents/skills/observability/SKILL.md +303 -303
  816. package/.agents/skills/opentelemetry-observability/SKILL.md +51 -51
  817. package/.agents/skills/page-transition-animation/SKILL.md +86 -86
  818. package/.agents/skills/parallel-agents/SKILL.md +110 -110
  819. package/.agents/skills/performance-profiling/SKILL.md +230 -230
  820. package/.agents/skills/plan-writing/SKILL.md +127 -127
  821. package/.agents/skills/platform-engineer/SKILL.md +108 -108
  822. package/.agents/skills/platform-engineering-opentofu/SKILL.md +59 -59
  823. package/.agents/skills/playwright-ai-e2e/SKILL.md +52 -52
  824. package/.agents/skills/playwright-best-practices/SKILL.md +149 -149
  825. package/.agents/skills/polish/SKILL.md +39 -39
  826. package/.agents/skills/powershell-windows/SKILL.md +122 -122
  827. package/.agents/skills/pricing-page/SKILL.md +48 -48
  828. package/.agents/skills/product-aware-heuristics/SKILL.md +390 -390
  829. package/.agents/skills/progressive-blur/SKILL.md +80 -80
  830. package/.agents/skills/project-idioms/SKILL.md +91 -91
  831. package/.agents/skills/property-based-testing/SKILL.md +50 -50
  832. package/.agents/skills/python-patterns/SKILL.md +220 -220
  833. package/.agents/skills/python-pro/SKILL.md +305 -305
  834. package/.agents/skills/quieter/SKILL.md +49 -49
  835. package/.agents/skills/react-doctor/SKILL.md +51 -51
  836. package/.agents/skills/react-specialist/SKILL.md +280 -280
  837. package/.agents/skills/readme-builder/SKILL.md +270 -270
  838. package/.agents/skills/realtime-patterns/SKILL.md +283 -283
  839. package/.agents/skills/red-team-tactics/SKILL.md +191 -191
  840. package/.agents/skills/redesign-skill/SKILL.md +46 -46
  841. package/.agents/skills/review-animations/SKILL.md +45 -45
  842. package/.agents/skills/review-animations/STANDARDS.md +87 -87
  843. package/.agents/skills/rust-pro/SKILL.md +652 -652
  844. package/.agents/skills/semantic-filesystem-navigation/SKILL.md +24 -0
  845. package/.agents/skills/seo-fundamentals/SKILL.md +139 -139
  846. package/.agents/skills/server-management/SKILL.md +178 -178
  847. package/.agents/skills/session-log-interrogation/SKILL.md +29 -0
  848. package/.agents/skills/shadcn-ui-expert/SKILL.md +196 -196
  849. package/.agents/skills/shape/SKILL.md +56 -56
  850. package/.agents/skills/skill-creator/SKILL.md +177 -177
  851. package/.agents/skills/soft-skill/SKILL.md +53 -53
  852. package/.agents/skills/sounds-on-the-web/SKILL.md +76 -76
  853. package/.agents/skills/sql-pro/SKILL.md +624 -624
  854. package/.agents/skills/subagent-driven-development/SKILL.md +32 -0
  855. package/.agents/skills/supabase-postgres-best-practices/SKILL.md +57 -57
  856. package/.agents/skills/svg-animation/SKILL.md +356 -356
  857. package/.agents/skills/swiftui-expert/SKILL.md +164 -164
  858. package/.agents/skills/swiss-design/SKILL.md +44 -44
  859. package/.agents/skills/system-design-pro/SKILL.md +188 -318
  860. package/.agents/skills/systematic-debugging/SKILL.md +129 -124
  861. package/.agents/skills/systematic-debugging/condition-based-waiting.md +120 -120
  862. package/.agents/skills/systematic-debugging/defense-in-depth.md +128 -128
  863. package/.agents/skills/systematic-debugging/root-cause-tracing.md +183 -183
  864. package/.agents/skills/tailwind-patterns/SKILL.md +583 -583
  865. package/.agents/skills/taste-skill/SKILL.md +52 -52
  866. package/.agents/skills/tdd-workflow/SKILL.md +105 -105
  867. package/.agents/skills/test-result-analyzer/SKILL.md +270 -270
  868. package/.agents/skills/testing-patterns/SKILL.md +534 -534
  869. package/.agents/skills/thermo-nuclear-code-quality-review/SKILL.md +62 -62
  870. package/.agents/skills/thinking-protocol/SKILL.md +21 -21
  871. package/.agents/skills/to-spring-or-not-to-spring/SKILL.md +43 -43
  872. package/.agents/skills/train-sentence-transformers/SKILL.md +109 -0
  873. package/.agents/skills/train-sentence-transformers/references/base_model_selection.md +79 -0
  874. package/.agents/skills/train-sentence-transformers/references/dataset_formats.md +128 -0
  875. package/.agents/skills/train-sentence-transformers/references/evaluators_cross_encoder.md +116 -0
  876. package/.agents/skills/train-sentence-transformers/references/evaluators_multi_vector_encoder.md +101 -0
  877. package/.agents/skills/train-sentence-transformers/references/evaluators_sentence_transformer.md +151 -0
  878. package/.agents/skills/train-sentence-transformers/references/evaluators_sparse_encoder.md +121 -0
  879. package/.agents/skills/train-sentence-transformers/references/hardware_guide.md +105 -0
  880. package/.agents/skills/train-sentence-transformers/references/hf_jobs_execution.md +173 -0
  881. package/.agents/skills/train-sentence-transformers/references/losses_cross_encoder.md +137 -0
  882. package/.agents/skills/train-sentence-transformers/references/losses_multi_vector_encoder.md +100 -0
  883. package/.agents/skills/train-sentence-transformers/references/losses_sentence_transformer.md +246 -0
  884. package/.agents/skills/train-sentence-transformers/references/losses_sparse_encoder.md +106 -0
  885. package/.agents/skills/train-sentence-transformers/references/model_architectures.md +178 -0
  886. package/.agents/skills/train-sentence-transformers/references/prompts_and_instructions.md +160 -0
  887. package/.agents/skills/train-sentence-transformers/references/training_args.md +270 -0
  888. package/.agents/skills/train-sentence-transformers/references/troubleshooting.md +225 -0
  889. package/.agents/skills/train-sentence-transformers/scripts/mine_hard_negatives.py +199 -0
  890. package/.agents/skills/train-sentence-transformers/scripts/train_cross_encoder_distillation_example.py +254 -0
  891. package/.agents/skills/train-sentence-transformers/scripts/train_cross_encoder_example.py +253 -0
  892. package/.agents/skills/train-sentence-transformers/scripts/train_cross_encoder_listwise_example.py +282 -0
  893. package/.agents/skills/train-sentence-transformers/scripts/train_multi_vector_encoder_example.py +240 -0
  894. package/.agents/skills/train-sentence-transformers/scripts/train_sentence_transformer_distillation_example.py +303 -0
  895. package/.agents/skills/train-sentence-transformers/scripts/train_sentence_transformer_example.py +227 -0
  896. package/.agents/skills/train-sentence-transformers/scripts/train_sentence_transformer_make_multilingual_example.py +308 -0
  897. package/.agents/skills/train-sentence-transformers/scripts/train_sentence_transformer_matryoshka_example.py +212 -0
  898. package/.agents/skills/train-sentence-transformers/scripts/train_sentence_transformer_multi_dataset_example.py +258 -0
  899. package/.agents/skills/train-sentence-transformers/scripts/train_sentence_transformer_static_embedding_example.py +273 -0
  900. package/.agents/skills/train-sentence-transformers/scripts/train_sentence_transformer_with_lora_example.py +275 -0
  901. package/.agents/skills/train-sentence-transformers/scripts/train_sparse_encoder_distillation_example.py +262 -0
  902. package/.agents/skills/train-sentence-transformers/scripts/train_sparse_encoder_example.py +237 -0
  903. package/.agents/skills/transformers-js/SKILL.md +692 -0
  904. package/.agents/skills/transformers-js/references/CACHE.md +339 -0
  905. package/.agents/skills/transformers-js/references/CONFIGURATION.md +438 -0
  906. package/.agents/skills/transformers-js/references/EXAMPLES.md +620 -0
  907. package/.agents/skills/transformers-js/references/MODEL_ARCHITECTURES.md +167 -0
  908. package/.agents/skills/transformers-js/references/MODEL_REGISTRY.md +197 -0
  909. package/.agents/skills/transformers-js/references/PIPELINE_OPTIONS.md +557 -0
  910. package/.agents/skills/transformers-js/references/TEXT_GENERATION.md +315 -0
  911. package/.agents/skills/transitions-dev/SKILL.md +90 -90
  912. package/.agents/skills/trend-researcher/SKILL.md +198 -198
  913. package/.agents/skills/tribunal-instincts-memory/SKILL.md +31 -0
  914. package/.agents/skills/trl-training/SKILL.md +318 -0
  915. package/.agents/skills/typescript-advanced/SKILL.md +306 -306
  916. package/.agents/skills/typeset/SKILL.md +60 -60
  917. package/.agents/skills/ui-reasoning-engine/SKILL.md +155 -155
  918. package/.agents/skills/ui-skill-packs/SKILL.md +57 -57
  919. package/.agents/skills/ui-skills-root/SKILL.md +69 -69
  920. package/.agents/skills/ui-ux-pro-max/SKILL.md +110 -110
  921. package/.agents/skills/ui-ux-researcher/SKILL.md +199 -199
  922. package/.agents/skills/vector-search-pgvector/SKILL.md +70 -70
  923. package/.agents/skills/verification-before-completion/SKILL.md +107 -107
  924. package/.agents/skills/vue-expert/SKILL.md +259 -259
  925. package/.agents/skills/vulnerability-scanner/SKILL.md +378 -378
  926. package/.agents/skills/web-accessibility-auditor/SKILL.md +179 -179
  927. package/.agents/skills/web-design-guidelines/SKILL.md +49 -49
  928. package/.agents/skills/web-quality-audit/SKILL.md +47 -47
  929. package/.agents/skills/webapp-testing/SKILL.md +128 -128
  930. package/.agents/skills/webgpu-performance/SKILL.md +88 -88
  931. package/.agents/skills/whimsy-injector/SKILL.md +305 -305
  932. package/.agents/skills/workflow-optimizer/SKILL.md +188 -188
  933. package/.agents/skills/zero-trust-passkeys/SKILL.md +82 -82
  934. package/AGENTS.md +93 -93
  935. package/CLAUDE.md +444 -444
  936. package/CONTRIBUTING.md +134 -134
  937. package/README.md +242 -542
  938. package/SECURITY.md +58 -52
  939. package/bin/adapter-install.js +264 -264
  940. package/bin/global-store.js +48 -48
  941. package/bin/mcp-server.js +1653 -1653
  942. package/bin/proxy-server.js +122 -122
  943. package/bin/spawn-agent.js +45 -45
  944. package/bin/tk-proxy.js +34 -34
  945. package/bin/tribunal-kit.js +113 -113
  946. package/bin/wrapper.js +209 -211
  947. package/hooks/hooks-cursor.json +10 -10
  948. package/hooks/hooks.json +10 -10
  949. package/hooks/session-start.js +77 -77
  950. package/mcp_config.json +18 -18
  951. package/package.json +169 -179
  952. package/{.claude-plugin → plugins/claude}/marketplace.json +14 -14
  953. package/{.claude-plugin → plugins/claude}/plugin.json +26 -26
  954. package/{.codex-plugin → plugins/codex}/plugin.json +41 -41
  955. package/{plugin.json → plugins/core-plugin.json} +26 -26
  956. package/{.cursor-plugin → plugins/cursor}/plugin.json +26 -26
  957. package/{.devin-plugin → plugins/devin}/plugin.json +14 -14
  958. package/{gemini-extension.json → plugins/gemini/extension.json} +6 -6
  959. package/{.hermes-plugin → plugins/hermes}/__init__.py +102 -102
  960. package/{.hermes-plugin → plugins/hermes}/plugin.yaml +6 -6
  961. package/{.kimi-plugin → plugins/kimi}/plugin.json +34 -34
  962. package/{marketplace.json → plugins/marketplace.json} +14 -14
  963. package/{.opencode → plugins/opencode}/INSTALL.md +42 -42
  964. package/{.opencode → plugins/opencode}/plugins/tribunal.js +110 -110
  965. package/{.opencode → plugins/opencode}/rules.md +258 -258
  966. package/{.pi → plugins/pi}/extensions/tribunal.ts +130 -130
  967. package/scripts/apply-version.js +57 -57
  968. package/scripts/audit_skill_sdo.js +89 -89
  969. package/scripts/benchmark.js +231 -231
  970. package/scripts/build-graph.js +71 -71
  971. package/scripts/changelog.js +190 -190
  972. package/scripts/clean-pycache.js +42 -42
  973. package/scripts/context_compiler.js +1143 -1117
  974. package/scripts/fix-vbc.js +96 -96
  975. package/scripts/fix-vbc.ps1 +3 -3
  976. package/scripts/modernize_skills.js +268 -268
  977. package/scripts/package-cores.js +116 -116
  978. package/scripts/skill_enhancement_engine.js +608 -608
  979. package/scripts/stress_benchmark.js +358 -358
  980. package/scripts/sync-skills.js +61 -61
  981. package/scripts/sync-version.js +177 -177
  982. package/scripts/telemetry_gc.js +156 -156
  983. package/scripts/validate-payload.js +73 -73
  984. package/scripts/visual_audit.js +136 -136
  985. package/skills/12-principles-of-animation/SKILL.md +51 -51
  986. package/skills/60fps-animation/SKILL.md +91 -91
  987. package/skills/accessible-animation/SKILL.md +189 -189
  988. package/skills/adapt/SKILL.md +56 -56
  989. package/skills/adr-generation/SKILL.md +57 -0
  990. package/skills/advanced-rag-pipelines/SKILL.md +94 -94
  991. package/skills/agent-organizer/SKILL.md +117 -117
  992. package/skills/agent-syscall-guidelines/SKILL.md +25 -0
  993. package/skills/agentic-patterns/SKILL.md +281 -281
  994. package/skills/agentic-workflows-2026/SKILL.md +91 -83
  995. package/skills/agentshield-security/SKILL.md +26 -0
  996. package/skills/ai-app-hardening/SKILL.md +51 -51
  997. package/skills/ai-prompt-injection-defense/SKILL.md +162 -162
  998. package/skills/animation-on-scroll/SKILL.md +196 -196
  999. package/skills/animation-systems/SKILL.md +198 -198
  1000. package/skills/antfu-conventions/SKILL.md +54 -54
  1001. package/skills/api-patterns/SKILL.md +218 -218
  1002. package/skills/api-security-auditor/SKILL.md +155 -155
  1003. package/skills/app-builder/SKILL.md +535 -535
  1004. package/skills/app-builder/templates/SKILL.md +108 -108
  1005. package/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  1006. package/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  1007. package/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  1008. package/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  1009. package/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  1010. package/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  1011. package/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  1012. package/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -126
  1013. package/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -127
  1014. package/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -172
  1015. package/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -139
  1016. package/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  1017. package/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -122
  1018. package/skills/appflow-wireframe/SKILL.md +96 -96
  1019. package/skills/apple-design/SKILL.md +89 -89
  1020. package/skills/architecture/SKILL.md +188 -188
  1021. package/skills/architecture-drift/SKILL.md +45 -0
  1022. package/skills/audit-and-fix/SKILL.md +100 -100
  1023. package/skills/authentication-best-practices/SKILL.md +157 -157
  1024. package/skills/autonomous-execution/SKILL.md +76 -0
  1025. package/skills/backend-security-expert/SKILL.md +73 -73
  1026. package/skills/baseline-ui/SKILL.md +55 -55
  1027. package/skills/bash-linux/SKILL.md +139 -139
  1028. package/skills/behavioral-modes/SKILL.md +200 -200
  1029. package/skills/better-colors/SKILL.md +116 -116
  1030. package/skills/better-typography/SKILL.md +90 -90
  1031. package/skills/better-ui/SKILL.md +130 -130
  1032. package/skills/bolder/SKILL.md +49 -49
  1033. package/skills/brainstorming/SKILL.md +460 -460
  1034. package/skills/browser-audit/SKILL.md +102 -102
  1035. package/skills/browser-native-ai/SKILL.md +72 -72
  1036. package/skills/build-primitive/SKILL.md +50 -50
  1037. package/skills/building-native-ui/SKILL.md +162 -162
  1038. package/skills/cicd-pro/SKILL.md +412 -412
  1039. package/skills/clarify/SKILL.md +55 -55
  1040. package/skills/clean-code/SKILL.md +367 -367
  1041. package/skills/cloud-architect/SKILL.md +409 -409
  1042. package/skills/cobejs/SKILL.md +70 -70
  1043. package/skills/code-review-checklist/SKILL.md +163 -163
  1044. package/skills/codebase-design/SKILL.md +76 -76
  1045. package/skills/colorize/SKILL.md +57 -57
  1046. package/skills/compact-landing/SKILL.md +50 -50
  1047. package/skills/company-logos/SKILL.md +54 -54
  1048. package/skills/config-validator/SKILL.md +125 -125
  1049. package/skills/containerization-pro/SKILL.md +422 -422
  1050. package/skills/context-engineering-pro/SKILL.md +69 -62
  1051. package/skills/create-design-md/SKILL.md +92 -92
  1052. package/skills/critique/SKILL.md +79 -79
  1053. package/skills/csharp-developer/SKILL.md +478 -478
  1054. package/skills/data-validation-schemas/SKILL.md +297 -297
  1055. package/skills/database-design/SKILL.md +219 -219
  1056. package/skills/delight/SKILL.md +46 -46
  1057. package/skills/deployment-procedures/SKILL.md +132 -132
  1058. package/skills/design-lab/SKILL.md +42 -42
  1059. package/skills/devops-engineer/SKILL.md +305 -305
  1060. package/skills/devops-incident-responder/SKILL.md +103 -103
  1061. package/skills/diagnosing-bugs/SKILL.md +172 -172
  1062. package/skills/distill/SKILL.md +45 -45
  1063. package/skills/documentation-templates/SKILL.md +251 -251
  1064. package/skills/domain-modeling/SKILL.md +61 -61
  1065. package/skills/duckdb-analytical-sql/SKILL.md +51 -51
  1066. package/skills/edge-ai-mobile/SKILL.md +42 -42
  1067. package/skills/edge-computing/SKILL.md +143 -143
  1068. package/skills/emil-design-eng/SKILL.md +134 -134
  1069. package/skills/error-resilience/SKILL.md +403 -403
  1070. package/skills/expo-router-v4/SKILL.md +72 -72
  1071. package/skills/extract-design-system/SKILL.md +120 -120
  1072. package/skills/fabel-protocol/SKILL.md +282 -277
  1073. package/skills/failure-mode-analysis/SKILL.md +48 -0
  1074. package/skills/fixing-accessibility/SKILL.md +87 -87
  1075. package/skills/fixing-metadata/SKILL.md +83 -83
  1076. package/skills/fixing-motion-performance/SKILL.md +78 -78
  1077. package/skills/framer-motion-expert/SKILL.md +237 -237
  1078. package/skills/frontend-design/SKILL.md +103 -103
  1079. package/skills/frontend-security-expert/SKILL.md +56 -56
  1080. package/skills/game-design-expert/SKILL.md +92 -92
  1081. package/skills/game-engineering-expert/SKILL.md +108 -108
  1082. package/skills/generative-ui-expert/SKILL.md +100 -100
  1083. package/skills/geo-fundamentals/SKILL.md +108 -108
  1084. package/skills/git-pro/SKILL.md +401 -401
  1085. package/skills/github-operations/SKILL.md +295 -295
  1086. package/skills/gpt-taste/SKILL.md +50 -50
  1087. package/skills/graph-engineering/SKILL.md +28 -0
  1088. package/skills/gsap-core/SKILL.md +277 -277
  1089. package/skills/gsap-frameworks/SKILL.md +168 -168
  1090. package/skills/gsap-performance/SKILL.md +94 -94
  1091. package/skills/gsap-plugins/SKILL.md +441 -441
  1092. package/skills/gsap-react/SKILL.md +213 -213
  1093. package/skills/gsap-scrolltrigger/SKILL.md +312 -312
  1094. package/skills/gsap-timeline/SKILL.md +122 -122
  1095. package/skills/gsap-utils/SKILL.md +299 -299
  1096. package/skills/harden/SKILL.md +55 -55
  1097. package/skills/harness-protocol/SKILL.md +48 -40
  1098. package/skills/hf-cli/SKILL.md +239 -0
  1099. package/skills/hf-cloud-aws-context-discovery/SKILL.md +74 -0
  1100. package/skills/hf-cloud-python-env-setup/SKILL.md +90 -0
  1101. package/skills/hf-cloud-python-env-setup/requirements.txt +17 -0
  1102. package/skills/hf-cloud-python-env-setup/scripts/check_versions.py +29 -0
  1103. package/skills/hf-cloud-python-env-setup/scripts/setup_env.py +143 -0
  1104. package/skills/hf-cloud-sagemaker-deployment-planner/SKILL.md +90 -0
  1105. package/skills/hf-cloud-sagemaker-iam-preflight/SKILL.md +102 -0
  1106. package/skills/hf-cloud-sagemaker-iam-preflight/references/minimum-permissions.json +47 -0
  1107. package/skills/hf-cloud-sagemaker-iam-preflight/references/trust-policy.json +12 -0
  1108. package/skills/hf-cloud-sagemaker-iam-preflight/scripts/check_role.py +184 -0
  1109. package/skills/hf-cloud-sagemaker-iam-preflight/scripts/create_role.py +118 -0
  1110. package/skills/hf-cloud-sagemaker-production-defaults/SKILL.md +419 -0
  1111. package/skills/hf-cloud-sagemaker-production-defaults/references/deployment-template.md +59 -0
  1112. package/skills/hf-cloud-sagemaker-production-defaults/scripts/_common.py +148 -0
  1113. package/skills/hf-cloud-sagemaker-production-defaults/scripts/deploy.py +327 -0
  1114. package/skills/hf-cloud-sagemaker-production-defaults/scripts/deploy_async.py +434 -0
  1115. package/skills/hf-cloud-sagemaker-production-defaults/scripts/deploy_ic.py +506 -0
  1116. package/skills/hf-cloud-sagemaker-production-defaults/scripts/invoke_endpoint.py +180 -0
  1117. package/skills/hf-cloud-sagemaker-production-defaults/scripts/teardown.py +246 -0
  1118. package/skills/hf-cloud-serving-image-selection/SKILL.md +220 -0
  1119. package/skills/hf-cloud-serving-image-selection/references/model-to-image.md +111 -0
  1120. package/skills/hf-cloud-serving-image-selection/scripts/mirror_image.py +145 -0
  1121. package/skills/hf-mem/SKILL.md +79 -0
  1122. package/skills/huggingface-best/SKILL.md +134 -0
  1123. package/skills/huggingface-community-evals/SKILL.md +207 -0
  1124. package/skills/huggingface-community-evals/examples/.env.example +3 -0
  1125. package/skills/huggingface-community-evals/examples/USAGE_EXAMPLES.md +101 -0
  1126. package/skills/huggingface-community-evals/scripts/inspect_eval_uv.py +104 -0
  1127. package/skills/huggingface-community-evals/scripts/inspect_vllm_uv.py +306 -0
  1128. package/skills/huggingface-community-evals/scripts/lighteval_vllm_uv.py +297 -0
  1129. package/skills/huggingface-datasets/SKILL.md +107 -0
  1130. package/skills/huggingface-gradio/SKILL.md +298 -0
  1131. package/skills/huggingface-gradio/examples.md +613 -0
  1132. package/skills/huggingface-llm-trainer/SKILL.md +738 -0
  1133. package/skills/huggingface-llm-trainer/references/gguf_conversion.md +296 -0
  1134. package/skills/huggingface-llm-trainer/references/hardware_guide.md +283 -0
  1135. package/skills/huggingface-llm-trainer/references/hub_saving.md +364 -0
  1136. package/skills/huggingface-llm-trainer/references/local_training_macos.md +231 -0
  1137. package/skills/huggingface-llm-trainer/references/reliability_principles.md +371 -0
  1138. package/skills/huggingface-llm-trainer/references/trackio_guide.md +191 -0
  1139. package/skills/huggingface-llm-trainer/references/training_methods.md +150 -0
  1140. package/skills/huggingface-llm-trainer/references/training_patterns.md +203 -0
  1141. package/skills/huggingface-llm-trainer/references/troubleshooting.md +282 -0
  1142. package/skills/huggingface-llm-trainer/references/unsloth.md +313 -0
  1143. package/skills/huggingface-llm-trainer/scripts/convert_to_gguf.py +424 -0
  1144. package/skills/huggingface-llm-trainer/scripts/dataset_inspector.py +417 -0
  1145. package/skills/huggingface-llm-trainer/scripts/estimate_cost.py +150 -0
  1146. package/skills/huggingface-llm-trainer/scripts/hf_benchmarks.py +659 -0
  1147. package/skills/huggingface-llm-trainer/scripts/train_dpo_example.py +106 -0
  1148. package/skills/huggingface-llm-trainer/scripts/train_grpo_example.py +89 -0
  1149. package/skills/huggingface-llm-trainer/scripts/train_sft_example.py +122 -0
  1150. package/skills/huggingface-llm-trainer/scripts/unsloth_sft_example.py +512 -0
  1151. package/skills/huggingface-local-models/SKILL.md +113 -0
  1152. package/skills/huggingface-local-models/references/hardware.md +38 -0
  1153. package/skills/huggingface-local-models/references/hub-discovery.md +178 -0
  1154. package/skills/huggingface-local-models/references/quantization.md +256 -0
  1155. package/skills/huggingface-lora-space-builder/SKILL.md +394 -0
  1156. package/skills/huggingface-lora-space-builder/references/adapting-to-the-lora.md +113 -0
  1157. package/skills/huggingface-lora-space-builder/references/base-models/krea-2.md +63 -0
  1158. package/skills/huggingface-lora-space-builder/references/base-models/ltx.md +205 -0
  1159. package/skills/huggingface-lora-space-builder/references/base-models/qwen-image.md +144 -0
  1160. package/skills/huggingface-lora-space-builder/references/creative-mode.md +262 -0
  1161. package/skills/huggingface-lora-space-builder/references/tasks.md +124 -0
  1162. package/skills/huggingface-lora-space-builder/references/zerogpu-and-publishing.md +196 -0
  1163. package/skills/huggingface-paper-publisher/SKILL.md +624 -0
  1164. package/skills/huggingface-paper-publisher/examples/example_usage.md +326 -0
  1165. package/skills/huggingface-paper-publisher/references/quick_reference.md +216 -0
  1166. package/skills/huggingface-paper-publisher/scripts/paper_manager.py +606 -0
  1167. package/skills/huggingface-paper-publisher/templates/arxiv.md +299 -0
  1168. package/skills/huggingface-paper-publisher/templates/ml-report.md +358 -0
  1169. package/skills/huggingface-paper-publisher/templates/modern.md +319 -0
  1170. package/skills/huggingface-paper-publisher/templates/standard.md +201 -0
  1171. package/skills/huggingface-papers/SKILL.md +239 -0
  1172. package/skills/huggingface-spaces/README.md +9 -0
  1173. package/skills/huggingface-spaces/SKILL.md +242 -0
  1174. package/skills/huggingface-spaces/references/3d-cuda-extensions.md +109 -0
  1175. package/skills/huggingface-spaces/references/3d-generation.md +98 -0
  1176. package/skills/huggingface-spaces/references/3d-gsplat.md +53 -0
  1177. package/skills/huggingface-spaces/references/3d-models.md +227 -0
  1178. package/skills/huggingface-spaces/references/3d-outputs.md +114 -0
  1179. package/skills/huggingface-spaces/references/buckets.md +89 -0
  1180. package/skills/huggingface-spaces/references/debugging.md +236 -0
  1181. package/skills/huggingface-spaces/references/gradio.md +200 -0
  1182. package/skills/huggingface-spaces/references/grants.md +63 -0
  1183. package/skills/huggingface-spaces/references/inference-providers.md +97 -0
  1184. package/skills/huggingface-spaces/references/known-errors.md +232 -0
  1185. package/skills/huggingface-spaces/references/requirements.md +169 -0
  1186. package/skills/huggingface-spaces/references/zerogpu.md +349 -0
  1187. package/skills/huggingface-tool-builder/SKILL.md +120 -0
  1188. package/skills/huggingface-tool-builder/references/baseline_hf_api.py +57 -0
  1189. package/skills/huggingface-tool-builder/references/baseline_hf_api.sh +40 -0
  1190. package/skills/huggingface-tool-builder/references/baseline_hf_api.tsx +57 -0
  1191. package/skills/huggingface-tool-builder/references/find_models_by_paper.sh +230 -0
  1192. package/skills/huggingface-tool-builder/references/hf_enrich_models.sh +96 -0
  1193. package/skills/huggingface-tool-builder/references/hf_model_card_frontmatter.sh +188 -0
  1194. package/skills/huggingface-tool-builder/references/hf_model_papers_auth.sh +171 -0
  1195. package/skills/huggingface-trackio/SKILL.md +142 -0
  1196. package/skills/huggingface-trackio/references/alerts.md +196 -0
  1197. package/skills/huggingface-trackio/references/logging_metrics.md +212 -0
  1198. package/skills/huggingface-trackio/references/retrieving_metrics.md +251 -0
  1199. package/skills/huggingface-vision-trainer/SKILL.md +593 -0
  1200. package/skills/huggingface-vision-trainer/references/finetune_sam2_trainer.md +254 -0
  1201. package/skills/huggingface-vision-trainer/references/hub_saving.md +618 -0
  1202. package/skills/huggingface-vision-trainer/references/image_classification_training_notebook.md +279 -0
  1203. package/skills/huggingface-vision-trainer/references/object_detection_training_notebook.md +700 -0
  1204. package/skills/huggingface-vision-trainer/references/reliability_principles.md +310 -0
  1205. package/skills/huggingface-vision-trainer/references/timm_trainer.md +91 -0
  1206. package/skills/huggingface-vision-trainer/scripts/dataset_inspector.py +814 -0
  1207. package/skills/huggingface-vision-trainer/scripts/estimate_cost.py +217 -0
  1208. package/skills/huggingface-vision-trainer/scripts/image_classification_training.py +383 -0
  1209. package/skills/huggingface-vision-trainer/scripts/object_detection_training.py +710 -0
  1210. package/skills/huggingface-vision-trainer/scripts/sam_segmentation_training.py +382 -0
  1211. package/skills/huggingface-zerogpu/SKILL.md +289 -0
  1212. package/skills/huggingface-zerogpu/references/concurrency.md +79 -0
  1213. package/skills/huggingface-zerogpu/references/cuda-and-deps.md +66 -0
  1214. package/skills/huggingface-zerogpu/references/how-quota-works.md +74 -0
  1215. package/skills/huggingface-zerogpu/references/how-zerogpu-works.md +50 -0
  1216. package/skills/human-gate-negotiation/SKILL.md +30 -0
  1217. package/skills/i18n-localization/SKILL.md +134 -134
  1218. package/skills/impeccable/SKILL.md +52 -52
  1219. package/skills/improve-codebase-architecture/SKILL.md +48 -48
  1220. package/skills/improve-ui/SKILL.md +70 -70
  1221. package/skills/intelligent-routing/SKILL.md +204 -198
  1222. package/skills/knowledge-graph/SKILL.md +71 -71
  1223. package/skills/landing-page/SKILL.md +65 -65
  1224. package/skills/lint-and-validate/SKILL.md +224 -224
  1225. package/skills/llm-engineering/SKILL.md +360 -360
  1226. package/skills/local-first/SKILL.md +138 -138
  1227. package/skills/local-first-architecture/SKILL.md +62 -62
  1228. package/skills/lottie-animation/SKILL.md +62 -62
  1229. package/skills/marquee-loop/SKILL.md +72 -72
  1230. package/skills/masked-reveal/SKILL.md +230 -230
  1231. package/skills/mcp-builder/SKILL.md +105 -105
  1232. package/skills/micro-interaction/SKILL.md +253 -253
  1233. package/skills/mobile-design/SKILL.md +245 -245
  1234. package/skills/monorepo-management/SKILL.md +295 -295
  1235. package/skills/morphing-icons/SKILL.md +348 -348
  1236. package/skills/motion-engineering/SKILL.md +197 -197
  1237. package/skills/nextjs-react-expert/SKILL.md +218 -218
  1238. package/skills/nodejs-best-practices/SKILL.md +542 -542
  1239. package/skills/observability/SKILL.md +303 -303
  1240. package/skills/opentelemetry-observability/SKILL.md +51 -51
  1241. package/skills/page-transition-animation/SKILL.md +86 -86
  1242. package/skills/parallel-agents/SKILL.md +110 -110
  1243. package/skills/performance-profiling/SKILL.md +230 -230
  1244. package/skills/plan-writing/SKILL.md +127 -127
  1245. package/skills/platform-engineer/SKILL.md +108 -108
  1246. package/skills/platform-engineering-opentofu/SKILL.md +59 -59
  1247. package/skills/playwright-ai-e2e/SKILL.md +52 -52
  1248. package/skills/playwright-best-practices/SKILL.md +149 -149
  1249. package/skills/polish/SKILL.md +39 -39
  1250. package/skills/powershell-windows/SKILL.md +122 -122
  1251. package/skills/pricing-page/SKILL.md +48 -48
  1252. package/skills/product-aware-heuristics/SKILL.md +390 -390
  1253. package/skills/progressive-blur/SKILL.md +80 -80
  1254. package/skills/project-idioms/SKILL.md +91 -91
  1255. package/skills/property-based-testing/SKILL.md +50 -50
  1256. package/skills/python-patterns/SKILL.md +220 -220
  1257. package/skills/python-pro/SKILL.md +305 -305
  1258. package/skills/quieter/SKILL.md +49 -49
  1259. package/skills/react-doctor/SKILL.md +51 -51
  1260. package/skills/react-specialist/SKILL.md +280 -280
  1261. package/skills/readme-builder/SKILL.md +270 -270
  1262. package/skills/realtime-patterns/SKILL.md +283 -283
  1263. package/skills/red-team-tactics/SKILL.md +191 -191
  1264. package/skills/redesign-skill/SKILL.md +46 -46
  1265. package/skills/review-animations/SKILL.md +45 -45
  1266. package/skills/review-animations/STANDARDS.md +87 -87
  1267. package/skills/rust-pro/SKILL.md +652 -652
  1268. package/skills/semantic-filesystem-navigation/SKILL.md +24 -0
  1269. package/skills/seo-fundamentals/SKILL.md +139 -139
  1270. package/skills/server-management/SKILL.md +178 -178
  1271. package/skills/session-log-interrogation/SKILL.md +29 -0
  1272. package/skills/shadcn-ui-expert/SKILL.md +196 -196
  1273. package/skills/shape/SKILL.md +56 -56
  1274. package/skills/skill-creator/SKILL.md +177 -177
  1275. package/skills/soft-skill/SKILL.md +53 -53
  1276. package/skills/sounds-on-the-web/SKILL.md +76 -76
  1277. package/skills/sql-pro/SKILL.md +624 -624
  1278. package/skills/subagent-driven-development/SKILL.md +32 -0
  1279. package/skills/supabase-postgres-best-practices/SKILL.md +57 -57
  1280. package/skills/svg-animation/SKILL.md +356 -356
  1281. package/skills/swiftui-expert/SKILL.md +164 -164
  1282. package/skills/swiss-design/SKILL.md +44 -44
  1283. package/skills/system-design-pro/SKILL.md +188 -318
  1284. package/skills/systematic-debugging/SKILL.md +129 -124
  1285. package/skills/systematic-debugging/condition-based-waiting.md +120 -120
  1286. package/skills/systematic-debugging/defense-in-depth.md +128 -128
  1287. package/skills/systematic-debugging/root-cause-tracing.md +183 -183
  1288. package/skills/tailwind-patterns/SKILL.md +583 -583
  1289. package/skills/taste-skill/SKILL.md +52 -52
  1290. package/skills/tdd-workflow/SKILL.md +105 -105
  1291. package/skills/test-result-analyzer/SKILL.md +270 -270
  1292. package/skills/testing-patterns/SKILL.md +534 -534
  1293. package/skills/thermo-nuclear-code-quality-review/SKILL.md +62 -62
  1294. package/skills/thinking-protocol/SKILL.md +21 -21
  1295. package/skills/to-spring-or-not-to-spring/SKILL.md +43 -43
  1296. package/skills/train-sentence-transformers/SKILL.md +109 -0
  1297. package/skills/train-sentence-transformers/references/base_model_selection.md +79 -0
  1298. package/skills/train-sentence-transformers/references/dataset_formats.md +128 -0
  1299. package/skills/train-sentence-transformers/references/evaluators_cross_encoder.md +116 -0
  1300. package/skills/train-sentence-transformers/references/evaluators_multi_vector_encoder.md +101 -0
  1301. package/skills/train-sentence-transformers/references/evaluators_sentence_transformer.md +151 -0
  1302. package/skills/train-sentence-transformers/references/evaluators_sparse_encoder.md +121 -0
  1303. package/skills/train-sentence-transformers/references/hardware_guide.md +105 -0
  1304. package/skills/train-sentence-transformers/references/hf_jobs_execution.md +173 -0
  1305. package/skills/train-sentence-transformers/references/losses_cross_encoder.md +137 -0
  1306. package/skills/train-sentence-transformers/references/losses_multi_vector_encoder.md +100 -0
  1307. package/skills/train-sentence-transformers/references/losses_sentence_transformer.md +246 -0
  1308. package/skills/train-sentence-transformers/references/losses_sparse_encoder.md +106 -0
  1309. package/skills/train-sentence-transformers/references/model_architectures.md +178 -0
  1310. package/skills/train-sentence-transformers/references/prompts_and_instructions.md +160 -0
  1311. package/skills/train-sentence-transformers/references/training_args.md +270 -0
  1312. package/skills/train-sentence-transformers/references/troubleshooting.md +225 -0
  1313. package/skills/train-sentence-transformers/scripts/mine_hard_negatives.py +199 -0
  1314. package/skills/train-sentence-transformers/scripts/train_cross_encoder_distillation_example.py +254 -0
  1315. package/skills/train-sentence-transformers/scripts/train_cross_encoder_example.py +253 -0
  1316. package/skills/train-sentence-transformers/scripts/train_cross_encoder_listwise_example.py +282 -0
  1317. package/skills/train-sentence-transformers/scripts/train_multi_vector_encoder_example.py +240 -0
  1318. package/skills/train-sentence-transformers/scripts/train_sentence_transformer_distillation_example.py +303 -0
  1319. package/skills/train-sentence-transformers/scripts/train_sentence_transformer_example.py +227 -0
  1320. package/skills/train-sentence-transformers/scripts/train_sentence_transformer_make_multilingual_example.py +308 -0
  1321. package/skills/train-sentence-transformers/scripts/train_sentence_transformer_matryoshka_example.py +212 -0
  1322. package/skills/train-sentence-transformers/scripts/train_sentence_transformer_multi_dataset_example.py +258 -0
  1323. package/skills/train-sentence-transformers/scripts/train_sentence_transformer_static_embedding_example.py +273 -0
  1324. package/skills/train-sentence-transformers/scripts/train_sentence_transformer_with_lora_example.py +275 -0
  1325. package/skills/train-sentence-transformers/scripts/train_sparse_encoder_distillation_example.py +262 -0
  1326. package/skills/train-sentence-transformers/scripts/train_sparse_encoder_example.py +237 -0
  1327. package/skills/transformers-js/SKILL.md +692 -0
  1328. package/skills/transformers-js/references/CACHE.md +339 -0
  1329. package/skills/transformers-js/references/CONFIGURATION.md +438 -0
  1330. package/skills/transformers-js/references/EXAMPLES.md +620 -0
  1331. package/skills/transformers-js/references/MODEL_ARCHITECTURES.md +167 -0
  1332. package/skills/transformers-js/references/MODEL_REGISTRY.md +197 -0
  1333. package/skills/transformers-js/references/PIPELINE_OPTIONS.md +557 -0
  1334. package/skills/transformers-js/references/TEXT_GENERATION.md +315 -0
  1335. package/skills/transitions-dev/SKILL.md +90 -90
  1336. package/skills/trend-researcher/SKILL.md +198 -198
  1337. package/skills/tribunal-instincts-memory/SKILL.md +31 -0
  1338. package/skills/trl-training/SKILL.md +318 -0
  1339. package/skills/typescript-advanced/SKILL.md +306 -306
  1340. package/skills/typeset/SKILL.md +60 -60
  1341. package/skills/ui-reasoning-engine/SKILL.md +155 -155
  1342. package/skills/ui-skill-packs/SKILL.md +57 -57
  1343. package/skills/ui-skills-root/SKILL.md +69 -69
  1344. package/skills/ui-ux-pro-max/SKILL.md +110 -110
  1345. package/skills/ui-ux-researcher/SKILL.md +199 -199
  1346. package/skills/vector-search-pgvector/SKILL.md +70 -70
  1347. package/skills/verification-before-completion/SKILL.md +107 -107
  1348. package/skills/vue-expert/SKILL.md +259 -259
  1349. package/skills/vulnerability-scanner/SKILL.md +378 -378
  1350. package/skills/web-accessibility-auditor/SKILL.md +179 -179
  1351. package/skills/web-design-guidelines/SKILL.md +49 -49
  1352. package/skills/web-quality-audit/SKILL.md +47 -47
  1353. package/skills/webapp-testing/SKILL.md +128 -128
  1354. package/skills/webgpu-performance/SKILL.md +88 -88
  1355. package/skills/whimsy-injector/SKILL.md +305 -305
  1356. package/skills/workflow-optimizer/SKILL.md +188 -188
  1357. package/skills/zero-trust-passkeys/SKILL.md +82 -82
  1358. package/{dist → src}/browser/audit.js +229 -229
  1359. package/{dist → src}/browser/case_bridge.js +189 -189
  1360. package/{dist → src}/browser/cdp.js +513 -513
  1361. package/{dist → src}/browser/compare.js +110 -110
  1362. package/{dist → src}/browser/discovery.js +140 -140
  1363. package/{dist → src}/browser/idpi.js +142 -142
  1364. package/{dist → src}/browser/index.js +89 -89
  1365. package/{dist → src}/browser/launcher.js +154 -154
  1366. package/{dist → src}/browser/sentinel.js +202 -202
  1367. package/{dist → src}/browser/synapse.js +251 -251
  1368. package/{dist → src}/browser/trimmer.js +210 -210
  1369. package/{dist → src}/commands/align.js +201 -201
  1370. package/{dist → src}/commands/audit-web.js +112 -112
  1371. package/{dist → src}/commands/browse.js +56 -56
  1372. package/{dist → src}/commands/case.js +71 -73
  1373. package/{dist → src}/commands/compare-web.js +61 -61
  1374. package/{dist → src}/commands/compile.js +91 -91
  1375. package/{dist → src}/commands/context.js +71 -71
  1376. package/{dist → src}/commands/contract.js +440 -440
  1377. package/{dist → src}/commands/deconstruct.js +58 -58
  1378. package/{dist → src}/commands/graph.js +44 -44
  1379. package/{dist → src}/commands/guardrail.js +275 -275
  1380. package/{dist → src}/commands/heal.js +99 -99
  1381. package/{dist → src}/commands/hook.js +28 -28
  1382. package/{dist → src}/commands/init.js +393 -393
  1383. package/{dist → src}/commands/learn.js +119 -117
  1384. package/{dist → src}/commands/marathon.js +45 -45
  1385. package/{dist → src}/commands/memory.js +508 -508
  1386. package/{dist → src}/commands/minimal.js +71 -71
  1387. package/{dist → src}/commands/mutate.js +30 -30
  1388. package/{dist → src}/commands/native.js +264 -264
  1389. package/{dist → src}/commands/optimize.js +332 -328
  1390. package/{dist → src}/commands/sdd.js +265 -229
  1391. package/{dist → src}/commands/status.js +66 -66
  1392. package/{dist → src}/commands/sync.js +25 -25
  1393. package/{dist → src}/commands/uninstall.js +54 -54
  1394. package/{dist → src}/commands/update.js +37 -37
  1395. package/{dist → src}/commands/validate.js +58 -58
  1396. package/{dist → src}/esm/index.mjs +1 -1
  1397. package/{dist → src}/mcp/server.js +8 -8
  1398. package/{dist → src}/tui/banner.js +1 -1
  1399. package/{dist → src}/tui/index.js +21 -21
  1400. package/{dist → src}/tui/reviewer-grid.js +90 -90
  1401. package/{dist → src}/tui/shimmer.js +91 -91
  1402. package/{dist → src}/tui/theme.js +130 -130
  1403. package/{dist → src}/tui/tree.js +93 -93
  1404. package/{dist → src}/tui/wizard.js +148 -148
  1405. package/{dist → src}/types.js +8 -8
  1406. package/{dist → src}/utils/fs.js +102 -102
  1407. package/{dist → src}/utils/hasher.js +142 -142
  1408. package/{dist → src}/utils/helpers.js +53 -53
  1409. package/{dist → src}/utils/logger.js +54 -54
  1410. package/{dist → src}/utils/version.js +157 -157
  1411. package/.agent/history/README.md +0 -53
  1412. package/.agent/history/architecture-explorer.html +0 -352
  1413. package/.agent/history/architecture-graph.yaml +0 -619
  1414. package/.agent/history/case-law/cases/template-case.json +0 -19
  1415. package/.agent/history/graph-cache.json +0 -1042
  1416. package/.agent/history/integrity_manifest.json +0 -4694
  1417. package/.agent/history/memory/.memory.idx +0 -7596
  1418. package/.agent/history/memory/MEMORY.md +0 -512
  1419. package/.agent/history/memory.db +0 -0
  1420. package/.agent/history/snapshots/.opencode__plugins__tribunal.js.json +0 -12
  1421. package/.agent/history/snapshots/.pi__extensions__tribunal.ts.json +0 -12
  1422. package/.agent/history/snapshots/bin__adapter-install.js.json +0 -13
  1423. package/.agent/history/snapshots/bin__global-store.js.json +0 -15
  1424. package/.agent/history/snapshots/bin__mcp-server.js.json +0 -21
  1425. package/.agent/history/snapshots/bin__proxy-server.js.json +0 -20
  1426. package/.agent/history/snapshots/bin__spawn-agent.js.json +0 -12
  1427. package/.agent/history/snapshots/bin__tk-proxy.js.json +0 -21
  1428. package/.agent/history/snapshots/bin__tribunal-kit.js.json +0 -21
  1429. package/.agent/history/snapshots/bin__wrapper.js.json +0 -14
  1430. package/.agent/history/snapshots/eslint.config.js.json +0 -8
  1431. package/.agent/history/snapshots/hooks__session-start.js.json +0 -11
  1432. package/.agent/history/snapshots/scripts__apply-version.js.json +0 -11
  1433. package/.agent/history/snapshots/scripts__audit_skill_sdo.js.json +0 -11
  1434. package/.agent/history/snapshots/scripts__benchmark.js.json +0 -14
  1435. package/.agent/history/snapshots/scripts__changelog.js.json +0 -12
  1436. package/.agent/history/snapshots/scripts__clean-pycache.js.json +0 -11
  1437. package/.agent/history/snapshots/scripts__context_compiler.js.json +0 -17
  1438. package/.agent/history/snapshots/scripts__fix-vbc.js.json +0 -11
  1439. package/.agent/history/snapshots/scripts__modernize_skills.js.json +0 -11
  1440. package/.agent/history/snapshots/scripts__package-cores.js.json +0 -12
  1441. package/.agent/history/snapshots/scripts__skill_enhancement_engine.js.json +0 -11
  1442. package/.agent/history/snapshots/scripts__stress_benchmark.js.json +0 -15
  1443. package/.agent/history/snapshots/scripts__sync-skills.js.json +0 -11
  1444. package/.agent/history/snapshots/scripts__sync-version.js.json +0 -11
  1445. package/.agent/history/snapshots/scripts__telemetry_gc.js.json +0 -11
  1446. package/.agent/history/snapshots/scripts__validate-payload.js.json +0 -11
  1447. package/.agent/history/snapshots/scripts__visual_audit.js.json +0 -11
  1448. package/.agent/history/snapshots/test__integration__bridges.test.js.json +0 -13
  1449. package/.agent/history/snapshots/test__integration__browser_cli.test.js.json +0 -12
  1450. package/.agent/history/snapshots/test__integration__graceful_degradation.test.js.json +0 -12
  1451. package/.agent/history/snapshots/test__integration__init.test.js.json +0 -13
  1452. package/.agent/history/snapshots/test__integration__minimal_change_pipeline.test.js.json +0 -13
  1453. package/.agent/history/snapshots/test__integration__parallel_tribunal.test.js.json +0 -12
  1454. package/.agent/history/snapshots/test__integration__routing.test.js.json +0 -11
  1455. package/.agent/history/snapshots/test__integration__swarm_dispatcher.test.js.json +0 -13
  1456. package/.agent/history/snapshots/test__integration__sync_status.test.js.json +0 -13
  1457. package/.agent/history/snapshots/test__integration__wave2.test.js.json +0 -13
  1458. package/.agent/history/snapshots/test__integration__wrapper.test.js.json +0 -13
  1459. package/.agent/history/snapshots/test__unit__align.test.js.json +0 -10
  1460. package/.agent/history/snapshots/test__unit__args.test.js.json +0 -20
  1461. package/.agent/history/snapshots/test__unit__ast_context_loader.test.js.json +0 -12
  1462. package/.agent/history/snapshots/test__unit__audit_release.test.js.json +0 -16
  1463. package/.agent/history/snapshots/test__unit__browser_case_bridge.test.js.json +0 -11
  1464. package/.agent/history/snapshots/test__unit__browser_discovery.test.js.json +0 -10
  1465. package/.agent/history/snapshots/test__unit__browser_idpi.test.js.json +0 -10
  1466. package/.agent/history/snapshots/test__unit__browser_sentinel.test.js.json +0 -11
  1467. package/.agent/history/snapshots/test__unit__browser_synapse.test.js.json +0 -10
  1468. package/.agent/history/snapshots/test__unit__browser_trimmer.test.js.json +0 -10
  1469. package/.agent/history/snapshots/test__unit__case_law_manager.test.js.json +0 -10
  1470. package/.agent/history/snapshots/test__unit__cicd_validator.test.js.json +0 -12
  1471. package/.agent/history/snapshots/test__unit__compile.test.js.json +0 -10
  1472. package/.agent/history/snapshots/test__unit__context_broker.test.js.json +0 -10
  1473. package/.agent/history/snapshots/test__unit__context_compiler.test.js.json +0 -26
  1474. package/.agent/history/snapshots/test__unit__contract_engine.test.js.json +0 -13
  1475. package/.agent/history/snapshots/test__unit__copyDir.test.js.json +0 -23
  1476. package/.agent/history/snapshots/test__unit__graph_tools.test.js.json +0 -11
  1477. package/.agent/history/snapshots/test__unit__guardrail_engine.test.js.json +0 -10
  1478. package/.agent/history/snapshots/test__unit__impact_classifier.test.js.json +0 -12
  1479. package/.agent/history/snapshots/test__unit__init.test.js.json +0 -14
  1480. package/.agent/history/snapshots/test__unit__inner_loop_validator.test.js.json +0 -10
  1481. package/.agent/history/snapshots/test__unit__integrity_manifest.test.js.json +0 -13
  1482. package/.agent/history/snapshots/test__unit__learn.test.js.json +0 -11
  1483. package/.agent/history/snapshots/test__unit__marathon.test.js.json +0 -22
  1484. package/.agent/history/snapshots/test__unit__mcp_server.test.js.json +0 -16
  1485. package/.agent/history/snapshots/test__unit__memory.test.js.json +0 -13
  1486. package/.agent/history/snapshots/test__unit__minimal_change.test.js.json +0 -10
  1487. package/.agent/history/snapshots/test__unit__native.test.js.json +0 -10
  1488. package/.agent/history/snapshots/test__unit__optimize.test.js.json +0 -13
  1489. package/.agent/history/snapshots/test__unit__path_resolution.test.js.json +0 -14
  1490. package/.agent/history/snapshots/test__unit__platform_download_audit.test.js.json +0 -11
  1491. package/.agent/history/snapshots/test__unit__production_readiness_evidence.test.js.json +0 -21
  1492. package/.agent/history/snapshots/test__unit__prompt_compiler.test.js.json +0 -10
  1493. package/.agent/history/snapshots/test__unit__sdd_integration.test.js.json +0 -12
  1494. package/.agent/history/snapshots/test__unit__selfInstall.test.js.json +0 -23
  1495. package/.agent/history/snapshots/test__unit__semver.test.js.json +0 -20
  1496. package/.agent/history/snapshots/test__unit__skill_evolution.test.js.json +0 -11
  1497. package/.agent/history/snapshots/test__unit__stress.test.js.json +0 -15
  1498. package/.agent/history/snapshots/test__unit__swarm_dispatcher.test.js.json +0 -12
  1499. package/.agent/history/snapshots/test__unit__token_budget_broker.test.js.json +0 -10
  1500. package/.agent/history/snapshots/test__unit__tui.test.js.json +0 -10
  1501. package/.agent/history/snapshots/test__unit__utils.test.js.json +0 -10
  1502. package/.agents/plugins/marketplace.json +0 -20
  1503. package/.claude/CLAUDE.md +0 -442
  1504. /package/{dist → src}/cli.js +0 -0
  1505. /package/{dist → src}/index.d.ts +0 -0
package/.agents/skills/tailwind-patterns/SKILL.md CHANGED
@@ -1,583 +1,583 @@
1
- ---
2
- name: tailwind-patterns
3
- description: "Use when Tailwind CSS v4+ mastery. CSS-first configuration, @theme directive, container queries, scroll-driven animations, logical properties, clamp(), fluid typography, responsive design, dark mode, custom variants, component extraction, and performance optimization. Use when styling with Tailwind, building design systems, or optimizing CSS output."
4
- version: 5.0.0
5
- last-updated: 2026-09-13
6
- skills:
7
- - baseline-ui
8
- - better-colors
9
- - shadcn-ui-expert
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
- # Tailwind CSS v4+ — CSS-First Mastery
17
-
18
- ---
19
-
20
- ## 🛠️ Technical Architecture & Reference Recipes
21
-
22
- ---
23
-
24
- ---
25
-
26
- ## v4 Configuration (CSS-First)
27
-
28
- ### The @theme Directive
29
-
30
- ```css
31
- /* app.css — THE configuration file in Tailwind v4 */
32
- @import 'tailwindcss';
33
-
34
- @theme {
35
- /* Colors */
36
- --color-primary-50: oklch(0.97 0.02 250);
37
- --color-primary-100: oklch(0.93 0.04 250);
38
- --color-primary-500: oklch(0.55 0.18 250);
39
- --color-primary-600: oklch(0.48 0.18 250);
40
- --color-primary-700: oklch(0.4 0.16 250);
41
- --color-primary-900: oklch(0.25 0.1 250);
42
-
43
- --color-surface: oklch(0.99 0 0);
44
- --color-surface-alt: oklch(0.96 0 0);
45
- --color-text: oklch(0.15 0 0);
46
- --color-text-muted: oklch(0.45 0 0);
47
-
48
- /* Typography */
49
- --font-sans: 'Inter', 'system-ui', sans-serif;
50
- --font-mono: 'JetBrains Mono', monospace;
51
-
52
- /* Spacing (extends the default scale) */
53
- --spacing-18: 4.5rem;
54
- --spacing-88: 22rem;
55
-
56
- /* Border radius */
57
- --radius-pill: 9999px;
58
- --radius-card: 1rem;
59
-
60
- /* Shadows */
61
- --shadow-card: 0 1px 3px oklch(0 0 0 / 0.08), 0 1px 2px oklch(0 0 0 / 0.06);
62
- --shadow-elevated: 0 10px 25px oklch(0 0 0 / 0.1), 0 4px 10px oklch(0 0 0 / 0.05);
63
-
64
- /* Animations */
65
- --animate-fade-in: fade-in 0.3s ease-out;
66
- --animate-slide-up: slide-up 0.4s cubic-bezier(0.16, 1, 0.3, 1);
67
- }
68
-
69
- @keyframes fade-in {
70
- from {
71
- opacity: 0;
72
- }
73
- to {
74
- opacity: 1;
75
- }
76
- }
77
-
78
- @keyframes slide-up {
79
- from {
80
- opacity: 0;
81
- transform: translateY(12px);
82
- }
83
- to {
84
- opacity: 1;
85
- transform: translateY(0);
86
- }
87
- }
88
-
89
- /* ❌ HALLUCINATION TRAP: Tailwind v4 does NOT use tailwind.config.js
90
- ❌ module.exports = { theme: { extend: { ... } } } ← REMOVED in v4
91
- ✅ Use @theme { } directive in your CSS file
92
- ✅ @import "tailwindcss" replaces the three @tailwind directives */
93
- ```
94
-
95
- ### Dark Mode
96
-
97
- ```css
98
- /* Tailwind v4 dark mode with @theme */
99
- @theme {
100
- --color-surface: oklch(0.99 0 0);
101
- --color-text: oklch(0.15 0 0);
102
- }
103
-
104
- /* Dark variant — override variables */
105
- @variant dark {
106
- @theme {
107
- --color-surface: oklch(0.13 0.02 260);
108
- --color-text: oklch(0.93 0 0);
109
- }
110
- }
111
-
112
- /* Usage in HTML: */
113
- /* <div class="bg-surface text-text dark:bg-surface dark:text-text"> */
114
- /* With the @variant dark override, classes "just work" in dark mode */
115
- ```
116
-
117
- ```html
118
- <!-- Dark mode toggle pattern -->
119
- <html class="dark">
120
- <body class="bg-surface text-text transition-colors duration-300">
121
- <!-- Automatically uses dark @theme values -->
122
- </body>
123
- </html>
124
- ```
125
-
126
- ### Custom Variants
127
-
128
- ```css
129
- /* @variant — custom selector-based variants */
130
- @variant scrolled (&:where([data-scrolled]));
131
- @variant hocus (&:hover, &:focus-visible);
132
-
133
- /* Usage: */
134
- /* <nav class="scrolled:shadow-elevated hocus:ring-2"> */
135
- ```
136
-
137
- ---
138
-
139
- ## Layout Patterns
140
-
141
- ### Flexbox
142
-
143
- ```html
144
- <!-- Centered hero -->
145
- <section class="flex min-h-svh flex-col items-center justify-center gap-6 px-6">
146
- <h1 class="text-5xl font-bold tracking-tight">Hero Title</h1>
147
- <p class="max-w-2xl text-center text-lg text-text-muted">Subtitle text</p>
148
- <div class="flex gap-3">
149
- <button class="rounded-pill bg-primary-600 px-6 py-3 text-white">Primary</button>
150
- <button class="rounded-pill border border-primary-600 px-6 py-3 text-primary-600">
151
- Secondary
152
- </button>
153
- </div>
154
- </section>
155
-
156
- <!-- Sidebar layout -->
157
- <div class="flex min-h-svh">
158
- <aside class="w-64 shrink-0 border-r border-gray-200 p-4">Sidebar</aside>
159
- <main class="flex-1 overflow-y-auto p-6">Content</main>
160
- </div>
161
-
162
- <!-- ❌ HALLUCINATION TRAP: Use min-h-svh (small viewport height), NOT min-h-screen
163
- min-h-screen = 100vh (broken on mobile — includes browser chrome)
164
- min-h-svh = 100svh (accounts for mobile browser chrome)
165
- min-h-dvh = 100dvh (dynamic — updates as chrome shows/hides) -->
166
- ```
167
-
168
- ### CSS Grid
169
-
170
- ```html
171
- <!-- Auto-fit responsive grid (no breakpoints needed) -->
172
- <div class="grid grid-cols-[repeat(auto-fit,minmax(280px,1fr))] gap-6">
173
- <div class="rounded-card bg-surface p-6 shadow-card">Card 1</div>
174
- <div class="rounded-card bg-surface p-6 shadow-card">Card 2</div>
175
- <div class="rounded-card bg-surface p-6 shadow-card">Card 3</div>
176
- </div>
177
-
178
- <!-- Dashboard grid with named areas -->
179
- <div class="grid grid-cols-[240px_1fr] grid-rows-[64px_1fr] min-h-svh">
180
- <header class="col-span-2 border-b">Header</header>
181
- <aside class="border-r p-4">Sidebar</aside>
182
- <main class="overflow-y-auto p-6">Content</main>
183
- </div>
184
-
185
- <!-- Bento grid -->
186
- <div class="grid auto-rows-[180px] grid-cols-3 gap-4">
187
- <div class="col-span-2 row-span-2 rounded-2xl bg-primary-100">Large</div>
188
- <div class="rounded-2xl bg-surface-alt">Small 1</div>
189
- <div class="rounded-2xl bg-surface-alt">Small 2</div>
190
- <div class="col-span-3 rounded-2xl bg-primary-50">Full width</div>
191
- </div>
192
- ```
193
-
194
- ### Container Queries
195
-
196
- ```html
197
- <!-- Container queries — component-level responsiveness -->
198
- <div class="@container">
199
- <div class="flex flex-col gap-3 @sm:flex-row @sm:items-center @lg:gap-6">
200
- <img class="size-16 rounded-full @sm:size-20" src="avatar.jpg" alt="" />
201
- <div>
202
- <h3 class="text-lg font-semibold @lg:text-xl">User Name</h3>
203
- <p class="text-sm text-text-muted @lg:text-base">Description</p>
204
- </div>
205
- </div>
206
- </div>
207
-
208
- <!-- Named container -->
209
- <div class="@container/card">
210
- <div class="@md/card:grid @md/card:grid-cols-2">
211
- <!-- Responds to the card container's width, not viewport -->
212
- </div>
213
- </div>
214
-
215
- <!-- ❌ HALLUCINATION TRAP: Container queries use @sm, @md, @lg (with @ prefix)
216
- NOT sm:, md:, lg: — those are VIEWPORT breakpoints
217
- @sm = container >= 320px (component-level)
218
- sm: = viewport >= 640px (page-level) -->
219
- ```
220
-
221
- ---
222
-
223
- ## Typography
224
-
225
- ### Fluid Typography with clamp()
226
-
227
- ```html
228
- <!-- Fluid heading — scales smoothly from 2rem to 4rem -->
229
- <h1 class="text-[clamp(2rem,5vw,4rem)] font-bold leading-tight tracking-tight">
230
- Responsive Heading
231
- </h1>
232
-
233
- <!-- Fluid body text -->
234
- <p class="text-[clamp(1rem,1.2vw,1.25rem)] leading-relaxed text-text-muted">
235
- Body text that scales with viewport
236
- </p>
237
-
238
- <!-- Prose (for long-form content) -->
239
- <article class="prose prose-lg mx-auto max-w-3xl dark:prose-invert">
240
- <!-- @tailwindcss/typography plugin handles all typography -->
241
- <h1>Article Title</h1>
242
- <p>Paragraph with <a href="#">links</a> and <code>code</code>.</p>
243
- </article>
244
- ```
245
-
246
- ### Font Loading
247
-
248
- ```css
249
- /* @font-face in your CSS (Tailwind v4 approach) */
250
- @font-face {
251
- font-family: 'Inter';
252
- font-weight: 100 900;
253
- font-display: swap;
254
- src: url('/fonts/inter-variable.woff2') format('woff2');
255
- }
256
-
257
- @theme {
258
- --font-sans: 'Inter', system-ui, sans-serif;
259
- }
260
- ```
261
-
262
- ---
263
-
264
- ## Component Patterns
265
-
266
- ### Button System
267
-
268
- ```html
269
- <!-- Base button with variants -->
270
- <button
271
- class="inline-flex items-center justify-center gap-2 rounded-lg px-4 py-2.5
272
- text-sm font-medium transition-all duration-150
273
- focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-500
274
- active:scale-[0.98] disabled:pointer-events-none disabled:opacity-50"
275
- >
276
- Button Text
277
- </button>
278
-
279
- <!-- Primary variant -->
280
- <button class="... bg-primary-600 text-white shadow-sm hover:bg-primary-700">Primary</button>
281
-
282
- <!-- Ghost variant -->
283
- <button class="... text-text hover:bg-gray-100 dark:hover:bg-gray-800">Ghost</button>
284
-
285
- <!-- Destructive variant -->
286
- <button class="... bg-red-600 text-white hover:bg-red-700">Delete</button>
287
-
288
- <!-- Icon button -->
289
- <button class="grid size-10 place-items-center rounded-lg hover:bg-gray-100" aria-label="Settings">
290
- <svg class="size-5" ...></svg>
291
- </button>
292
- ```
293
-
294
- ### Input System
295
-
296
- ```html
297
- <!-- Text input -->
298
- <div class="space-y-1.5">
299
- <label for="email" class="text-sm font-medium text-text">Email</label>
300
- <input
301
- id="email"
302
- type="email"
303
- placeholder="you@example.com"
304
- class="w-full rounded-lg border border-gray-300 bg-surface px-3.5 py-2.5
305
- text-sm text-text placeholder:text-text-muted
306
- transition-colors duration-150
307
- focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-primary-500/20
308
- disabled:cursor-not-allowed disabled:bg-gray-50 disabled:opacity-60"
309
- />
310
- <p class="text-xs text-red-500">Error message here</p>
311
- </div>
312
-
313
- <!-- Checkbox -->
314
- <label class="flex items-center gap-2.5 text-sm">
315
- <input
316
- type="checkbox"
317
- class="size-4 rounded border-gray-300 text-primary-600
318
- focus:ring-2 focus:ring-primary-500/20"
319
- />
320
- Remember me
321
- </label>
322
- ```
323
-
324
- ### Card Pattern
325
-
326
- ```html
327
- <div
328
- class="group overflow-hidden rounded-card bg-surface shadow-card
329
- transition-shadow duration-200 hover:shadow-elevated"
330
- >
331
- <div class="aspect-video overflow-hidden bg-gray-100">
332
- <img
333
- src="cover.jpg"
334
- alt="Cover"
335
- class="size-full object-cover transition-transform duration-300
336
- group-hover:scale-105"
337
- />
338
- </div>
339
- <div class="space-y-2 p-5">
340
- <span
341
- class="inline-block rounded-full bg-primary-100 px-2.5 py-0.5
342
- text-xs font-medium text-primary-700"
343
- >Category</span
344
- >
345
- <h3 class="text-lg font-semibold text-text line-clamp-2">Card Title</h3>
346
- <p class="text-sm text-text-muted line-clamp-3">Description text...</p>
347
- </div>
348
- </div>
349
- ```
350
-
351
- ### Modal / Dialog
352
-
353
- ```html
354
- <!-- Backdrop -->
355
- <div
356
- class="fixed inset-0 z-50 flex items-center justify-center bg-black/50
357
- backdrop-blur-sm animate-fade-in"
358
- >
359
- <!-- Modal -->
360
- <div
361
- class="w-full max-w-md rounded-2xl bg-surface p-6 shadow-elevated animate-slide-up"
362
- role="dialog"
363
- aria-modal="true"
364
- aria-labelledby="modal-title"
365
- >
366
- <h2 id="modal-title" class="text-lg font-semibold">Dialog Title</h2>
367
- <p class="mt-2 text-sm text-text-muted">Dialog description.</p>
368
-
369
- <div class="mt-6 flex justify-end gap-3">
370
- <button class="rounded-lg px-4 py-2 text-sm hover:bg-gray-100">Cancel</button>
371
- <button
372
- class="rounded-lg bg-primary-600 px-4 py-2 text-sm text-white
373
- hover:bg-primary-700"
374
- >
375
- Confirm
376
- </button>
377
- </div>
378
- </div>
379
- </div>
380
- ```
381
-
382
- ---
383
-
384
- ## Responsive Design Rules
385
-
386
- ```html
387
- <!-- Tailwind breakpoints (mobile-first) -->
388
- <!-- sm: 640px │ md: 768px │ lg: 1024px │ xl: 1280px │ 2xl: 1536px -->
389
-
390
- <!-- Stack on mobile, row on tablet+ -->
391
- <div class="flex flex-col gap-4 md:flex-row md:items-center">
392
- <div class="md:w-1/2">Left</div>
393
- <div class="md:w-1/2">Right</div>
394
- </div>
395
-
396
- <!-- Hide/show at breakpoints -->
397
- <nav class="hidden lg:flex">Desktop nav</nav>
398
- <button class="lg:hidden">☰ Mobile menu</button>
399
-
400
- <!-- Responsive padding -->
401
- <section class="px-4 py-12 sm:px-6 lg:px-8 lg:py-24">
402
- <div class="mx-auto max-w-7xl">Content</div>
403
- </section>
404
-
405
- <!-- Responsive grid -->
406
- <div class="grid grid-cols-1 gap-6 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
407
- <!-- Cards -->
408
- </div>
409
- ```
410
-
411
- ---
412
-
413
- ## Animations & Transitions
414
-
415
- ### Transition Utilities
416
-
417
- ```html
418
- <!-- Smooth hover transitions -->
419
- <a class="text-text-muted transition-colors duration-150 hover:text-primary-600">Link</a>
420
-
421
- <!-- Transform transitions -->
422
- <div class="transition-transform duration-300 hover:-translate-y-1 hover:scale-105">Hover me</div>
423
-
424
- <!-- Combined transition -->
425
- <button
426
- class="rounded-lg bg-primary-600 px-4 py-2 text-white
427
- transition-all duration-200
428
- hover:bg-primary-700 hover:shadow-lg
429
- active:scale-95"
430
- >
431
- Click me
432
- </button>
433
- ```
434
-
435
- ### Custom Keyframe Animations
436
-
437
- ```css
438
- @theme {
439
- --animate-bounce-in: bounce-in 0.5s cubic-bezier(0.68, -0.55, 0.265, 1.55);
440
- --animate-spin-slow: spin 3s linear infinite;
441
- --animate-pulse-soft: pulse-soft 2s ease-in-out infinite;
442
- }
443
-
444
- @keyframes bounce-in {
445
- 0% {
446
- opacity: 0;
447
- transform: scale(0.3);
448
- }
449
- 50% {
450
- transform: scale(1.05);
451
- }
452
- 70% {
453
- transform: scale(0.9);
454
- }
455
- 100% {
456
- opacity: 1;
457
- transform: scale(1);
458
- }
459
- }
460
-
461
- @keyframes pulse-soft {
462
- 0%,
463
- 100% {
464
- opacity: 1;
465
- }
466
- 50% {
467
- opacity: 0.7;
468
- }
469
- }
470
- ```
471
-
472
- ### Scroll-Driven Animations (CSS Native)
473
-
474
- ```css
475
- /* Progress bar that fills as user scrolls */
476
- .scroll-progress {
477
- animation: grow-width linear;
478
- animation-timeline: scroll();
479
- }
480
-
481
- @keyframes grow-width {
482
- from {
483
- transform: scaleX(0);
484
- }
485
- to {
486
- transform: scaleX(1);
487
- }
488
- }
489
- ```
490
-
491
- ```html
492
- <div class="scroll-progress fixed top-0 left-0 z-50 h-1 w-full origin-left bg-primary-600"></div>
493
- ```
494
-
495
- ---
496
-
497
- ## Performance
498
-
499
- ### Purging & Bundle Size
500
-
501
- ```css
502
- /* Tailwind v4 automatically tree-shakes unused CSS at build time */
503
- /* No manual purge configuration needed */
504
-
505
- /* @source — explicitly add content paths for scanning */
506
- @source "../components/**/*.tsx";
507
- @source "../pages/**/*.tsx";
508
-
509
- /* ❌ HALLUCINATION TRAP: Tailwind v4 does NOT use purge: [] config
510
- ❌ purge: ['./src/**/*.{html,tsx}'] ← REMOVED in v4
511
- ✅ Uses automatic content detection based on your project structure
512
- ✅ Use @source directive for custom paths */
513
- ```
514
-
515
- ### Avoiding Bloat
516
-
517
- ```html
518
- <!-- ✅ GOOD: Use component extraction for repeated patterns -->
519
- <!-- Create a .btn class in CSS instead of repeating 15 utilities -->
520
-
521
- <!-- ❌ BAD: One-off arbitrary values everywhere -->
522
- <div class="mt-[13px] mr-[7px] p-[11px] text-[15px]">
523
- <!-- Every arbitrary value = unique CSS rule = bundle bloat -->
524
- </div>
525
-
526
- <!-- ✅ GOOD: Use your design scale -->
527
- <div class="mt-3 mr-2 p-3 text-sm">
528
- <!-- Maps to existing utilities = zero extra CSS -->
529
- </div>
530
- ```
531
-
532
- ### Component Extraction (When to @apply)
533
-
534
- ```css
535
- /* Use @apply ONLY for highly reused component patterns */
536
- /* Do NOT @apply everything — it defeats Tailwind's purpose */
537
-
538
- .btn {
539
- @apply inline-flex items-center justify-center gap-2 rounded-lg px-4 py-2.5
540
- text-sm font-medium transition-all duration-150
541
- focus-visible:outline-2 focus-visible:outline-offset-2
542
- active:scale-[0.98] disabled:pointer-events-none disabled:opacity-50;
543
- }
544
-
545
- .btn-primary {
546
- @apply btn bg-primary-600 text-white shadow-sm hover:bg-primary-700
547
- focus-visible:outline-primary-500;
548
- }
549
-
550
- /* ❌ HALLUCINATION TRAP: @apply is for component patterns shared across files
551
- If a pattern appears in only 1-2 places, just use inline utilities
552
- Over-extracting with @apply = recreating regular CSS with extra steps */
553
- ```
554
-
555
- ---
556
-
557
- ## Accessibility with Tailwind
558
-
559
- ```html
560
- <!-- Focus visible (keyboard only, not mouse click) -->
561
- <a
562
- class="rounded-lg focus-visible:outline-2 focus-visible:outline-primary-500
563
- focus-visible:outline-offset-2"
564
- >
565
- Keyboard accessible link
566
- </a>
567
-
568
- <!-- Screen reader only text -->
569
- <button>
570
- <svg class="size-5" aria-hidden="true"></svg>
571
- <span class="sr-only">Close menu</span>
572
- </button>
573
-
574
- <!-- Motion-safe / motion-reduce -->
575
- <div class="motion-safe:animate-bounce-in motion-reduce:animate-none">
576
- <!-- Only animates if user hasn't enabled "reduce motion" -->
577
- </div>
578
-
579
- <!-- Forced colors mode (high contrast) -->
580
- <button class="bg-primary-600 forced-colors:bg-[Highlight] forced-colors:text-[HighlightText]">
581
- Accessible button
582
- </button>
583
- ```
1
+ ---
2
+ name: tailwind-patterns
3
+ description: "Use when Tailwind CSS v4+ mastery. CSS-first configuration, @theme directive, container queries, scroll-driven animations, logical properties, clamp(), fluid typography, responsive design, dark mode, custom variants, component extraction, and performance optimization. Use when styling with Tailwind, building design systems, or optimizing CSS output."
4
+ version: 5.0.0
5
+ last-updated: 2026-09-13
6
+ skills:
7
+ - baseline-ui
8
+ - better-colors
9
+ - shadcn-ui-expert
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
+ # Tailwind CSS v4+ — CSS-First Mastery
17
+
18
+ ---
19
+
20
+ ## 🛠️ Technical Architecture & Reference Recipes
21
+
22
+ ---
23
+
24
+ ---
25
+
26
+ ## v4 Configuration (CSS-First)
27
+
28
+ ### The @theme Directive
29
+
30
+ ```css
31
+ /* app.css — THE configuration file in Tailwind v4 */
32
+ @import 'tailwindcss';
33
+
34
+ @theme {
35
+ /* Colors */
36
+ --color-primary-50: oklch(0.97 0.02 250);
37
+ --color-primary-100: oklch(0.93 0.04 250);
38
+ --color-primary-500: oklch(0.55 0.18 250);
39
+ --color-primary-600: oklch(0.48 0.18 250);
40
+ --color-primary-700: oklch(0.4 0.16 250);
41
+ --color-primary-900: oklch(0.25 0.1 250);
42
+
43
+ --color-surface: oklch(0.99 0 0);
44
+ --color-surface-alt: oklch(0.96 0 0);
45
+ --color-text: oklch(0.15 0 0);
46
+ --color-text-muted: oklch(0.45 0 0);
47
+
48
+ /* Typography */
49
+ --font-sans: 'Inter', 'system-ui', sans-serif;
50
+ --font-mono: 'JetBrains Mono', monospace;
51
+
52
+ /* Spacing (extends the default scale) */
53
+ --spacing-18: 4.5rem;
54
+ --spacing-88: 22rem;
55
+
56
+ /* Border radius */
57
+ --radius-pill: 9999px;
58
+ --radius-card: 1rem;
59
+
60
+ /* Shadows */
61
+ --shadow-card: 0 1px 3px oklch(0 0 0 / 0.08), 0 1px 2px oklch(0 0 0 / 0.06);
62
+ --shadow-elevated: 0 10px 25px oklch(0 0 0 / 0.1), 0 4px 10px oklch(0 0 0 / 0.05);
63
+
64
+ /* Animations */
65
+ --animate-fade-in: fade-in 0.3s ease-out;
66
+ --animate-slide-up: slide-up 0.4s cubic-bezier(0.16, 1, 0.3, 1);
67
+ }
68
+
69
+ @keyframes fade-in {
70
+ from {
71
+ opacity: 0;
72
+ }
73
+ to {
74
+ opacity: 1;
75
+ }
76
+ }
77
+
78
+ @keyframes slide-up {
79
+ from {
80
+ opacity: 0;
81
+ transform: translateY(12px);
82
+ }
83
+ to {
84
+ opacity: 1;
85
+ transform: translateY(0);
86
+ }
87
+ }
88
+
89
+ /* ❌ HALLUCINATION TRAP: Tailwind v4 does NOT use tailwind.config.js
90
+ ❌ module.exports = { theme: { extend: { ... } } } ← REMOVED in v4
91
+ ✅ Use @theme { } directive in your CSS file
92
+ ✅ @import "tailwindcss" replaces the three @tailwind directives */
93
+ ```
94
+
95
+ ### Dark Mode
96
+
97
+ ```css
98
+ /* Tailwind v4 dark mode with @theme */
99
+ @theme {
100
+ --color-surface: oklch(0.99 0 0);
101
+ --color-text: oklch(0.15 0 0);
102
+ }
103
+
104
+ /* Dark variant — override variables */
105
+ @variant dark {
106
+ @theme {
107
+ --color-surface: oklch(0.13 0.02 260);
108
+ --color-text: oklch(0.93 0 0);
109
+ }
110
+ }
111
+
112
+ /* Usage in HTML: */
113
+ /* <div class="bg-surface text-text dark:bg-surface dark:text-text"> */
114
+ /* With the @variant dark override, classes "just work" in dark mode */
115
+ ```
116
+
117
+ ```html
118
+ <!-- Dark mode toggle pattern -->
119
+ <html class="dark">
120
+ <body class="bg-surface text-text transition-colors duration-300">
121
+ <!-- Automatically uses dark @theme values -->
122
+ </body>
123
+ </html>
124
+ ```
125
+
126
+ ### Custom Variants
127
+
128
+ ```css
129
+ /* @variant — custom selector-based variants */
130
+ @variant scrolled (&:where([data-scrolled]));
131
+ @variant hocus (&:hover, &:focus-visible);
132
+
133
+ /* Usage: */
134
+ /* <nav class="scrolled:shadow-elevated hocus:ring-2"> */
135
+ ```
136
+
137
+ ---
138
+
139
+ ## Layout Patterns
140
+
141
+ ### Flexbox
142
+
143
+ ```html
144
+ <!-- Centered hero -->
145
+ <section class="flex min-h-svh flex-col items-center justify-center gap-6 px-6">
146
+ <h1 class="text-5xl font-bold tracking-tight">Hero Title</h1>
147
+ <p class="max-w-2xl text-center text-lg text-text-muted">Subtitle text</p>
148
+ <div class="flex gap-3">
149
+ <button class="rounded-pill bg-primary-600 px-6 py-3 text-white">Primary</button>
150
+ <button class="rounded-pill border border-primary-600 px-6 py-3 text-primary-600">
151
+ Secondary
152
+ </button>
153
+ </div>
154
+ </section>
155
+
156
+ <!-- Sidebar layout -->
157
+ <div class="flex min-h-svh">
158
+ <aside class="w-64 shrink-0 border-r border-gray-200 p-4">Sidebar</aside>
159
+ <main class="flex-1 overflow-y-auto p-6">Content</main>
160
+ </div>
161
+
162
+ <!-- ❌ HALLUCINATION TRAP: Use min-h-svh (small viewport height), NOT min-h-screen
163
+ min-h-screen = 100vh (broken on mobile — includes browser chrome)
164
+ min-h-svh = 100svh (accounts for mobile browser chrome)
165
+ min-h-dvh = 100dvh (dynamic — updates as chrome shows/hides) -->
166
+ ```
167
+
168
+ ### CSS Grid
169
+
170
+ ```html
171
+ <!-- Auto-fit responsive grid (no breakpoints needed) -->
172
+ <div class="grid grid-cols-[repeat(auto-fit,minmax(280px,1fr))] gap-6">
173
+ <div class="rounded-card bg-surface p-6 shadow-card">Card 1</div>
174
+ <div class="rounded-card bg-surface p-6 shadow-card">Card 2</div>
175
+ <div class="rounded-card bg-surface p-6 shadow-card">Card 3</div>
176
+ </div>
177
+
178
+ <!-- Dashboard grid with named areas -->
179
+ <div class="grid grid-cols-[240px_1fr] grid-rows-[64px_1fr] min-h-svh">
180
+ <header class="col-span-2 border-b">Header</header>
181
+ <aside class="border-r p-4">Sidebar</aside>
182
+ <main class="overflow-y-auto p-6">Content</main>
183
+ </div>
184
+
185
+ <!-- Bento grid -->
186
+ <div class="grid auto-rows-[180px] grid-cols-3 gap-4">
187
+ <div class="col-span-2 row-span-2 rounded-2xl bg-primary-100">Large</div>
188
+ <div class="rounded-2xl bg-surface-alt">Small 1</div>
189
+ <div class="rounded-2xl bg-surface-alt">Small 2</div>
190
+ <div class="col-span-3 rounded-2xl bg-primary-50">Full width</div>
191
+ </div>
192
+ ```
193
+
194
+ ### Container Queries
195
+
196
+ ```html
197
+ <!-- Container queries — component-level responsiveness -->
198
+ <div class="@container">
199
+ <div class="flex flex-col gap-3 @sm:flex-row @sm:items-center @lg:gap-6">
200
+ <img class="size-16 rounded-full @sm:size-20" src="avatar.jpg" alt="" />
201
+ <div>
202
+ <h3 class="text-lg font-semibold @lg:text-xl">User Name</h3>
203
+ <p class="text-sm text-text-muted @lg:text-base">Description</p>
204
+ </div>
205
+ </div>
206
+ </div>
207
+
208
+ <!-- Named container -->
209
+ <div class="@container/card">
210
+ <div class="@md/card:grid @md/card:grid-cols-2">
211
+ <!-- Responds to the card container's width, not viewport -->
212
+ </div>
213
+ </div>
214
+
215
+ <!-- ❌ HALLUCINATION TRAP: Container queries use @sm, @md, @lg (with @ prefix)
216
+ NOT sm:, md:, lg: — those are VIEWPORT breakpoints
217
+ @sm = container >= 320px (component-level)
218
+ sm: = viewport >= 640px (page-level) -->
219
+ ```
220
+
221
+ ---
222
+
223
+ ## Typography
224
+
225
+ ### Fluid Typography with clamp()
226
+
227
+ ```html
228
+ <!-- Fluid heading — scales smoothly from 2rem to 4rem -->
229
+ <h1 class="text-[clamp(2rem,5vw,4rem)] font-bold leading-tight tracking-tight">
230
+ Responsive Heading
231
+ </h1>
232
+
233
+ <!-- Fluid body text -->
234
+ <p class="text-[clamp(1rem,1.2vw,1.25rem)] leading-relaxed text-text-muted">
235
+ Body text that scales with viewport
236
+ </p>
237
+
238
+ <!-- Prose (for long-form content) -->
239
+ <article class="prose prose-lg mx-auto max-w-3xl dark:prose-invert">
240
+ <!-- @tailwindcss/typography plugin handles all typography -->
241
+ <h1>Article Title</h1>
242
+ <p>Paragraph with <a href="#">links</a> and <code>code</code>.</p>
243
+ </article>
244
+ ```
245
+
246
+ ### Font Loading
247
+
248
+ ```css
249
+ /* @font-face in your CSS (Tailwind v4 approach) */
250
+ @font-face {
251
+ font-family: 'Inter';
252
+ font-weight: 100 900;
253
+ font-display: swap;
254
+ src: url('/fonts/inter-variable.woff2') format('woff2');
255
+ }
256
+
257
+ @theme {
258
+ --font-sans: 'Inter', system-ui, sans-serif;
259
+ }
260
+ ```
261
+
262
+ ---
263
+
264
+ ## Component Patterns
265
+
266
+ ### Button System
267
+
268
+ ```html
269
+ <!-- Base button with variants -->
270
+ <button
271
+ class="inline-flex items-center justify-center gap-2 rounded-lg px-4 py-2.5
272
+ text-sm font-medium transition-all duration-150
273
+ focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-500
274
+ active:scale-[0.98] disabled:pointer-events-none disabled:opacity-50"
275
+ >
276
+ Button Text
277
+ </button>
278
+
279
+ <!-- Primary variant -->
280
+ <button class="... bg-primary-600 text-white shadow-sm hover:bg-primary-700">Primary</button>
281
+
282
+ <!-- Ghost variant -->
283
+ <button class="... text-text hover:bg-gray-100 dark:hover:bg-gray-800">Ghost</button>
284
+
285
+ <!-- Destructive variant -->
286
+ <button class="... bg-red-600 text-white hover:bg-red-700">Delete</button>
287
+
288
+ <!-- Icon button -->
289
+ <button class="grid size-10 place-items-center rounded-lg hover:bg-gray-100" aria-label="Settings">
290
+ <svg class="size-5" ...></svg>
291
+ </button>
292
+ ```
293
+
294
+ ### Input System
295
+
296
+ ```html
297
+ <!-- Text input -->
298
+ <div class="space-y-1.5">
299
+ <label for="email" class="text-sm font-medium text-text">Email</label>
300
+ <input
301
+ id="email"
302
+ type="email"
303
+ placeholder="you@example.com"
304
+ class="w-full rounded-lg border border-gray-300 bg-surface px-3.5 py-2.5
305
+ text-sm text-text placeholder:text-text-muted
306
+ transition-colors duration-150
307
+ focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-primary-500/20
308
+ disabled:cursor-not-allowed disabled:bg-gray-50 disabled:opacity-60"
309
+ />
310
+ <p class="text-xs text-red-500">Error message here</p>
311
+ </div>
312
+
313
+ <!-- Checkbox -->
314
+ <label class="flex items-center gap-2.5 text-sm">
315
+ <input
316
+ type="checkbox"
317
+ class="size-4 rounded border-gray-300 text-primary-600
318
+ focus:ring-2 focus:ring-primary-500/20"
319
+ />
320
+ Remember me
321
+ </label>
322
+ ```
323
+
324
+ ### Card Pattern
325
+
326
+ ```html
327
+ <div
328
+ class="group overflow-hidden rounded-card bg-surface shadow-card
329
+ transition-shadow duration-200 hover:shadow-elevated"
330
+ >
331
+ <div class="aspect-video overflow-hidden bg-gray-100">
332
+ <img
333
+ src="cover.jpg"
334
+ alt="Cover"
335
+ class="size-full object-cover transition-transform duration-300
336
+ group-hover:scale-105"
337
+ />
338
+ </div>
339
+ <div class="space-y-2 p-5">
340
+ <span
341
+ class="inline-block rounded-full bg-primary-100 px-2.5 py-0.5
342
+ text-xs font-medium text-primary-700"
343
+ >Category</span
344
+ >
345
+ <h3 class="text-lg font-semibold text-text line-clamp-2">Card Title</h3>
346
+ <p class="text-sm text-text-muted line-clamp-3">Description text...</p>
347
+ </div>
348
+ </div>
349
+ ```
350
+
351
+ ### Modal / Dialog
352
+
353
+ ```html
354
+ <!-- Backdrop -->
355
+ <div
356
+ class="fixed inset-0 z-50 flex items-center justify-center bg-black/50
357
+ backdrop-blur-sm animate-fade-in"
358
+ >
359
+ <!-- Modal -->
360
+ <div
361
+ class="w-full max-w-md rounded-2xl bg-surface p-6 shadow-elevated animate-slide-up"
362
+ role="dialog"
363
+ aria-modal="true"
364
+ aria-labelledby="modal-title"
365
+ >
366
+ <h2 id="modal-title" class="text-lg font-semibold">Dialog Title</h2>
367
+ <p class="mt-2 text-sm text-text-muted">Dialog description.</p>
368
+
369
+ <div class="mt-6 flex justify-end gap-3">
370
+ <button class="rounded-lg px-4 py-2 text-sm hover:bg-gray-100">Cancel</button>
371
+ <button
372
+ class="rounded-lg bg-primary-600 px-4 py-2 text-sm text-white
373
+ hover:bg-primary-700"
374
+ >
375
+ Confirm
376
+ </button>
377
+ </div>
378
+ </div>
379
+ </div>
380
+ ```
381
+
382
+ ---
383
+
384
+ ## Responsive Design Rules
385
+
386
+ ```html
387
+ <!-- Tailwind breakpoints (mobile-first) -->
388
+ <!-- sm: 640px │ md: 768px │ lg: 1024px │ xl: 1280px │ 2xl: 1536px -->
389
+
390
+ <!-- Stack on mobile, row on tablet+ -->
391
+ <div class="flex flex-col gap-4 md:flex-row md:items-center">
392
+ <div class="md:w-1/2">Left</div>
393
+ <div class="md:w-1/2">Right</div>
394
+ </div>
395
+
396
+ <!-- Hide/show at breakpoints -->
397
+ <nav class="hidden lg:flex">Desktop nav</nav>
398
+ <button class="lg:hidden">☰ Mobile menu</button>
399
+
400
+ <!-- Responsive padding -->
401
+ <section class="px-4 py-12 sm:px-6 lg:px-8 lg:py-24">
402
+ <div class="mx-auto max-w-7xl">Content</div>
403
+ </section>
404
+
405
+ <!-- Responsive grid -->
406
+ <div class="grid grid-cols-1 gap-6 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
407
+ <!-- Cards -->
408
+ </div>
409
+ ```
410
+
411
+ ---
412
+
413
+ ## Animations & Transitions
414
+
415
+ ### Transition Utilities
416
+
417
+ ```html
418
+ <!-- Smooth hover transitions -->
419
+ <a class="text-text-muted transition-colors duration-150 hover:text-primary-600">Link</a>
420
+
421
+ <!-- Transform transitions -->
422
+ <div class="transition-transform duration-300 hover:-translate-y-1 hover:scale-105">Hover me</div>
423
+
424
+ <!-- Combined transition -->
425
+ <button
426
+ class="rounded-lg bg-primary-600 px-4 py-2 text-white
427
+ transition-all duration-200
428
+ hover:bg-primary-700 hover:shadow-lg
429
+ active:scale-95"
430
+ >
431
+ Click me
432
+ </button>
433
+ ```
434
+
435
+ ### Custom Keyframe Animations
436
+
437
+ ```css
438
+ @theme {
439
+ --animate-bounce-in: bounce-in 0.5s cubic-bezier(0.68, -0.55, 0.265, 1.55);
440
+ --animate-spin-slow: spin 3s linear infinite;
441
+ --animate-pulse-soft: pulse-soft 2s ease-in-out infinite;
442
+ }
443
+
444
+ @keyframes bounce-in {
445
+ 0% {
446
+ opacity: 0;
447
+ transform: scale(0.3);
448
+ }
449
+ 50% {
450
+ transform: scale(1.05);
451
+ }
452
+ 70% {
453
+ transform: scale(0.9);
454
+ }
455
+ 100% {
456
+ opacity: 1;
457
+ transform: scale(1);
458
+ }
459
+ }
460
+
461
+ @keyframes pulse-soft {
462
+ 0%,
463
+ 100% {
464
+ opacity: 1;
465
+ }
466
+ 50% {
467
+ opacity: 0.7;
468
+ }
469
+ }
470
+ ```
471
+
472
+ ### Scroll-Driven Animations (CSS Native)
473
+
474
+ ```css
475
+ /* Progress bar that fills as user scrolls */
476
+ .scroll-progress {
477
+ animation: grow-width linear;
478
+ animation-timeline: scroll();
479
+ }
480
+
481
+ @keyframes grow-width {
482
+ from {
483
+ transform: scaleX(0);
484
+ }
485
+ to {
486
+ transform: scaleX(1);
487
+ }
488
+ }
489
+ ```
490
+
491
+ ```html
492
+ <div class="scroll-progress fixed top-0 left-0 z-50 h-1 w-full origin-left bg-primary-600"></div>
493
+ ```
494
+
495
+ ---
496
+
497
+ ## Performance
498
+
499
+ ### Purging & Bundle Size
500
+
501
+ ```css
502
+ /* Tailwind v4 automatically tree-shakes unused CSS at build time */
503
+ /* No manual purge configuration needed */
504
+
505
+ /* @source — explicitly add content paths for scanning */
506
+ @source "../components/**/*.tsx";
507
+ @source "../pages/**/*.tsx";
508
+
509
+ /* ❌ HALLUCINATION TRAP: Tailwind v4 does NOT use purge: [] config
510
+ ❌ purge: ['./src/**/*.{html,tsx}'] ← REMOVED in v4
511
+ ✅ Uses automatic content detection based on your project structure
512
+ ✅ Use @source directive for custom paths */
513
+ ```
514
+
515
+ ### Avoiding Bloat
516
+
517
+ ```html
518
+ <!-- ✅ GOOD: Use component extraction for repeated patterns -->
519
+ <!-- Create a .btn class in CSS instead of repeating 15 utilities -->
520
+
521
+ <!-- ❌ BAD: One-off arbitrary values everywhere -->
522
+ <div class="mt-[13px] mr-[7px] p-[11px] text-[15px]">
523
+ <!-- Every arbitrary value = unique CSS rule = bundle bloat -->
524
+ </div>
525
+
526
+ <!-- ✅ GOOD: Use your design scale -->
527
+ <div class="mt-3 mr-2 p-3 text-sm">
528
+ <!-- Maps to existing utilities = zero extra CSS -->
529
+ </div>
530
+ ```
531
+
532
+ ### Component Extraction (When to @apply)
533
+
534
+ ```css
535
+ /* Use @apply ONLY for highly reused component patterns */
536
+ /* Do NOT @apply everything — it defeats Tailwind's purpose */
537
+
538
+ .btn {
539
+ @apply inline-flex items-center justify-center gap-2 rounded-lg px-4 py-2.5
540
+ text-sm font-medium transition-all duration-150
541
+ focus-visible:outline-2 focus-visible:outline-offset-2
542
+ active:scale-[0.98] disabled:pointer-events-none disabled:opacity-50;
543
+ }
544
+
545
+ .btn-primary {
546
+ @apply btn bg-primary-600 text-white shadow-sm hover:bg-primary-700
547
+ focus-visible:outline-primary-500;
548
+ }
549
+
550
+ /* ❌ HALLUCINATION TRAP: @apply is for component patterns shared across files
551
+ If a pattern appears in only 1-2 places, just use inline utilities
552
+ Over-extracting with @apply = recreating regular CSS with extra steps */
553
+ ```
554
+
555
+ ---
556
+
557
+ ## Accessibility with Tailwind
558
+
559
+ ```html
560
+ <!-- Focus visible (keyboard only, not mouse click) -->
561
+ <a
562
+ class="rounded-lg focus-visible:outline-2 focus-visible:outline-primary-500
563
+ focus-visible:outline-offset-2"
564
+ >
565
+ Keyboard accessible link
566
+ </a>
567
+
568
+ <!-- Screen reader only text -->
569
+ <button>
570
+ <svg class="size-5" aria-hidden="true"></svg>
571
+ <span class="sr-only">Close menu</span>
572
+ </button>
573
+
574
+ <!-- Motion-safe / motion-reduce -->
575
+ <div class="motion-safe:animate-bounce-in motion-reduce:animate-none">
576
+ <!-- Only animates if user hasn't enabled "reduce motion" -->
577
+ </div>
578
+
579
+ <!-- Forced colors mode (high contrast) -->
580
+ <button class="bg-primary-600 forced-colors:bg-[Highlight] forced-colors:text-[HighlightText]">
581
+ Accessible button
582
+ </button>
583
+ ```