@kensaurus/skills 0.0.0-stage → 2.1.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 (425) hide show
  1. package/.claude-plugin/marketplace.json +53 -0
  2. package/.claude-plugin/plugin.json +40 -0
  3. package/.cursor-plugin/plugin.json +38 -0
  4. package/.mcp.json +28 -0
  5. package/CHANGELOG.md +1790 -0
  6. package/LICENSE +21 -0
  7. package/LICENSE-APACHE +62 -0
  8. package/NOTICE +13 -0
  9. package/README.md +821 -2
  10. package/SECURITY.md +55 -0
  11. package/agents/code-reviewer.md +60 -0
  12. package/agents/completion-judge.md +89 -0
  13. package/agents/db-migrator.md +125 -0
  14. package/agents/debugger.md +47 -0
  15. package/agents/deploy-checker.md +100 -0
  16. package/agents/perf-monitor.md +74 -0
  17. package/assets/favicon.png +0 -0
  18. package/assets/logo-light.png +0 -0
  19. package/assets/logo.png +0 -0
  20. package/assets/logo.svg +6 -0
  21. package/assets/og.png +0 -0
  22. package/bin/install.mjs +1127 -0
  23. package/bin/kenji.js +2 -0
  24. package/commands/adr.md +17 -0
  25. package/commands/aeo-plan.md +18 -0
  26. package/commands/arch-boundaries.md +17 -0
  27. package/commands/aso-plan.md +18 -0
  28. package/commands/auth-flows.md +19 -0
  29. package/commands/backup-plan.md +17 -0
  30. package/commands/burndown-full.md +25 -0
  31. package/commands/capacitor-plan.md +18 -0
  32. package/commands/codemod-safety.md +22 -0
  33. package/commands/commit.md +18 -0
  34. package/commands/complete-everything.md +40 -0
  35. package/commands/cost-plan.md +19 -0
  36. package/commands/deadcode-plan.md +26 -0
  37. package/commands/deadcode.md +32 -0
  38. package/commands/debug-issue.md +17 -0
  39. package/commands/deps-plan.md +18 -0
  40. package/commands/docs-plan.md +17 -0
  41. package/commands/doctrine.md +19 -0
  42. package/commands/error-plan.md +19 -0
  43. package/commands/feedback-to-closure.md +36 -0
  44. package/commands/fix-issue.md +76 -0
  45. package/commands/gate-logic.md +26 -0
  46. package/commands/green-repo.md +36 -0
  47. package/commands/grill-me.md +19 -0
  48. package/commands/gtm-plan.md +21 -0
  49. package/commands/gtm-weekly.md +17 -0
  50. package/commands/gtm.md +22 -0
  51. package/commands/handoff.md +15 -0
  52. package/commands/housekeep-backlog.md +18 -0
  53. package/commands/housekeep-files.md +22 -0
  54. package/commands/housekeep-gates.md +18 -0
  55. package/commands/instant-nav.md +11 -0
  56. package/commands/integrity-plan.md +19 -0
  57. package/commands/launch-kit.md +16 -0
  58. package/commands/mcp-guide.md +40 -0
  59. package/commands/mobile-plan.md +19 -0
  60. package/commands/native-rn-monorepo/README.md +78 -0
  61. package/commands/native-rn-monorepo/android-build.md +26 -0
  62. package/commands/native-rn-monorepo/android-install.md +32 -0
  63. package/commands/native-rn-monorepo/android-logcat.md +37 -0
  64. package/commands/native-rn-monorepo/ios-ci-logs.md +56 -0
  65. package/commands/native-rn-monorepo/ios-ci-status.md +52 -0
  66. package/commands/native-rn-monorepo/ios-ci-trigger.md +59 -0
  67. package/commands/native-rn-monorepo/rn-reset.md +50 -0
  68. package/commands/native-rn-monorepo/rn-ship-ios.md +67 -0
  69. package/commands/native-rn-monorepo/rn-verify.md +53 -0
  70. package/commands/perf-plan.md +18 -0
  71. package/commands/plan-mode.md +74 -0
  72. package/commands/pr.md +16 -0
  73. package/commands/pricing-plan.md +20 -0
  74. package/commands/privacy-plan.md +18 -0
  75. package/commands/readability.md +12 -0
  76. package/commands/readme.md +15 -0
  77. package/commands/refactor.md +15 -0
  78. package/commands/release-prep.md +17 -0
  79. package/commands/research.md +25 -0
  80. package/commands/responsive-audit.md +21 -0
  81. package/commands/review-code.md +18 -0
  82. package/commands/rls-plan.md +18 -0
  83. package/commands/secrets-plan.md +18 -0
  84. package/commands/security-plan.md +19 -0
  85. package/commands/ship-and-observe.md +36 -0
  86. package/commands/skill-conflicts.md +19 -0
  87. package/commands/slop-plan.md +18 -0
  88. package/commands/stub-plan.md +18 -0
  89. package/commands/test-mutation.md +16 -0
  90. package/commands/test-plan.md +17 -0
  91. package/commands/test.md +29 -0
  92. package/commands/thirdparty-web-interface-guidelines.md +185 -0
  93. package/commands/uiux-plan.md +18 -0
  94. package/commands/uiux.md +45 -0
  95. package/commands/update-deps.md +21 -0
  96. package/commands/validation-plan.md +19 -0
  97. package/commands-portable/fix-issue.md +72 -0
  98. package/commands-portable/plan-mode.md +92 -0
  99. package/commands-portable/research.md +91 -0
  100. package/docs/screenshots/README.md +5 -0
  101. package/docs/screenshots/audit-dark.png +0 -0
  102. package/docs/screenshots/build-dark.png +0 -0
  103. package/docs/screenshots/grill-dark.png +0 -0
  104. package/docs/screenshots/hero-dark.png +0 -0
  105. package/docs/screenshots/hero-light.png +0 -0
  106. package/docs/screenshots/ship-dark.png +0 -0
  107. package/docs/screenshots/src/showcase.html +320 -0
  108. package/hooks/completion-gate.mjs +258 -0
  109. package/hooks/cursor-hooks.json +13 -0
  110. package/hooks/hooks.json +15 -0
  111. package/install.sh +21 -0
  112. package/llms.txt +40 -0
  113. package/mcp/README.md +266 -0
  114. package/mcp/VERSIONS.md +41 -0
  115. package/mcp/mcp-full.json.template +124 -0
  116. package/mcp/mcp.json.template +29 -0
  117. package/mcp/pinned-versions.json +27 -0
  118. package/package.json +94 -4
  119. package/rules/approved-plan-execution.mdc +65 -0
  120. package/rules/full-stack-ship-discipline.mdc +37 -0
  121. package/rules/native-rn-monorepo/README.md +63 -0
  122. package/rules/native-rn-monorepo/_project.mdc +69 -0
  123. package/rules/native-rn-monorepo/native-android.mdc +72 -0
  124. package/rules/native-rn-monorepo/native-ios.mdc +61 -0
  125. package/rules/native-rn-monorepo/react-native-js.mdc +78 -0
  126. package/rules/native-rn-monorepo/web.mdc +60 -0
  127. package/rules/project-starter/components.mdc +54 -0
  128. package/rules/project-starter/data-fetching.mdc +77 -0
  129. package/rules/project-starter/git.mdc +41 -0
  130. package/rules/project-starter/supabase.mdc +37 -0
  131. package/rules/project-starter/tailwind.mdc +48 -0
  132. package/rules/project-starter/typescript.mdc +36 -0
  133. package/rules/project-starter/web-performance.mdc +42 -0
  134. package/rules/senior-engineer.mdc +30 -0
  135. package/rules/shell-first-search.mdc +19 -0
  136. package/rules/skill-workflows.mdc +35 -0
  137. package/rules/verification-before-completion.mdc +57 -0
  138. package/skills/audit-accessibility/SKILL.md +441 -0
  139. package/skills/audit-agent-speed/SKILL.md +181 -0
  140. package/skills/audit-agent-speed/scripts/stop-typecheck.mjs +151 -0
  141. package/skills/audit-analytics/SKILL.md +138 -0
  142. package/skills/audit-auth-flows/SKILL.md +267 -0
  143. package/skills/audit-backend-architecture/SKILL.md +266 -0
  144. package/skills/audit-backend-architecture/references/patterns.md +386 -0
  145. package/skills/audit-bundle-size/SKILL.md +295 -0
  146. package/skills/audit-cicd/SKILL.md +218 -0
  147. package/skills/audit-code-quality/SKILL.md +314 -0
  148. package/skills/audit-code-review/SKILL.md +289 -0
  149. package/skills/audit-codemod-safety/SKILL.md +159 -0
  150. package/skills/audit-db-schema/SKILL.md +465 -0
  151. package/skills/audit-db-schema/references/details.md +110 -0
  152. package/skills/audit-doctrine/SKILL.md +189 -0
  153. package/skills/audit-env-parity/SKILL.md +133 -0
  154. package/skills/audit-fe-api/SKILL.md +458 -0
  155. package/skills/audit-gate-logic/SKILL.md +219 -0
  156. package/skills/audit-i18n/SKILL.md +339 -0
  157. package/skills/audit-infra-cost/SKILL.md +142 -0
  158. package/skills/audit-langfuse-llm/SKILL.md +468 -0
  159. package/skills/audit-langfuse-llm/references/details.md +226 -0
  160. package/skills/audit-llm-security/SKILL.md +147 -0
  161. package/skills/audit-monetization-iap/SKILL.md +137 -0
  162. package/skills/audit-payment-system/SKILL.md +268 -0
  163. package/skills/audit-payment-system/references/checklist.md +283 -0
  164. package/skills/audit-performance/SKILL.md +383 -0
  165. package/skills/audit-performance/references/loading-priority-2026.md +81 -0
  166. package/skills/audit-realworld/SKILL.md +287 -0
  167. package/skills/audit-registry-listing/SKILL.md +122 -0
  168. package/skills/audit-resilience/SKILL.md +153 -0
  169. package/skills/audit-responsive/SKILL.md +221 -0
  170. package/skills/audit-responsive/references/checklist.md +166 -0
  171. package/skills/audit-security/SKILL.md +289 -0
  172. package/skills/audit-skill-conflicts/SKILL.md +178 -0
  173. package/skills/audit-ui-states/SKILL.md +146 -0
  174. package/skills/audit-uiux-design-system/SKILL.md +475 -0
  175. package/skills/audit-uiux-design-system/references/details.md +71 -0
  176. package/skills/audit-ux/SKILL.md +381 -0
  177. package/skills/audit-ux/references/details.md +245 -0
  178. package/skills/audit-ux-journeys/SKILL.md +215 -0
  179. package/skills/audit-ux-journeys/references/checklist.md +179 -0
  180. package/skills/backend-db-performance/SKILL.md +441 -0
  181. package/skills/backend-error-handling/SKILL.md +489 -0
  182. package/skills/backend-error-handling/references/details.md +58 -0
  183. package/skills/backend-observability/SKILL.md +88 -0
  184. package/skills/backend-patterns/SKILL.md +499 -0
  185. package/skills/backend-patterns/references/architecture-patterns.md +298 -0
  186. package/skills/backend-realtime/SKILL.md +403 -0
  187. package/skills/backend-realtime/references/patterns.md +74 -0
  188. package/skills/burndown-full/SKILL.md +174 -0
  189. package/skills/complete-everything/SKILL.md +295 -0
  190. package/skills/data-pipeline/SKILL.md +109 -0
  191. package/skills/data-visualization/SKILL.md +488 -0
  192. package/skills/debug-error/SKILL.md +322 -0
  193. package/skills/debug-fe-be-integration/SKILL.md +459 -0
  194. package/skills/debug-sentry-monitor/SKILL.md +497 -0
  195. package/skills/debug-sentry-monitor/references/details.md +165 -0
  196. package/skills/deploy-npm/SKILL.md +394 -0
  197. package/skills/deploy-npm/references/example-mushi-mushi.md +52 -0
  198. package/skills/deploy-verify/SKILL.md +489 -0
  199. package/skills/design-api/SKILL.md +379 -0
  200. package/skills/design-canvas/SKILL.md +155 -0
  201. package/skills/design-email/SKILL.md +370 -0
  202. package/skills/design-frontend/SKILL.md +143 -0
  203. package/skills/design-generative-art/SKILL.md +474 -0
  204. package/skills/design-mobile-first/SKILL.md +506 -0
  205. package/skills/design-motion/SKILL.md +333 -0
  206. package/skills/design-motion/references/delight-interactions.md +191 -0
  207. package/skills/design-prd/SKILL.md +443 -0
  208. package/skills/design-system/SKILL.md +457 -0
  209. package/skills/design-theme/SKILL.md +226 -0
  210. package/skills/design-theme/themes/tsumagoi-ranch.md +150 -0
  211. package/skills/docs-adr/SKILL.md +168 -0
  212. package/skills/docs-coauthor/SKILL.md +368 -0
  213. package/skills/docs-comparison-pages/SKILL.md +117 -0
  214. package/skills/docs-domain-modeling/SKILL.md +97 -0
  215. package/skills/docs-launch-kit/SKILL.md +139 -0
  216. package/skills/docs-writer/SKILL.md +469 -0
  217. package/skills/enhance-agent-guardrails/SKILL.md +164 -0
  218. package/skills/enhance-arch-boundaries/SKILL.md +154 -0
  219. package/skills/enhance-capacitor-ui/SKILL.md +463 -0
  220. package/skills/enhance-capacitor-ui/references/details.md +750 -0
  221. package/skills/enhance-email-deliverability/SKILL.md +143 -0
  222. package/skills/enhance-growth-loops/SKILL.md +122 -0
  223. package/skills/enhance-lifecycle-email/SKILL.md +130 -0
  224. package/skills/enhance-motion/SKILL.md +193 -0
  225. package/skills/enhance-onboarding/SKILL.md +148 -0
  226. package/skills/enhance-pwa/SKILL.md +303 -0
  227. package/skills/enhance-readability/SKILL.md +146 -0
  228. package/skills/enhance-readme/SKILL.md +496 -0
  229. package/skills/enhance-readme/package-lock.json +187 -0
  230. package/skills/enhance-readme/package.json +17 -0
  231. package/skills/enhance-readme/scripts/generate-readme-blocks.mjs +199 -0
  232. package/skills/enhance-readme/scripts/record-readme-tour.mjs +442 -0
  233. package/skills/enhance-skill-prompts/SKILL.md +167 -0
  234. package/skills/enhance-skill-prompts/references/exemplar-audit-auth-flows.md +311 -0
  235. package/skills/enhance-ux-laws/SKILL.md +409 -0
  236. package/skills/enhance-web-conversion/SKILL.md +155 -0
  237. package/skills/enhance-web-forms/SKILL.md +154 -0
  238. package/skills/enhance-web-instant-nav/SKILL.md +138 -0
  239. package/skills/enhance-web-instant-nav/references/bfcache-blockers.md +23 -0
  240. package/skills/enhance-web-instant-nav/references/early-hints.md +33 -0
  241. package/skills/enhance-web-instant-nav/references/speculation-rules.md +44 -0
  242. package/skills/enhance-web-landing/SKILL.md +459 -0
  243. package/skills/enhance-web-landing/references/details.md +773 -0
  244. package/skills/enhance-web-redesign/SKILL.md +228 -0
  245. package/skills/enhance-web-seo/SKILL.md +276 -0
  246. package/skills/enhance-web-ui/SKILL.md +473 -0
  247. package/skills/enhance-web-ui/references/details.md +674 -0
  248. package/skills/enhance-web-ux/HEURISTICS.md +248 -0
  249. package/skills/enhance-web-ux/PATTERNS.md +375 -0
  250. package/skills/enhance-web-ux/SKILL.md +464 -0
  251. package/skills/enhance-web-ux/examples.md +222 -0
  252. package/skills/enhance-web-ux/references/details.md +406 -0
  253. package/skills/enhance-web-web3d/SKILL.md +397 -0
  254. package/skills/enhance-web-web3d/references/css-canvas-effects.md +180 -0
  255. package/skills/handoff/SKILL.md +66 -0
  256. package/skills/housekeep-backlog/SKILL.md +149 -0
  257. package/skills/housekeep-dead-code/SKILL.md +387 -0
  258. package/skills/housekeep-dead-code/references/ratchet-ci.md +205 -0
  259. package/skills/housekeep-dead-code/references/supabase-hygiene.md +152 -0
  260. package/skills/housekeep-design/SKILL.md +207 -0
  261. package/skills/housekeep-files/SKILL.md +220 -0
  262. package/skills/housekeep-files/references/naming-and-catalog.md +86 -0
  263. package/skills/housekeep-files/scripts/housekeep-files.ps1 +360 -0
  264. package/skills/housekeep-files/scripts/housekeep-files.sh +238 -0
  265. package/skills/housekeep-gates/SKILL.md +174 -0
  266. package/skills/iterate-agent-harness/SKILL.md +137 -0
  267. package/skills/iterate-gtm-weekly/SKILL.md +103 -0
  268. package/skills/iterate-post-launch/SKILL.md +292 -0
  269. package/skills/meta-mcp-builder/SKILL.md +313 -0
  270. package/skills/meta-skill-creator/SKILL.md +304 -0
  271. package/skills/mobile-capacitor-platform/SKILL.md +103 -0
  272. package/skills/mobile-emulator-start/SKILL.md +296 -0
  273. package/skills/mobile-emulator-test/SKILL.md +491 -0
  274. package/skills/mobile-emulator-test/references/details.md +478 -0
  275. package/skills/mobile-rn-performance/SKILL.md +107 -0
  276. package/skills/mobile-rn-screen/SKILL.md +476 -0
  277. package/skills/mobile-rn-screen/references/details.md +785 -0
  278. package/skills/mushi-health/SKILL.md +206 -0
  279. package/skills/mushi-integration/SKILL.md +257 -0
  280. package/skills/plan-aeo-readiness/SKILL.md +166 -0
  281. package/skills/plan-antislop/SKILL.md +281 -0
  282. package/skills/plan-aso/SKILL.md +149 -0
  283. package/skills/plan-backup-dr/SKILL.md +131 -0
  284. package/skills/plan-capacitor-hardening/SKILL.md +217 -0
  285. package/skills/plan-data-integrity/SKILL.md +187 -0
  286. package/skills/plan-dead-code/SKILL.md +386 -0
  287. package/skills/plan-dead-code/references/knip-config.md +214 -0
  288. package/skills/plan-dead-code/references/output-templates.md +133 -0
  289. package/skills/plan-dead-code/references/preservation-contract.md +50 -0
  290. package/skills/plan-dead-code/references/residue-greps.md +84 -0
  291. package/skills/plan-dependency-provenance/SKILL.md +200 -0
  292. package/skills/plan-docs-sync/SKILL.md +143 -0
  293. package/skills/plan-docs-sync/references/drift-taxonomy.md +43 -0
  294. package/skills/plan-docs-sync/references/output-templates.md +33 -0
  295. package/skills/plan-docs-sync/references/preservation-contract.md +17 -0
  296. package/skills/plan-error-handling/SKILL.md +205 -0
  297. package/skills/plan-gtm/SKILL.md +276 -0
  298. package/skills/plan-gtm/references/benchmarks-2026.md +183 -0
  299. package/skills/plan-input-validation/SKILL.md +179 -0
  300. package/skills/plan-llm-cost-guardrails/SKILL.md +176 -0
  301. package/skills/plan-mobile-readiness/SKILL.md +171 -0
  302. package/skills/plan-perf-audit/SKILL.md +145 -0
  303. package/skills/plan-perf-audit/references/audit-scope.md +51 -0
  304. package/skills/plan-perf-audit/references/output-templates.md +33 -0
  305. package/skills/plan-perf-audit/references/preservation-contract.md +13 -0
  306. package/skills/plan-pricing/SKILL.md +173 -0
  307. package/skills/plan-privacy-compliance/SKILL.md +148 -0
  308. package/skills/plan-rls-audit/SKILL.md +231 -0
  309. package/skills/plan-secrets-audit/SKILL.md +181 -0
  310. package/skills/plan-security-audit/SKILL.md +168 -0
  311. package/skills/plan-security-audit/references/output-templates.md +36 -0
  312. package/skills/plan-security-audit/references/owasp-supabase-scope.md +55 -0
  313. package/skills/plan-security-audit/references/preservation-contract.md +18 -0
  314. package/skills/plan-stub-checker/SKILL.md +216 -0
  315. package/skills/plan-stub-checker/references/detection-methodology.md +75 -0
  316. package/skills/plan-stub-checker/references/detection-taxonomy.md +34 -0
  317. package/skills/plan-stub-checker/references/output-templates.md +63 -0
  318. package/skills/plan-stub-checker/references/preservation-contract.md +24 -0
  319. package/skills/plan-test-coverage/SKILL.md +170 -0
  320. package/skills/plan-test-coverage/references/methodology.md +54 -0
  321. package/skills/plan-test-coverage/references/output-templates.md +34 -0
  322. package/skills/plan-test-coverage/references/preservation-contract.md +15 -0
  323. package/skills/plan-uiux-unification/SKILL.md +230 -0
  324. package/skills/plan-uiux-unification/references/output-templates.md +67 -0
  325. package/skills/plan-uiux-unification/references/phase-workbook.md +85 -0
  326. package/skills/plan-uiux-unification/references/preservation-contract.md +24 -0
  327. package/skills/protocol-browser-anti-stall/SKILL.md +211 -0
  328. package/skills/protocol-browser-anti-stall/references/mcp-to-cli-map.md +113 -0
  329. package/skills/protocol-browser-anti-stall/references/playwright-session-coordination.md +170 -0
  330. package/skills/research/SKILL.md +422 -0
  331. package/skills/test-exploratory/SKILL.md +165 -0
  332. package/skills/test-exploratory/references/charter-template.md +29 -0
  333. package/skills/test-load/SKILL.md +126 -0
  334. package/skills/test-mutation/SKILL.md +160 -0
  335. package/skills/test-playwright/SKILL.md +354 -0
  336. package/skills/test-qa/SKILL.md +364 -0
  337. package/skills/test-qa/references/details.md +268 -0
  338. package/skills/test-red-team/SKILL.md +386 -0
  339. package/skills/test-red-team/references/owasp-attack-checklist.md +193 -0
  340. package/skills/test-unit/SKILL.md +259 -0
  341. package/skills/test-unit/references/details.md +267 -0
  342. package/skills/test-visual-regression/SKILL.md +132 -0
  343. package/skills/thirdparty-emil-design-eng/ATTRIBUTION.md +20 -0
  344. package/skills/thirdparty-emil-design-eng/SKILL.md +21 -0
  345. package/skills/thirdparty-emil-design-eng/references/emil-design-eng.md +676 -0
  346. package/skills/thirdparty-ui-ux-pro-max/ATTRIBUTION.md +22 -0
  347. package/skills/thirdparty-ui-ux-pro-max/SKILL.md +304 -0
  348. package/skills/thirdparty-ui-ux-pro-max/data/charts.csv +26 -0
  349. package/skills/thirdparty-ui-ux-pro-max/data/colors.csv +97 -0
  350. package/skills/thirdparty-ui-ux-pro-max/data/icons.csv +101 -0
  351. package/skills/thirdparty-ui-ux-pro-max/data/landing.csv +31 -0
  352. package/skills/thirdparty-ui-ux-pro-max/data/products.csv +97 -0
  353. package/skills/thirdparty-ui-ux-pro-max/data/react-performance.csv +45 -0
  354. package/skills/thirdparty-ui-ux-pro-max/data/stacks/astro.csv +54 -0
  355. package/skills/thirdparty-ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  356. package/skills/thirdparty-ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  357. package/skills/thirdparty-ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  358. package/skills/thirdparty-ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  359. package/skills/thirdparty-ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  360. package/skills/thirdparty-ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  361. package/skills/thirdparty-ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  362. package/skills/thirdparty-ui-ux-pro-max/data/stacks/react.csv +54 -0
  363. package/skills/thirdparty-ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  364. package/skills/thirdparty-ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  365. package/skills/thirdparty-ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  366. package/skills/thirdparty-ui-ux-pro-max/data/stacks/vue.csv +50 -0
  367. package/skills/thirdparty-ui-ux-pro-max/data/styles.csv +68 -0
  368. package/skills/thirdparty-ui-ux-pro-max/data/typography.csv +58 -0
  369. package/skills/thirdparty-ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  370. package/skills/thirdparty-ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  371. package/skills/thirdparty-ui-ux-pro-max/data/web-interface.csv +31 -0
  372. package/skills/thirdparty-ui-ux-pro-max/scripts/core.py +253 -0
  373. package/skills/thirdparty-ui-ux-pro-max/scripts/design_system.py +1067 -0
  374. package/skills/thirdparty-ui-ux-pro-max/scripts/search.py +114 -0
  375. package/skills/thirdparty-web-interface-guidelines/ATTRIBUTION.md +23 -0
  376. package/skills/thirdparty-web-interface-guidelines/SKILL.md +190 -0
  377. package/skills/workflow-build-feature/SKILL.md +118 -0
  378. package/skills/workflow-coding-discipline/SKILL.md +140 -0
  379. package/skills/workflow-environment-ready/SKILL.md +128 -0
  380. package/skills/workflow-feature-flag/SKILL.md +262 -0
  381. package/skills/workflow-feedback-to-closure/SKILL.md +165 -0
  382. package/skills/workflow-fix-and-ship/SKILL.md +136 -0
  383. package/skills/workflow-git-commit/SKILL.md +200 -0
  384. package/skills/workflow-green-repo/SKILL.md +166 -0
  385. package/skills/workflow-grilling/SKILL.md +73 -0
  386. package/skills/workflow-gtm/SKILL.md +153 -0
  387. package/skills/workflow-housekeep/SKILL.md +453 -0
  388. package/skills/workflow-housekeep/references/templates.md +109 -0
  389. package/skills/workflow-launch-ready/SKILL.md +145 -0
  390. package/skills/workflow-merge-conflicts/SKILL.md +62 -0
  391. package/skills/workflow-onboard/SKILL.md +99 -0
  392. package/skills/workflow-parallel-agents/SKILL.md +164 -0
  393. package/skills/workflow-pr/SKILL.md +197 -0
  394. package/skills/workflow-quality-gate/SKILL.md +147 -0
  395. package/skills/workflow-refactor/SKILL.md +274 -0
  396. package/skills/workflow-release-prep/SKILL.md +207 -0
  397. package/skills/workflow-ship-and-observe/SKILL.md +164 -0
  398. package/skills/workflow-spec-tdd/SKILL.md +141 -0
  399. package/skills/workflow-spec-tdd/references/spec-template.md +126 -0
  400. package/skills/workflow-spec-tdd/references/tdd-patterns.md +167 -0
  401. package/skills-cursor/babysit/SKILL.md +17 -0
  402. package/skills-cursor/canvas/SKILL.md +142 -0
  403. package/skills-cursor/canvas/sdk/canvas-tokens.d.ts +235 -0
  404. package/skills-cursor/canvas/sdk/chart-primitives.d.ts +200 -0
  405. package/skills-cursor/canvas/sdk/dag-layout.d.ts +102 -0
  406. package/skills-cursor/canvas/sdk/diff-view.d.ts +130 -0
  407. package/skills-cursor/canvas/sdk/form-primitives.d.ts +194 -0
  408. package/skills-cursor/canvas/sdk/hooks.d.ts +117 -0
  409. package/skills-cursor/canvas/sdk/index.d.ts +47 -0
  410. package/skills-cursor/canvas/sdk/theme.d.ts +61 -0
  411. package/skills-cursor/canvas/sdk/todo-list.d.ts +49 -0
  412. package/skills-cursor/canvas/sdk/ui-primitives.d.ts +549 -0
  413. package/skills-cursor/canvas/sdk/ui-primitives.test.d.ts +2 -0
  414. package/skills-cursor/create-hook/SKILL.md +238 -0
  415. package/skills-cursor/create-rule/SKILL.md +185 -0
  416. package/skills-cursor/create-skill/SKILL.md +269 -0
  417. package/skills-cursor/create-skill/references/authoring-guide.md +182 -0
  418. package/skills-cursor/create-subagent/SKILL.md +228 -0
  419. package/skills-cursor/migrate-to-skills/SKILL.md +121 -0
  420. package/skills-cursor/shell/SKILL.md +22 -0
  421. package/skills-cursor/split-to-prs/SKILL.md +47 -0
  422. package/skills-cursor/statusline/SKILL.md +193 -0
  423. package/skills-cursor/update-cli-config/SKILL.md +85 -0
  424. package/skills-cursor/update-cursor-settings/SKILL.md +137 -0
  425. package/skills.sh.json +297 -0
