@kensaurus/skills 0.0.0-stage → 2.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.
- package/.claude-plugin/marketplace.json +53 -0
- package/.claude-plugin/plugin.json +40 -0
- package/.cursor-plugin/plugin.json +38 -0
- package/.mcp.json +28 -0
- package/CHANGELOG.md +1761 -0
- package/LICENSE +21 -0
- package/NOTICE +13 -0
- package/README.md +820 -2
- package/SECURITY.md +55 -0
- package/agents/code-reviewer.md +60 -0
- package/agents/completion-judge.md +89 -0
- package/agents/db-migrator.md +125 -0
- package/agents/debugger.md +47 -0
- package/agents/deploy-checker.md +100 -0
- package/agents/perf-monitor.md +74 -0
- package/assets/favicon.png +0 -0
- package/assets/logo-light.png +0 -0
- package/assets/logo.png +0 -0
- package/assets/logo.svg +6 -0
- package/assets/og.png +0 -0
- package/bin/install.mjs +1127 -0
- package/bin/kenji.js +2 -0
- package/commands/adr.md +17 -0
- package/commands/aeo-plan.md +18 -0
- package/commands/arch-boundaries.md +17 -0
- package/commands/aso-plan.md +18 -0
- package/commands/auth-flows.md +19 -0
- package/commands/backup-plan.md +17 -0
- package/commands/burndown-full.md +25 -0
- package/commands/capacitor-plan.md +18 -0
- package/commands/codemod-safety.md +22 -0
- package/commands/commit.md +18 -0
- package/commands/complete-everything.md +40 -0
- package/commands/cost-plan.md +19 -0
- package/commands/deadcode-plan.md +26 -0
- package/commands/deadcode.md +32 -0
- package/commands/debug-issue.md +17 -0
- package/commands/deps-plan.md +18 -0
- package/commands/docs-plan.md +17 -0
- package/commands/doctrine.md +19 -0
- package/commands/error-plan.md +19 -0
- package/commands/feedback-to-closure.md +36 -0
- package/commands/fix-issue.md +76 -0
- package/commands/gate-logic.md +26 -0
- package/commands/green-repo.md +36 -0
- package/commands/grill-me.md +19 -0
- package/commands/gtm-plan.md +21 -0
- package/commands/gtm-weekly.md +17 -0
- package/commands/gtm.md +22 -0
- package/commands/handoff.md +15 -0
- package/commands/housekeep-backlog.md +18 -0
- package/commands/housekeep-files.md +22 -0
- package/commands/housekeep-gates.md +18 -0
- package/commands/instant-nav.md +11 -0
- package/commands/integrity-plan.md +19 -0
- package/commands/launch-kit.md +16 -0
- package/commands/mcp-guide.md +40 -0
- package/commands/mobile-plan.md +19 -0
- package/commands/native-rn-monorepo/README.md +78 -0
- package/commands/native-rn-monorepo/android-build.md +26 -0
- package/commands/native-rn-monorepo/android-install.md +32 -0
- package/commands/native-rn-monorepo/android-logcat.md +37 -0
- package/commands/native-rn-monorepo/ios-ci-logs.md +56 -0
- package/commands/native-rn-monorepo/ios-ci-status.md +52 -0
- package/commands/native-rn-monorepo/ios-ci-trigger.md +59 -0
- package/commands/native-rn-monorepo/rn-reset.md +50 -0
- package/commands/native-rn-monorepo/rn-ship-ios.md +67 -0
- package/commands/native-rn-monorepo/rn-verify.md +53 -0
- package/commands/perf-plan.md +18 -0
- package/commands/plan-mode.md +74 -0
- package/commands/pr.md +16 -0
- package/commands/pricing-plan.md +20 -0
- package/commands/privacy-plan.md +18 -0
- package/commands/readability.md +12 -0
- package/commands/readme.md +15 -0
- package/commands/refactor.md +15 -0
- package/commands/release-prep.md +17 -0
- package/commands/research.md +25 -0
- package/commands/responsive-audit.md +21 -0
- package/commands/review-code.md +18 -0
- package/commands/rls-plan.md +18 -0
- package/commands/secrets-plan.md +18 -0
- package/commands/security-plan.md +19 -0
- package/commands/ship-and-observe.md +36 -0
- package/commands/skill-conflicts.md +19 -0
- package/commands/slop-plan.md +18 -0
- package/commands/stub-plan.md +18 -0
- package/commands/test-mutation.md +16 -0
- package/commands/test-plan.md +17 -0
- package/commands/test.md +29 -0
- package/commands/thirdparty-web-interface-guidelines.md +185 -0
- package/commands/uiux-plan.md +18 -0
- package/commands/uiux.md +45 -0
- package/commands/update-deps.md +21 -0
- package/commands/validation-plan.md +19 -0
- package/commands-portable/fix-issue.md +72 -0
- package/commands-portable/plan-mode.md +92 -0
- package/commands-portable/research.md +91 -0
- package/docs/screenshots/README.md +5 -0
- package/docs/screenshots/audit-dark.png +0 -0
- package/docs/screenshots/build-dark.png +0 -0
- package/docs/screenshots/grill-dark.png +0 -0
- package/docs/screenshots/hero-dark.png +0 -0
- package/docs/screenshots/hero-light.png +0 -0
- package/docs/screenshots/ship-dark.png +0 -0
- package/docs/screenshots/src/showcase.html +320 -0
- package/hooks/completion-gate.mjs +258 -0
- package/hooks/cursor-hooks.json +13 -0
- package/hooks/hooks.json +15 -0
- package/install.sh +21 -0
- package/llms.txt +40 -0
- package/mcp/README.md +266 -0
- package/mcp/VERSIONS.md +41 -0
- package/mcp/mcp-full.json.template +124 -0
- package/mcp/mcp.json.template +29 -0
- package/mcp/pinned-versions.json +27 -0
- package/package.json +93 -4
- package/rules/approved-plan-execution.mdc +65 -0
- package/rules/full-stack-ship-discipline.mdc +37 -0
- package/rules/native-rn-monorepo/README.md +63 -0
- package/rules/native-rn-monorepo/_project.mdc +69 -0
- package/rules/native-rn-monorepo/native-android.mdc +72 -0
- package/rules/native-rn-monorepo/native-ios.mdc +61 -0
- package/rules/native-rn-monorepo/react-native-js.mdc +78 -0
- package/rules/native-rn-monorepo/web.mdc +60 -0
- package/rules/project-starter/components.mdc +54 -0
- package/rules/project-starter/data-fetching.mdc +77 -0
- package/rules/project-starter/git.mdc +41 -0
- package/rules/project-starter/supabase.mdc +37 -0
- package/rules/project-starter/tailwind.mdc +48 -0
- package/rules/project-starter/typescript.mdc +36 -0
- package/rules/project-starter/web-performance.mdc +42 -0
- package/rules/senior-engineer.mdc +30 -0
- package/rules/shell-first-search.mdc +19 -0
- package/rules/skill-workflows.mdc +35 -0
- package/rules/verification-before-completion.mdc +57 -0
- package/skills/audit-accessibility/SKILL.md +441 -0
- package/skills/audit-agent-speed/SKILL.md +181 -0
- package/skills/audit-agent-speed/scripts/stop-typecheck.mjs +151 -0
- package/skills/audit-analytics/SKILL.md +138 -0
- package/skills/audit-auth-flows/SKILL.md +267 -0
- package/skills/audit-backend-architecture/SKILL.md +266 -0
- package/skills/audit-backend-architecture/references/patterns.md +386 -0
- package/skills/audit-bundle-size/SKILL.md +296 -0
- package/skills/audit-cicd/SKILL.md +218 -0
- package/skills/audit-code-quality/SKILL.md +314 -0
- package/skills/audit-code-review/SKILL.md +289 -0
- package/skills/audit-codemod-safety/SKILL.md +159 -0
- package/skills/audit-db-schema/SKILL.md +465 -0
- package/skills/audit-db-schema/references/details.md +110 -0
- package/skills/audit-doctrine/SKILL.md +189 -0
- package/skills/audit-env-parity/SKILL.md +133 -0
- package/skills/audit-fe-api/SKILL.md +458 -0
- package/skills/audit-gate-logic/SKILL.md +219 -0
- package/skills/audit-i18n/SKILL.md +339 -0
- package/skills/audit-infra-cost/SKILL.md +142 -0
- package/skills/audit-langfuse-llm/SKILL.md +468 -0
- package/skills/audit-langfuse-llm/references/details.md +226 -0
- package/skills/audit-llm-security/SKILL.md +147 -0
- package/skills/audit-monetization-iap/SKILL.md +137 -0
- package/skills/audit-payment-system/SKILL.md +268 -0
- package/skills/audit-payment-system/references/checklist.md +283 -0
- package/skills/audit-performance/SKILL.md +383 -0
- package/skills/audit-performance/references/loading-priority-2026.md +81 -0
- package/skills/audit-realworld/SKILL.md +287 -0
- package/skills/audit-registry-listing/SKILL.md +122 -0
- package/skills/audit-resilience/SKILL.md +154 -0
- package/skills/audit-responsive/SKILL.md +221 -0
- package/skills/audit-responsive/references/checklist.md +166 -0
- package/skills/audit-security/SKILL.md +289 -0
- package/skills/audit-skill-conflicts/SKILL.md +178 -0
- package/skills/audit-ui-states/SKILL.md +146 -0
- package/skills/audit-uiux-design-system/SKILL.md +475 -0
- package/skills/audit-uiux-design-system/references/details.md +71 -0
- package/skills/audit-ux/SKILL.md +379 -0
- package/skills/audit-ux/references/details.md +245 -0
- package/skills/audit-ux-journeys/SKILL.md +215 -0
- package/skills/audit-ux-journeys/references/checklist.md +179 -0
- package/skills/backend-db-performance/SKILL.md +441 -0
- package/skills/backend-error-handling/SKILL.md +489 -0
- package/skills/backend-error-handling/references/details.md +58 -0
- package/skills/backend-observability/SKILL.md +88 -0
- package/skills/backend-patterns/SKILL.md +499 -0
- package/skills/backend-patterns/references/architecture-patterns.md +298 -0
- package/skills/backend-realtime/SKILL.md +403 -0
- package/skills/backend-realtime/references/patterns.md +74 -0
- package/skills/burndown-full/SKILL.md +174 -0
- package/skills/complete-everything/SKILL.md +295 -0
- package/skills/data-pipeline/SKILL.md +109 -0
- package/skills/data-visualization/SKILL.md +488 -0
- package/skills/debug-error/SKILL.md +322 -0
- package/skills/debug-fe-be-integration/SKILL.md +459 -0
- package/skills/debug-sentry-monitor/SKILL.md +497 -0
- package/skills/debug-sentry-monitor/references/details.md +165 -0
- package/skills/deploy-npm/SKILL.md +394 -0
- package/skills/deploy-npm/references/example-mushi-mushi.md +52 -0
- package/skills/deploy-verify/SKILL.md +489 -0
- package/skills/design-api/SKILL.md +379 -0
- package/skills/design-canvas/SKILL.md +155 -0
- package/skills/design-email/SKILL.md +370 -0
- package/skills/design-frontend/SKILL.md +143 -0
- package/skills/design-generative-art/SKILL.md +474 -0
- package/skills/design-mobile-first/SKILL.md +506 -0
- package/skills/design-motion/SKILL.md +333 -0
- package/skills/design-motion/references/delight-interactions.md +191 -0
- package/skills/design-prd/SKILL.md +443 -0
- package/skills/design-system/SKILL.md +457 -0
- package/skills/design-theme/SKILL.md +226 -0
- package/skills/design-theme/themes/tsumagoi-ranch.md +150 -0
- package/skills/docs-adr/SKILL.md +168 -0
- package/skills/docs-coauthor/SKILL.md +368 -0
- package/skills/docs-comparison-pages/SKILL.md +117 -0
- package/skills/docs-domain-modeling/SKILL.md +97 -0
- package/skills/docs-launch-kit/SKILL.md +139 -0
- package/skills/docs-writer/SKILL.md +469 -0
- package/skills/enhance-agent-guardrails/SKILL.md +164 -0
- package/skills/enhance-arch-boundaries/SKILL.md +154 -0
- package/skills/enhance-capacitor-ui/SKILL.md +463 -0
- package/skills/enhance-capacitor-ui/references/details.md +750 -0
- package/skills/enhance-email-deliverability/SKILL.md +143 -0
- package/skills/enhance-growth-loops/SKILL.md +122 -0
- package/skills/enhance-lifecycle-email/SKILL.md +130 -0
- package/skills/enhance-motion/SKILL.md +193 -0
- package/skills/enhance-onboarding/SKILL.md +148 -0
- package/skills/enhance-pwa/SKILL.md +304 -0
- package/skills/enhance-readability/SKILL.md +146 -0
- package/skills/enhance-readme/SKILL.md +496 -0
- package/skills/enhance-readme/package-lock.json +187 -0
- package/skills/enhance-readme/package.json +17 -0
- package/skills/enhance-readme/scripts/generate-readme-blocks.mjs +199 -0
- package/skills/enhance-readme/scripts/record-readme-tour.mjs +442 -0
- package/skills/enhance-skill-prompts/SKILL.md +167 -0
- package/skills/enhance-skill-prompts/references/exemplar-audit-auth-flows.md +311 -0
- package/skills/enhance-web-conversion/SKILL.md +155 -0
- package/skills/enhance-web-forms/SKILL.md +154 -0
- package/skills/enhance-web-instant-nav/SKILL.md +138 -0
- package/skills/enhance-web-instant-nav/references/bfcache-blockers.md +23 -0
- package/skills/enhance-web-instant-nav/references/early-hints.md +33 -0
- package/skills/enhance-web-instant-nav/references/speculation-rules.md +44 -0
- package/skills/enhance-web-landing/SKILL.md +459 -0
- package/skills/enhance-web-landing/references/details.md +773 -0
- package/skills/enhance-web-redesign/SKILL.md +228 -0
- package/skills/enhance-web-seo/SKILL.md +276 -0
- package/skills/enhance-web-ui/SKILL.md +473 -0
- package/skills/enhance-web-ui/references/details.md +674 -0
- package/skills/enhance-web-ux/HEURISTICS.md +242 -0
- package/skills/enhance-web-ux/PATTERNS.md +375 -0
- package/skills/enhance-web-ux/SKILL.md +464 -0
- package/skills/enhance-web-ux/examples.md +222 -0
- package/skills/enhance-web-ux/references/details.md +406 -0
- package/skills/enhance-web-web3d/SKILL.md +397 -0
- package/skills/enhance-web-web3d/references/css-canvas-effects.md +180 -0
- package/skills/handoff/SKILL.md +66 -0
- package/skills/housekeep-backlog/SKILL.md +149 -0
- package/skills/housekeep-dead-code/SKILL.md +387 -0
- package/skills/housekeep-dead-code/references/ratchet-ci.md +205 -0
- package/skills/housekeep-dead-code/references/supabase-hygiene.md +152 -0
- package/skills/housekeep-design/SKILL.md +207 -0
- package/skills/housekeep-files/SKILL.md +220 -0
- package/skills/housekeep-files/references/naming-and-catalog.md +86 -0
- package/skills/housekeep-files/scripts/housekeep-files.ps1 +360 -0
- package/skills/housekeep-files/scripts/housekeep-files.sh +238 -0
- package/skills/housekeep-gates/SKILL.md +174 -0
- package/skills/iterate-agent-harness/SKILL.md +137 -0
- package/skills/iterate-gtm-weekly/SKILL.md +103 -0
- package/skills/iterate-post-launch/SKILL.md +292 -0
- package/skills/meta-mcp-builder/SKILL.md +313 -0
- package/skills/meta-skill-creator/SKILL.md +304 -0
- package/skills/mobile-capacitor-platform/SKILL.md +104 -0
- package/skills/mobile-emulator-start/SKILL.md +296 -0
- package/skills/mobile-emulator-test/SKILL.md +491 -0
- package/skills/mobile-emulator-test/references/details.md +478 -0
- package/skills/mobile-rn-performance/SKILL.md +107 -0
- package/skills/mobile-rn-screen/SKILL.md +476 -0
- package/skills/mobile-rn-screen/references/details.md +785 -0
- package/skills/mushi-health/SKILL.md +206 -0
- package/skills/mushi-integration/SKILL.md +257 -0
- package/skills/plan-aeo-readiness/SKILL.md +166 -0
- package/skills/plan-antislop/SKILL.md +281 -0
- package/skills/plan-aso/SKILL.md +149 -0
- package/skills/plan-backup-dr/SKILL.md +131 -0
- package/skills/plan-capacitor-hardening/SKILL.md +217 -0
- package/skills/plan-data-integrity/SKILL.md +187 -0
- package/skills/plan-dead-code/SKILL.md +386 -0
- package/skills/plan-dead-code/references/knip-config.md +214 -0
- package/skills/plan-dead-code/references/output-templates.md +133 -0
- package/skills/plan-dead-code/references/preservation-contract.md +50 -0
- package/skills/plan-dead-code/references/residue-greps.md +84 -0
- package/skills/plan-dependency-provenance/SKILL.md +200 -0
- package/skills/plan-docs-sync/SKILL.md +143 -0
- package/skills/plan-docs-sync/references/drift-taxonomy.md +43 -0
- package/skills/plan-docs-sync/references/output-templates.md +33 -0
- package/skills/plan-docs-sync/references/preservation-contract.md +17 -0
- package/skills/plan-error-handling/SKILL.md +205 -0
- package/skills/plan-gtm/SKILL.md +276 -0
- package/skills/plan-gtm/references/benchmarks-2026.md +183 -0
- package/skills/plan-input-validation/SKILL.md +179 -0
- package/skills/plan-llm-cost-guardrails/SKILL.md +176 -0
- package/skills/plan-mobile-readiness/SKILL.md +171 -0
- package/skills/plan-perf-audit/SKILL.md +145 -0
- package/skills/plan-perf-audit/references/audit-scope.md +51 -0
- package/skills/plan-perf-audit/references/output-templates.md +33 -0
- package/skills/plan-perf-audit/references/preservation-contract.md +13 -0
- package/skills/plan-pricing/SKILL.md +173 -0
- package/skills/plan-privacy-compliance/SKILL.md +148 -0
- package/skills/plan-rls-audit/SKILL.md +231 -0
- package/skills/plan-secrets-audit/SKILL.md +181 -0
- package/skills/plan-security-audit/SKILL.md +168 -0
- package/skills/plan-security-audit/references/output-templates.md +36 -0
- package/skills/plan-security-audit/references/owasp-supabase-scope.md +55 -0
- package/skills/plan-security-audit/references/preservation-contract.md +18 -0
- package/skills/plan-stub-checker/SKILL.md +216 -0
- package/skills/plan-stub-checker/references/detection-methodology.md +75 -0
- package/skills/plan-stub-checker/references/detection-taxonomy.md +34 -0
- package/skills/plan-stub-checker/references/output-templates.md +63 -0
- package/skills/plan-stub-checker/references/preservation-contract.md +24 -0
- package/skills/plan-test-coverage/SKILL.md +170 -0
- package/skills/plan-test-coverage/references/methodology.md +54 -0
- package/skills/plan-test-coverage/references/output-templates.md +34 -0
- package/skills/plan-test-coverage/references/preservation-contract.md +15 -0
- package/skills/plan-uiux-unification/SKILL.md +230 -0
- package/skills/plan-uiux-unification/references/output-templates.md +67 -0
- package/skills/plan-uiux-unification/references/phase-workbook.md +85 -0
- package/skills/plan-uiux-unification/references/preservation-contract.md +24 -0
- package/skills/protocol-browser-anti-stall/SKILL.md +211 -0
- package/skills/protocol-browser-anti-stall/references/mcp-to-cli-map.md +113 -0
- package/skills/protocol-browser-anti-stall/references/playwright-session-coordination.md +170 -0
- package/skills/research/SKILL.md +422 -0
- package/skills/test-exploratory/SKILL.md +165 -0
- package/skills/test-exploratory/references/charter-template.md +29 -0
- package/skills/test-load/SKILL.md +126 -0
- package/skills/test-mutation/SKILL.md +160 -0
- package/skills/test-playwright/SKILL.md +354 -0
- package/skills/test-qa/SKILL.md +364 -0
- package/skills/test-qa/references/details.md +268 -0
- package/skills/test-red-team/SKILL.md +387 -0
- package/skills/test-red-team/references/owasp-attack-checklist.md +193 -0
- package/skills/test-unit/SKILL.md +259 -0
- package/skills/test-unit/references/details.md +267 -0
- package/skills/test-visual-regression/SKILL.md +132 -0
- package/skills/thirdparty-emil-design-eng/ATTRIBUTION.md +20 -0
- package/skills/thirdparty-emil-design-eng/SKILL.md +21 -0
- package/skills/thirdparty-emil-design-eng/references/emil-design-eng.md +676 -0
- package/skills/thirdparty-ui-ux-pro-max/ATTRIBUTION.md +22 -0
- package/skills/thirdparty-ui-ux-pro-max/SKILL.md +304 -0
- package/skills/thirdparty-ui-ux-pro-max/data/charts.csv +26 -0
- package/skills/thirdparty-ui-ux-pro-max/data/colors.csv +97 -0
- package/skills/thirdparty-ui-ux-pro-max/data/icons.csv +101 -0
- package/skills/thirdparty-ui-ux-pro-max/data/landing.csv +31 -0
- package/skills/thirdparty-ui-ux-pro-max/data/products.csv +97 -0
- package/skills/thirdparty-ui-ux-pro-max/data/react-performance.csv +45 -0
- package/skills/thirdparty-ui-ux-pro-max/data/stacks/astro.csv +54 -0
- package/skills/thirdparty-ui-ux-pro-max/data/stacks/flutter.csv +53 -0
- package/skills/thirdparty-ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
- package/skills/thirdparty-ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
- package/skills/thirdparty-ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
- package/skills/thirdparty-ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
- package/skills/thirdparty-ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
- package/skills/thirdparty-ui-ux-pro-max/data/stacks/react-native.csv +52 -0
- package/skills/thirdparty-ui-ux-pro-max/data/stacks/react.csv +54 -0
- package/skills/thirdparty-ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
- package/skills/thirdparty-ui-ux-pro-max/data/stacks/svelte.csv +54 -0
- package/skills/thirdparty-ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
- package/skills/thirdparty-ui-ux-pro-max/data/stacks/vue.csv +50 -0
- package/skills/thirdparty-ui-ux-pro-max/data/styles.csv +68 -0
- package/skills/thirdparty-ui-ux-pro-max/data/typography.csv +58 -0
- package/skills/thirdparty-ui-ux-pro-max/data/ui-reasoning.csv +101 -0
- package/skills/thirdparty-ui-ux-pro-max/data/ux-guidelines.csv +100 -0
- package/skills/thirdparty-ui-ux-pro-max/data/web-interface.csv +31 -0
- package/skills/thirdparty-ui-ux-pro-max/scripts/core.py +253 -0
- package/skills/thirdparty-ui-ux-pro-max/scripts/design_system.py +1067 -0
- package/skills/thirdparty-ui-ux-pro-max/scripts/search.py +114 -0
- package/skills/thirdparty-web-interface-guidelines/ATTRIBUTION.md +23 -0
- package/skills/thirdparty-web-interface-guidelines/SKILL.md +190 -0
- package/skills/workflow-build-feature/SKILL.md +118 -0
- package/skills/workflow-coding-discipline/SKILL.md +140 -0
- package/skills/workflow-environment-ready/SKILL.md +128 -0
- package/skills/workflow-feature-flag/SKILL.md +262 -0
- package/skills/workflow-feedback-to-closure/SKILL.md +165 -0
- package/skills/workflow-fix-and-ship/SKILL.md +136 -0
- package/skills/workflow-git-commit/SKILL.md +200 -0
- package/skills/workflow-green-repo/SKILL.md +166 -0
- package/skills/workflow-grilling/SKILL.md +73 -0
- package/skills/workflow-gtm/SKILL.md +153 -0
- package/skills/workflow-housekeep/SKILL.md +453 -0
- package/skills/workflow-housekeep/references/templates.md +109 -0
- package/skills/workflow-launch-ready/SKILL.md +145 -0
- package/skills/workflow-merge-conflicts/SKILL.md +62 -0
- package/skills/workflow-onboard/SKILL.md +99 -0
- package/skills/workflow-parallel-agents/SKILL.md +164 -0
- package/skills/workflow-pr/SKILL.md +197 -0
- package/skills/workflow-quality-gate/SKILL.md +147 -0
- package/skills/workflow-refactor/SKILL.md +274 -0
- package/skills/workflow-release-prep/SKILL.md +207 -0
- package/skills/workflow-ship-and-observe/SKILL.md +164 -0
- package/skills/workflow-spec-tdd/SKILL.md +141 -0
- package/skills/workflow-spec-tdd/references/spec-template.md +126 -0
- package/skills/workflow-spec-tdd/references/tdd-patterns.md +167 -0
- package/skills-cursor/babysit/SKILL.md +17 -0
- package/skills-cursor/canvas/SKILL.md +142 -0
- package/skills-cursor/canvas/sdk/canvas-tokens.d.ts +235 -0
- package/skills-cursor/canvas/sdk/chart-primitives.d.ts +200 -0
- package/skills-cursor/canvas/sdk/dag-layout.d.ts +102 -0
- package/skills-cursor/canvas/sdk/diff-view.d.ts +130 -0
- package/skills-cursor/canvas/sdk/form-primitives.d.ts +194 -0
- package/skills-cursor/canvas/sdk/hooks.d.ts +117 -0
- package/skills-cursor/canvas/sdk/index.d.ts +47 -0
- package/skills-cursor/canvas/sdk/theme.d.ts +61 -0
- package/skills-cursor/canvas/sdk/todo-list.d.ts +49 -0
- package/skills-cursor/canvas/sdk/ui-primitives.d.ts +549 -0
- package/skills-cursor/canvas/sdk/ui-primitives.test.d.ts +2 -0
- package/skills-cursor/create-hook/SKILL.md +238 -0
- package/skills-cursor/create-rule/SKILL.md +185 -0
- package/skills-cursor/create-skill/SKILL.md +269 -0
- package/skills-cursor/create-skill/references/authoring-guide.md +182 -0
- package/skills-cursor/create-subagent/SKILL.md +228 -0
- package/skills-cursor/migrate-to-skills/SKILL.md +121 -0
- package/skills-cursor/shell/SKILL.md +22 -0
- package/skills-cursor/split-to-prs/SKILL.md +47 -0
- package/skills-cursor/statusline/SKILL.md +193 -0
- package/skills-cursor/update-cli-config/SKILL.md +85 -0
- package/skills-cursor/update-cursor-settings/SKILL.md +137 -0
- package/skills.sh.json +296 -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
|