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
@@ -1,422 +1,422 @@
1
- ---
2
- name: containerization-pro
3
- description: "Use when Production-grade containerization mastery. Multi-stage Dockerfiles for Node.js/Python/Rust/Go, image hardening (non-root, distroless, read-only FS), BuildKit layer caching, multi-platform builds (docker buildx), Docker Compose for local dev, container security scanning (Trivy/Grype), and AWS ECR workflows. Use when containerizing applications, optimizing Docker builds, or setting up container registries."
4
- version: 5.0.0
5
- last-updated: 2026-09-13
6
- skills:
7
- - devops-engineer
8
- - cicd-pro
9
- - cloud-architect
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
- # Containerization Pro — Production-Grade Docker Mastery
17
-
18
- ---
19
-
20
- ## 🛠️ Technical Architecture & Reference Recipes
21
-
22
- ---
23
-
24
- ## Hallucination Traps (Read First)
25
-
26
- - ❌ `FROM node:22` → ✅ `FROM node:22-alpine` (1GB+ vs ~150MB). Always use slim/alpine variants.
27
- - ❌ `RUN npm install` → ✅ `RUN npm ci --omit=dev` (deterministic, no devDeps, respects lockfile)
28
- - ❌ `COPY . .` without `.dockerignore` → ✅ Always create `.dockerignore` first. Copies `node_modules`, `.env`, `.git` otherwise.
29
- - ❌ Running container as root → ✅ Always create and switch to a non-root user. Root in container = root on host if container escapes.
30
- - ❌ Single-stage Dockerfile → ✅ Multi-stage builds for any compiled/built application. Final image should contain ONLY runtime artifacts.
31
- - ❌ `docker build` without `--platform` for CI → ✅ CI often runs on `amd64`; target hosts may be `arm64`. Always specify platform or use multi-platform builds.
32
-
33
- ---
34
-
35
- ## 1. The .dockerignore (Write This First)
36
-
37
- ```
38
- # .dockerignore — always create before writing Dockerfile
39
- node_modules
40
- npm-debug.log*
41
- .npm
42
- .git
43
- .gitignore
44
- .env
45
- .env.*
46
- *.md
47
- README*
48
- .github
49
- .vscode
50
- coverage
51
- .nyc_output
52
- dist # will be rebuilt in container
53
- build # will be rebuilt in container
54
- __pycache__
55
- *.pyc
56
- *.pyo
57
- .pytest_cache
58
- target # Rust build artifacts
59
- ```
60
-
61
- ---
62
-
63
- ## 2. Multi-Stage Dockerfiles
64
-
65
- ### Node.js (Production-Ready)
66
-
67
- ```dockerfile
68
- # ✅ Multi-stage — builder produces artifacts, runner is minimal
69
- FROM node:22-alpine AS base
70
- WORKDIR /app
71
-
72
- # Install deps in isolation for better caching
73
- FROM base AS deps
74
- COPY package.json package-lock.json ./
75
- RUN npm ci
76
-
77
- # Build stage
78
- FROM base AS builder
79
- COPY --from=deps /app/node_modules ./node_modules
80
- COPY . .
81
- RUN npm run build
82
-
83
- # ──── Runtime (final) stage ────
84
- FROM node:22-alpine AS runner
85
- WORKDIR /app
86
-
87
- # Security: create non-root user
88
- RUN addgroup --system --gid 1001 appgroup && \
89
- adduser --system --uid 1001 --ingroup appgroup appuser
90
-
91
- # Copy only production artifacts
92
- COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
93
- COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules
94
- COPY --from=builder --chown=appuser:appgroup /app/package.json ./
95
-
96
- USER appuser
97
-
98
- ENV NODE_ENV=production
99
- ENV PORT=3000
100
- EXPOSE 3000
101
-
102
- # Health check — required for orchestration (ECS, Kubernetes)
103
- HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
104
- CMD wget --quiet --tries=1 --spider http://localhost:3000/health || exit 1
105
-
106
- CMD ["node", "dist/index.js"]
107
- ```
108
-
109
- ### Python (FastAPI)
110
-
111
- ```dockerfile
112
- FROM python:3.12-slim AS builder
113
- WORKDIR /app
114
-
115
- # Install build tools (needed for some packages, discarded in final image)
116
- RUN apt-get update && apt-get install -y --no-install-recommends gcc && \
117
- rm -rf /var/lib/apt/lists/*
118
-
119
- COPY requirements.txt .
120
- RUN pip install --user --no-cache-dir -r requirements.txt
121
-
122
- # ──── Runtime stage ────
123
- FROM python:3.12-slim AS runner
124
- WORKDIR /app
125
-
126
- # Security: non-root user
127
- RUN addgroup --system --gid 1001 appgroup && \
128
- adduser --system --uid 1001 --gid 1001 appuser
129
-
130
- # Copy installed packages from builder
131
- COPY --from=builder --chown=appuser:appgroup /root/.local /home/appuser/.local
132
- COPY --chown=appuser:appgroup . .
133
-
134
- USER appuser
135
-
136
- ENV PATH=/home/appuser/.local/bin:$PATH
137
- ENV PYTHONUNBUFFERED=1
138
-
139
- EXPOSE 8000
140
-
141
- HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
142
- CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')"
143
-
144
- CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
145
- ```
146
-
147
- ### Rust (Distroless Final Image)
148
-
149
- ```dockerfile
150
- FROM rust:1.78-slim AS builder
151
- WORKDIR /app
152
-
153
- # Cache dependencies separately for fast rebuilds
154
- COPY Cargo.toml Cargo.lock ./
155
- RUN mkdir src && echo "fn main() {}" > src/main.rs
156
- RUN cargo build --release
157
- RUN rm src/main.rs
158
-
159
- # Build actual application
160
- COPY src ./src
161
- RUN touch src/main.rs && cargo build --release
162
-
163
- # ──── Distroless runtime (no shell, no package manager, minimal attack surface) ────
164
- FROM gcr.io/distroless/cc-debian12 AS runner
165
- WORKDIR /app
166
-
167
- COPY --from=builder /app/target/release/myapp ./myapp
168
-
169
- USER nonroot:nonroot
170
- EXPOSE 8080
171
-
172
- CMD ["/app/myapp"]
173
- ```
174
-
175
- ### Go
176
-
177
- ```dockerfile
178
- FROM golang:1.22-alpine AS builder
179
- WORKDIR /app
180
-
181
- COPY go.mod go.sum ./
182
- RUN go mod download
183
-
184
- COPY . .
185
- RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-w -s" -o server ./cmd/server
186
-
187
- # ──── Scratch (smallest possible image) ────
188
- FROM scratch AS runner
189
- COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
190
- COPY --from=builder /app/server /server
191
-
192
- EXPOSE 8080
193
- ENTRYPOINT ["/server"]
194
- ```
195
-
196
- ---
197
-
198
- ## 3. BuildKit Layer Caching (CI Speed)
199
-
200
- ```dockerfile
201
- # syntax=docker/dockerfile:1.6
202
- FROM node:22-alpine AS builder
203
- WORKDIR /app
204
-
205
- # Mount npm cache — persists between builds (dramatic speed improvement in CI)
206
- COPY package.json package-lock.json ./
207
- RUN --mount=type=cache,target=/root/.npm \
208
- npm ci
209
-
210
- # Mount build cache (Next.js / webpack)
211
- COPY . .
212
- RUN --mount=type=cache,target=/app/.next/cache \
213
- npm run build
214
- ```
215
-
216
- ```yaml
217
- # GitHub Actions — enable BuildKit with caching
218
- - name: Build and push Docker image
219
- uses: docker/build-push-action@v5
220
- with:
221
- context: .
222
- push: true
223
- tags: ${{ env.ECR_REGISTRY }}/${{ env.ECR_REPOSITORY }}:${{ github.sha }}
224
- cache-from: type=gha # GitHub Actions cache
225
- cache-to: type=gha,mode=max # Cache all layers
226
- build-args: |
227
- BUILDKIT_INLINE_CACHE=1
228
- ```
229
-
230
- ---
231
-
232
- ## 4. Multi-Platform Builds
233
-
234
- ```bash
235
- # Build for both amd64 (x86) and arm64 (Apple Silicon, AWS Graviton)
236
- docker buildx create --name mybuilder --use
237
- docker buildx build \
238
- --platform linux/amd64,linux/arm64 \
239
- --tag myapp:latest \
240
- --push \
241
- .
242
- ```
243
-
244
- ```yaml
245
- # GitHub Actions — multi-platform
246
- - name: Set up QEMU
247
- uses: docker/setup-qemu-action@v3
248
-
249
- - name: Set up Docker Buildx
250
- uses: docker/setup-buildx-action@v3
251
-
252
- - name: Build multi-platform image
253
- uses: docker/build-push-action@v5
254
- with:
255
- platforms: linux/amd64,linux/arm64
256
- push: true
257
- tags: ${{ steps.meta.outputs.tags }}
258
- ```
259
-
260
- ---
261
-
262
- ## 5. Docker Compose (Local Development)
263
-
264
- ```yaml
265
- # docker-compose.yml
266
- services:
267
- api:
268
- build:
269
- context: .
270
- target: builder # use builder stage locally (includes devtools)
271
- dockerfile: Dockerfile
272
- ports:
273
- - '3000:3000'
274
- environment:
275
- NODE_ENV: development
276
- DATABASE_URL: postgres://postgres:postgres@db:5432/myapp_dev
277
- REDIS_URL: redis://redis:6379
278
- volumes:
279
- - .:/app # mount source for hot-reload
280
- - /app/node_modules # anonymous volume prevents host node_modules overwrite
281
- depends_on:
282
- db:
283
- condition: service_healthy
284
- redis:
285
- condition: service_started
286
- restart: unless-stopped
287
-
288
- db:
289
- image: postgres:16-alpine
290
- environment:
291
- POSTGRES_DB: myapp_dev
292
- POSTGRES_USER: postgres
293
- POSTGRES_PASSWORD: postgres
294
- volumes:
295
- - pgdata:/var/lib/postgresql/data
296
- healthcheck:
297
- test: ['CMD-SHELL', 'pg_isready -U postgres']
298
- interval: 5s
299
- timeout: 3s
300
- retries: 5
301
- ports:
302
- - '5432:5432' # expose for local DB clients
303
-
304
- redis:
305
- image: redis:7-alpine
306
- volumes:
307
- - redisdata:/data
308
- ports:
309
- - '6379:6379'
310
-
311
- volumes:
312
- pgdata:
313
- redisdata:
314
- ```
315
-
316
- ---
317
-
318
- ## 6. Container Security Scanning
319
-
320
- ```yaml
321
- # GitHub Actions — Trivy vulnerability scan
322
- - name: Run Trivy vulnerability scanner
323
- uses: aquasecurity/trivy-action@master
324
- with:
325
- image-ref: ${{ env.ECR_REGISTRY }}/${{ env.ECR_REPOSITORY }}:${{ github.sha }}
326
- format: sarif
327
- output: trivy-results.sarif
328
- severity: CRITICAL,HIGH
329
- exit-code: '1' # fail pipeline on CRITICAL/HIGH vulnerabilities
330
-
331
- - name: Upload Trivy scan results to GitHub Security tab
332
- uses: github/codeql-action/upload-sarif@v3
333
- if: always()
334
- with:
335
- sarif_file: trivy-results.sarif
336
- ```
337
-
338
- ```bash
339
- # Local scanning
340
- trivy image myapp:latest
341
-
342
- # Scan Dockerfile for misconfigurations before building
343
- trivy config Dockerfile
344
- ```
345
-
346
- ---
347
-
348
- ## 7. AWS ECR Workflow
349
-
350
- ```yaml
351
- # Complete ECR push workflow
352
- jobs:
353
- build-and-push:
354
- runs-on: ubuntu-latest
355
- permissions:
356
- id-token: write
357
- contents: read
358
- outputs:
359
- image: ${{ steps.build.outputs.image }}
360
-
361
- steps:
362
- - uses: actions/checkout@v4
363
-
364
- - name: Configure AWS credentials (OIDC — no static keys)
365
- uses: aws-actions/configure-aws-credentials@v4
366
- with:
367
- role-to-assume: ${{ secrets.AWS_ROLE_ARN }}
368
- aws-region: us-east-1
369
-
370
- - name: Login to Amazon ECR
371
- id: login-ecr
372
- uses: aws-actions/amazon-ecr-login@v2
373
-
374
- - name: Set up Docker Buildx
375
- uses: docker/setup-buildx-action@v3
376
-
377
- - name: Build, tag, and push image
378
- id: build
379
- uses: docker/build-push-action@v5
380
- with:
381
- context: .
382
- push: true
383
- tags: |
384
- ${{ steps.login-ecr.outputs.registry }}/myapp:${{ github.sha }}
385
- ${{ steps.login-ecr.outputs.registry }}/myapp:latest
386
- cache-from: type=gha
387
- cache-to: type=gha,mode=max
388
-
389
- - name: Output image URI
390
- run: echo "image=${{ steps.login-ecr.outputs.registry }}/myapp:${{ github.sha }}" >> $GITHUB_OUTPUT
391
- ```
392
-
393
- ### ECR Lifecycle Policy (Cost Control)
394
-
395
- ```json
396
- {
397
- "rules": [
398
- {
399
- "rulePriority": 1,
400
- "description": "Keep last 10 production images",
401
- "selection": {
402
- "tagStatus": "tagged",
403
- "tagPrefixList": ["v"],
404
- "countType": "imageCountMoreThan",
405
- "countNumber": 10
406
- },
407
- "action": { "type": "expire" }
408
- },
409
- {
410
- "rulePriority": 2,
411
- "description": "Expire untagged images after 1 day",
412
- "selection": {
413
- "tagStatus": "untagged",
414
- "countType": "sinceImagePushed",
415
- "countUnit": "days",
416
- "countNumber": 1
417
- },
418
- "action": { "type": "expire" }
419
- }
420
- ]
421
- }
422
- ```
1
+ ---
2
+ name: containerization-pro
3
+ description: "Use when Production-grade containerization mastery. Multi-stage Dockerfiles for Node.js/Python/Rust/Go, image hardening (non-root, distroless, read-only FS), BuildKit layer caching, multi-platform builds (docker buildx), Docker Compose for local dev, container security scanning (Trivy/Grype), and AWS ECR workflows. Use when containerizing applications, optimizing Docker builds, or setting up container registries."
4
+ version: 5.0.0
5
+ last-updated: 2026-09-13
6
+ skills:
7
+ - devops-engineer
8
+ - cicd-pro
9
+ - cloud-architect
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
+ # Containerization Pro — Production-Grade Docker Mastery
17
+
18
+ ---
19
+
20
+ ## 🛠️ Technical Architecture & Reference Recipes
21
+
22
+ ---
23
+
24
+ ## Hallucination Traps (Read First)
25
+
26
+ - ❌ `FROM node:22` → ✅ `FROM node:22-alpine` (1GB+ vs ~150MB). Always use slim/alpine variants.
27
+ - ❌ `RUN npm install` → ✅ `RUN npm ci --omit=dev` (deterministic, no devDeps, respects lockfile)
28
+ - ❌ `COPY . .` without `.dockerignore` → ✅ Always create `.dockerignore` first. Copies `node_modules`, `.env`, `.git` otherwise.
29
+ - ❌ Running container as root → ✅ Always create and switch to a non-root user. Root in container = root on host if container escapes.
30
+ - ❌ Single-stage Dockerfile → ✅ Multi-stage builds for any compiled/built application. Final image should contain ONLY runtime artifacts.
31
+ - ❌ `docker build` without `--platform` for CI → ✅ CI often runs on `amd64`; target hosts may be `arm64`. Always specify platform or use multi-platform builds.
32
+
33
+ ---
34
+
35
+ ## 1. The .dockerignore (Write This First)
36
+
37
+ ```
38
+ # .dockerignore — always create before writing Dockerfile
39
+ node_modules
40
+ npm-debug.log*
41
+ .npm
42
+ .git
43
+ .gitignore
44
+ .env
45
+ .env.*
46
+ *.md
47
+ README*
48
+ .github
49
+ .vscode
50
+ coverage
51
+ .nyc_output
52
+ dist # will be rebuilt in container
53
+ build # will be rebuilt in container
54
+ __pycache__
55
+ *.pyc
56
+ *.pyo
57
+ .pytest_cache
58
+ target # Rust build artifacts
59
+ ```
60
+
61
+ ---
62
+
63
+ ## 2. Multi-Stage Dockerfiles
64
+
65
+ ### Node.js (Production-Ready)
66
+
67
+ ```dockerfile
68
+ # ✅ Multi-stage — builder produces artifacts, runner is minimal
69
+ FROM node:22-alpine AS base
70
+ WORKDIR /app
71
+
72
+ # Install deps in isolation for better caching
73
+ FROM base AS deps
74
+ COPY package.json package-lock.json ./
75
+ RUN npm ci
76
+
77
+ # Build stage
78
+ FROM base AS builder
79
+ COPY --from=deps /app/node_modules ./node_modules
80
+ COPY . .
81
+ RUN npm run build
82
+
83
+ # ──── Runtime (final) stage ────
84
+ FROM node:22-alpine AS runner
85
+ WORKDIR /app
86
+
87
+ # Security: create non-root user
88
+ RUN addgroup --system --gid 1001 appgroup && \
89
+ adduser --system --uid 1001 --ingroup appgroup appuser
90
+
91
+ # Copy only production artifacts
92
+ COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
93
+ COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules
94
+ COPY --from=builder --chown=appuser:appgroup /app/package.json ./
95
+
96
+ USER appuser
97
+
98
+ ENV NODE_ENV=production
99
+ ENV PORT=3000
100
+ EXPOSE 3000
101
+
102
+ # Health check — required for orchestration (ECS, Kubernetes)
103
+ HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
104
+ CMD wget --quiet --tries=1 --spider http://localhost:3000/health || exit 1
105
+
106
+ CMD ["node", "src/index.js"]
107
+ ```
108
+
109
+ ### Python (FastAPI)
110
+
111
+ ```dockerfile
112
+ FROM python:3.12-slim AS builder
113
+ WORKDIR /app
114
+
115
+ # Install build tools (needed for some packages, discarded in final image)
116
+ RUN apt-get update && apt-get install -y --no-install-recommends gcc && \
117
+ rm -rf /var/lib/apt/lists/*
118
+
119
+ COPY requirements.txt .
120
+ RUN pip install --user --no-cache-dir -r requirements.txt
121
+
122
+ # ──── Runtime stage ────
123
+ FROM python:3.12-slim AS runner
124
+ WORKDIR /app
125
+
126
+ # Security: non-root user
127
+ RUN addgroup --system --gid 1001 appgroup && \
128
+ adduser --system --uid 1001 --gid 1001 appuser
129
+
130
+ # Copy installed packages from builder
131
+ COPY --from=builder --chown=appuser:appgroup /root/.local /home/appuser/.local
132
+ COPY --chown=appuser:appgroup . .
133
+
134
+ USER appuser
135
+
136
+ ENV PATH=/home/appuser/.local/bin:$PATH
137
+ ENV PYTHONUNBUFFERED=1
138
+
139
+ EXPOSE 8000
140
+
141
+ HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
142
+ CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')"
143
+
144
+ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
145
+ ```
146
+
147
+ ### Rust (Distroless Final Image)
148
+
149
+ ```dockerfile
150
+ FROM rust:1.78-slim AS builder
151
+ WORKDIR /app
152
+
153
+ # Cache dependencies separately for fast rebuilds
154
+ COPY Cargo.toml Cargo.lock ./
155
+ RUN mkdir src && echo "fn main() {}" > src/main.rs
156
+ RUN cargo build --release
157
+ RUN rm src/main.rs
158
+
159
+ # Build actual application
160
+ COPY src ./src
161
+ RUN touch src/main.rs && cargo build --release
162
+
163
+ # ──── Distroless runtime (no shell, no package manager, minimal attack surface) ────
164
+ FROM gcr.io/distroless/cc-debian12 AS runner
165
+ WORKDIR /app
166
+
167
+ COPY --from=builder /app/target/release/myapp ./myapp
168
+
169
+ USER nonroot:nonroot
170
+ EXPOSE 8080
171
+
172
+ CMD ["/app/myapp"]
173
+ ```
174
+
175
+ ### Go
176
+
177
+ ```dockerfile
178
+ FROM golang:1.22-alpine AS builder
179
+ WORKDIR /app
180
+
181
+ COPY go.mod go.sum ./
182
+ RUN go mod download
183
+
184
+ COPY . .
185
+ RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-w -s" -o server ./cmd/server
186
+
187
+ # ──── Scratch (smallest possible image) ────
188
+ FROM scratch AS runner
189
+ COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
190
+ COPY --from=builder /app/server /server
191
+
192
+ EXPOSE 8080
193
+ ENTRYPOINT ["/server"]
194
+ ```
195
+
196
+ ---
197
+
198
+ ## 3. BuildKit Layer Caching (CI Speed)
199
+
200
+ ```dockerfile
201
+ # syntax=docker/dockerfile:1.6
202
+ FROM node:22-alpine AS builder
203
+ WORKDIR /app
204
+
205
+ # Mount npm cache — persists between builds (dramatic speed improvement in CI)
206
+ COPY package.json package-lock.json ./
207
+ RUN --mount=type=cache,target=/root/.npm \
208
+ npm ci
209
+
210
+ # Mount build cache (Next.js / webpack)
211
+ COPY . .
212
+ RUN --mount=type=cache,target=/app/.next/cache \
213
+ npm run build
214
+ ```
215
+
216
+ ```yaml
217
+ # GitHub Actions — enable BuildKit with caching
218
+ - name: Build and push Docker image
219
+ uses: docker/build-push-action@v5
220
+ with:
221
+ context: .
222
+ push: true
223
+ tags: ${{ env.ECR_REGISTRY }}/${{ env.ECR_REPOSITORY }}:${{ github.sha }}
224
+ cache-from: type=gha # GitHub Actions cache
225
+ cache-to: type=gha,mode=max # Cache all layers
226
+ build-args: |
227
+ BUILDKIT_INLINE_CACHE=1
228
+ ```
229
+
230
+ ---
231
+
232
+ ## 4. Multi-Platform Builds
233
+
234
+ ```bash
235
+ # Build for both amd64 (x86) and arm64 (Apple Silicon, AWS Graviton)
236
+ docker buildx create --name mybuilder --use
237
+ docker buildx build \
238
+ --platform linux/amd64,linux/arm64 \
239
+ --tag myapp:latest \
240
+ --push \
241
+ .
242
+ ```
243
+
244
+ ```yaml
245
+ # GitHub Actions — multi-platform
246
+ - name: Set up QEMU
247
+ uses: docker/setup-qemu-action@v3
248
+
249
+ - name: Set up Docker Buildx
250
+ uses: docker/setup-buildx-action@v3
251
+
252
+ - name: Build multi-platform image
253
+ uses: docker/build-push-action@v5
254
+ with:
255
+ platforms: linux/amd64,linux/arm64
256
+ push: true
257
+ tags: ${{ steps.meta.outputs.tags }}
258
+ ```
259
+
260
+ ---
261
+
262
+ ## 5. Docker Compose (Local Development)
263
+
264
+ ```yaml
265
+ # docker-compose.yml
266
+ services:
267
+ api:
268
+ build:
269
+ context: .
270
+ target: builder # use builder stage locally (includes devtools)
271
+ dockerfile: Dockerfile
272
+ ports:
273
+ - '3000:3000'
274
+ environment:
275
+ NODE_ENV: development
276
+ DATABASE_URL: postgres://postgres:postgres@db:5432/myapp_dev
277
+ REDIS_URL: redis://redis:6379
278
+ volumes:
279
+ - .:/app # mount source for hot-reload
280
+ - /app/node_modules # anonymous volume prevents host node_modules overwrite
281
+ depends_on:
282
+ db:
283
+ condition: service_healthy
284
+ redis:
285
+ condition: service_started
286
+ restart: unless-stopped
287
+
288
+ db:
289
+ image: postgres:16-alpine
290
+ environment:
291
+ POSTGRES_DB: myapp_dev
292
+ POSTGRES_USER: postgres
293
+ POSTGRES_PASSWORD: postgres
294
+ volumes:
295
+ - pgdata:/var/lib/postgresql/data
296
+ healthcheck:
297
+ test: ['CMD-SHELL', 'pg_isready -U postgres']
298
+ interval: 5s
299
+ timeout: 3s
300
+ retries: 5
301
+ ports:
302
+ - '5432:5432' # expose for local DB clients
303
+
304
+ redis:
305
+ image: redis:7-alpine
306
+ volumes:
307
+ - redisdata:/data
308
+ ports:
309
+ - '6379:6379'
310
+
311
+ volumes:
312
+ pgdata:
313
+ redisdata:
314
+ ```
315
+
316
+ ---
317
+
318
+ ## 6. Container Security Scanning
319
+
320
+ ```yaml
321
+ # GitHub Actions — Trivy vulnerability scan
322
+ - name: Run Trivy vulnerability scanner
323
+ uses: aquasecurity/trivy-action@master
324
+ with:
325
+ image-ref: ${{ env.ECR_REGISTRY }}/${{ env.ECR_REPOSITORY }}:${{ github.sha }}
326
+ format: sarif
327
+ output: trivy-results.sarif
328
+ severity: CRITICAL,HIGH
329
+ exit-code: '1' # fail pipeline on CRITICAL/HIGH vulnerabilities
330
+
331
+ - name: Upload Trivy scan results to GitHub Security tab
332
+ uses: github/codeql-action/upload-sarif@v3
333
+ if: always()
334
+ with:
335
+ sarif_file: trivy-results.sarif
336
+ ```
337
+
338
+ ```bash
339
+ # Local scanning
340
+ trivy image myapp:latest
341
+
342
+ # Scan Dockerfile for misconfigurations before building
343
+ trivy config Dockerfile
344
+ ```
345
+
346
+ ---
347
+
348
+ ## 7. AWS ECR Workflow
349
+
350
+ ```yaml
351
+ # Complete ECR push workflow
352
+ jobs:
353
+ build-and-push:
354
+ runs-on: ubuntu-latest
355
+ permissions:
356
+ id-token: write
357
+ contents: read
358
+ outputs:
359
+ image: ${{ steps.build.outputs.image }}
360
+
361
+ steps:
362
+ - uses: actions/checkout@v4
363
+
364
+ - name: Configure AWS credentials (OIDC — no static keys)
365
+ uses: aws-actions/configure-aws-credentials@v4
366
+ with:
367
+ role-to-assume: ${{ secrets.AWS_ROLE_ARN }}
368
+ aws-region: us-east-1
369
+
370
+ - name: Login to Amazon ECR
371
+ id: login-ecr
372
+ uses: aws-actions/amazon-ecr-login@v2
373
+
374
+ - name: Set up Docker Buildx
375
+ uses: docker/setup-buildx-action@v3
376
+
377
+ - name: Build, tag, and push image
378
+ id: build
379
+ uses: docker/build-push-action@v5
380
+ with:
381
+ context: .
382
+ push: true
383
+ tags: |
384
+ ${{ steps.login-ecr.outputs.registry }}/myapp:${{ github.sha }}
385
+ ${{ steps.login-ecr.outputs.registry }}/myapp:latest
386
+ cache-from: type=gha
387
+ cache-to: type=gha,mode=max
388
+
389
+ - name: Output image URI
390
+ run: echo "image=${{ steps.login-ecr.outputs.registry }}/myapp:${{ github.sha }}" >> $GITHUB_OUTPUT
391
+ ```
392
+
393
+ ### ECR Lifecycle Policy (Cost Control)
394
+
395
+ ```json
396
+ {
397
+ "rules": [
398
+ {
399
+ "rulePriority": 1,
400
+ "description": "Keep last 10 production images",
401
+ "selection": {
402
+ "tagStatus": "tagged",
403
+ "tagPrefixList": ["v"],
404
+ "countType": "imageCountMoreThan",
405
+ "countNumber": 10
406
+ },
407
+ "action": { "type": "expire" }
408
+ },
409
+ {
410
+ "rulePriority": 2,
411
+ "description": "Expire untagged images after 1 day",
412
+ "selection": {
413
+ "tagStatus": "untagged",
414
+ "countType": "sinceImagePushed",
415
+ "countUnit": "days",
416
+ "countNumber": 1
417
+ },
418
+ "action": { "type": "expire" }
419
+ }
420
+ ]
421
+ }
422
+ ```