claudecode-omc 5.5.2 → 5.6.1
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/.local/skills/de-ai-writing/SKILL.md +243 -0
- package/.local/skills/de-ai-writing/references/chinese-patterns.md +152 -0
- package/.local/skills/de-ai-writing/references/chinese-signals.md +121 -0
- package/.local/skills/de-ai-writing/references/domain-playbooks.md +120 -0
- package/.local/skills/de-ai-writing/references/wikipedia-signs.md +196 -0
- package/README.md +102 -10
- package/bundled/manifest.json +3 -2
- package/bundled/upstream/ecc/.omc-source/bundle.json +23 -0
- package/bundled/upstream/ecc/.omc-source/last-plan-apply.json +439 -0
- package/bundled/upstream/ecc/.omc-source/manifests/.claude-plugin/marketplace.json +47 -0
- package/bundled/upstream/ecc/agents/a11y-architect.md +141 -0
- package/bundled/upstream/ecc/agents/architect.md +211 -0
- package/bundled/upstream/ecc/agents/build-error-resolver.md +114 -0
- package/bundled/upstream/ecc/agents/chief-of-staff.md +151 -0
- package/bundled/upstream/ecc/agents/code-architect.md +71 -0
- package/bundled/upstream/ecc/agents/code-explorer.md +69 -0
- package/bundled/upstream/ecc/agents/code-reviewer.md +237 -0
- package/bundled/upstream/ecc/agents/code-simplifier.md +47 -0
- package/bundled/upstream/ecc/agents/comment-analyzer.md +45 -0
- package/bundled/upstream/ecc/agents/conversation-analyzer.md +52 -0
- package/bundled/upstream/ecc/agents/cpp-build-resolver.md +90 -0
- package/bundled/upstream/ecc/agents/cpp-reviewer.md +72 -0
- package/bundled/upstream/ecc/agents/csharp-reviewer.md +101 -0
- package/bundled/upstream/ecc/agents/dart-build-resolver.md +201 -0
- package/bundled/upstream/ecc/agents/database-reviewer.md +91 -0
- package/bundled/upstream/ecc/agents/doc-updater.md +107 -0
- package/bundled/upstream/ecc/agents/docs-lookup.md +68 -0
- package/bundled/upstream/ecc/agents/e2e-runner.md +107 -0
- package/bundled/upstream/ecc/agents/flutter-reviewer.md +243 -0
- package/bundled/upstream/ecc/agents/gan-evaluator.md +209 -0
- package/bundled/upstream/ecc/agents/gan-generator.md +131 -0
- package/bundled/upstream/ecc/agents/gan-planner.md +99 -0
- package/bundled/upstream/ecc/agents/go-build-resolver.md +94 -0
- package/bundled/upstream/ecc/agents/go-reviewer.md +76 -0
- package/bundled/upstream/ecc/agents/harness-optimizer.md +35 -0
- package/bundled/upstream/ecc/agents/healthcare-reviewer.md +83 -0
- package/bundled/upstream/ecc/agents/java-build-resolver.md +153 -0
- package/bundled/upstream/ecc/agents/java-reviewer.md +92 -0
- package/bundled/upstream/ecc/agents/kotlin-build-resolver.md +118 -0
- package/bundled/upstream/ecc/agents/kotlin-reviewer.md +159 -0
- package/bundled/upstream/ecc/agents/loop-operator.md +36 -0
- package/bundled/upstream/ecc/agents/opensource-forker.md +198 -0
- package/bundled/upstream/ecc/agents/opensource-packager.md +249 -0
- package/bundled/upstream/ecc/agents/opensource-sanitizer.md +188 -0
- package/bundled/upstream/ecc/agents/performance-optimizer.md +446 -0
- package/bundled/upstream/ecc/agents/planner.md +212 -0
- package/bundled/upstream/ecc/agents/pr-test-analyzer.md +45 -0
- package/bundled/upstream/ecc/agents/python-reviewer.md +98 -0
- package/bundled/upstream/ecc/agents/pytorch-build-resolver.md +120 -0
- package/bundled/upstream/ecc/agents/refactor-cleaner.md +85 -0
- package/bundled/upstream/ecc/agents/rust-build-resolver.md +148 -0
- package/bundled/upstream/ecc/agents/rust-reviewer.md +94 -0
- package/bundled/upstream/ecc/agents/security-reviewer.md +108 -0
- package/bundled/upstream/ecc/agents/seo-specialist.md +62 -0
- package/bundled/upstream/ecc/agents/silent-failure-hunter.md +50 -0
- package/bundled/upstream/ecc/agents/tdd-guide.md +91 -0
- package/bundled/upstream/ecc/agents/type-design-analyzer.md +41 -0
- package/bundled/upstream/ecc/agents/typescript-reviewer.md +112 -0
- package/bundled/upstream/ecc/commands/agent-sort.md +23 -0
- package/bundled/upstream/ecc/commands/aside.md +164 -0
- package/bundled/upstream/ecc/commands/build-fix.md +62 -0
- package/bundled/upstream/ecc/commands/checkpoint.md +74 -0
- package/bundled/upstream/ecc/commands/claw.md +23 -0
- package/bundled/upstream/ecc/commands/code-review.md +289 -0
- package/bundled/upstream/ecc/commands/context-budget.md +23 -0
- package/bundled/upstream/ecc/commands/cpp-build.md +173 -0
- package/bundled/upstream/ecc/commands/cpp-review.md +132 -0
- package/bundled/upstream/ecc/commands/cpp-test.md +251 -0
- package/bundled/upstream/ecc/commands/devfleet.md +23 -0
- package/bundled/upstream/ecc/commands/docs.md +23 -0
- package/bundled/upstream/ecc/commands/e2e.md +268 -0
- package/bundled/upstream/ecc/commands/eval.md +23 -0
- package/bundled/upstream/ecc/commands/evolve.md +178 -0
- package/bundled/upstream/ecc/commands/feature-dev.md +49 -0
- package/bundled/upstream/ecc/commands/flutter-build.md +164 -0
- package/bundled/upstream/ecc/commands/flutter-review.md +116 -0
- package/bundled/upstream/ecc/commands/flutter-test.md +144 -0
- package/bundled/upstream/ecc/commands/gan-build.md +99 -0
- package/bundled/upstream/ecc/commands/gan-design.md +35 -0
- package/bundled/upstream/ecc/commands/go-build.md +183 -0
- package/bundled/upstream/ecc/commands/go-review.md +148 -0
- package/bundled/upstream/ecc/commands/go-test.md +268 -0
- package/bundled/upstream/ecc/commands/gradle-build.md +70 -0
- package/bundled/upstream/ecc/commands/harness-audit.md +73 -0
- package/bundled/upstream/ecc/commands/hookify-configure.md +14 -0
- package/bundled/upstream/ecc/commands/hookify-help.md +46 -0
- package/bundled/upstream/ecc/commands/hookify-list.md +21 -0
- package/bundled/upstream/ecc/commands/hookify.md +50 -0
- package/bundled/upstream/ecc/commands/instinct-export.md +66 -0
- package/bundled/upstream/ecc/commands/instinct-import.md +114 -0
- package/bundled/upstream/ecc/commands/instinct-status.md +59 -0
- package/bundled/upstream/ecc/commands/jira.md +106 -0
- package/bundled/upstream/ecc/commands/kotlin-build.md +174 -0
- package/bundled/upstream/ecc/commands/kotlin-review.md +140 -0
- package/bundled/upstream/ecc/commands/kotlin-test.md +312 -0
- package/bundled/upstream/ecc/commands/learn-eval.md +116 -0
- package/bundled/upstream/ecc/commands/learn.md +70 -0
- package/bundled/upstream/ecc/commands/loop-start.md +32 -0
- package/bundled/upstream/ecc/commands/loop-status.md +24 -0
- package/bundled/upstream/ecc/commands/model-route.md +26 -0
- package/bundled/upstream/ecc/commands/multi-backend.md +158 -0
- package/bundled/upstream/ecc/commands/multi-execute.md +315 -0
- package/bundled/upstream/ecc/commands/multi-frontend.md +158 -0
- package/bundled/upstream/ecc/commands/multi-plan.md +268 -0
- package/bundled/upstream/ecc/commands/multi-workflow.md +191 -0
- package/bundled/upstream/ecc/commands/orchestrate.md +135 -0
- package/bundled/upstream/ecc/commands/plan.md +117 -0
- package/bundled/upstream/ecc/commands/pm2.md +272 -0
- package/bundled/upstream/ecc/commands/projects.md +39 -0
- package/bundled/upstream/ecc/commands/promote.md +41 -0
- package/bundled/upstream/ecc/commands/prompt-optimize.md +23 -0
- package/bundled/upstream/ecc/commands/prp-commit.md +112 -0
- package/bundled/upstream/ecc/commands/prp-implement.md +385 -0
- package/bundled/upstream/ecc/commands/prp-plan.md +502 -0
- package/bundled/upstream/ecc/commands/prp-pr.md +184 -0
- package/bundled/upstream/ecc/commands/prp-prd.md +447 -0
- package/bundled/upstream/ecc/commands/prune.md +31 -0
- package/bundled/upstream/ecc/commands/python-review.md +297 -0
- package/bundled/upstream/ecc/commands/quality-gate.md +29 -0
- package/bundled/upstream/ecc/commands/refactor-clean.md +80 -0
- package/bundled/upstream/ecc/commands/resume-session.md +156 -0
- package/bundled/upstream/ecc/commands/review-pr.md +37 -0
- package/bundled/upstream/ecc/commands/rules-distill.md +20 -0
- package/bundled/upstream/ecc/commands/rust-build.md +187 -0
- package/bundled/upstream/ecc/commands/rust-review.md +142 -0
- package/bundled/upstream/ecc/commands/rust-test.md +308 -0
- package/bundled/upstream/ecc/commands/santa-loop.md +175 -0
- package/bundled/upstream/ecc/commands/save-session.md +275 -0
- package/bundled/upstream/ecc/commands/sessions.md +339 -0
- package/bundled/upstream/ecc/commands/setup-pm.md +80 -0
- package/bundled/upstream/ecc/commands/skill-create.md +174 -0
- package/bundled/upstream/ecc/commands/skill-health.md +54 -0
- package/bundled/upstream/ecc/commands/tdd.md +231 -0
- package/bundled/upstream/ecc/commands/test-coverage.md +69 -0
- package/bundled/upstream/ecc/commands/update-codemaps.md +72 -0
- package/bundled/upstream/ecc/commands/update-docs.md +84 -0
- package/bundled/upstream/ecc/commands/verify.md +23 -0
- package/bundled/upstream/ecc/hooks/README.md +237 -0
- package/bundled/upstream/ecc/hooks/hooks.json +330 -0
- package/bundled/upstream/ecc/skills/accessibility/SKILL.md +146 -0
- package/bundled/upstream/ecc/skills/agent-eval/SKILL.md +145 -0
- package/bundled/upstream/ecc/skills/agent-harness-construction/SKILL.md +73 -0
- package/bundled/upstream/ecc/skills/agent-introspection-debugging/SKILL.md +153 -0
- package/bundled/upstream/ecc/skills/agent-payment-x402/SKILL.md +178 -0
- package/bundled/upstream/ecc/skills/agent-sort/SKILL.md +215 -0
- package/bundled/upstream/ecc/skills/agentic-engineering/SKILL.md +63 -0
- package/bundled/upstream/ecc/skills/ai-first-engineering/SKILL.md +51 -0
- package/bundled/upstream/ecc/skills/ai-regression-testing/SKILL.md +385 -0
- package/bundled/upstream/ecc/skills/android-clean-architecture/SKILL.md +339 -0
- package/bundled/upstream/ecc/skills/api-connector-builder/SKILL.md +120 -0
- package/bundled/upstream/ecc/skills/api-design/SKILL.md +523 -0
- package/bundled/upstream/ecc/skills/architecture-decision-records/SKILL.md +179 -0
- package/bundled/upstream/ecc/skills/article-writing/SKILL.md +79 -0
- package/bundled/upstream/ecc/skills/automation-audit-ops/SKILL.md +142 -0
- package/bundled/upstream/ecc/skills/autonomous-agent-harness/SKILL.md +267 -0
- package/bundled/upstream/ecc/skills/autonomous-loops/SKILL.md +610 -0
- package/bundled/upstream/ecc/skills/backend-patterns/SKILL.md +598 -0
- package/bundled/upstream/ecc/skills/benchmark/SKILL.md +93 -0
- package/bundled/upstream/ecc/skills/blueprint/SKILL.md +105 -0
- package/bundled/upstream/ecc/skills/brand-voice/SKILL.md +97 -0
- package/bundled/upstream/ecc/skills/brand-voice/references/voice-profile-schema.md +55 -0
- package/bundled/upstream/ecc/skills/browser-qa/SKILL.md +87 -0
- package/bundled/upstream/ecc/skills/bun-runtime/SKILL.md +84 -0
- package/bundled/upstream/ecc/skills/canary-watch/SKILL.md +99 -0
- package/bundled/upstream/ecc/skills/carrier-relationship-management/SKILL.md +212 -0
- package/bundled/upstream/ecc/skills/ck/SKILL.md +147 -0
- package/bundled/upstream/ecc/skills/ck/commands/forget.mjs +44 -0
- package/bundled/upstream/ecc/skills/ck/commands/info.mjs +24 -0
- package/bundled/upstream/ecc/skills/ck/commands/init.mjs +143 -0
- package/bundled/upstream/ecc/skills/ck/commands/list.mjs +40 -0
- package/bundled/upstream/ecc/skills/ck/commands/migrate.mjs +202 -0
- package/bundled/upstream/ecc/skills/ck/commands/resume.mjs +36 -0
- package/bundled/upstream/ecc/skills/ck/commands/save.mjs +210 -0
- package/bundled/upstream/ecc/skills/ck/commands/shared.mjs +387 -0
- package/bundled/upstream/ecc/skills/ck/hooks/session-start.mjs +224 -0
- package/bundled/upstream/ecc/skills/claude-api/SKILL.md +337 -0
- package/bundled/upstream/ecc/skills/claude-devfleet/SKILL.md +103 -0
- package/bundled/upstream/ecc/skills/click-path-audit/SKILL.md +244 -0
- package/bundled/upstream/ecc/skills/clickhouse-io/SKILL.md +439 -0
- package/bundled/upstream/ecc/skills/code-tour/SKILL.md +236 -0
- package/bundled/upstream/ecc/skills/codebase-onboarding/SKILL.md +233 -0
- package/bundled/upstream/ecc/skills/coding-standards/SKILL.md +549 -0
- package/bundled/upstream/ecc/skills/compose-multiplatform-patterns/SKILL.md +299 -0
- package/bundled/upstream/ecc/skills/configure-ecc/SKILL.md +367 -0
- package/bundled/upstream/ecc/skills/connections-optimizer/SKILL.md +189 -0
- package/bundled/upstream/ecc/skills/content-engine/SKILL.md +131 -0
- package/bundled/upstream/ecc/skills/content-hash-cache-pattern/SKILL.md +161 -0
- package/bundled/upstream/ecc/skills/context-budget/SKILL.md +135 -0
- package/bundled/upstream/ecc/skills/continuous-agent-loop/SKILL.md +45 -0
- package/bundled/upstream/ecc/skills/continuous-learning/SKILL.md +123 -0
- package/bundled/upstream/ecc/skills/continuous-learning/config.json +18 -0
- package/bundled/upstream/ecc/skills/continuous-learning/evaluate-session.sh +69 -0
- package/bundled/upstream/ecc/skills/continuous-learning-v2/SKILL.md +346 -0
- package/bundled/upstream/ecc/skills/continuous-learning-v2/agents/observer-loop.sh +282 -0
- package/bundled/upstream/ecc/skills/continuous-learning-v2/agents/observer.md +198 -0
- package/bundled/upstream/ecc/skills/continuous-learning-v2/agents/session-guardian.sh +150 -0
- package/bundled/upstream/ecc/skills/continuous-learning-v2/agents/start-observer.sh +244 -0
- package/bundled/upstream/ecc/skills/continuous-learning-v2/config.json +8 -0
- package/bundled/upstream/ecc/skills/continuous-learning-v2/hooks/observe.sh +460 -0
- package/bundled/upstream/ecc/skills/continuous-learning-v2/scripts/detect-project.sh +243 -0
- package/bundled/upstream/ecc/skills/continuous-learning-v2/scripts/instinct-cli.py +1426 -0
- package/bundled/upstream/ecc/skills/continuous-learning-v2/scripts/test_parse_instinct.py +984 -0
- package/bundled/upstream/ecc/skills/cost-aware-llm-pipeline/SKILL.md +183 -0
- package/bundled/upstream/ecc/skills/council/SKILL.md +203 -0
- package/bundled/upstream/ecc/skills/cpp-coding-standards/SKILL.md +723 -0
- package/bundled/upstream/ecc/skills/cpp-testing/SKILL.md +324 -0
- package/bundled/upstream/ecc/skills/crosspost/SKILL.md +111 -0
- package/bundled/upstream/ecc/skills/csharp-testing/SKILL.md +321 -0
- package/bundled/upstream/ecc/skills/customer-billing-ops/SKILL.md +140 -0
- package/bundled/upstream/ecc/skills/customs-trade-compliance/SKILL.md +263 -0
- package/bundled/upstream/ecc/skills/dart-flutter-patterns/SKILL.md +563 -0
- package/bundled/upstream/ecc/skills/dashboard-builder/SKILL.md +108 -0
- package/bundled/upstream/ecc/skills/data-scraper-agent/SKILL.md +764 -0
- package/bundled/upstream/ecc/skills/database-migrations/SKILL.md +429 -0
- package/bundled/upstream/ecc/skills/deep-research/SKILL.md +155 -0
- package/bundled/upstream/ecc/skills/defi-amm-security/SKILL.md +160 -0
- package/bundled/upstream/ecc/skills/deployment-patterns/SKILL.md +427 -0
- package/bundled/upstream/ecc/skills/design-system/SKILL.md +82 -0
- package/bundled/upstream/ecc/skills/django-patterns/SKILL.md +734 -0
- package/bundled/upstream/ecc/skills/django-security/SKILL.md +593 -0
- package/bundled/upstream/ecc/skills/django-tdd/SKILL.md +729 -0
- package/bundled/upstream/ecc/skills/django-verification/SKILL.md +469 -0
- package/bundled/upstream/ecc/skills/dmux-workflows/SKILL.md +191 -0
- package/bundled/upstream/ecc/skills/docker-patterns/SKILL.md +364 -0
- package/bundled/upstream/ecc/skills/documentation-lookup/SKILL.md +90 -0
- package/bundled/upstream/ecc/skills/dotnet-patterns/SKILL.md +321 -0
- package/bundled/upstream/ecc/skills/e2e-testing/SKILL.md +326 -0
- package/bundled/upstream/ecc/skills/ecc-tools-cost-audit/SKILL.md +160 -0
- package/bundled/upstream/ecc/skills/email-ops/SKILL.md +121 -0
- package/bundled/upstream/ecc/skills/energy-procurement/SKILL.md +228 -0
- package/bundled/upstream/ecc/skills/enterprise-agent-ops/SKILL.md +50 -0
- package/bundled/upstream/ecc/skills/eval-harness/SKILL.md +270 -0
- package/bundled/upstream/ecc/skills/evm-token-decimals/SKILL.md +130 -0
- package/bundled/upstream/ecc/skills/exa-search/SKILL.md +103 -0
- package/bundled/upstream/ecc/skills/fal-ai-media/SKILL.md +284 -0
- package/bundled/upstream/ecc/skills/finance-billing-ops/SKILL.md +127 -0
- package/bundled/upstream/ecc/skills/flutter-dart-code-review/SKILL.md +435 -0
- package/bundled/upstream/ecc/skills/foundation-models-on-device/SKILL.md +243 -0
- package/bundled/upstream/ecc/skills/frontend-design/SKILL.md +145 -0
- package/bundled/upstream/ecc/skills/frontend-patterns/SKILL.md +642 -0
- package/bundled/upstream/ecc/skills/frontend-slides/SKILL.md +184 -0
- package/bundled/upstream/ecc/skills/frontend-slides/STYLE_PRESETS.md +330 -0
- package/bundled/upstream/ecc/skills/gan-style-harness/SKILL.md +278 -0
- package/bundled/upstream/ecc/skills/gateguard/SKILL.md +121 -0
- package/bundled/upstream/ecc/skills/git-workflow/SKILL.md +715 -0
- package/bundled/upstream/ecc/skills/github-ops/SKILL.md +144 -0
- package/bundled/upstream/ecc/skills/golang-patterns/SKILL.md +674 -0
- package/bundled/upstream/ecc/skills/golang-testing/SKILL.md +720 -0
- package/bundled/upstream/ecc/skills/google-workspace-ops/SKILL.md +95 -0
- package/bundled/upstream/ecc/skills/healthcare-cdss-patterns/SKILL.md +245 -0
- package/bundled/upstream/ecc/skills/healthcare-emr-patterns/SKILL.md +159 -0
- package/bundled/upstream/ecc/skills/healthcare-eval-harness/SKILL.md +207 -0
- package/bundled/upstream/ecc/skills/healthcare-phi-compliance/SKILL.md +145 -0
- package/bundled/upstream/ecc/skills/hexagonal-architecture/SKILL.md +276 -0
- package/bundled/upstream/ecc/skills/hipaa-compliance/SKILL.md +78 -0
- package/bundled/upstream/ecc/skills/hookify-rules/SKILL.md +128 -0
- package/bundled/upstream/ecc/skills/inventory-demand-planning/SKILL.md +247 -0
- package/bundled/upstream/ecc/skills/investor-materials/SKILL.md +96 -0
- package/bundled/upstream/ecc/skills/investor-outreach/SKILL.md +91 -0
- package/bundled/upstream/ecc/skills/iterative-retrieval/SKILL.md +211 -0
- package/bundled/upstream/ecc/skills/java-coding-standards/SKILL.md +147 -0
- package/bundled/upstream/ecc/skills/jira-integration/SKILL.md +293 -0
- package/bundled/upstream/ecc/skills/jpa-patterns/SKILL.md +151 -0
- package/bundled/upstream/ecc/skills/knowledge-ops/SKILL.md +154 -0
- package/bundled/upstream/ecc/skills/kotlin-coroutines-flows/SKILL.md +284 -0
- package/bundled/upstream/ecc/skills/kotlin-exposed-patterns/SKILL.md +719 -0
- package/bundled/upstream/ecc/skills/kotlin-ktor-patterns/SKILL.md +689 -0
- package/bundled/upstream/ecc/skills/kotlin-patterns/SKILL.md +711 -0
- package/bundled/upstream/ecc/skills/kotlin-testing/SKILL.md +824 -0
- package/bundled/upstream/ecc/skills/laravel-patterns/SKILL.md +415 -0
- package/bundled/upstream/ecc/skills/laravel-plugin-discovery/SKILL.md +229 -0
- package/bundled/upstream/ecc/skills/laravel-security/SKILL.md +285 -0
- package/bundled/upstream/ecc/skills/laravel-tdd/SKILL.md +283 -0
- package/bundled/upstream/ecc/skills/laravel-verification/SKILL.md +179 -0
- package/bundled/upstream/ecc/skills/lead-intelligence/SKILL.md +321 -0
- package/bundled/upstream/ecc/skills/lead-intelligence/agents/enrichment-agent.md +85 -0
- package/bundled/upstream/ecc/skills/lead-intelligence/agents/mutual-mapper.md +75 -0
- package/bundled/upstream/ecc/skills/lead-intelligence/agents/outreach-drafter.md +98 -0
- package/bundled/upstream/ecc/skills/lead-intelligence/agents/signal-scorer.md +60 -0
- package/bundled/upstream/ecc/skills/liquid-glass-design/SKILL.md +279 -0
- package/bundled/upstream/ecc/skills/llm-trading-agent-security/SKILL.md +146 -0
- package/bundled/upstream/ecc/skills/logistics-exception-management/SKILL.md +222 -0
- package/bundled/upstream/ecc/skills/manim-video/SKILL.md +89 -0
- package/bundled/upstream/ecc/skills/manim-video/assets/network_graph_scene.py +52 -0
- package/bundled/upstream/ecc/skills/market-research/SKILL.md +75 -0
- package/bundled/upstream/ecc/skills/mcp-server-patterns/SKILL.md +69 -0
- package/bundled/upstream/ecc/skills/messages-ops/SKILL.md +104 -0
- package/bundled/upstream/ecc/skills/nanoclaw-repl/SKILL.md +33 -0
- package/bundled/upstream/ecc/skills/nestjs-patterns/SKILL.md +230 -0
- package/bundled/upstream/ecc/skills/nextjs-turbopack/SKILL.md +44 -0
- package/bundled/upstream/ecc/skills/nodejs-keccak256/SKILL.md +102 -0
- package/bundled/upstream/ecc/skills/nutrient-document-processing/SKILL.md +167 -0
- package/bundled/upstream/ecc/skills/nuxt4-patterns/SKILL.md +100 -0
- package/bundled/upstream/ecc/skills/openclaw-persona-forge/SKILL.md +296 -0
- package/bundled/upstream/ecc/skills/openclaw-persona-forge/gacha.py +224 -0
- package/bundled/upstream/ecc/skills/openclaw-persona-forge/gacha.sh +5 -0
- package/bundled/upstream/ecc/skills/openclaw-persona-forge/references/avatar-style.md +124 -0
- package/bundled/upstream/ecc/skills/openclaw-persona-forge/references/boundary-rules.md +53 -0
- package/bundled/upstream/ecc/skills/openclaw-persona-forge/references/error-handling.md +53 -0
- package/bundled/upstream/ecc/skills/openclaw-persona-forge/references/identity-tension.md +48 -0
- package/bundled/upstream/ecc/skills/openclaw-persona-forge/references/naming-system.md +39 -0
- package/bundled/upstream/ecc/skills/openclaw-persona-forge/references/output-template.md +166 -0
- package/bundled/upstream/ecc/skills/opensource-pipeline/SKILL.md +255 -0
- package/bundled/upstream/ecc/skills/perl-patterns/SKILL.md +504 -0
- package/bundled/upstream/ecc/skills/perl-security/SKILL.md +503 -0
- package/bundled/upstream/ecc/skills/perl-testing/SKILL.md +475 -0
- package/bundled/upstream/ecc/skills/plankton-code-quality/SKILL.md +236 -0
- package/bundled/upstream/ecc/skills/postgres-patterns/SKILL.md +147 -0
- package/bundled/upstream/ecc/skills/product-capability/SKILL.md +141 -0
- package/bundled/upstream/ecc/skills/product-lens/SKILL.md +92 -0
- package/bundled/upstream/ecc/skills/production-scheduling/SKILL.md +238 -0
- package/bundled/upstream/ecc/skills/project-flow-ops/SKILL.md +111 -0
- package/bundled/upstream/ecc/skills/prompt-optimizer/SKILL.md +397 -0
- package/bundled/upstream/ecc/skills/python-patterns/SKILL.md +750 -0
- package/bundled/upstream/ecc/skills/python-testing/SKILL.md +816 -0
- package/bundled/upstream/ecc/skills/pytorch-patterns/SKILL.md +396 -0
- package/bundled/upstream/ecc/skills/quality-nonconformance/SKILL.md +260 -0
- package/bundled/upstream/ecc/skills/ralphinho-rfc-pipeline/SKILL.md +67 -0
- package/bundled/upstream/ecc/skills/regex-vs-llm-structured-text/SKILL.md +220 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/SKILL.md +43 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/3d.md +86 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/animations.md +29 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/assets/charts-bar-chart.tsx +173 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/assets/text-animations-typewriter.tsx +100 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/assets/text-animations-word-highlight.tsx +108 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/assets.md +78 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/audio.md +172 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/calculate-metadata.md +104 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/can-decode.md +75 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/charts.md +58 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/compositions.md +146 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/display-captions.md +126 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/extract-frames.md +229 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/fonts.md +152 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/get-audio-duration.md +58 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/get-video-dimensions.md +68 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/get-video-duration.md +58 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/gifs.md +138 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/images.md +130 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/import-srt-captions.md +67 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/lottie.md +67 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/measuring-dom-nodes.md +34 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/measuring-text.md +143 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/sequencing.md +106 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/tailwind.md +11 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/text-animations.md +20 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/timing.md +179 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/transcribe-captions.md +19 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/transitions.md +122 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/trimming.md +52 -0
- package/bundled/upstream/ecc/skills/remotion-video-creation/rules/videos.md +171 -0
- package/bundled/upstream/ecc/skills/repo-scan/SKILL.md +78 -0
- package/bundled/upstream/ecc/skills/research-ops/SKILL.md +112 -0
- package/bundled/upstream/ecc/skills/returns-reverse-logistics/SKILL.md +240 -0
- package/bundled/upstream/ecc/skills/rules-distill/SKILL.md +264 -0
- package/bundled/upstream/ecc/skills/rules-distill/scripts/scan-rules.sh +58 -0
- package/bundled/upstream/ecc/skills/rules-distill/scripts/scan-skills.sh +129 -0
- package/bundled/upstream/ecc/skills/rust-patterns/SKILL.md +499 -0
- package/bundled/upstream/ecc/skills/rust-testing/SKILL.md +500 -0
- package/bundled/upstream/ecc/skills/safety-guard/SKILL.md +75 -0
- package/bundled/upstream/ecc/skills/santa-method/SKILL.md +306 -0
- package/bundled/upstream/ecc/skills/search-first/SKILL.md +161 -0
- package/bundled/upstream/ecc/skills/security-bounty-hunter/SKILL.md +99 -0
- package/bundled/upstream/ecc/skills/security-review/SKILL.md +495 -0
- package/bundled/upstream/ecc/skills/security-review/cloud-infrastructure-security.md +361 -0
- package/bundled/upstream/ecc/skills/security-scan/SKILL.md +165 -0
- package/bundled/upstream/ecc/skills/seo/SKILL.md +154 -0
- package/bundled/upstream/ecc/skills/skill-comply/SKILL.md +58 -0
- package/bundled/upstream/ecc/skills/skill-comply/fixtures/compliant_trace.jsonl +5 -0
- package/bundled/upstream/ecc/skills/skill-comply/fixtures/noncompliant_trace.jsonl +3 -0
- package/bundled/upstream/ecc/skills/skill-comply/fixtures/tdd_spec.yaml +44 -0
- package/bundled/upstream/ecc/skills/skill-comply/prompts/classifier.md +24 -0
- package/bundled/upstream/ecc/skills/skill-comply/prompts/scenario_generator.md +62 -0
- package/bundled/upstream/ecc/skills/skill-comply/prompts/spec_generator.md +42 -0
- package/bundled/upstream/ecc/skills/skill-comply/pyproject.toml +15 -0
- package/bundled/upstream/ecc/skills/skill-comply/scripts/__init__.py +0 -0
- package/bundled/upstream/ecc/skills/skill-comply/scripts/classifier.py +85 -0
- package/bundled/upstream/ecc/skills/skill-comply/scripts/grader.py +124 -0
- package/bundled/upstream/ecc/skills/skill-comply/scripts/parser.py +107 -0
- package/bundled/upstream/ecc/skills/skill-comply/scripts/report.py +170 -0
- package/bundled/upstream/ecc/skills/skill-comply/scripts/run.py +127 -0
- package/bundled/upstream/ecc/skills/skill-comply/scripts/runner.py +161 -0
- package/bundled/upstream/ecc/skills/skill-comply/scripts/scenario_generator.py +70 -0
- package/bundled/upstream/ecc/skills/skill-comply/scripts/spec_generator.py +72 -0
- package/bundled/upstream/ecc/skills/skill-comply/scripts/utils.py +13 -0
- package/bundled/upstream/ecc/skills/skill-comply/tests/test_grader.py +197 -0
- package/bundled/upstream/ecc/skills/skill-comply/tests/test_parser.py +90 -0
- package/bundled/upstream/ecc/skills/skill-stocktake/SKILL.md +193 -0
- package/bundled/upstream/ecc/skills/skill-stocktake/scripts/quick-diff.sh +87 -0
- package/bundled/upstream/ecc/skills/skill-stocktake/scripts/save-results.sh +56 -0
- package/bundled/upstream/ecc/skills/skill-stocktake/scripts/scan.sh +170 -0
- package/bundled/upstream/ecc/skills/social-graph-ranker/SKILL.md +154 -0
- package/bundled/upstream/ecc/skills/springboot-patterns/SKILL.md +314 -0
- package/bundled/upstream/ecc/skills/springboot-security/SKILL.md +272 -0
- package/bundled/upstream/ecc/skills/springboot-tdd/SKILL.md +158 -0
- package/bundled/upstream/ecc/skills/springboot-verification/SKILL.md +231 -0
- package/bundled/upstream/ecc/skills/strategic-compact/SKILL.md +131 -0
- package/bundled/upstream/ecc/skills/strategic-compact/suggest-compact.sh +54 -0
- package/bundled/upstream/ecc/skills/swift-actor-persistence/SKILL.md +143 -0
- package/bundled/upstream/ecc/skills/swift-concurrency-6-2/SKILL.md +216 -0
- package/bundled/upstream/ecc/skills/swift-protocol-di-testing/SKILL.md +190 -0
- package/bundled/upstream/ecc/skills/swiftui-patterns/SKILL.md +259 -0
- package/bundled/upstream/ecc/skills/tdd-workflow/SKILL.md +463 -0
- package/bundled/upstream/ecc/skills/team-builder/SKILL.md +168 -0
- package/bundled/upstream/ecc/skills/terminal-ops/SKILL.md +109 -0
- package/bundled/upstream/ecc/skills/token-budget-advisor/SKILL.md +133 -0
- package/bundled/upstream/ecc/skills/ui-demo/SKILL.md +465 -0
- package/bundled/upstream/ecc/skills/unified-notifications-ops/SKILL.md +187 -0
- package/bundled/upstream/ecc/skills/verification-loop/SKILL.md +126 -0
- package/bundled/upstream/ecc/skills/video-editing/SKILL.md +310 -0
- package/bundled/upstream/ecc/skills/videodb/SKILL.md +374 -0
- package/bundled/upstream/ecc/skills/videodb/reference/api-reference.md +550 -0
- package/bundled/upstream/ecc/skills/videodb/reference/capture-reference.md +407 -0
- package/bundled/upstream/ecc/skills/videodb/reference/capture.md +101 -0
- package/bundled/upstream/ecc/skills/videodb/reference/editor.md +443 -0
- package/bundled/upstream/ecc/skills/videodb/reference/generative.md +331 -0
- package/bundled/upstream/ecc/skills/videodb/reference/rtstream-reference.md +564 -0
- package/bundled/upstream/ecc/skills/videodb/reference/rtstream.md +65 -0
- package/bundled/upstream/ecc/skills/videodb/reference/search.md +230 -0
- package/bundled/upstream/ecc/skills/videodb/reference/streaming.md +406 -0
- package/bundled/upstream/ecc/skills/videodb/reference/use-cases.md +118 -0
- package/bundled/upstream/ecc/skills/videodb/scripts/ws_listener.py +282 -0
- package/bundled/upstream/ecc/skills/visa-doc-translate/README.md +86 -0
- package/bundled/upstream/ecc/skills/visa-doc-translate/SKILL.md +117 -0
- package/bundled/upstream/ecc/skills/workspace-surface-audit/SKILL.md +125 -0
- package/bundled/upstream/ecc/skills/x-api/SKILL.md +230 -0
- package/bundled/upstream/superpowers/.omc-source/last-plan-apply.json +22 -0
- package/package.json +3 -1
- package/src/catalog/source-catalog.js +391 -0
- package/src/cli/artifact.js +3 -2
- package/src/cli/doctor.js +25 -4
- package/src/cli/index.js +19 -0
- package/src/cli/plan.js +220 -0
- package/src/cli/setup.js +209 -12
- package/src/cli/source.js +110 -3
- package/src/config/paths.js +31 -0
- package/src/config/sources.js +103 -10
- package/src/merge/hook-merger.js +1 -0
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: terminal-ops
|
|
3
|
+
description: Evidence-first repo execution workflow for ECC. Use when the user wants a command run, a repo checked, a CI failure debugged, or a narrow fix pushed with exact proof of what was executed and verified.
|
|
4
|
+
origin: ECC
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Terminal Ops
|
|
8
|
+
|
|
9
|
+
Use this when the user wants real repo execution: run commands, inspect git state, debug CI or builds, make a narrow fix, and report exactly what changed and what was verified.
|
|
10
|
+
|
|
11
|
+
This skill is intentionally narrower than general coding guidance. It is an operator workflow for evidence-first terminal execution.
|
|
12
|
+
|
|
13
|
+
## Skill Stack
|
|
14
|
+
|
|
15
|
+
Pull these ECC-native skills into the workflow when relevant:
|
|
16
|
+
|
|
17
|
+
- `verification-loop` for exact proving steps after changes
|
|
18
|
+
- `tdd-workflow` when the right fix needs regression coverage
|
|
19
|
+
- `security-review` when secrets, auth, or external inputs are involved
|
|
20
|
+
- `github-ops` when the task depends on CI runs, PR state, or release status
|
|
21
|
+
- `knowledge-ops` when the verified outcome needs to be captured into durable project context
|
|
22
|
+
|
|
23
|
+
## When to Use
|
|
24
|
+
|
|
25
|
+
- user says "fix", "debug", "run this", "check the repo", or "push it"
|
|
26
|
+
- the task depends on command output, git state, test results, or a verified local fix
|
|
27
|
+
- the answer must distinguish changed locally, verified locally, committed, and pushed
|
|
28
|
+
|
|
29
|
+
## Guardrails
|
|
30
|
+
|
|
31
|
+
- inspect before editing
|
|
32
|
+
- stay read-only if the user asked for audit/review only
|
|
33
|
+
- prefer repo-local scripts and helpers over improvised ad hoc wrappers
|
|
34
|
+
- do not claim fixed until the proving command was rerun
|
|
35
|
+
- do not claim pushed unless the branch actually moved upstream
|
|
36
|
+
|
|
37
|
+
## Workflow
|
|
38
|
+
|
|
39
|
+
### 1. Resolve the working surface
|
|
40
|
+
|
|
41
|
+
Settle:
|
|
42
|
+
|
|
43
|
+
- exact repo path
|
|
44
|
+
- branch
|
|
45
|
+
- local diff state
|
|
46
|
+
- requested mode:
|
|
47
|
+
- inspect
|
|
48
|
+
- fix
|
|
49
|
+
- verify
|
|
50
|
+
- push
|
|
51
|
+
|
|
52
|
+
### 2. Read the failing surface first
|
|
53
|
+
|
|
54
|
+
Before changing anything:
|
|
55
|
+
|
|
56
|
+
- inspect the error
|
|
57
|
+
- inspect the file or test
|
|
58
|
+
- inspect git state
|
|
59
|
+
- use any already-supplied logs or context before re-reading blindly
|
|
60
|
+
|
|
61
|
+
### 3. Keep the fix narrow
|
|
62
|
+
|
|
63
|
+
Solve one dominant failure at a time:
|
|
64
|
+
|
|
65
|
+
- use the smallest useful proving command first
|
|
66
|
+
- only escalate to a bigger build/test pass after the local failure is addressed
|
|
67
|
+
- if a command keeps failing with the same signature, stop broad retries and narrow scope
|
|
68
|
+
|
|
69
|
+
### 4. Report exact execution state
|
|
70
|
+
|
|
71
|
+
Use exact status words:
|
|
72
|
+
|
|
73
|
+
- inspected
|
|
74
|
+
- changed locally
|
|
75
|
+
- verified locally
|
|
76
|
+
- committed
|
|
77
|
+
- pushed
|
|
78
|
+
- blocked
|
|
79
|
+
|
|
80
|
+
## Output Format
|
|
81
|
+
|
|
82
|
+
```text
|
|
83
|
+
SURFACE
|
|
84
|
+
- repo
|
|
85
|
+
- branch
|
|
86
|
+
- requested mode
|
|
87
|
+
|
|
88
|
+
EVIDENCE
|
|
89
|
+
- failing command / diff / test
|
|
90
|
+
|
|
91
|
+
ACTION
|
|
92
|
+
- what changed
|
|
93
|
+
|
|
94
|
+
STATUS
|
|
95
|
+
- inspected / changed locally / verified locally / committed / pushed / blocked
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## Pitfalls
|
|
99
|
+
|
|
100
|
+
- do not work from stale memory when the live repo state can be read
|
|
101
|
+
- do not widen a narrow fix into repo-wide churn
|
|
102
|
+
- do not use destructive git commands
|
|
103
|
+
- do not ignore unrelated local work
|
|
104
|
+
|
|
105
|
+
## Verification
|
|
106
|
+
|
|
107
|
+
- the response names the proving command or test
|
|
108
|
+
- git-related work names the repo path and branch
|
|
109
|
+
- any push claim includes the target branch and exact result
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: token-budget-advisor
|
|
3
|
+
description: >-
|
|
4
|
+
Offers the user an informed choice about how much response depth to
|
|
5
|
+
consume before answering. Use this skill when the user explicitly
|
|
6
|
+
wants to control response length, depth, or token budget.
|
|
7
|
+
TRIGGER when: "token budget", "token count", "token usage", "token limit",
|
|
8
|
+
"response length", "answer depth", "short version", "brief answer",
|
|
9
|
+
"detailed answer", "exhaustive answer", "respuesta corta vs larga",
|
|
10
|
+
"cuántos tokens", "ahorrar tokens", "responde al 50%", "dame la versión
|
|
11
|
+
corta", "quiero controlar cuánto usas", or clear variants where the
|
|
12
|
+
user is explicitly asking to control answer size or depth.
|
|
13
|
+
DO NOT TRIGGER when: user has already specified a level in the current
|
|
14
|
+
session (maintain it), the request is clearly a one-word answer, or
|
|
15
|
+
"token" refers to auth/session/payment tokens rather than response size.
|
|
16
|
+
origin: community
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
# Token Budget Advisor (TBA)
|
|
20
|
+
|
|
21
|
+
Intercept the response flow to offer the user a choice about response depth **before** Claude answers.
|
|
22
|
+
|
|
23
|
+
## When to Use
|
|
24
|
+
|
|
25
|
+
- User wants to control how long or detailed a response is
|
|
26
|
+
- User mentions tokens, budget, depth, or response length
|
|
27
|
+
- User says "short version", "tldr", "brief", "al 25%", "exhaustive", etc.
|
|
28
|
+
- Any time the user wants to choose depth/detail level upfront
|
|
29
|
+
|
|
30
|
+
**Do not trigger** when: user already set a level this session (maintain it silently), or the answer is trivially one line.
|
|
31
|
+
|
|
32
|
+
## How It Works
|
|
33
|
+
|
|
34
|
+
### Step 1 — Estimate input tokens
|
|
35
|
+
|
|
36
|
+
Use the repository's canonical context-budget heuristics to estimate the prompt's token count mentally.
|
|
37
|
+
|
|
38
|
+
Use the same calibration guidance as [context-budget](../context-budget/SKILL.md):
|
|
39
|
+
|
|
40
|
+
- prose: `words × 1.3`
|
|
41
|
+
- code-heavy or mixed/code blocks: `chars / 4`
|
|
42
|
+
|
|
43
|
+
For mixed content, use the dominant content type and keep the estimate heuristic.
|
|
44
|
+
|
|
45
|
+
### Step 2 — Estimate response size by complexity
|
|
46
|
+
|
|
47
|
+
Classify the prompt, then apply the multiplier range to get the full response window:
|
|
48
|
+
|
|
49
|
+
| Complexity | Multiplier range | Example prompts |
|
|
50
|
+
|--------------|------------------|------------------------------------------------------|
|
|
51
|
+
| Simple | 3× – 8× | "What is X?", yes/no, single fact |
|
|
52
|
+
| Medium | 8× – 20× | "How does X work?" |
|
|
53
|
+
| Medium-High | 10× – 25× | Code request with context |
|
|
54
|
+
| Complex | 15× – 40× | Multi-part analysis, comparisons, architecture |
|
|
55
|
+
| Creative | 10× – 30× | Stories, essays, narrative writing |
|
|
56
|
+
|
|
57
|
+
Response window = `input_tokens × mult_min` to `input_tokens × mult_max` (but don’t exceed your model’s configured output-token limit).
|
|
58
|
+
|
|
59
|
+
### Step 3 — Present depth options
|
|
60
|
+
|
|
61
|
+
Present this block **before** answering, using the actual estimated numbers:
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
Analyzing your prompt...
|
|
65
|
+
|
|
66
|
+
Input: ~[N] tokens | Type: [type] | Complexity: [level] | Language: [lang]
|
|
67
|
+
|
|
68
|
+
Choose your depth level:
|
|
69
|
+
|
|
70
|
+
[1] Essential (25%) -> ~[tokens] Direct answer only, no preamble
|
|
71
|
+
[2] Moderate (50%) -> ~[tokens] Answer + context + 1 example
|
|
72
|
+
[3] Detailed (75%) -> ~[tokens] Full answer with alternatives
|
|
73
|
+
[4] Exhaustive (100%) -> ~[tokens] Everything, no limits
|
|
74
|
+
|
|
75
|
+
Which level? (1-4 or say "25% depth", "50% depth", "75% depth", "100% depth")
|
|
76
|
+
|
|
77
|
+
Precision: heuristic estimate ~85-90% accuracy (±15%).
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
Level token estimates (within the response window):
|
|
81
|
+
- 25% → `min + (max - min) × 0.25`
|
|
82
|
+
- 50% → `min + (max - min) × 0.50`
|
|
83
|
+
- 75% → `min + (max - min) × 0.75`
|
|
84
|
+
- 100% → `max`
|
|
85
|
+
|
|
86
|
+
### Step 4 — Respond at the chosen level
|
|
87
|
+
|
|
88
|
+
| Level | Target length | Include | Omit |
|
|
89
|
+
|------------------|---------------------|-----------------------------------------------------|---------------------------------------------------|
|
|
90
|
+
| 25% Essential | 2-4 sentences max | Direct answer, key conclusion | Context, examples, nuance, alternatives |
|
|
91
|
+
| 50% Moderate | 1-3 paragraphs | Answer + necessary context + 1 example | Deep analysis, edge cases, references |
|
|
92
|
+
| 75% Detailed | Structured response | Multiple examples, pros/cons, alternatives | Extreme edge cases, exhaustive references |
|
|
93
|
+
| 100% Exhaustive | No restriction | Everything — full analysis, all code, all perspectives | Nothing |
|
|
94
|
+
|
|
95
|
+
## Shortcuts — skip the question
|
|
96
|
+
|
|
97
|
+
If the user already signals a level, respond at that level immediately without asking:
|
|
98
|
+
|
|
99
|
+
| What they say | Level |
|
|
100
|
+
|----------------------------------------------------|-------|
|
|
101
|
+
| "1" / "25% depth" / "short version" / "brief answer" / "tldr" | 25% |
|
|
102
|
+
| "2" / "50% depth" / "moderate depth" / "balanced answer" | 50% |
|
|
103
|
+
| "3" / "75% depth" / "detailed answer" / "thorough answer" | 75% |
|
|
104
|
+
| "4" / "100% depth" / "exhaustive answer" / "full deep dive" | 100% |
|
|
105
|
+
|
|
106
|
+
If the user set a level earlier in the session, **maintain it silently** for subsequent responses unless they change it.
|
|
107
|
+
|
|
108
|
+
## Precision note
|
|
109
|
+
|
|
110
|
+
This skill uses heuristic estimation — no real tokenizer. Accuracy ~85-90%, variance ±15%. Always show the disclaimer.
|
|
111
|
+
|
|
112
|
+
## Examples
|
|
113
|
+
|
|
114
|
+
### Triggers
|
|
115
|
+
|
|
116
|
+
- "Give me the short version first."
|
|
117
|
+
- "How many tokens will your answer use?"
|
|
118
|
+
- "Respond at 50% depth."
|
|
119
|
+
- "I want the exhaustive answer, not the summary."
|
|
120
|
+
- "Dame la version corta y luego la detallada."
|
|
121
|
+
|
|
122
|
+
### Does Not Trigger
|
|
123
|
+
|
|
124
|
+
- "What is a JWT token?"
|
|
125
|
+
- "The checkout flow uses a payment token."
|
|
126
|
+
- "Is this normal?"
|
|
127
|
+
- "Complete the refactor."
|
|
128
|
+
- Follow-up questions after the user already chose a depth for the session
|
|
129
|
+
|
|
130
|
+
## Source
|
|
131
|
+
|
|
132
|
+
Standalone skill from [TBA — Token Budget Advisor for Claude Code](https://github.com/Xabilimon1/Token-Budget-Advisor-Claude-Code-).
|
|
133
|
+
Original project also ships a Python estimator script, but this repository keeps the skill self-contained and heuristic-only.
|
|
@@ -0,0 +1,465 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ui-demo
|
|
3
|
+
description: Record polished UI demo videos using Playwright. Use when the user asks to create a demo, walkthrough, screen recording, or tutorial video of a web application. Produces WebM videos with visible cursor, natural pacing, and professional feel.
|
|
4
|
+
origin: ECC
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# UI Demo Video Recorder
|
|
8
|
+
|
|
9
|
+
Record polished demo videos of web applications using Playwright's video recording with an injected cursor overlay, natural pacing, and storytelling flow.
|
|
10
|
+
|
|
11
|
+
## When to Use
|
|
12
|
+
|
|
13
|
+
- User asks for a "demo video", "screen recording", "walkthrough", or "tutorial"
|
|
14
|
+
- User wants to showcase a feature or workflow visually
|
|
15
|
+
- User needs a video for documentation, onboarding, or stakeholder presentation
|
|
16
|
+
|
|
17
|
+
## Three-Phase Process
|
|
18
|
+
|
|
19
|
+
Every demo goes through three phases: **Discover -> Rehearse -> Record**. Never skip straight to recording.
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Phase 1: Discover
|
|
24
|
+
|
|
25
|
+
Before writing any script, explore the target pages to understand what is actually there.
|
|
26
|
+
|
|
27
|
+
### Why
|
|
28
|
+
|
|
29
|
+
You cannot script what you have not seen. Fields may be `<input>` not `<textarea>`, dropdowns may be custom components not `<select>`, and comment boxes may support `@mentions` or `#tags`. Assumptions break recordings silently.
|
|
30
|
+
|
|
31
|
+
### How
|
|
32
|
+
|
|
33
|
+
Navigate to each page in the flow and dump its interactive elements:
|
|
34
|
+
|
|
35
|
+
```javascript
|
|
36
|
+
// Run this for each page in the flow BEFORE writing the demo script
|
|
37
|
+
const fields = await page.evaluate(() => {
|
|
38
|
+
const els = [];
|
|
39
|
+
document.querySelectorAll('input, select, textarea, button, [contenteditable]').forEach(el => {
|
|
40
|
+
if (el.offsetParent !== null) {
|
|
41
|
+
els.push({
|
|
42
|
+
tag: el.tagName,
|
|
43
|
+
type: el.type || '',
|
|
44
|
+
name: el.name || '',
|
|
45
|
+
placeholder: el.placeholder || '',
|
|
46
|
+
text: el.textContent?.trim().substring(0, 40) || '',
|
|
47
|
+
contentEditable: el.contentEditable === 'true',
|
|
48
|
+
role: el.getAttribute('role') || '',
|
|
49
|
+
});
|
|
50
|
+
}
|
|
51
|
+
});
|
|
52
|
+
return els;
|
|
53
|
+
});
|
|
54
|
+
console.log(JSON.stringify(fields, null, 2));
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### What to look for
|
|
58
|
+
|
|
59
|
+
- **Form fields**: Are they `<select>`, `<input>`, custom dropdowns, or comboboxes?
|
|
60
|
+
- **Select options**: Dump option values AND text. Placeholders often have `value="0"` or `value=""` which looks non-empty. Use `Array.from(el.options).map(o => ({ value: o.value, text: o.text }))`. Skip options where text includes "Select" or value is `"0"`.
|
|
61
|
+
- **Rich text**: Does the comment box support `@mentions`, `#tags`, markdown, or emoji? Check placeholder text.
|
|
62
|
+
- **Required fields**: Which fields block form submission? Check `required`, `*` in labels, and try submitting empty to see validation errors.
|
|
63
|
+
- **Dynamic content**: Do fields appear after other fields are filled?
|
|
64
|
+
- **Button labels**: Exact text such as `"Submit"`, `"Submit Request"`, or `"Send"`.
|
|
65
|
+
- **Table column headers**: For table-driven modals, map each `input[type="number"]` to its column header instead of assuming all numeric inputs mean the same thing.
|
|
66
|
+
|
|
67
|
+
### Output
|
|
68
|
+
|
|
69
|
+
A field map for each page, used to write correct selectors in the script. Example:
|
|
70
|
+
|
|
71
|
+
```text
|
|
72
|
+
/purchase-requests/new:
|
|
73
|
+
- Budget Code: <select> (first select on page, 4 options)
|
|
74
|
+
- Desired Delivery: <input type="date">
|
|
75
|
+
- Context: <textarea> (not input)
|
|
76
|
+
- BOM table: inline-editable cells with span.cursor-pointer -> input pattern
|
|
77
|
+
- Submit: <button> text="Submit"
|
|
78
|
+
|
|
79
|
+
/purchase-requests/N (detail):
|
|
80
|
+
- Comment: <input placeholder="Type a message..."> supports @user and #PR tags
|
|
81
|
+
- Send: <button> text="Send" (disabled until input has content)
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## Phase 2: Rehearse
|
|
87
|
+
|
|
88
|
+
Run through all steps without recording. Verify every selector resolves.
|
|
89
|
+
|
|
90
|
+
### Why
|
|
91
|
+
|
|
92
|
+
Silent selector failures are the main reason demo recordings break. Rehearsal catches them before you waste a recording.
|
|
93
|
+
|
|
94
|
+
### How
|
|
95
|
+
|
|
96
|
+
Use `ensureVisible`, a wrapper that logs and fails loudly:
|
|
97
|
+
|
|
98
|
+
```javascript
|
|
99
|
+
async function ensureVisible(page, locator, label) {
|
|
100
|
+
const el = typeof locator === 'string' ? page.locator(locator).first() : locator;
|
|
101
|
+
const visible = await el.isVisible().catch(() => false);
|
|
102
|
+
if (!visible) {
|
|
103
|
+
const msg = `REHEARSAL FAIL: "${label}" not found - selector: ${typeof locator === 'string' ? locator : '(locator object)'}`;
|
|
104
|
+
console.error(msg);
|
|
105
|
+
const found = await page.evaluate(() => {
|
|
106
|
+
return Array.from(document.querySelectorAll('button, input, select, textarea, a'))
|
|
107
|
+
.filter(el => el.offsetParent !== null)
|
|
108
|
+
.map(el => `${el.tagName}[${el.type || ''}] "${el.textContent?.trim().substring(0, 30)}"`)
|
|
109
|
+
.join('\n ');
|
|
110
|
+
});
|
|
111
|
+
console.error(' Visible elements:\n ' + found);
|
|
112
|
+
return false;
|
|
113
|
+
}
|
|
114
|
+
console.log(`REHEARSAL OK: "${label}"`);
|
|
115
|
+
return true;
|
|
116
|
+
}
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
### Rehearsal script structure
|
|
120
|
+
|
|
121
|
+
```javascript
|
|
122
|
+
const steps = [
|
|
123
|
+
{ label: 'Login email field', selector: '#email' },
|
|
124
|
+
{ label: 'Login submit', selector: 'button[type="submit"]' },
|
|
125
|
+
{ label: 'New Request button', selector: 'button:has-text("New Request")' },
|
|
126
|
+
{ label: 'Budget Code select', selector: 'select' },
|
|
127
|
+
{ label: 'Delivery date', selector: 'input[type="date"]:visible' },
|
|
128
|
+
{ label: 'Description field', selector: 'textarea:visible' },
|
|
129
|
+
{ label: 'Add Item button', selector: 'button:has-text("Add Item")' },
|
|
130
|
+
{ label: 'Submit button', selector: 'button:has-text("Submit")' },
|
|
131
|
+
];
|
|
132
|
+
|
|
133
|
+
let allOk = true;
|
|
134
|
+
for (const step of steps) {
|
|
135
|
+
if (!await ensureVisible(page, step.selector, step.label)) {
|
|
136
|
+
allOk = false;
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
if (!allOk) {
|
|
140
|
+
console.error('REHEARSAL FAILED - fix selectors before recording');
|
|
141
|
+
process.exit(1);
|
|
142
|
+
}
|
|
143
|
+
console.log('REHEARSAL PASSED - all selectors verified');
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
### When rehearsal fails
|
|
147
|
+
|
|
148
|
+
1. Read the visible-element dump.
|
|
149
|
+
2. Find the correct selector.
|
|
150
|
+
3. Update the script.
|
|
151
|
+
4. Re-run rehearsal.
|
|
152
|
+
5. Only proceed when every selector passes.
|
|
153
|
+
|
|
154
|
+
---
|
|
155
|
+
|
|
156
|
+
## Phase 3: Record
|
|
157
|
+
|
|
158
|
+
Only after discovery and rehearsal pass should you create the recording.
|
|
159
|
+
|
|
160
|
+
### Recording Principles
|
|
161
|
+
|
|
162
|
+
#### 1. Storytelling Flow
|
|
163
|
+
|
|
164
|
+
Plan the video as a story. Follow user-specified order, or use this default:
|
|
165
|
+
|
|
166
|
+
- **Entry**: Login or navigate to the starting point
|
|
167
|
+
- **Context**: Pan the surroundings so viewers orient themselves
|
|
168
|
+
- **Action**: Perform the main workflow steps
|
|
169
|
+
- **Variation**: Show a secondary feature such as settings, theme, or localization
|
|
170
|
+
- **Result**: Show the outcome, confirmation, or new state
|
|
171
|
+
|
|
172
|
+
#### 2. Pacing
|
|
173
|
+
|
|
174
|
+
- After login: `4s`
|
|
175
|
+
- After navigation: `3s`
|
|
176
|
+
- After clicking a button: `2s`
|
|
177
|
+
- Between major steps: `1.5-2s`
|
|
178
|
+
- After the final action: `3s`
|
|
179
|
+
- Typing delay: `25-40ms` per character
|
|
180
|
+
|
|
181
|
+
#### 3. Cursor Overlay
|
|
182
|
+
|
|
183
|
+
Inject an SVG arrow cursor that follows mouse movements:
|
|
184
|
+
|
|
185
|
+
```javascript
|
|
186
|
+
async function injectCursor(page) {
|
|
187
|
+
await page.evaluate(() => {
|
|
188
|
+
if (document.getElementById('demo-cursor')) return;
|
|
189
|
+
const cursor = document.createElement('div');
|
|
190
|
+
cursor.id = 'demo-cursor';
|
|
191
|
+
cursor.innerHTML = `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
|
|
192
|
+
<path d="M5 3L19 12L12 13L9 20L5 3Z" fill="white" stroke="black" stroke-width="1.5" stroke-linejoin="round"/>
|
|
193
|
+
</svg>`;
|
|
194
|
+
cursor.style.cssText = `
|
|
195
|
+
position: fixed; z-index: 999999; pointer-events: none;
|
|
196
|
+
width: 24px; height: 24px;
|
|
197
|
+
transition: left 0.1s, top 0.1s;
|
|
198
|
+
filter: drop-shadow(1px 1px 2px rgba(0,0,0,0.3));
|
|
199
|
+
`;
|
|
200
|
+
cursor.style.left = '0px';
|
|
201
|
+
cursor.style.top = '0px';
|
|
202
|
+
document.body.appendChild(cursor);
|
|
203
|
+
document.addEventListener('mousemove', (e) => {
|
|
204
|
+
cursor.style.left = e.clientX + 'px';
|
|
205
|
+
cursor.style.top = e.clientY + 'px';
|
|
206
|
+
});
|
|
207
|
+
});
|
|
208
|
+
}
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
Call `injectCursor(page)` after every page navigation because the overlay is destroyed on navigate.
|
|
212
|
+
|
|
213
|
+
#### 4. Mouse Movement
|
|
214
|
+
|
|
215
|
+
Never teleport the cursor. Move to the target before clicking:
|
|
216
|
+
|
|
217
|
+
```javascript
|
|
218
|
+
async function moveAndClick(page, locator, label, opts = {}) {
|
|
219
|
+
const { postClickDelay = 800, ...clickOpts } = opts;
|
|
220
|
+
const el = typeof locator === 'string' ? page.locator(locator).first() : locator;
|
|
221
|
+
const visible = await el.isVisible().catch(() => false);
|
|
222
|
+
if (!visible) {
|
|
223
|
+
console.error(`WARNING: moveAndClick skipped - "${label}" not visible`);
|
|
224
|
+
return false;
|
|
225
|
+
}
|
|
226
|
+
try {
|
|
227
|
+
await el.scrollIntoViewIfNeeded();
|
|
228
|
+
await page.waitForTimeout(300);
|
|
229
|
+
const box = await el.boundingBox();
|
|
230
|
+
if (box) {
|
|
231
|
+
await page.mouse.move(box.x + box.width / 2, box.y + box.height / 2, { steps: 10 });
|
|
232
|
+
await page.waitForTimeout(400);
|
|
233
|
+
}
|
|
234
|
+
await el.click(clickOpts);
|
|
235
|
+
} catch (e) {
|
|
236
|
+
console.error(`WARNING: moveAndClick failed on "${label}": ${e.message}`);
|
|
237
|
+
return false;
|
|
238
|
+
}
|
|
239
|
+
await page.waitForTimeout(postClickDelay);
|
|
240
|
+
return true;
|
|
241
|
+
}
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
Every call should include a descriptive `label` for debugging.
|
|
245
|
+
|
|
246
|
+
#### 5. Typing
|
|
247
|
+
|
|
248
|
+
Type visibly, not instant-fill:
|
|
249
|
+
|
|
250
|
+
```javascript
|
|
251
|
+
async function typeSlowly(page, locator, text, label, charDelay = 35) {
|
|
252
|
+
const el = typeof locator === 'string' ? page.locator(locator).first() : locator;
|
|
253
|
+
const visible = await el.isVisible().catch(() => false);
|
|
254
|
+
if (!visible) {
|
|
255
|
+
console.error(`WARNING: typeSlowly skipped - "${label}" not visible`);
|
|
256
|
+
return false;
|
|
257
|
+
}
|
|
258
|
+
await moveAndClick(page, el, label);
|
|
259
|
+
await el.fill('');
|
|
260
|
+
await el.pressSequentially(text, { delay: charDelay });
|
|
261
|
+
await page.waitForTimeout(500);
|
|
262
|
+
return true;
|
|
263
|
+
}
|
|
264
|
+
```
|
|
265
|
+
|
|
266
|
+
#### 6. Scrolling
|
|
267
|
+
|
|
268
|
+
Use smooth scroll instead of jumps:
|
|
269
|
+
|
|
270
|
+
```javascript
|
|
271
|
+
await page.evaluate(() => window.scrollTo({ top: 400, behavior: 'smooth' }));
|
|
272
|
+
await page.waitForTimeout(1500);
|
|
273
|
+
```
|
|
274
|
+
|
|
275
|
+
#### 7. Dashboard Panning
|
|
276
|
+
|
|
277
|
+
When showing a dashboard or overview page, move the cursor across key elements:
|
|
278
|
+
|
|
279
|
+
```javascript
|
|
280
|
+
async function panElements(page, selector, maxCount = 6) {
|
|
281
|
+
const elements = await page.locator(selector).all();
|
|
282
|
+
for (let i = 0; i < Math.min(elements.length, maxCount); i++) {
|
|
283
|
+
try {
|
|
284
|
+
const box = await elements[i].boundingBox();
|
|
285
|
+
if (box && box.y < 700) {
|
|
286
|
+
await page.mouse.move(box.x + box.width / 2, box.y + box.height / 2, { steps: 8 });
|
|
287
|
+
await page.waitForTimeout(600);
|
|
288
|
+
}
|
|
289
|
+
} catch (e) {
|
|
290
|
+
console.warn(`WARNING: panElements skipped element ${i} (selector: "${selector}"): ${e.message}`);
|
|
291
|
+
}
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
```
|
|
295
|
+
|
|
296
|
+
#### 8. Subtitles
|
|
297
|
+
|
|
298
|
+
Inject a subtitle bar at the bottom of the viewport:
|
|
299
|
+
|
|
300
|
+
```javascript
|
|
301
|
+
async function injectSubtitleBar(page) {
|
|
302
|
+
await page.evaluate(() => {
|
|
303
|
+
if (document.getElementById('demo-subtitle')) return;
|
|
304
|
+
const bar = document.createElement('div');
|
|
305
|
+
bar.id = 'demo-subtitle';
|
|
306
|
+
bar.style.cssText = `
|
|
307
|
+
position: fixed; bottom: 0; left: 0; right: 0; z-index: 999998;
|
|
308
|
+
text-align: center; padding: 12px 24px;
|
|
309
|
+
background: rgba(0, 0, 0, 0.75);
|
|
310
|
+
color: white; font-family: -apple-system, "Segoe UI", sans-serif;
|
|
311
|
+
font-size: 16px; font-weight: 500; letter-spacing: 0.3px;
|
|
312
|
+
transition: opacity 0.3s;
|
|
313
|
+
pointer-events: none;
|
|
314
|
+
`;
|
|
315
|
+
bar.textContent = '';
|
|
316
|
+
bar.style.opacity = '0';
|
|
317
|
+
document.body.appendChild(bar);
|
|
318
|
+
});
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
async function showSubtitle(page, text) {
|
|
322
|
+
await page.evaluate((t) => {
|
|
323
|
+
const bar = document.getElementById('demo-subtitle');
|
|
324
|
+
if (!bar) return;
|
|
325
|
+
if (t) {
|
|
326
|
+
bar.textContent = t;
|
|
327
|
+
bar.style.opacity = '1';
|
|
328
|
+
} else {
|
|
329
|
+
bar.style.opacity = '0';
|
|
330
|
+
}
|
|
331
|
+
}, text);
|
|
332
|
+
if (text) await page.waitForTimeout(800);
|
|
333
|
+
}
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
Call `injectSubtitleBar(page)` alongside `injectCursor(page)` after every navigation.
|
|
337
|
+
|
|
338
|
+
Usage pattern:
|
|
339
|
+
|
|
340
|
+
```javascript
|
|
341
|
+
await showSubtitle(page, 'Step 1 - Logging in');
|
|
342
|
+
await showSubtitle(page, 'Step 2 - Dashboard overview');
|
|
343
|
+
await showSubtitle(page, '');
|
|
344
|
+
```
|
|
345
|
+
|
|
346
|
+
Guidelines:
|
|
347
|
+
|
|
348
|
+
- Keep subtitle text short, ideally under 60 characters.
|
|
349
|
+
- Use `Step N - Action` format for consistency.
|
|
350
|
+
- Clear the subtitle during long pauses where the UI can speak for itself.
|
|
351
|
+
|
|
352
|
+
## Script Template
|
|
353
|
+
|
|
354
|
+
```javascript
|
|
355
|
+
'use strict';
|
|
356
|
+
const { chromium } = require('playwright');
|
|
357
|
+
const path = require('path');
|
|
358
|
+
const fs = require('fs');
|
|
359
|
+
|
|
360
|
+
const BASE_URL = process.env.QA_BASE_URL || 'http://localhost:3000';
|
|
361
|
+
const VIDEO_DIR = path.join(__dirname, 'screenshots');
|
|
362
|
+
const OUTPUT_NAME = 'demo-FEATURE.webm';
|
|
363
|
+
const REHEARSAL = process.argv.includes('--rehearse');
|
|
364
|
+
|
|
365
|
+
// Paste injectCursor, injectSubtitleBar, showSubtitle, moveAndClick,
|
|
366
|
+
// typeSlowly, ensureVisible, and panElements here.
|
|
367
|
+
|
|
368
|
+
(async () => {
|
|
369
|
+
const browser = await chromium.launch({ headless: true });
|
|
370
|
+
|
|
371
|
+
if (REHEARSAL) {
|
|
372
|
+
const context = await browser.newContext({ viewport: { width: 1280, height: 720 } });
|
|
373
|
+
const page = await context.newPage();
|
|
374
|
+
// Navigate through the flow and run ensureVisible for each selector.
|
|
375
|
+
await browser.close();
|
|
376
|
+
return;
|
|
377
|
+
}
|
|
378
|
+
|
|
379
|
+
const context = await browser.newContext({
|
|
380
|
+
recordVideo: { dir: VIDEO_DIR, size: { width: 1280, height: 720 } },
|
|
381
|
+
viewport: { width: 1280, height: 720 }
|
|
382
|
+
});
|
|
383
|
+
const page = await context.newPage();
|
|
384
|
+
|
|
385
|
+
try {
|
|
386
|
+
await injectCursor(page);
|
|
387
|
+
await injectSubtitleBar(page);
|
|
388
|
+
|
|
389
|
+
await showSubtitle(page, 'Step 1 - Logging in');
|
|
390
|
+
// login actions
|
|
391
|
+
|
|
392
|
+
await page.goto(`${BASE_URL}/dashboard`);
|
|
393
|
+
await injectCursor(page);
|
|
394
|
+
await injectSubtitleBar(page);
|
|
395
|
+
await showSubtitle(page, 'Step 2 - Dashboard overview');
|
|
396
|
+
// pan dashboard
|
|
397
|
+
|
|
398
|
+
await showSubtitle(page, 'Step 3 - Main workflow');
|
|
399
|
+
// action sequence
|
|
400
|
+
|
|
401
|
+
await showSubtitle(page, 'Step 4 - Result');
|
|
402
|
+
// final reveal
|
|
403
|
+
await showSubtitle(page, '');
|
|
404
|
+
} catch (err) {
|
|
405
|
+
console.error('DEMO ERROR:', err.message);
|
|
406
|
+
} finally {
|
|
407
|
+
await context.close();
|
|
408
|
+
const video = page.video();
|
|
409
|
+
if (video) {
|
|
410
|
+
const src = await video.path();
|
|
411
|
+
const dest = path.join(VIDEO_DIR, OUTPUT_NAME);
|
|
412
|
+
try {
|
|
413
|
+
fs.copyFileSync(src, dest);
|
|
414
|
+
console.log('Video saved:', dest);
|
|
415
|
+
} catch (e) {
|
|
416
|
+
console.error('ERROR: Failed to copy video:', e.message);
|
|
417
|
+
console.error(' Source:', src);
|
|
418
|
+
console.error(' Destination:', dest);
|
|
419
|
+
}
|
|
420
|
+
}
|
|
421
|
+
await browser.close();
|
|
422
|
+
}
|
|
423
|
+
})();
|
|
424
|
+
```
|
|
425
|
+
|
|
426
|
+
Usage:
|
|
427
|
+
|
|
428
|
+
```bash
|
|
429
|
+
# Phase 2: Rehearse
|
|
430
|
+
node demo-script.cjs --rehearse
|
|
431
|
+
|
|
432
|
+
# Phase 3: Record
|
|
433
|
+
node demo-script.cjs
|
|
434
|
+
```
|
|
435
|
+
|
|
436
|
+
## Checklist Before Recording
|
|
437
|
+
|
|
438
|
+
- [ ] Discovery phase completed
|
|
439
|
+
- [ ] Rehearsal passes with all selectors OK
|
|
440
|
+
- [ ] Headless mode enabled
|
|
441
|
+
- [ ] Resolution set to `1280x720`
|
|
442
|
+
- [ ] Cursor and subtitle overlays re-injected after every navigation
|
|
443
|
+
- [ ] `showSubtitle(page, 'Step N - ...')` used at major transitions
|
|
444
|
+
- [ ] `moveAndClick` used for all clicks with descriptive labels
|
|
445
|
+
- [ ] `typeSlowly` used for visible input
|
|
446
|
+
- [ ] No silent catches; helpers log warnings
|
|
447
|
+
- [ ] Smooth scrolling used for content reveal
|
|
448
|
+
- [ ] Key pauses are visible to a human viewer
|
|
449
|
+
- [ ] Flow matches the requested story order
|
|
450
|
+
- [ ] Script reflects the actual UI discovered in phase 1
|
|
451
|
+
|
|
452
|
+
## Common Pitfalls
|
|
453
|
+
|
|
454
|
+
1. Cursor disappears after navigation - re-inject it.
|
|
455
|
+
2. Video is too fast - add pauses.
|
|
456
|
+
3. Cursor is a dot instead of an arrow - use the SVG overlay.
|
|
457
|
+
4. Cursor teleports - move before clicking.
|
|
458
|
+
5. Select dropdowns look wrong - show the move, then pick the option.
|
|
459
|
+
6. Modals feel abrupt - add a read pause before confirming.
|
|
460
|
+
7. Video file path is random - copy it to a stable output name.
|
|
461
|
+
8. Selector failures are swallowed - never use silent catch blocks.
|
|
462
|
+
9. Field types were assumed - discover them first.
|
|
463
|
+
10. Features were assumed - inspect the actual UI before scripting.
|
|
464
|
+
11. Placeholder select values look real - watch for `"0"` and `"Select..."`.
|
|
465
|
+
12. Popups create separate videos - capture popup pages explicitly and merge later if needed.
|