@@ -0,0 +1,281 @@
1
+ ---
2
+ name: plan-antislop
3
+ description: >
4
+ Plan-only authenticity / AI-slop audit across prose, UI, code, and IA.
5
+ Use when "looks like AI slop", "reads like ChatGPT", or "authenticity
6
+ burndown". One-page UX apply → enhance-web-ux. Visual polish →
7
+ enhance-web-ui.
8
+ license: MIT
9
+ effort: high
10
+ ---
11
+
12
+ # Anti-Slop Audit + Authenticity Burndown Plan
13
+
14
+ **Degree of freedom: HIGH** — inventory tells, score, plan. Stay
15
+ **plan-only**. No rewrites until each phase is approved.
16
+
17
+ ## This skill vs neighbors
18
+
19
+ | Skill | Owns |
20
+ |---|---|
21
+ | **plan-antislop** (this) | Authenticity / slop burndown (plan only) |
22
+ | `enhance-web-ui` / `enhance-web-ux` | Apply polish after the plan |
23
+ | `plan-uiux-unification` | Design-system + IA unification |
24
+ | `plan-dead-code` | Provably unreachable code, deps, duplication |
25
+
26
+ ## How to reason (every plan item)
27
+
28
+ 1. **Propose** — direction to remove a tell (not the rewrite)
29
+ 2. **Risk** — how loudly it reads as machine-made, and who sees it first
30
+ 3. **Keep-working** — copy/UI/code that already sounds or looks intentional
31
+ 4. **Phase** — copy → visual → IA → code (do not execute)
32
+
33
+ ## Worked example
34
+
35
+ > **Propose:** replace the hero dual-clause ("It's not just a tracker, it's a companion") with the concrete benefit already in the docs.
36
+ > **Risk:** first-screen cadence is the loudest AI tell; readers bounce.
37
+ > **Keep-working:** settings microcopy is already terse and product-specific.
38
+ > **Phase:** Phase 1 — copy pass via `docs-writer`.
39
+
40
+ **Role:** Senior editor + product designer + staff engineer (authenticity lens).
41
+
42
+ **Task:** Inventory machine-generated tells across prose, visual/UI, code, and structure/IA.
43
+ Score each finding by recognizability × effort, cluster into phased burndowns, emit
44
+ `plan-antislop.md`. **Audit & plan only — no rewrites until each phase is approved.**
45
+
46
+ **Find the AI tells. Plan their removal. Change nothing until approved.**
47
+
48
+ "Slop" is content that is *recognizably* machine-generated: technically fine,
49
+ semantically empty, and uniform in a way no human hand would produce. This skill
50
+ is the **audit-and-plan** half of de-slopping. It inventories slop across four
51
+ surfaces, ranks each finding by *recognizability × effort*, and emits a phased
52
+ burndown the user approves before any rewrite happens.
53
+
54
+ This skill never rewrites. It produces `plan-antislop.md`. Execution is handed to
55
+ `enhance-web-ux`, `enhance-web-ui`, `enhance-web-landing`, `design-frontend`,
56
+ `audit-i18n`, or `docs-writer` after approval — same contract as every `plan-*`
57
+ skill in this repo.
58
+
59
+ ---
60
+
61
+ ## When this fires
62
+
63
+ Trigger phrases: *"this feels AI-generated"*, *"de-slop this"*, *"reads like
64
+ ChatGPT"*, *"make it sound human"*, *"every page looks identical"*, *"it's
65
+ generic/templated/soulless"*, *"strip the AI smell before launch"*, *"voice and
66
+ authenticity pass"*.
67
+
68
+ Do **not** fire for: functional bugs (`debug-*`), security/RLS
69
+ (`plan-security-audit`), missing tests (`plan-test-coverage`), or designing a new
70
+ surface from scratch (`design-frontend`). Slop is about *recognizability*, not
71
+ correctness — code can be 100% working and still be 100% slop.
72
+
73
+ ---
74
+
75
+ ## The four slop surfaces [HIGH freedom]
76
+
77
+ Audit each surface the codebase actually has. Skip surfaces that don't apply
78
+ (a backend-only repo has no visual surface).
79
+
80
+ ### 1 · Prose & copy slop
81
+
82
+ The most detectable surface. Scan all user-facing strings, marketing copy,
83
+ READMEs, microcopy, error messages, and comments for:
84
+
85
+ - **Cadence tells** — "It's not just X, it's Y." / "In today's fast-paced world…"
86
+ / "Let's dive in." / "The result? …" / "But here's the thing:" / rhetorical
87
+ question → one-line answer.
88
+ - **Filler vocabulary** — *delve, tapestry, realm, landscape, leverage,
89
+ seamless, robust, elevate, unlock, empower, navigate, foster, testament,
90
+ bustling, vibrant, game-changer, at the end of the day.*
91
+ - **Hedge-and-pad** — "it's important to note that", "it's worth mentioning",
92
+ "in conclusion", triple-adjective stacks, sentences that restate the heading.
93
+ - **Punctuation tics** — em-dash overuse, "—and that's the point.", emoji as
94
+ bullet points, Title Case Everywhere, bolded **every** other phrase.
95
+ - **Empty symmetry** — three benefits that are the same benefit, "Fast. Simple.
96
+ Powerful." triads, conclusions that summarize a 2-paragraph page.
97
+
98
+ Output for each: file/line, the tell, *why a human wouldn't write it*, and a
99
+ direction for the fix (not the fix itself).
100
+
101
+ ### 2 · Visual & UI slop
102
+
103
+ The "I've seen this exact app 400 times" surface:
104
+
105
+ - **Default-palette tell** — untouched shadcn violet/zinc, the default Tailwind
106
+ blue-600 CTA, no brand color anywhere.
107
+ - **Card-grid monotony** — every section is a 3-up grid of identical rounded
108
+ cards with an icon, a bold title, and two lines of gray text.
109
+ - **Centered-everything** — every section center-aligned, max-w-2xl, same
110
+ vertical rhythm, no asymmetry, no intentional focal point.
111
+ - **Iconography slop** — a lucide icon on every feature whether it means
112
+ anything or not; emoji in headings.
113
+ - **No hierarchy** — all sections weighted equally; nothing is the hero, nothing
114
+ recedes; uniform spacing top to bottom.
115
+ - **Generic motion** — fade-in-on-scroll on everything, or no motion at all.
116
+
117
+ Cross-check against the project's design tokens if `audit-uiux-design-system`
118
+ data or a tokens file exists — slop is often *divergence from* the design system
119
+ plus *convergence toward* the framework default.
120
+
121
+ ### 3 · Code slop
122
+
123
+ Working code that no engineer would have left as-is:
124
+
125
+ - **Placeholder residue** — `// TODO: implement`, `// your logic here`,
126
+ `foo`/`bar`/`data`/`handleClick` naming, `lorem ipsum`, commented-out
127
+ scaffolding, `console.log('here')`.
128
+ - **Comment slop** — comments restating the code (`// increment i by 1`),
129
+ docstrings that paraphrase the function name, banner comments around trivial
130
+ blocks.
131
+ - **Over-abstraction** — a factory + interface + strategy for one concrete case;
132
+ `utils/helpers/index.ts` dumping grounds; premature generics.
133
+ - **Copy-paste uniformity** — five near-identical components that should be one
134
+ parameterized component; the same try/catch boilerplate everywhere.
135
+ - **Defensive theater** — `if (!data) return null` guards that can't trigger;
136
+ empty catch blocks; types widened to `any` to silence the compiler.
137
+
138
+ This overlaps `audit-code-quality` — here the lens is specifically *"looks
139
+ auto-generated"*, not general correctness. Flag, don't fix.
140
+
141
+ It also overlaps `plan-dead-code`, which owns *provable unreachability*
142
+ (a module-graph fact). Split by which judgment you are making: commented-out
143
+ scaffolding and guards that can't trigger are slop **because a human would
144
+ not have left them**, not because a tool proved nothing reaches them. Counts
145
+ and deletion of unused files, exports, deps, and duplication belong there.
146
+
147
+ ### 4 · Structure & IA slop
148
+
149
+ The shape of the thing:
150
+
151
+ - **Listicle-brain** — everything is a bulleted list because the model defaults
152
+ to lists; no prose, no flow, no argument.
153
+ - **Symmetrical IA** — every page has identical Hero → Features → Testimonials →
154
+ CTA scaffolding regardless of purpose.
155
+ - **README slop** — emoji-headers, a feature table no one asked for, "## Getting
156
+ Started" boilerplate, badges that don't link anywhere, a "Contributing"
157
+ section on a solo throwaway.
158
+ - **Empty completeness** — sections that exist because the template had them
159
+ (FAQ with invented questions, "Roadmap" with placeholder quarters).
160
+
161
+ ---
162
+
163
+ ## Procedure [HIGH freedom]
164
+
165
+ 1. **Scope.** Identify which of the four surfaces exist. State assumptions. If
166
+ the user pointed at a specific route/file, scope to it; otherwise sweep the
167
+ user-facing surface area.
168
+ 2. **Inventory.** Walk each in-scope surface. Collect concrete findings with
169
+ `path:line` (or route + screenshot region for visual). Quote the *minimum*
170
+ needed to identify the tell — never paste whole files.
171
+ 3. **Score.** Rate each finding **Recognizability** (how loudly it screams "AI
172
+ wrote this": High / Med / Low) × **Effort** (S / M / L). High-recognizability +
173
+ Small-effort items are the top of the burndown — biggest authenticity gain per
174
+ minute.
175
+ 4. **Cluster into phases.** Group findings so each phase is independently
176
+ shippable and maps to one execution skill. Suggested default ordering:
177
+ - **Phase 1 — Copy pass** (`docs-writer` / `audit-i18n`): kill cadence tells &
178
+ filler vocab. Highest signal, lowest risk, no visual regression.
179
+ - **Phase 2 — Visual identity** (`enhance-web-ui` / `design-frontend`): break
180
+ the default palette, introduce hierarchy and one intentional focal point per
181
+ view, de-monotonize the card grids.
182
+ - **Phase 3 — UX & flow** (`enhance-web-ux` / `enhance-web-landing`): fix IA,
183
+ replace symmetrical scaffolding with purpose-driven structure.
184
+ - **Phase 4 — Code cleanup** (`audit-code-quality` / `workflow-refactor`):
185
+ placeholder residue, comment slop, over-abstraction.
186
+ 5. **Emit the report.** Write `plan-antislop.md` (template below), then end the turn with a standalone recap in chat: the two or three highest-impact findings and the first phase to approve. The file is the deliverable — write it before the recap.
187
+ **Do not start Phase 1.** Wait for explicit approval per phase — the
188
+ `approved-plan-execution.mdc` handoff contract applies.
189
+
190
+ ---
191
+
192
+ ## Guardrails [LOW freedom — run exactly]
193
+
194
+ - **Plan only.** No rewrites, no edits, no "while I'm here" fixes. The deliverable
195
+ is the report.
196
+ - **Slop ≠ broken.** Don't flag working code as slop just because it's simple.
197
+ Simple-and-intentional is the *goal*, not a defect. The test is "would a human
198
+ engineer/writer have left this exact thing?" — not "could this be fancier?"
199
+ - **Voice is the user's, not yours.** Recommend *directions* ("warm up the CTA
200
+ copy to match the conversational tone of the docs"), never ghost-write the
201
+ replacement in the plan. The whole point is to remove generic voice, so don't
202
+ inject a different generic voice.
203
+ - **Don't over-correct into anti-slop slop.** Forced quirkiness, ironic
204
+ lowercase, gratuitous em-dashes-the-other-way, and "edgy" copy are *also* slop.
205
+ Flag the tendency; aim for intentional, not performative.
206
+ - **Cite the design system.** When flagging visual slop, reference the project's
207
+ actual tokens/brand if they exist. "Diverges from your defined `--brand-500`"
208
+ is actionable; "use nicer colors" is not.
209
+ - **Minimal quoting.** Identify tells by location and short excerpt; never
210
+ reproduce large blocks of the source.
211
+
212
+ ## Self-critique before the burndown [LOW freedom — do not skip]
213
+
214
+ 1. **evidenced-not-assumed** — `path:line` (or route + region) plus the tell
215
+ 2. **plan-only** — direction only; no rewrite and no ghost-written replacement
216
+ 3. **phase justified** — high-recognizability + small-effort leads; copy before code
217
+ 4. **right-owner** — functional bugs → `debug-*`; new surface from scratch → `design-frontend`
218
+ 5. **no-false-safety** — simple-and-intentional is not slop; don't invent anti-slop slop
219
+
220
+ ---
221
+
222
+ ## Report template — `plan-antislop.md`
223
+
224
+ ```markdown
225
+ # Anti-Slop Burndown — <repo/route>
226
+
227
+ _Audit-only. Nothing changes until each phase is approved._
228
+
229
+ ## Scope
230
+ - Surfaces audited: [ ] Prose [ ] Visual [ ] Code [ ] Structure
231
+ - Out of scope / assumptions: …
232
+
233
+ ## Slop score (at a glance)
234
+ | Surface | Findings | High-recognizability | Top quick win |
235
+ |------------|----------|----------------------|---------------|
236
+ | Prose | n | n | … |
237
+ | Visual | n | n | … |
238
+ | Code | n | n | … |
239
+ | Structure | n | n | … |
240
+
241
+ ## Findings
242
+ ### Prose & copy
243
+ | # | Location | Tell | Why it reads as AI | Recog | Effort | Direction |
244
+ |---|----------|------|--------------------|-------|--------|-----------|
245
+ | P1 | hero/page.tsx:24 | "It's not just a tracker, it's a companion" | dual-clause hype cadence | High | S | state the concrete benefit plainly |
246
+
247
+ ### Visual & UI
248
+ | # | Route/region | Tell | Recog | Effort | Direction |
249
+ |---|--------------|------|-------|--------|-----------|
250
+
251
+ ### Code
252
+ | # | path:line | Tell | Recog | Effort | Direction |
253
+ |---|-----------|------|-------|--------|-----------|
254
+
255
+ ### Structure & IA
256
+ | # | Location | Tell | Recog | Effort | Direction |
257
+ |---|----------|------|-------|--------|-----------|
258
+
259
+ ## Phased burndown
260
+ - **Phase 1 — Copy pass** → `docs-writer` / `audit-i18n` — items P1, P3, P7…
261
+ - **Phase 2 — Visual identity** → `enhance-web-ui` / `design-frontend` — V1, V2…
262
+ - **Phase 3 — UX & flow** → `enhance-web-ux` / `enhance-web-landing` — S1, S4…
263
+ - **Phase 4 — Code cleanup** → `audit-code-quality` / `workflow-refactor` — C2…
264
+
265
+ ## Execution handoff
266
+ Approve a phase to run it. Suggested order maximizes authenticity-per-effort.
267
+ Re-run `plan-antislop` after execution to confirm the burndown closed.
268
+ ```
269
+
270
+ ---
271
+
272
+ ## Chains with
273
+
274
+ - **Six-skill plan loop** — slots beside `plan-uiux-unification`; run after it so
275
+ visual-slop findings inherit the design-system burndown.
276
+ - **Execution:** `enhance-web-ux`, `enhance-web-ui`, `enhance-web-landing`,
277
+ `design-frontend`, `audit-i18n`, `docs-writer`, `workflow-refactor`.
278
+ - **Verify:** after execution, `test-playwright` (does it still work?) and a
279
+ second `plan-antislop` pass (did the slop actually drop?).
280
+
281
+ > Planned at high effort; executed at the default effort under the approved-plan execution rule (`approved-plan-execution.mdc`), which forbids reward hacking and feature deletion on any model. The plan says *which* slop to remove; the rule constrains *how*.
@@ -0,0 +1,149 @@
1
+ ---
2
+ name: plan-aso
3
+ description: >
4
+ Plan-only ASO audit of App Store and Google Play listings: keywords,
5
+ localized metadata, screenshots, ratings prompts. Use when "optimize our
6
+ store listing", "improve app downloads", or "ASO". Submission readiness →
7
+ plan-mobile-readiness.
8
+ license: MIT
9
+ effort: high
10
+ ---
11
+
12
+ # plan-aso — Store listing growth plan
13
+
14
+ **Degree of freedom: HIGH** — audit the listing, emit a plan. Stay
15
+ **plan-only**. No metadata, screenshot, or prompt edits until approved.
16
+
17
+ **Role:** Mobile growth / ASO specialist.
18
+
19
+ **Task:** Audit the listing that decides whether a visitor installs, emit
20
+ `plan-aso.md`. **Plan only — no metadata, screenshot, or prompt edits until
21
+ approved.**
22
+
23
+ **ASO is two funnels:** keywords decide who *finds* the app; screenshots +
24
+ first impression decide who *installs*.
25
+
26
+ ## This skill vs neighbors
27
+
28
+ | Skill | Owns |
29
+ |---|---|
30
+ | **plan-aso** (this) | Find + install conversion of the *listing* |
31
+ | `plan-mobile-readiness` | Submission mechanics, privacy manifest, demo account |
32
+ | `plan-privacy-compliance` | Honest privacy labels (don't ASO-lie about data) |
33
+ | `enhance-web-seo` / `plan-aeo-readiness` | Web / answer-engine discoverability |
34
+ | `audit-monetization-iap` | Whether IAP actually works |
35
+ | `design-frontend` | Asset production after the plan is approved |
36
+
37
+ Do **not** fire for "will Play reject us / Guideline 2.5.2" →
38
+ `plan-mobile-readiness`.
39
+
40
+ ## How to reason (every plan item)
41
+
42
+ 1. **Propose** — keyword, locale, screenshot order, or ratings-prompt change
43
+ 2. **Risk** — find vs install: who never sees the app, or who sees it and bounces
44
+ 3. **Keep-working** — locales/assets that already convert
45
+ 4. **Phase** — quick / medium / ongoing (do not execute)
46
+
47
+ ## Worked example
48
+
49
+ > **Propose:** fill the unused 40 chars of the iOS keyword field; drop
50
+ > title-word repeats; put the benefit screenshot first.
51
+ > **Risk:** core use-case terms never indexed; first impression is a bare UI dump.
52
+ > **Keep-working:** JP long description already locale-native.
53
+ > **Phase:** quick — keywords + screenshot reorder.
54
+ > **Find vs install:** find (keywords) + install (shot 1).
55
+
56
+ ---
57
+
58
+ ## Phase 0 — Gather the current listing [HIGH freedom]
59
+
60
+ Per platform × locale: name, subtitle (iOS) / short description (Android),
61
+ iOS 100-char keyword field, long description, screenshots + captions, preview
62
+ video, icon, category, ratings state. Note machine-translated or EN-only
63
+ locales.
64
+
65
+ ---
66
+
67
+ ## Phase 1 — Discoverability (find) [HIGH freedom]
68
+
69
+ **iOS keywords** — 100 chars fully used, comma-separated, no wasted spaces, no
70
+ repeats of title/subtitle words, no plural+singular waste. Core use-case terms
71
+ present.
72
+
73
+ **Title & subtitle** — Title carries the #1 keyword beyond brand. Subtitle is
74
+ a keyword-bearing value line, not a slogan.
75
+
76
+ **Android** — Play indexes the long description. Core terms in the first lines,
77
+ natural density, not stuffed.
78
+
79
+ **Localization** — Each locale is a separate keyword surface. JP + EN need
80
+ *locale-native* keywords, not translated English. Untapped locales are the
81
+ cheap win.
82
+
83
+ **Category & competitors** — Right primary category? Terms competitors rank
84
+ that this listing ignores?
85
+
86
+ ---
87
+
88
+ ## Phase 2 — Conversion (install) [HIGH freedom]
89
+
90
+ **Screenshots** — First 2–3 (no scroll) lead with benefit captions, not bare
91
+ UI. Narrative across the set. Localized text for key markets.
92
+
93
+ **Icon** — Distinct at thumbnail size.
94
+
95
+ **Preview video** — Value in the first seconds (often muted autoplay).
96
+
97
+ **Above-the-fold copy** — One-line hook, not "Welcome to…".
98
+
99
+ **Ratings** — In-app prompt at a *positive* moment (after value, not on
100
+ launch). Reviews responded to.
101
+
102
+ **Trust** — No leftover screenshots from an old version.
103
+
104
+ ---
105
+
106
+ ## Phase 3 — Prioritized plan (approve before executing) [HIGH freedom — plan only]
107
+
108
+ - **Quick** — fill keyword field, drop redundant title words, add missing
109
+ core-market locale, reorder screenshots value-first
110
+ - **Medium** — benefit captions, localized screenshot text, preview video,
111
+ well-timed rating prompt
112
+ - **Ongoing** — locale expansion, review cadence, store A/B on icon/shots,
113
+ keyword iteration
114
+
115
+ Each item: current → change → find vs install → effort. Asset work flagged
116
+ for `design-frontend`.
117
+
118
+ ## Self-critique before the burndown [LOW freedom — do not skip]
119
+
120
+ 1. **Per platform × locale** — do not audit EN-only and call JP done
121
+ 2. **Find vs install labeled** — every item says which funnel it moves
122
+ 3. **No ASO-lie** — privacy labels stay honest (`plan-privacy-compliance`)
123
+ 4. **Right owner** — Guideline 2.5.2 / demo account → `plan-mobile-readiness`
124
+ 5. **Nothing edited** on the listing until approved
125
+
126
+ ## Definition of Done
127
+
128
+ - [ ] Listing inventory per platform × locale
129
+ - [ ] iOS keywords + title/subtitle audited
130
+ - [ ] Android description placement checked
131
+ - [ ] Localization gaps with locale-native keyword notes
132
+ - [ ] Screenshots / icon / video / hook / ratings reviewed
133
+ - [ ] Plan prioritized; approved before listing edits
134
+
135
+ ## Output format
136
+
137
+ 1. **Inventory** — field × platform × locale
138
+ 2. **Find findings** — issue | severity | fix
139
+ 3. **Install findings** — issue | severity | fix
140
+ 4. **Plan** — quick / medium / ongoing
141
+ 5. **Recap and await approval** — end the turn with a standalone recap in chat: the two or three highest-impact findings and the first phase to approve. `plan-aso.md` is the deliverable; write it before the recap.
142
+
143
+ ## Related
144
+
145
+ - `plan-mobile-readiness` — get into the store
146
+ - `plan-privacy-compliance` — labels must match collection
147
+ - `audit-monetization-iap` — paid features actually unlock
148
+ - `enhance-web-seo` / `plan-aeo-readiness` — web counterparts
149
+ - `design-frontend` — produce approved assets
@@ -0,0 +1,131 @@
1
+ ---
2
+ name: plan-backup-dr
3
+ description: >
4
+ Plan-only audit of whether a project can actually recover from data loss,
5
+ not just whether backups exist. Use when "can we recover if the DB dies",
6
+ "audit our backups", "what's our RPO/RTO", or "disaster recovery".
7
+ license: MIT
8
+ effort: high
9
+ ---
10
+
11
+ # plan-backup-dr — Recovery capability plan
12
+
13
+ **Degree of freedom: HIGH** — prove restore, quantify RPO/RTO, plan.
14
+ Stay **plan-only**. No PITR toggles or prod-writing drills until approved.
15
+
16
+ **Role:** Platform / disaster-recovery engineer.
17
+
18
+ **Task:** Prove restore works, quantify RPO/RTO, emit `plan-backup-dr.md`.
19
+ **Audit & plan only — no PITR toggles, lifecycle edits, or drills that write
20
+ to prod until approved.**
21
+
22
+ **Backup existence is not recovery capability.** An untested backup is a hope.
23
+
24
+ ## This skill vs neighbors
25
+
26
+ | Skill | Owns |
27
+ |---|---|
28
+ | **plan-backup-dr** (this) | Can you restore? RPO/RTO, drill evidence, SPOF |
29
+ | `plan-data-integrity` | Stop destructive ops *going forward* (unguarded DELETE/DROP) |
30
+ | `audit-env-parity` | Staging pointing at prod data (blast-radius setup) |
31
+ | `audit-infra-cost` | Backup retention that silently explodes the bill |
32
+ | `plan-secrets-audit` | Credential exposure — not "can I reconstruct secrets after loss" |
33
+
34
+ Do **not** fire for "is this migration safe / agent might delete prod" →
35
+ `plan-data-integrity`. That skill *prevents* wipe; this one *recovers* after one.
36
+
37
+ ## How to reason (every plan item)
38
+
39
+ 1. **Propose** — backup, restore path, drill, or off-provider export
40
+ 2. **Risk** — worst-case in plain language ("lose up to a day of uploads")
41
+ 3. **Keep-working** — stores that already have a proven restore
42
+ 4. **Phase** — P0 / P1 / P2 (do not execute)
43
+
44
+ ## Worked example
45
+
46
+ > **Propose:** run one isolated restore drill of the primary DB; write the
47
+ > runbook from what you actually did.
48
+ > **Risk:** daily snapshot exists, never restored — RPO 24h is a hope, RTO unbounded.
49
+ > **Keep-working:** object-storage versioning already on.
50
+ > **Phase:** P0 — no proven restore.
51
+ > **Target:** drill into an isolated env, never over prod.
52
+
53
+ ---
54
+
55
+ ## Phase 0 — Map the recovery surface [HIGH freedom]
56
+
57
+ For each stateful thing, find backup *and* restore:
58
+
59
+ - **Primary DB** (Supabase/Postgres): PITR? snapshots? retention? who restores?
60
+ - **Object storage:** versioning? lifecycle that *deletes*? backed up at all?
61
+ - **Secrets & config:** reconstructable if the account vanished?
62
+ - **Auth users:** identities recoverable, or only app rows?
63
+ - **External state:** Stripe, third-party subs, DNS, domain
64
+ - **Code & IaC:** reproducible from repo, or dashboard-only?
65
+
66
+ ---
67
+
68
+ ## Phase 1 — Audit recovery reality [HIGH freedom]
69
+
70
+ **RPO** — Real gap between backups. Daily snapshot = up to 24h gone. PITR =
71
+ seconds. State the number, not the aspiration.
72
+
73
+ **RTO** — Walk the actual restore runbook. No runbook → RTO is unbounded.
74
+
75
+ **Restore drill** — Evidence a restore *succeeded* and was verified. None →
76
+ P0 is "run one end-to-end drill" (into an isolated env, never over prod).
77
+
78
+ **SPOF** — One provider/region/account. Billing/ToS/compromise suspends
79
+ everything? Off-provider export?
80
+
81
+ **Silent loss** — Lifecycle rules or `ON DELETE CASCADE` that erase more than
82
+ intended (cross-check `plan-data-integrity`). Backups that expire before anyone
83
+ would notice slow corruption.
84
+
85
+ **Bus-factor** — Restore credentials behind a login only one person has.
86
+
87
+ ---
88
+
89
+ ## Phase 2 — Phased DR plan (approve before executing) [HIGH freedom — plan only]
90
+
91
+ - **P0** — no proven restore; any store with *no* backup; secrets unrecoverable; bus-factor-1
92
+ - **P1** — RPO worse than the data justifies; no written runbook; no off-provider export
93
+ - **P2** — RTO reduction, automated restore verify, drill cadence
94
+
95
+ Each item: current state, worst-case in plain language ("lose up to a day of
96
+ uploads"), target RPO/RTO, concrete change.
97
+
98
+ ## Self-critique before the burndown [LOW freedom — do not skip]
99
+
100
+ 1. **RPO is a number** — not "we have backups"
101
+ 2. **Drill evidence or P0** — absence is the finding
102
+ 3. **No prod writes** — isolated env only, and only after approval
103
+ 4. **Right owner** — unguarded DELETE → `plan-data-integrity`
104
+ 5. **Do not cut restore** to save cost (`audit-infra-cost` must not expire backups)
105
+
106
+ ## Definition of Done
107
+
108
+ - [ ] Every stateful store has backup AND restore method
109
+ - [ ] RPO stated as a real number per store
110
+ - [ ] RTO estimated from the actual (or absent) runbook
111
+ - [ ] Restore-drill evidence found — or absence flagged P0
112
+ - [ ] Secrets/config reconstructable
113
+ - [ ] SPOF + off-provider export status known
114
+ - [ ] Recovery-access bus-factor assessed
115
+ - [ ] Plan approved before infra change
116
+
117
+ ## Output format
118
+
119
+ 1. **Recovery surface** — store | backup | restore | RPO | RTO | last drill
120
+ 2. **Findings** — issue | worst-case | severity | evidence
121
+ 3. **SPOF map** — shared account/region/provider
122
+ 4. **Phased DR plan** — P0/P1/P2 with target RPO/RTO
123
+ 5. **Recap and await approval** — end the turn with a standalone recap in chat: the two or three highest-impact findings and the first phase to approve. `plan-backup-dr.md` is the deliverable; write it before the recap. Test restore only into an isolated env.
124
+
125
+ ## Related
126
+
127
+ - `plan-data-integrity` — prevent wipe; this proves restore
128
+ - `audit-env-parity` — staging vs prod data targeting
129
+ - `audit-infra-cost` — retention vs bill
130
+ - `plan-secrets-audit` — leaked keys, not reconstructability
131
+ - `workflow-environment-ready` — local runnability, not DR