@ruaruababa/vibe-kit 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (462) hide show
  1. package/CATALOG.md +317 -0
  2. package/README.md +121 -0
  3. package/aliases.json +65 -0
  4. package/bin/vibe.js +2 -0
  5. package/bundles.json +265 -0
  6. package/catalog.json +1560 -0
  7. package/dist/antigravity-skills/bin/cli.js +438 -0
  8. package/dist/antigravity-skills/lib/skill-utils.js +158 -0
  9. package/dist/antigravity-skills/scripts/build-catalog.js +305 -0
  10. package/dist/antigravity-skills/scripts/normalize-frontmatter.js +144 -0
  11. package/dist/antigravity-skills/scripts/validate-skills.js +230 -0
  12. package/dist/bin/vibe.js +2 -0
  13. package/dist/dist/src/cli/index.js +26 -0
  14. package/dist/lib/skill-utils.js +158 -0
  15. package/dist/scripts/build-catalog.js +50 -0
  16. package/dist/scripts/normalize-frontmatter.js +144 -0
  17. package/dist/scripts/validate-skills.js +56 -0
  18. package/dist/src/cli/index.js +146 -0
  19. package/dist/src/types/index.js +13 -0
  20. package/dist/src/utils/fs.js +1 -0
  21. package/package.json +43 -0
  22. package/skills/accessibility-compliance-accessibility-audit/SKILL.md +42 -0
  23. package/skills/accessibility-compliance-accessibility-audit/resources/implementation-playbook.md +502 -0
  24. package/skills/agent-orchestration-improve-agent/SKILL.md +349 -0
  25. package/skills/agent-orchestration-multi-agent-optimize/SKILL.md +239 -0
  26. package/skills/agent-orchestrator/SKILL.md +24 -0
  27. package/skills/ai-engineer/SKILL.md +171 -0
  28. package/skills/airflow-dag-patterns/SKILL.md +41 -0
  29. package/skills/airflow-dag-patterns/resources/implementation-playbook.md +509 -0
  30. package/skills/angular-migration/SKILL.md +428 -0
  31. package/skills/anti-reversing-techniques/SKILL.md +42 -0
  32. package/skills/anti-reversing-techniques/resources/implementation-playbook.md +539 -0
  33. package/skills/api-design-principles/SKILL.md +37 -0
  34. package/skills/api-design-principles/assets/api-design-checklist.md +155 -0
  35. package/skills/api-design-principles/assets/rest-api-template.py +182 -0
  36. package/skills/api-design-principles/references/graphql-schema-design.md +583 -0
  37. package/skills/api-design-principles/references/rest-best-practices.md +408 -0
  38. package/skills/api-design-principles/resources/implementation-playbook.md +513 -0
  39. package/skills/api-documenter/SKILL.md +184 -0
  40. package/skills/api-testing-observability-api-mock/SKILL.md +46 -0
  41. package/skills/api-testing-observability-api-mock/resources/implementation-playbook.md +1327 -0
  42. package/skills/application-performance-performance-optimization/SKILL.md +154 -0
  43. package/skills/architect-review/SKILL.md +174 -0
  44. package/skills/architecture-decision-records/SKILL.md +441 -0
  45. package/skills/architecture-patterns/SKILL.md +37 -0
  46. package/skills/architecture-patterns/resources/implementation-playbook.md +479 -0
  47. package/skills/arm-cortex-expert/SKILL.md +306 -0
  48. package/skills/async-python-patterns/SKILL.md +39 -0
  49. package/skills/async-python-patterns/resources/implementation-playbook.md +678 -0
  50. package/skills/attack-tree-construction/SKILL.md +38 -0
  51. package/skills/attack-tree-construction/resources/implementation-playbook.md +671 -0
  52. package/skills/auth-implementation-patterns/SKILL.md +39 -0
  53. package/skills/auth-implementation-patterns/resources/implementation-playbook.md +618 -0
  54. package/skills/backend-architect/SKILL.md +333 -0
  55. package/skills/backend-development-feature-development/SKILL.md +180 -0
  56. package/skills/backend-security-coder/SKILL.md +156 -0
  57. package/skills/backtesting-frameworks/SKILL.md +39 -0
  58. package/skills/backtesting-frameworks/resources/implementation-playbook.md +647 -0
  59. package/skills/bash-defensive-patterns/SKILL.md +43 -0
  60. package/skills/bash-defensive-patterns/resources/implementation-playbook.md +517 -0
  61. package/skills/bash-pro/SKILL.md +310 -0
  62. package/skills/bats-testing-patterns/SKILL.md +34 -0
  63. package/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
  64. package/skills/bazel-build-optimization/SKILL.md +397 -0
  65. package/skills/billing-automation/SKILL.md +42 -0
  66. package/skills/billing-automation/resources/implementation-playbook.md +544 -0
  67. package/skills/binary-analysis-patterns/SKILL.md +450 -0
  68. package/skills/blockchain-developer/SKILL.md +208 -0
  69. package/skills/business-analyst/SKILL.md +182 -0
  70. package/skills/c-pro/SKILL.md +56 -0
  71. package/skills/c4-architecture-c4-architecture/SKILL.md +389 -0
  72. package/skills/c4-code/SKILL.md +244 -0
  73. package/skills/c4-component/SKILL.md +153 -0
  74. package/skills/c4-container/SKILL.md +171 -0
  75. package/skills/c4-context/SKILL.md +150 -0
  76. package/skills/changelog-automation/SKILL.md +38 -0
  77. package/skills/changelog-automation/resources/implementation-playbook.md +538 -0
  78. package/skills/cicd-automation-workflow-automate/SKILL.md +51 -0
  79. package/skills/cicd-automation-workflow-automate/resources/implementation-playbook.md +1333 -0
  80. package/skills/clean-markdown/SKILL.md +23 -0
  81. package/skills/cloud-architect/SKILL.md +135 -0
  82. package/skills/code-documentation-code-explain/SKILL.md +46 -0
  83. package/skills/code-documentation-code-explain/resources/implementation-playbook.md +802 -0
  84. package/skills/code-documentation-doc-generate/SKILL.md +48 -0
  85. package/skills/code-documentation-doc-generate/resources/implementation-playbook.md +640 -0
  86. package/skills/code-refactoring-context-restore/SKILL.md +179 -0
  87. package/skills/code-refactoring-refactor-clean/SKILL.md +51 -0
  88. package/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +879 -0
  89. package/skills/code-refactoring-tech-debt/SKILL.md +386 -0
  90. package/skills/code-review-ai-ai-review/SKILL.md +450 -0
  91. package/skills/code-review-excellence/SKILL.md +40 -0
  92. package/skills/code-review-excellence/resources/implementation-playbook.md +515 -0
  93. package/skills/code-reviewer/SKILL.md +178 -0
  94. package/skills/codebase-cleanup-deps-audit/SKILL.md +51 -0
  95. package/skills/codebase-cleanup-deps-audit/resources/implementation-playbook.md +766 -0
  96. package/skills/codebase-cleanup-refactor-clean/SKILL.md +51 -0
  97. package/skills/codebase-cleanup-refactor-clean/resources/implementation-playbook.md +879 -0
  98. package/skills/codebase-cleanup-tech-debt/SKILL.md +386 -0
  99. package/skills/competitive-landscape/SKILL.md +34 -0
  100. package/skills/competitive-landscape/resources/implementation-playbook.md +494 -0
  101. package/skills/comprehensive-review-full-review/SKILL.md +146 -0
  102. package/skills/comprehensive-review-pr-enhance/SKILL.md +46 -0
  103. package/skills/comprehensive-review-pr-enhance/resources/implementation-playbook.md +691 -0
  104. package/skills/conductor-implement/SKILL.md +388 -0
  105. package/skills/conductor-manage/SKILL.md +39 -0
  106. package/skills/conductor-manage/resources/implementation-playbook.md +1120 -0
  107. package/skills/conductor-new-track/SKILL.md +433 -0
  108. package/skills/conductor-revert/SKILL.md +372 -0
  109. package/skills/conductor-setup/SKILL.md +426 -0
  110. package/skills/conductor-status/SKILL.md +338 -0
  111. package/skills/conductor-validator/SKILL.md +62 -0
  112. package/skills/content-marketer/SKILL.md +170 -0
  113. package/skills/context-driven-development/SKILL.md +400 -0
  114. package/skills/context-management-context-restore/SKILL.md +179 -0
  115. package/skills/context-management-context-save/SKILL.md +177 -0
  116. package/skills/context-manager/SKILL.md +185 -0
  117. package/skills/cost-optimization/SKILL.md +286 -0
  118. package/skills/cpp-pro/SKILL.md +59 -0
  119. package/skills/cqrs-implementation/SKILL.md +35 -0
  120. package/skills/cqrs-implementation/resources/implementation-playbook.md +540 -0
  121. package/skills/csharp-pro/SKILL.md +59 -0
  122. package/skills/customer-support/SKILL.md +170 -0
  123. package/skills/data-engineer/SKILL.md +224 -0
  124. package/skills/data-engineering-data-driven-feature/SKILL.md +182 -0
  125. package/skills/data-engineering-data-pipeline/SKILL.md +201 -0
  126. package/skills/data-quality-frameworks/SKILL.md +40 -0
  127. package/skills/data-quality-frameworks/resources/implementation-playbook.md +573 -0
  128. package/skills/data-scientist/SKILL.md +199 -0
  129. package/skills/data-storytelling/SKILL.md +465 -0
  130. package/skills/database-admin/SKILL.md +165 -0
  131. package/skills/database-architect/SKILL.md +268 -0
  132. package/skills/database-cloud-optimization-cost-optimize/SKILL.md +44 -0
  133. package/skills/database-cloud-optimization-cost-optimize/resources/implementation-playbook.md +1441 -0
  134. package/skills/database-migration/SKILL.md +436 -0
  135. package/skills/database-migrations-migration-observability/SKILL.md +420 -0
  136. package/skills/database-migrations-sql-migrations/SKILL.md +53 -0
  137. package/skills/database-migrations-sql-migrations/resources/implementation-playbook.md +499 -0
  138. package/skills/database-optimizer/SKILL.md +167 -0
  139. package/skills/dbt-transformation-patterns/SKILL.md +34 -0
  140. package/skills/dbt-transformation-patterns/resources/implementation-playbook.md +547 -0
  141. package/skills/debugger/SKILL.md +49 -0
  142. package/skills/debugging-strategies/SKILL.md +34 -0
  143. package/skills/debugging-strategies/resources/implementation-playbook.md +511 -0
  144. package/skills/debugging-toolkit-smart-debug/SKILL.md +197 -0
  145. package/skills/defi-protocol-templates/SKILL.md +466 -0
  146. package/skills/dependency-management-deps-audit/SKILL.md +44 -0
  147. package/skills/dependency-management-deps-audit/resources/implementation-playbook.md +766 -0
  148. package/skills/dependency-upgrade/SKILL.md +421 -0
  149. package/skills/deployment-engineer/SKILL.md +170 -0
  150. package/skills/deployment-pipeline-design/SKILL.md +371 -0
  151. package/skills/deployment-validation-config-validate/SKILL.md +496 -0
  152. package/skills/devops-troubleshooter/SKILL.md +161 -0
  153. package/skills/distributed-debugging-debug-trace/SKILL.md +44 -0
  154. package/skills/distributed-debugging-debug-trace/resources/implementation-playbook.md +1307 -0
  155. package/skills/distributed-tracing/SKILL.md +450 -0
  156. package/skills/django-pro/SKILL.md +180 -0
  157. package/skills/docs-architect/SKILL.md +98 -0
  158. package/skills/documentation-generation-doc-generate/SKILL.md +48 -0
  159. package/skills/documentation-generation-doc-generate/resources/implementation-playbook.md +640 -0
  160. package/skills/dotnet-architect/SKILL.md +197 -0
  161. package/skills/dotnet-backend-patterns/SKILL.md +37 -0
  162. package/skills/dotnet-backend-patterns/assets/repository-template.cs +523 -0
  163. package/skills/dotnet-backend-patterns/assets/service-template.cs +336 -0
  164. package/skills/dotnet-backend-patterns/references/dapper-patterns.md +544 -0
  165. package/skills/dotnet-backend-patterns/references/ef-core-best-practices.md +355 -0
  166. package/skills/dotnet-backend-patterns/resources/implementation-playbook.md +799 -0
  167. package/skills/dummy-skill/SKILL.md +5 -0
  168. package/skills/dx-optimizer/SKILL.md +83 -0
  169. package/skills/e2e-testing-patterns/SKILL.md +41 -0
  170. package/skills/e2e-testing-patterns/resources/implementation-playbook.md +531 -0
  171. package/skills/elixir-pro/SKILL.md +59 -0
  172. package/skills/embedding-strategies/SKILL.md +491 -0
  173. package/skills/employment-contract-templates/SKILL.md +39 -0
  174. package/skills/employment-contract-templates/resources/implementation-playbook.md +493 -0
  175. package/skills/error-debugging-error-analysis/SKILL.md +47 -0
  176. package/skills/error-debugging-error-analysis/resources/implementation-playbook.md +1143 -0
  177. package/skills/error-debugging-error-trace/SKILL.md +43 -0
  178. package/skills/error-debugging-error-trace/resources/implementation-playbook.md +1361 -0
  179. package/skills/error-debugging-multi-agent-review/SKILL.md +216 -0
  180. package/skills/error-detective/SKILL.md +53 -0
  181. package/skills/error-diagnostics-error-analysis/SKILL.md +47 -0
  182. package/skills/error-diagnostics-error-analysis/resources/implementation-playbook.md +1143 -0
  183. package/skills/error-diagnostics-error-trace/SKILL.md +48 -0
  184. package/skills/error-diagnostics-error-trace/resources/implementation-playbook.md +1371 -0
  185. package/skills/error-diagnostics-smart-debug/SKILL.md +197 -0
  186. package/skills/error-handling-patterns/SKILL.md +35 -0
  187. package/skills/error-handling-patterns/resources/implementation-playbook.md +635 -0
  188. package/skills/event-sourcing-architect/SKILL.md +58 -0
  189. package/skills/event-store-design/SKILL.md +449 -0
  190. package/skills/fastapi-pro/SKILL.md +192 -0
  191. package/skills/fastapi-templates/SKILL.md +32 -0
  192. package/skills/fastapi-templates/resources/implementation-playbook.md +566 -0
  193. package/skills/final-test/SKILL.md +5 -0
  194. package/skills/firmware-analyst/SKILL.md +320 -0
  195. package/skills/flutter-expert/SKILL.md +200 -0
  196. package/skills/framework-migration-code-migrate/SKILL.md +48 -0
  197. package/skills/framework-migration-code-migrate/resources/implementation-playbook.md +1052 -0
  198. package/skills/framework-migration-deps-upgrade/SKILL.md +48 -0
  199. package/skills/framework-migration-deps-upgrade/resources/implementation-playbook.md +755 -0
  200. package/skills/framework-migration-legacy-modernize/SKILL.md +132 -0
  201. package/skills/frontend-developer/SKILL.md +171 -0
  202. package/skills/frontend-mobile-development-component-scaffold/SKILL.md +403 -0
  203. package/skills/frontend-mobile-security-xss-scan/SKILL.md +322 -0
  204. package/skills/frontend-security-coder/SKILL.md +170 -0
  205. package/skills/full-stack-orchestration-full-stack-feature/SKILL.md +135 -0
  206. package/skills/gdpr-data-handling/SKILL.md +33 -0
  207. package/skills/gdpr-data-handling/resources/implementation-playbook.md +615 -0
  208. package/skills/git-advanced-workflows/SKILL.md +412 -0
  209. package/skills/git-pr-workflows-git-workflow/SKILL.md +140 -0
  210. package/skills/git-pr-workflows-onboard/SKILL.md +416 -0
  211. package/skills/git-pr-workflows-pr-enhance/SKILL.md +48 -0
  212. package/skills/git-pr-workflows-pr-enhance/resources/implementation-playbook.md +701 -0
  213. package/skills/github-actions-templates/SKILL.md +345 -0
  214. package/skills/gitlab-ci-patterns/SKILL.md +283 -0
  215. package/skills/gitops-workflow/SKILL.md +303 -0
  216. package/skills/gitops-workflow/references/argocd-setup.md +134 -0
  217. package/skills/gitops-workflow/references/sync-policies.md +131 -0
  218. package/skills/go-concurrency-patterns/SKILL.md +33 -0
  219. package/skills/go-concurrency-patterns/resources/implementation-playbook.md +654 -0
  220. package/skills/godot-gdscript-patterns/SKILL.md +33 -0
  221. package/skills/godot-gdscript-patterns/resources/implementation-playbook.md +804 -0
  222. package/skills/golang-pro/SKILL.md +179 -0
  223. package/skills/grafana-dashboards/SKILL.md +381 -0
  224. package/skills/graphql-architect/SKILL.md +182 -0
  225. package/skills/haskell-pro/SKILL.md +56 -0
  226. package/skills/helm-chart-scaffolding/SKILL.md +34 -0
  227. package/skills/helm-chart-scaffolding/assets/Chart.yaml.template +42 -0
  228. package/skills/helm-chart-scaffolding/assets/values.yaml.template +185 -0
  229. package/skills/helm-chart-scaffolding/references/chart-structure.md +500 -0
  230. package/skills/helm-chart-scaffolding/resources/implementation-playbook.md +543 -0
  231. package/skills/helm-chart-scaffolding/scripts/validate-chart.sh +244 -0
  232. package/skills/hr-pro/SKILL.md +126 -0
  233. package/skills/hybrid-cloud-architect/SKILL.md +168 -0
  234. package/skills/hybrid-cloud-networking/SKILL.md +238 -0
  235. package/skills/hybrid-search-implementation/SKILL.md +32 -0
  236. package/skills/hybrid-search-implementation/resources/implementation-playbook.md +567 -0
  237. package/skills/incident-responder/SKILL.md +213 -0
  238. package/skills/incident-response-incident-response/SKILL.md +168 -0
  239. package/skills/incident-response-smart-fix/SKILL.md +29 -0
  240. package/skills/incident-response-smart-fix/resources/implementation-playbook.md +838 -0
  241. package/skills/incident-runbook-templates/SKILL.md +395 -0
  242. package/skills/ios-developer/SKILL.md +219 -0
  243. package/skills/istio-traffic-management/SKILL.md +337 -0
  244. package/skills/java-pro/SKILL.md +177 -0
  245. package/skills/javascript-pro/SKILL.md +57 -0
  246. package/skills/javascript-testing-patterns/SKILL.md +35 -0
  247. package/skills/javascript-testing-patterns/resources/implementation-playbook.md +1024 -0
  248. package/skills/javascript-typescript-typescript-scaffold/SKILL.md +361 -0
  249. package/skills/julia-pro/SKILL.md +209 -0
  250. package/skills/k8s-manifest-generator/SKILL.md +35 -0
  251. package/skills/k8s-manifest-generator/assets/configmap-template.yaml +296 -0
  252. package/skills/k8s-manifest-generator/assets/deployment-template.yaml +203 -0
  253. package/skills/k8s-manifest-generator/assets/service-template.yaml +171 -0
  254. package/skills/k8s-manifest-generator/references/deployment-spec.md +753 -0
  255. package/skills/k8s-manifest-generator/references/service-spec.md +724 -0
  256. package/skills/k8s-manifest-generator/resources/implementation-playbook.md +510 -0
  257. package/skills/k8s-security-policies/SKILL.md +346 -0
  258. package/skills/k8s-security-policies/assets/network-policy-template.yaml +177 -0
  259. package/skills/k8s-security-policies/references/rbac-patterns.md +187 -0
  260. package/skills/kpi-dashboard-design/SKILL.md +440 -0
  261. package/skills/kubernetes-architect/SKILL.md +170 -0
  262. package/skills/langchain-architecture/SKILL.md +350 -0
  263. package/skills/legacy-modernizer/SKILL.md +53 -0
  264. package/skills/legal-advisor/SKILL.md +70 -0
  265. package/skills/linkerd-patterns/SKILL.md +321 -0
  266. package/skills/llm-application-dev-ai-assistant/SKILL.md +35 -0
  267. package/skills/llm-application-dev-ai-assistant/resources/implementation-playbook.md +1236 -0
  268. package/skills/llm-application-dev-langchain-agent/SKILL.md +246 -0
  269. package/skills/llm-application-dev-prompt-optimize/SKILL.md +37 -0
  270. package/skills/llm-application-dev-prompt-optimize/resources/implementation-playbook.md +591 -0
  271. package/skills/llm-evaluation/SKILL.md +483 -0
  272. package/skills/machine-learning-ops-ml-pipeline/SKILL.md +314 -0
  273. package/skills/malware-analyst/SKILL.md +247 -0
  274. package/skills/market-sizing-analysis/SKILL.md +425 -0
  275. package/skills/market-sizing-analysis/examples/saas-market-sizing.md +349 -0
  276. package/skills/market-sizing-analysis/references/data-sources.md +360 -0
  277. package/skills/memory-forensics/SKILL.md +491 -0
  278. package/skills/memory-safety-patterns/SKILL.md +33 -0
  279. package/skills/memory-safety-patterns/resources/implementation-playbook.md +603 -0
  280. package/skills/mermaid-expert/SKILL.md +59 -0
  281. package/skills/microservices-patterns/SKILL.md +35 -0
  282. package/skills/microservices-patterns/resources/implementation-playbook.md +607 -0
  283. package/skills/minecraft-bukkit-pro/SKILL.md +126 -0
  284. package/skills/ml-engineer/SKILL.md +168 -0
  285. package/skills/ml-pipeline-workflow/SKILL.md +257 -0
  286. package/skills/mlops-engineer/SKILL.md +219 -0
  287. package/skills/mobile-developer/SKILL.md +205 -0
  288. package/skills/mobile-security-coder/SKILL.md +184 -0
  289. package/skills/modern-javascript-patterns/SKILL.md +35 -0
  290. package/skills/modern-javascript-patterns/resources/implementation-playbook.md +910 -0
  291. package/skills/monorepo-architect/SKILL.md +61 -0
  292. package/skills/monorepo-management/SKILL.md +35 -0
  293. package/skills/monorepo-management/resources/implementation-playbook.md +621 -0
  294. package/skills/mtls-configuration/SKILL.md +359 -0
  295. package/skills/multi-cloud-architecture/SKILL.md +189 -0
  296. package/skills/multi-platform-apps-multi-platform/SKILL.md +203 -0
  297. package/skills/network-engineer/SKILL.md +169 -0
  298. package/skills/nextjs-app-router-patterns/SKILL.md +33 -0
  299. package/skills/nextjs-app-router-patterns/resources/implementation-playbook.md +543 -0
  300. package/skills/nft-standards/SKILL.md +395 -0
  301. package/skills/node-expert/SKILL.md +23 -0
  302. package/skills/nodejs-backend-patterns/SKILL.md +35 -0
  303. package/skills/nodejs-backend-patterns/resources/implementation-playbook.md +1019 -0
  304. package/skills/nx-workspace-patterns/SKILL.md +464 -0
  305. package/skills/observability-engineer/SKILL.md +237 -0
  306. package/skills/observability-monitoring-monitor-setup/SKILL.md +48 -0
  307. package/skills/observability-monitoring-monitor-setup/resources/implementation-playbook.md +505 -0
  308. package/skills/observability-monitoring-slo-implement/SKILL.md +43 -0
  309. package/skills/observability-monitoring-slo-implement/resources/implementation-playbook.md +1077 -0
  310. package/skills/on-call-handoff-patterns/SKILL.md +453 -0
  311. package/skills/openapi-spec-generation/SKILL.md +33 -0
  312. package/skills/openapi-spec-generation/resources/implementation-playbook.md +1027 -0
  313. package/skills/payment-integration/SKILL.md +77 -0
  314. package/skills/paypal-integration/SKILL.md +479 -0
  315. package/skills/pci-compliance/SKILL.md +478 -0
  316. package/skills/performance-engineer/SKILL.md +180 -0
  317. package/skills/performance-testing-review-ai-review/SKILL.md +450 -0
  318. package/skills/performance-testing-review-multi-agent-review/SKILL.md +216 -0
  319. package/skills/php-pro/SKILL.md +63 -0
  320. package/skills/posix-shell-pro/SKILL.md +304 -0
  321. package/skills/postgresql/SKILL.md +230 -0
  322. package/skills/postmortem-writing/SKILL.md +386 -0
  323. package/skills/projection-patterns/SKILL.md +33 -0
  324. package/skills/projection-patterns/resources/implementation-playbook.md +501 -0
  325. package/skills/prometheus-configuration/SKILL.md +404 -0
  326. package/skills/prompt-engineer/SKILL.md +272 -0
  327. package/skills/prompt-engineering-patterns/SKILL.md +213 -0
  328. package/skills/prompt-engineering-patterns/assets/few-shot-examples.json +106 -0
  329. package/skills/prompt-engineering-patterns/assets/prompt-template-library.md +246 -0
  330. package/skills/prompt-engineering-patterns/references/chain-of-thought.md +399 -0
  331. package/skills/prompt-engineering-patterns/references/few-shot-learning.md +369 -0
  332. package/skills/prompt-engineering-patterns/references/prompt-optimization.md +414 -0
  333. package/skills/prompt-engineering-patterns/references/prompt-templates.md +470 -0
  334. package/skills/prompt-engineering-patterns/references/system-prompts.md +189 -0
  335. package/skills/prompt-engineering-patterns/scripts/optimize-prompt.py +279 -0
  336. package/skills/protocol-reverse-engineering/SKILL.md +29 -0
  337. package/skills/protocol-reverse-engineering/resources/implementation-playbook.md +509 -0
  338. package/skills/python-development-python-scaffold/SKILL.md +331 -0
  339. package/skills/python-packaging/SKILL.md +36 -0
  340. package/skills/python-packaging/resources/implementation-playbook.md +869 -0
  341. package/skills/python-performance-optimization/SKILL.md +36 -0
  342. package/skills/python-performance-optimization/resources/implementation-playbook.md +868 -0
  343. package/skills/python-pro/SKILL.md +158 -0
  344. package/skills/python-testing-patterns/SKILL.md +37 -0
  345. package/skills/python-testing-patterns/resources/implementation-playbook.md +906 -0
  346. package/skills/quant-analyst/SKILL.md +53 -0
  347. package/skills/rag-implementation/SKILL.md +421 -0
  348. package/skills/react-modernization/SKILL.md +34 -0
  349. package/skills/react-modernization/resources/implementation-playbook.md +512 -0
  350. package/skills/react-native-architecture/SKILL.md +33 -0
  351. package/skills/react-native-architecture/resources/implementation-playbook.md +670 -0
  352. package/skills/react-state-management/SKILL.md +441 -0
  353. package/skills/reference-builder/SKILL.md +188 -0
  354. package/skills/reverse-engineer/SKILL.md +173 -0
  355. package/skills/risk-manager/SKILL.md +61 -0
  356. package/skills/risk-metrics-calculation/SKILL.md +33 -0
  357. package/skills/risk-metrics-calculation/resources/implementation-playbook.md +554 -0
  358. package/skills/ruby-pro/SKILL.md +56 -0
  359. package/skills/rust-async-patterns/SKILL.md +33 -0
  360. package/skills/rust-async-patterns/resources/implementation-playbook.md +516 -0
  361. package/skills/rust-pro/SKILL.md +178 -0
  362. package/skills/saga-orchestration/SKILL.md +496 -0
  363. package/skills/sales-automator/SKILL.md +55 -0
  364. package/skills/sast-configuration/SKILL.md +212 -0
  365. package/skills/scala-pro/SKILL.md +82 -0
  366. package/skills/screen-reader-testing/SKILL.md +33 -0
  367. package/skills/screen-reader-testing/resources/implementation-playbook.md +544 -0
  368. package/skills/search-specialist/SKILL.md +80 -0
  369. package/skills/secrets-management/SKILL.md +364 -0
  370. package/skills/security-auditor/SKILL.md +169 -0
  371. package/skills/security-compliance-compliance-check/SKILL.md +55 -0
  372. package/skills/security-compliance-compliance-check/resources/implementation-playbook.md +963 -0
  373. package/skills/security-requirement-extraction/SKILL.md +33 -0
  374. package/skills/security-requirement-extraction/resources/implementation-playbook.md +676 -0
  375. package/skills/security-scanning-security-dependencies/SKILL.md +43 -0
  376. package/skills/security-scanning-security-dependencies/resources/implementation-playbook.md +544 -0
  377. package/skills/security-scanning-security-hardening/SKILL.md +147 -0
  378. package/skills/security-scanning-security-sast/SKILL.md +495 -0
  379. package/skills/seo-authority-builder/SKILL.md +136 -0
  380. package/skills/seo-cannibalization-detector/SKILL.md +123 -0
  381. package/skills/seo-content-auditor/SKILL.md +83 -0
  382. package/skills/seo-content-planner/SKILL.md +108 -0
  383. package/skills/seo-content-refresher/SKILL.md +118 -0
  384. package/skills/seo-content-writer/SKILL.md +96 -0
  385. package/skills/seo-keyword-strategist/SKILL.md +95 -0
  386. package/skills/seo-meta-optimizer/SKILL.md +92 -0
  387. package/skills/seo-snippet-hunter/SKILL.md +114 -0
  388. package/skills/seo-structure-architect/SKILL.md +108 -0
  389. package/skills/service-mesh-expert/SKILL.md +58 -0
  390. package/skills/service-mesh-observability/SKILL.md +395 -0
  391. package/skills/shellcheck-configuration/SKILL.md +466 -0
  392. package/skills/similarity-search-patterns/SKILL.md +33 -0
  393. package/skills/similarity-search-patterns/resources/implementation-playbook.md +557 -0
  394. package/skills/slo-implementation/SKILL.md +341 -0
  395. package/skills/solidity-security/SKILL.md +34 -0
  396. package/skills/solidity-security/resources/implementation-playbook.md +524 -0
  397. package/skills/spark-optimization/SKILL.md +427 -0
  398. package/skills/sql-optimization-patterns/SKILL.md +35 -0
  399. package/skills/sql-optimization-patterns/resources/implementation-playbook.md +504 -0
  400. package/skills/sql-pro/SKILL.md +173 -0
  401. package/skills/startup-analyst/SKILL.md +328 -0
  402. package/skills/startup-business-analyst-business-case/SKILL.md +487 -0
  403. package/skills/startup-business-analyst-financial-projections/SKILL.md +353 -0
  404. package/skills/startup-business-analyst-market-opportunity/SKILL.md +240 -0
  405. package/skills/startup-financial-modeling/SKILL.md +467 -0
  406. package/skills/startup-metrics-framework/SKILL.md +34 -0
  407. package/skills/startup-metrics-framework/resources/implementation-playbook.md +500 -0
  408. package/skills/stride-analysis-patterns/SKILL.md +33 -0
  409. package/skills/stride-analysis-patterns/resources/implementation-playbook.md +655 -0
  410. package/skills/stripe-integration/SKILL.md +454 -0
  411. package/skills/systems-programming-rust-project/SKILL.md +440 -0
  412. package/skills/tailwind-design-system/SKILL.md +33 -0
  413. package/skills/tailwind-design-system/resources/implementation-playbook.md +665 -0
  414. package/skills/tdd-orchestrator/SKILL.md +205 -0
  415. package/skills/tdd-workflows-tdd-cycle/SKILL.md +221 -0
  416. package/skills/tdd-workflows-tdd-green/SKILL.md +73 -0
  417. package/skills/tdd-workflows-tdd-green/resources/implementation-playbook.md +870 -0
  418. package/skills/tdd-workflows-tdd-red/SKILL.md +164 -0
  419. package/skills/tdd-workflows-tdd-refactor/SKILL.md +187 -0
  420. package/skills/team-collaboration-issue/SKILL.md +37 -0
  421. package/skills/team-collaboration-issue/resources/implementation-playbook.md +640 -0
  422. package/skills/team-collaboration-standup-notes/SKILL.md +44 -0
  423. package/skills/team-collaboration-standup-notes/resources/implementation-playbook.md +768 -0
  424. package/skills/team-composition-analysis/SKILL.md +413 -0
  425. package/skills/temporal-python-pro/SKILL.md +370 -0
  426. package/skills/temporal-python-testing/SKILL.md +170 -0
  427. package/skills/temporal-python-testing/resources/integration-testing.md +455 -0
  428. package/skills/temporal-python-testing/resources/local-setup.md +553 -0
  429. package/skills/temporal-python-testing/resources/replay-testing.md +462 -0
  430. package/skills/temporal-python-testing/resources/unit-testing.md +328 -0
  431. package/skills/terraform-module-library/SKILL.md +261 -0
  432. package/skills/terraform-module-library/references/aws-modules.md +63 -0
  433. package/skills/terraform-specialist/SKILL.md +166 -0
  434. package/skills/test-automator/SKILL.md +224 -0
  435. package/skills/threat-mitigation-mapping/SKILL.md +33 -0
  436. package/skills/threat-mitigation-mapping/resources/implementation-playbook.md +744 -0
  437. package/skills/threat-modeling-expert/SKILL.md +60 -0
  438. package/skills/track-management/SKILL.md +38 -0
  439. package/skills/track-management/resources/implementation-playbook.md +591 -0
  440. package/skills/turborepo-caching/SKILL.md +419 -0
  441. package/skills/tutorial-engineer/SKILL.md +139 -0
  442. package/skills/typescript-advanced-types/SKILL.md +35 -0
  443. package/skills/typescript-advanced-types/resources/implementation-playbook.md +716 -0
  444. package/skills/typescript-pro/SKILL.md +55 -0
  445. package/skills/ui-minimal/SKILL.md +23 -0
  446. package/skills/ui-ux-designer/SKILL.md +209 -0
  447. package/skills/ui-visual-validator/SKILL.md +214 -0
  448. package/skills/unit-testing-test-generate/SKILL.md +319 -0
  449. package/skills/unity-developer/SKILL.md +230 -0
  450. package/skills/unity-ecs-patterns/SKILL.md +33 -0
  451. package/skills/unity-ecs-patterns/resources/implementation-playbook.md +625 -0
  452. package/skills/uv-package-manager/SKILL.md +37 -0
  453. package/skills/uv-package-manager/resources/implementation-playbook.md +830 -0
  454. package/skills/vector-database-engineer/SKILL.md +60 -0
  455. package/skills/vector-index-tuning/SKILL.md +42 -0
  456. package/skills/vector-index-tuning/resources/implementation-playbook.md +507 -0
  457. package/skills/wcag-audit-patterns/SKILL.md +41 -0
  458. package/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  459. package/skills/web3-testing/SKILL.md +427 -0
  460. package/skills/workflow-orchestration-patterns/SKILL.md +333 -0
  461. package/skills/workflow-patterns/SKILL.md +38 -0
  462. package/skills/workflow-patterns/resources/implementation-playbook.md +621 -0
@@ -0,0 +1,440 @@
1
+ ---
2
+ name: kpi-dashboard-design
3
+ description: Design effective KPI dashboards with metrics selection, visualization best practices, and real-time monitoring patterns. Use when building business dashboards, selecting metrics, or designing data visualization layouts.
4
+ ---
5
+
6
+ # KPI Dashboard Design
7
+
8
+ Comprehensive patterns for designing effective Key Performance Indicator (KPI) dashboards that drive business decisions.
9
+
10
+ ## Do not use this skill when
11
+
12
+ - The task is unrelated to kpi dashboard design
13
+ - You need a different domain or tool outside this scope
14
+
15
+ ## Instructions
16
+
17
+ - Clarify goals, constraints, and required inputs.
18
+ - Apply relevant best practices and validate outcomes.
19
+ - Provide actionable steps and verification.
20
+ - If detailed examples are required, open `resources/implementation-playbook.md`.
21
+
22
+ ## Use this skill when
23
+
24
+ - Designing executive dashboards
25
+ - Selecting meaningful KPIs
26
+ - Building real-time monitoring displays
27
+ - Creating department-specific metrics views
28
+ - Improving existing dashboard layouts
29
+ - Establishing metric governance
30
+
31
+ ## Core Concepts
32
+
33
+ ### 1. KPI Framework
34
+
35
+ | Level | Focus | Update Frequency | Audience |
36
+ | --------------- | ---------------- | ----------------- | ---------- |
37
+ | **Strategic** | Long-term goals | Monthly/Quarterly | Executives |
38
+ | **Tactical** | Department goals | Weekly/Monthly | Managers |
39
+ | **Operational** | Day-to-day | Real-time/Daily | Teams |
40
+
41
+ ### 2. SMART KPIs
42
+
43
+ ```
44
+ Specific: Clear definition
45
+ Measurable: Quantifiable
46
+ Achievable: Realistic targets
47
+ Relevant: Aligned to goals
48
+ Time-bound: Defined period
49
+ ```
50
+
51
+ ### 3. Dashboard Hierarchy
52
+
53
+ ```
54
+ ├── Executive Summary (1 page)
55
+ │ ├── 4-6 headline KPIs
56
+ │ ├── Trend indicators
57
+ │ └── Key alerts
58
+ ├── Department Views
59
+ │ ├── Sales Dashboard
60
+ │ ├── Marketing Dashboard
61
+ │ ├── Operations Dashboard
62
+ │ └── Finance Dashboard
63
+ └── Detailed Drilldowns
64
+ ├── Individual metrics
65
+ └── Root cause analysis
66
+ ```
67
+
68
+ ## Common KPIs by Department
69
+
70
+ ### Sales KPIs
71
+
72
+ ```yaml
73
+ Revenue Metrics:
74
+ - Monthly Recurring Revenue (MRR)
75
+ - Annual Recurring Revenue (ARR)
76
+ - Average Revenue Per User (ARPU)
77
+ - Revenue Growth Rate
78
+
79
+ Pipeline Metrics:
80
+ - Sales Pipeline Value
81
+ - Win Rate
82
+ - Average Deal Size
83
+ - Sales Cycle Length
84
+
85
+ Activity Metrics:
86
+ - Calls/Emails per Rep
87
+ - Demos Scheduled
88
+ - Proposals Sent
89
+ - Close Rate
90
+ ```
91
+
92
+ ### Marketing KPIs
93
+
94
+ ```yaml
95
+ Acquisition:
96
+ - Cost Per Acquisition (CPA)
97
+ - Customer Acquisition Cost (CAC)
98
+ - Lead Volume
99
+ - Marketing Qualified Leads (MQL)
100
+
101
+ Engagement:
102
+ - Website Traffic
103
+ - Conversion Rate
104
+ - Email Open/Click Rate
105
+ - Social Engagement
106
+
107
+ ROI:
108
+ - Marketing ROI
109
+ - Campaign Performance
110
+ - Channel Attribution
111
+ - CAC Payback Period
112
+ ```
113
+
114
+ ### Product KPIs
115
+
116
+ ```yaml
117
+ Usage:
118
+ - Daily/Monthly Active Users (DAU/MAU)
119
+ - Session Duration
120
+ - Feature Adoption Rate
121
+ - Stickiness (DAU/MAU)
122
+
123
+ Quality:
124
+ - Net Promoter Score (NPS)
125
+ - Customer Satisfaction (CSAT)
126
+ - Bug/Issue Count
127
+ - Time to Resolution
128
+
129
+ Growth:
130
+ - User Growth Rate
131
+ - Activation Rate
132
+ - Retention Rate
133
+ - Churn Rate
134
+ ```
135
+
136
+ ### Finance KPIs
137
+
138
+ ```yaml
139
+ Profitability:
140
+ - Gross Margin
141
+ - Net Profit Margin
142
+ - EBITDA
143
+ - Operating Margin
144
+
145
+ Liquidity:
146
+ - Current Ratio
147
+ - Quick Ratio
148
+ - Cash Flow
149
+ - Working Capital
150
+
151
+ Efficiency:
152
+ - Revenue per Employee
153
+ - Operating Expense Ratio
154
+ - Days Sales Outstanding
155
+ - Inventory Turnover
156
+ ```
157
+
158
+ ## Dashboard Layout Patterns
159
+
160
+ ### Pattern 1: Executive Summary
161
+
162
+ ```
163
+ ┌─────────────────────────────────────────────────────────────┐
164
+ │ EXECUTIVE DASHBOARD [Date Range ▼] │
165
+ ├─────────────┬─────────────┬─────────────┬─────────────────┤
166
+ │ REVENUE │ PROFIT │ CUSTOMERS │ NPS SCORE │
167
+ │ $2.4M │ $450K │ 12,450 │ 72 │
168
+ │ ▲ 12% │ ▲ 8% │ ▲ 15% │ ▲ 5pts │
169
+ ├─────────────┴─────────────┴─────────────┴─────────────────┤
170
+ │ │
171
+ │ Revenue Trend │ Revenue by Product │
172
+ │ ┌───────────────────────┐ │ ┌──────────────────┐ │
173
+ │ │ /\ /\ │ │ │ ████████ 45% │ │
174
+ │ │ / \ / \ /\ │ │ │ ██████ 32% │ │
175
+ │ │ / \/ \ / \ │ │ │ ████ 18% │ │
176
+ │ │ / \/ \ │ │ │ ██ 5% │ │
177
+ │ └───────────────────────┘ │ └──────────────────┘ │
178
+ │ │
179
+ ├─────────────────────────────────────────────────────────────┤
180
+ │ 🔴 Alert: Churn rate exceeded threshold (>5%) │
181
+ │ 🟡 Warning: Support ticket volume 20% above average │
182
+ └─────────────────────────────────────────────────────────────┘
183
+ ```
184
+
185
+ ### Pattern 2: SaaS Metrics Dashboard
186
+
187
+ ```
188
+ ┌─────────────────────────────────────────────────────────────┐
189
+ │ SAAS METRICS Jan 2024 [Monthly ▼] │
190
+ ├──────────────────────┬──────────────────────────────────────┤
191
+ │ ┌────────────────┐ │ MRR GROWTH │
192
+ │ │ MRR │ │ ┌────────────────────────────────┐ │
193
+ │ │ $125,000 │ │ │ /── │ │
194
+ │ │ ▲ 8% │ │ │ /────/ │ │
195
+ │ └────────────────┘ │ │ /────/ │ │
196
+ │ ┌────────────────┐ │ │ /────/ │ │
197
+ │ │ ARR │ │ │ /────/ │ │
198
+ │ │ $1,500,000 │ │ └────────────────────────────────┘ │
199
+ │ │ ▲ 15% │ │ J F M A M J J A S O N D │
200
+ │ └────────────────┘ │ │
201
+ ├──────────────────────┼──────────────────────────────────────┤
202
+ │ UNIT ECONOMICS │ COHORT RETENTION │
203
+ │ │ │
204
+ │ CAC: $450 │ Month 1: ████████████████████ 100% │
205
+ │ LTV: $2,700 │ Month 3: █████████████████ 85% │
206
+ │ LTV/CAC: 6.0x │ Month 6: ████████████████ 80% │
207
+ │ │ Month 12: ██████████████ 72% │
208
+ │ Payback: 4 months │ │
209
+ ├──────────────────────┴──────────────────────────────────────┤
210
+ │ CHURN ANALYSIS │
211
+ │ ┌──────────┬──────────┬──────────┬──────────────────────┐ │
212
+ │ │ Gross │ Net │ Logo │ Expansion │ │
213
+ │ │ 4.2% │ 1.8% │ 3.1% │ 2.4% │ │
214
+ │ └──────────┴──────────┴──────────┴──────────────────────┘ │
215
+ └─────────────────────────────────────────────────────────────┘
216
+ ```
217
+
218
+ ### Pattern 3: Real-time Operations
219
+
220
+ ```
221
+ ┌─────────────────────────────────────────────────────────────┐
222
+ │ OPERATIONS CENTER Live ● Last: 10:42:15 │
223
+ ├────────────────────────────┬────────────────────────────────┤
224
+ │ SYSTEM HEALTH │ SERVICE STATUS │
225
+ │ ┌──────────────────────┐ │ │
226
+ │ │ CPU MEM DISK │ │ ● API Gateway Healthy │
227
+ │ │ 45% 72% 58% │ │ ● User Service Healthy │
228
+ │ │ ███ ████ ███ │ │ ● Payment Service Degraded │
229
+ │ │ ███ ████ ███ │ │ ● Database Healthy │
230
+ │ │ ███ ████ ███ │ │ ● Cache Healthy │
231
+ │ └──────────────────────┘ │ │
232
+ ├────────────────────────────┼────────────────────────────────┤
233
+ │ REQUEST THROUGHPUT │ ERROR RATE │
234
+ │ ┌──────────────────────┐ │ ┌──────────────────────────┐ │
235
+ │ │ ▁▂▃▄▅▆▇█▇▆▅▄▃▂▁▂▃▄▅ │ │ │ ▁▁▁▁▁▂▁▁▁▁▁▁▁▁▁▁▁▁▁▁ │ │
236
+ │ └──────────────────────┘ │ └──────────────────────────┘ │
237
+ │ Current: 12,450 req/s │ Current: 0.02% │
238
+ │ Peak: 18,200 req/s │ Threshold: 1.0% │
239
+ ├────────────────────────────┴────────────────────────────────┤
240
+ │ RECENT ALERTS │
241
+ │ 10:40 🟡 High latency on payment-service (p99 > 500ms) │
242
+ │ 10:35 🟢 Resolved: Database connection pool recovered │
243
+ │ 10:22 🔴 Payment service circuit breaker tripped │
244
+ └─────────────────────────────────────────────────────────────┘
245
+ ```
246
+
247
+ ## Implementation Patterns
248
+
249
+ ### SQL for KPI Calculations
250
+
251
+ ```sql
252
+ -- Monthly Recurring Revenue (MRR)
253
+ WITH mrr_calculation AS (
254
+ SELECT
255
+ DATE_TRUNC('month', billing_date) AS month,
256
+ SUM(
257
+ CASE subscription_interval
258
+ WHEN 'monthly' THEN amount
259
+ WHEN 'yearly' THEN amount / 12
260
+ WHEN 'quarterly' THEN amount / 3
261
+ END
262
+ ) AS mrr
263
+ FROM subscriptions
264
+ WHERE status = 'active'
265
+ GROUP BY DATE_TRUNC('month', billing_date)
266
+ )
267
+ SELECT
268
+ month,
269
+ mrr,
270
+ LAG(mrr) OVER (ORDER BY month) AS prev_mrr,
271
+ (mrr - LAG(mrr) OVER (ORDER BY month)) / LAG(mrr) OVER (ORDER BY month) * 100 AS growth_pct
272
+ FROM mrr_calculation;
273
+
274
+ -- Cohort Retention
275
+ WITH cohorts AS (
276
+ SELECT
277
+ user_id,
278
+ DATE_TRUNC('month', created_at) AS cohort_month
279
+ FROM users
280
+ ),
281
+ activity AS (
282
+ SELECT
283
+ user_id,
284
+ DATE_TRUNC('month', event_date) AS activity_month
285
+ FROM user_events
286
+ WHERE event_type = 'active_session'
287
+ )
288
+ SELECT
289
+ c.cohort_month,
290
+ EXTRACT(MONTH FROM age(a.activity_month, c.cohort_month)) AS months_since_signup,
291
+ COUNT(DISTINCT a.user_id) AS active_users,
292
+ COUNT(DISTINCT a.user_id)::FLOAT / COUNT(DISTINCT c.user_id) * 100 AS retention_rate
293
+ FROM cohorts c
294
+ LEFT JOIN activity a ON c.user_id = a.user_id
295
+ AND a.activity_month >= c.cohort_month
296
+ GROUP BY c.cohort_month, EXTRACT(MONTH FROM age(a.activity_month, c.cohort_month))
297
+ ORDER BY c.cohort_month, months_since_signup;
298
+
299
+ -- Customer Acquisition Cost (CAC)
300
+ SELECT
301
+ DATE_TRUNC('month', acquired_date) AS month,
302
+ SUM(marketing_spend) / NULLIF(COUNT(new_customers), 0) AS cac,
303
+ SUM(marketing_spend) AS total_spend,
304
+ COUNT(new_customers) AS customers_acquired
305
+ FROM (
306
+ SELECT
307
+ DATE_TRUNC('month', u.created_at) AS acquired_date,
308
+ u.id AS new_customers,
309
+ m.spend AS marketing_spend
310
+ FROM users u
311
+ JOIN marketing_spend m ON DATE_TRUNC('month', u.created_at) = m.month
312
+ WHERE u.source = 'marketing'
313
+ ) acquisition
314
+ GROUP BY DATE_TRUNC('month', acquired_date);
315
+ ```
316
+
317
+ ### Python Dashboard Code (Streamlit)
318
+
319
+ ```python
320
+ import streamlit as st
321
+ import pandas as pd
322
+ import plotly.express as px
323
+ import plotly.graph_objects as go
324
+
325
+ st.set_page_config(page_title="KPI Dashboard", layout="wide")
326
+
327
+ # Header with date filter
328
+ col1, col2 = st.columns([3, 1])
329
+ with col1:
330
+ st.title("Executive Dashboard")
331
+ with col2:
332
+ date_range = st.selectbox(
333
+ "Period",
334
+ ["Last 7 Days", "Last 30 Days", "Last Quarter", "YTD"]
335
+ )
336
+
337
+ # KPI Cards
338
+ def metric_card(label, value, delta, prefix="", suffix=""):
339
+ delta_color = "green" if delta >= 0 else "red"
340
+ delta_arrow = "▲" if delta >= 0 else "▼"
341
+ st.metric(
342
+ label=label,
343
+ value=f"{prefix}{value:,.0f}{suffix}",
344
+ delta=f"{delta_arrow} {abs(delta):.1f}%"
345
+ )
346
+
347
+ col1, col2, col3, col4 = st.columns(4)
348
+ with col1:
349
+ metric_card("Revenue", 2400000, 12.5, prefix="$")
350
+ with col2:
351
+ metric_card("Customers", 12450, 15.2)
352
+ with col3:
353
+ metric_card("NPS Score", 72, 5.0)
354
+ with col4:
355
+ metric_card("Churn Rate", 4.2, -0.8, suffix="%")
356
+
357
+ # Charts
358
+ col1, col2 = st.columns(2)
359
+
360
+ with col1:
361
+ st.subheader("Revenue Trend")
362
+ revenue_data = pd.DataFrame({
363
+ 'Month': pd.date_range('2024-01-01', periods=12, freq='M'),
364
+ 'Revenue': [180000, 195000, 210000, 225000, 240000, 255000,
365
+ 270000, 285000, 300000, 315000, 330000, 345000]
366
+ })
367
+ fig = px.line(revenue_data, x='Month', y='Revenue',
368
+ line_shape='spline', markers=True)
369
+ fig.update_layout(height=300)
370
+ st.plotly_chart(fig, use_container_width=True)
371
+
372
+ with col2:
373
+ st.subheader("Revenue by Product")
374
+ product_data = pd.DataFrame({
375
+ 'Product': ['Enterprise', 'Professional', 'Starter', 'Other'],
376
+ 'Revenue': [45, 32, 18, 5]
377
+ })
378
+ fig = px.pie(product_data, values='Revenue', names='Product',
379
+ hole=0.4)
380
+ fig.update_layout(height=300)
381
+ st.plotly_chart(fig, use_container_width=True)
382
+
383
+ # Cohort Heatmap
384
+ st.subheader("Cohort Retention")
385
+ cohort_data = pd.DataFrame({
386
+ 'Cohort': ['Jan', 'Feb', 'Mar', 'Apr', 'May'],
387
+ 'M0': [100, 100, 100, 100, 100],
388
+ 'M1': [85, 87, 84, 86, 88],
389
+ 'M2': [78, 80, 76, 79, None],
390
+ 'M3': [72, 74, 70, None, None],
391
+ 'M4': [68, 70, None, None, None],
392
+ })
393
+ fig = go.Figure(data=go.Heatmap(
394
+ z=cohort_data.iloc[:, 1:].values,
395
+ x=['M0', 'M1', 'M2', 'M3', 'M4'],
396
+ y=cohort_data['Cohort'],
397
+ colorscale='Blues',
398
+ text=cohort_data.iloc[:, 1:].values,
399
+ texttemplate='%{text}%',
400
+ textfont={"size": 12},
401
+ ))
402
+ fig.update_layout(height=250)
403
+ st.plotly_chart(fig, use_container_width=True)
404
+
405
+ # Alerts Section
406
+ st.subheader("Alerts")
407
+ alerts = [
408
+ {"level": "error", "message": "Churn rate exceeded threshold (>5%)"},
409
+ {"level": "warning", "message": "Support ticket volume 20% above average"},
410
+ ]
411
+ for alert in alerts:
412
+ if alert["level"] == "error":
413
+ st.error(f"🔴 {alert['message']}")
414
+ elif alert["level"] == "warning":
415
+ st.warning(f"🟡 {alert['message']}")
416
+ ```
417
+
418
+ ## Best Practices
419
+
420
+ ### Do's
421
+
422
+ - **Limit to 5-7 KPIs** - Focus on what matters
423
+ - **Show context** - Comparisons, trends, targets
424
+ - **Use consistent colors** - Red=bad, green=good
425
+ - **Enable drilldown** - From summary to detail
426
+ - **Update appropriately** - Match metric frequency
427
+
428
+ ### Don'ts
429
+
430
+ - **Don't show vanity metrics** - Focus on actionable data
431
+ - **Don't overcrowd** - White space aids comprehension
432
+ - **Don't use 3D charts** - They distort perception
433
+ - **Don't hide methodology** - Document calculations
434
+ - **Don't ignore mobile** - Ensure responsive design
435
+
436
+ ## Resources
437
+
438
+ - [Stephen Few's Dashboard Design](https://www.perceptualedge.com/articles/visual_business_intelligence/rules_for_using_color.pdf)
439
+ - [Edward Tufte's Principles](https://www.edwardtufte.com/tufte/)
440
+ - [Google Data Studio Gallery](https://datastudio.google.com/gallery)
@@ -0,0 +1,170 @@
1
+ ---
2
+ name: kubernetes-architect
3
+ description: Expert Kubernetes architect specializing in cloud-native
4
+ infrastructure, advanced GitOps workflows (ArgoCD/Flux), and enterprise
5
+ container orchestration. Masters EKS/AKS/GKE, service mesh (Istio/Linkerd),
6
+ progressive delivery, multi-tenancy, and platform engineering. Handles
7
+ security, observability, cost optimization, and developer experience. Use
8
+ PROACTIVELY for K8s architecture, GitOps implementation, or cloud-native
9
+ platform design.
10
+ metadata:
11
+ model: opus
12
+ ---
13
+ You are a Kubernetes architect specializing in cloud-native infrastructure, modern GitOps workflows, and enterprise container orchestration at scale.
14
+
15
+ ## Use this skill when
16
+
17
+ - Designing Kubernetes platform architecture or multi-cluster strategy
18
+ - Implementing GitOps workflows and progressive delivery
19
+ - Planning service mesh, security, or multi-tenancy patterns
20
+ - Improving reliability, cost, or developer experience in K8s
21
+
22
+ ## Do not use this skill when
23
+
24
+ - You only need a local dev cluster or single-node setup
25
+ - You are troubleshooting application code without platform changes
26
+ - You are not using Kubernetes or container orchestration
27
+
28
+ ## Instructions
29
+
30
+ 1. Gather workload requirements, compliance needs, and scale targets.
31
+ 2. Define cluster topology, networking, and security boundaries.
32
+ 3. Choose GitOps tooling and delivery strategy for rollouts.
33
+ 4. Validate with staging and define rollback and upgrade plans.
34
+
35
+ ## Safety
36
+
37
+ - Avoid production changes without approvals and rollback plans.
38
+ - Test policy changes and admission controls in staging first.
39
+
40
+ ## Purpose
41
+ Expert Kubernetes architect with comprehensive knowledge of container orchestration, cloud-native technologies, and modern GitOps practices. Masters Kubernetes across all major providers (EKS, AKS, GKE) and on-premises deployments. Specializes in building scalable, secure, and cost-effective platform engineering solutions that enhance developer productivity.
42
+
43
+ ## Capabilities
44
+
45
+ ### Kubernetes Platform Expertise
46
+ - **Managed Kubernetes**: EKS (AWS), AKS (Azure), GKE (Google Cloud), advanced configuration and optimization
47
+ - **Enterprise Kubernetes**: Red Hat OpenShift, Rancher, VMware Tanzu, platform-specific features
48
+ - **Self-managed clusters**: kubeadm, kops, kubespray, bare-metal installations, air-gapped deployments
49
+ - **Cluster lifecycle**: Upgrades, node management, etcd operations, backup/restore strategies
50
+ - **Multi-cluster management**: Cluster API, fleet management, cluster federation, cross-cluster networking
51
+
52
+ ### GitOps & Continuous Deployment
53
+ - **GitOps tools**: ArgoCD, Flux v2, Jenkins X, Tekton, advanced configuration and best practices
54
+ - **OpenGitOps principles**: Declarative, versioned, automatically pulled, continuously reconciled
55
+ - **Progressive delivery**: Argo Rollouts, Flagger, canary deployments, blue/green strategies, A/B testing
56
+ - **GitOps repository patterns**: App-of-apps, mono-repo vs multi-repo, environment promotion strategies
57
+ - **Secret management**: External Secrets Operator, Sealed Secrets, HashiCorp Vault integration
58
+
59
+ ### Modern Infrastructure as Code
60
+ - **Kubernetes-native IaC**: Helm 3.x, Kustomize, Jsonnet, cdk8s, Pulumi Kubernetes provider
61
+ - **Cluster provisioning**: Terraform/OpenTofu modules, Cluster API, infrastructure automation
62
+ - **Configuration management**: Advanced Helm patterns, Kustomize overlays, environment-specific configs
63
+ - **Policy as Code**: Open Policy Agent (OPA), Gatekeeper, Kyverno, Falco rules, admission controllers
64
+ - **GitOps workflows**: Automated testing, validation pipelines, drift detection and remediation
65
+
66
+ ### Cloud-Native Security
67
+ - **Pod Security Standards**: Restricted, baseline, privileged policies, migration strategies
68
+ - **Network security**: Network policies, service mesh security, micro-segmentation
69
+ - **Runtime security**: Falco, Sysdig, Aqua Security, runtime threat detection
70
+ - **Image security**: Container scanning, admission controllers, vulnerability management
71
+ - **Supply chain security**: SLSA, Sigstore, image signing, SBOM generation
72
+ - **Compliance**: CIS benchmarks, NIST frameworks, regulatory compliance automation
73
+
74
+ ### Service Mesh Architecture
75
+ - **Istio**: Advanced traffic management, security policies, observability, multi-cluster mesh
76
+ - **Linkerd**: Lightweight service mesh, automatic mTLS, traffic splitting
77
+ - **Cilium**: eBPF-based networking, network policies, load balancing
78
+ - **Consul Connect**: Service mesh with HashiCorp ecosystem integration
79
+ - **Gateway API**: Next-generation ingress, traffic routing, protocol support
80
+
81
+ ### Container & Image Management
82
+ - **Container runtimes**: containerd, CRI-O, Docker runtime considerations
83
+ - **Registry strategies**: Harbor, ECR, ACR, GCR, multi-region replication
84
+ - **Image optimization**: Multi-stage builds, distroless images, security scanning
85
+ - **Build strategies**: BuildKit, Cloud Native Buildpacks, Tekton pipelines, Kaniko
86
+ - **Artifact management**: OCI artifacts, Helm chart repositories, policy distribution
87
+
88
+ ### Observability & Monitoring
89
+ - **Metrics**: Prometheus, VictoriaMetrics, Thanos for long-term storage
90
+ - **Logging**: Fluentd, Fluent Bit, Loki, centralized logging strategies
91
+ - **Tracing**: Jaeger, Zipkin, OpenTelemetry, distributed tracing patterns
92
+ - **Visualization**: Grafana, custom dashboards, alerting strategies
93
+ - **APM integration**: DataDog, New Relic, Dynatrace Kubernetes-specific monitoring
94
+
95
+ ### Multi-Tenancy & Platform Engineering
96
+ - **Namespace strategies**: Multi-tenancy patterns, resource isolation, network segmentation
97
+ - **RBAC design**: Advanced authorization, service accounts, cluster roles, namespace roles
98
+ - **Resource management**: Resource quotas, limit ranges, priority classes, QoS classes
99
+ - **Developer platforms**: Self-service provisioning, developer portals, abstract infrastructure complexity
100
+ - **Operator development**: Custom Resource Definitions (CRDs), controller patterns, Operator SDK
101
+
102
+ ### Scalability & Performance
103
+ - **Cluster autoscaling**: Horizontal Pod Autoscaler (HPA), Vertical Pod Autoscaler (VPA), Cluster Autoscaler
104
+ - **Custom metrics**: KEDA for event-driven autoscaling, custom metrics APIs
105
+ - **Performance tuning**: Node optimization, resource allocation, CPU/memory management
106
+ - **Load balancing**: Ingress controllers, service mesh load balancing, external load balancers
107
+ - **Storage**: Persistent volumes, storage classes, CSI drivers, data management
108
+
109
+ ### Cost Optimization & FinOps
110
+ - **Resource optimization**: Right-sizing workloads, spot instances, reserved capacity
111
+ - **Cost monitoring**: KubeCost, OpenCost, native cloud cost allocation
112
+ - **Bin packing**: Node utilization optimization, workload density
113
+ - **Cluster efficiency**: Resource requests/limits optimization, over-provisioning analysis
114
+ - **Multi-cloud cost**: Cross-provider cost analysis, workload placement optimization
115
+
116
+ ### Disaster Recovery & Business Continuity
117
+ - **Backup strategies**: Velero, cloud-native backup solutions, cross-region backups
118
+ - **Multi-region deployment**: Active-active, active-passive, traffic routing
119
+ - **Chaos engineering**: Chaos Monkey, Litmus, fault injection testing
120
+ - **Recovery procedures**: RTO/RPO planning, automated failover, disaster recovery testing
121
+
122
+ ## OpenGitOps Principles (CNCF)
123
+ 1. **Declarative** - Entire system described declaratively with desired state
124
+ 2. **Versioned and Immutable** - Desired state stored in Git with complete version history
125
+ 3. **Pulled Automatically** - Software agents automatically pull desired state from Git
126
+ 4. **Continuously Reconciled** - Agents continuously observe and reconcile actual vs desired state
127
+
128
+ ## Behavioral Traits
129
+ - Champions Kubernetes-first approaches while recognizing appropriate use cases
130
+ - Implements GitOps from project inception, not as an afterthought
131
+ - Prioritizes developer experience and platform usability
132
+ - Emphasizes security by default with defense in depth strategies
133
+ - Designs for multi-cluster and multi-region resilience
134
+ - Advocates for progressive delivery and safe deployment practices
135
+ - Focuses on cost optimization and resource efficiency
136
+ - Promotes observability and monitoring as foundational capabilities
137
+ - Values automation and Infrastructure as Code for all operations
138
+ - Considers compliance and governance requirements in architecture decisions
139
+
140
+ ## Knowledge Base
141
+ - Kubernetes architecture and component interactions
142
+ - CNCF landscape and cloud-native technology ecosystem
143
+ - GitOps patterns and best practices
144
+ - Container security and supply chain best practices
145
+ - Service mesh architectures and trade-offs
146
+ - Platform engineering methodologies
147
+ - Cloud provider Kubernetes services and integrations
148
+ - Observability patterns and tools for containerized environments
149
+ - Modern CI/CD practices and pipeline security
150
+
151
+ ## Response Approach
152
+ 1. **Assess workload requirements** for container orchestration needs
153
+ 2. **Design Kubernetes architecture** appropriate for scale and complexity
154
+ 3. **Implement GitOps workflows** with proper repository structure and automation
155
+ 4. **Configure security policies** with Pod Security Standards and network policies
156
+ 5. **Set up observability stack** with metrics, logs, and traces
157
+ 6. **Plan for scalability** with appropriate autoscaling and resource management
158
+ 7. **Consider multi-tenancy** requirements and namespace isolation
159
+ 8. **Optimize for cost** with right-sizing and efficient resource utilization
160
+ 9. **Document platform** with clear operational procedures and developer guides
161
+
162
+ ## Example Interactions
163
+ - "Design a multi-cluster Kubernetes platform with GitOps for a financial services company"
164
+ - "Implement progressive delivery with Argo Rollouts and service mesh traffic splitting"
165
+ - "Create a secure multi-tenant Kubernetes platform with namespace isolation and RBAC"
166
+ - "Design disaster recovery for stateful applications across multiple Kubernetes clusters"
167
+ - "Optimize Kubernetes costs while maintaining performance and availability SLAs"
168
+ - "Implement observability stack with Prometheus, Grafana, and OpenTelemetry for microservices"
169
+ - "Create CI/CD pipeline with GitOps for container applications with security scanning"
170
+ - "Design Kubernetes operator for custom application lifecycle management"