tribunal-kit 8.0.0 → 9.0.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/.agent/ARCHITECTURE.md +2 -2
- package/.agent/agents/backend-specialist.md +1 -1
- package/.agent/agents/code-archaeologist.md +1 -1
- package/.agent/agents/database-architect.md +1 -1
- package/.agent/agents/debugger.md +1 -1
- package/.agent/agents/devops-engineer.md +1 -1
- package/.agent/agents/documentation-writer.md +1 -1
- package/.agent/agents/explorer-agent.md +1 -1
- package/.agent/agents/game-developer.md +1 -1
- package/.agent/agents/minimalist-reviewer.md +1 -1
- package/.agent/agents/mobile-developer.md +1 -1
- package/.agent/agents/orchestrator.md +1 -1
- package/.agent/agents/penetration-tester.md +1 -1
- package/.agent/agents/performance-optimizer.md +1 -1
- package/.agent/agents/product-manager.md +1 -1
- package/.agent/agents/product-owner.md +1 -1
- package/.agent/agents/project-planner.md +1 -1
- package/.agent/agents/qa-automation-engineer.md +1 -1
- package/.agent/agents/seo-specialist.md +1 -1
- package/.agent/agents/test-engineer.md +1 -1
- package/.agent/config/plugin.json +4 -4
- package/.agent/config/slash-commands.json +13 -1
- package/.agent/config/system-prompt.md +75 -8
- package/.agent/routing_index.json +1546 -268
- package/.agent/scripts/browser_audit.js +94 -0
- package/.agent/scripts/context_compiler.js +9 -0
- package/.agent/scripts/prompt_compiler.js +105 -13
- package/.agent/skill_topic_map.json +2 -1
- package/.agent/skills/12-principles-of-animation/SKILL.md +62 -21
- package/.agent/skills/60fps-animation/SKILL.md +90 -20
- package/.agent/skills/accessible-animation/SKILL.md +207 -40
- package/.agent/skills/adapt/SKILL.md +62 -21
- package/.agent/skills/advanced-rag-pipelines/SKILL.md +87 -46
- package/.agent/skills/agent-organizer/SKILL.md +60 -81
- package/.agent/skills/agentic-patterns/SKILL.md +60 -79
- package/.agent/skills/agentic-workflows-2026/SKILL.md +92 -15
- package/.agent/skills/ai-app-hardening/SKILL.md +81 -15
- package/.agent/skills/ai-prompt-injection-defense/SKILL.md +75 -85
- package/.agent/skills/animation-on-scroll/SKILL.md +186 -47
- package/.agent/skills/animation-systems/SKILL.md +229 -35
- package/.agent/skills/antfu-conventions/SKILL.md +62 -23
- package/.agent/skills/api-patterns/SKILL.md +59 -79
- package/.agent/skills/api-security-auditor/SKILL.md +59 -81
- package/.agent/skills/app-builder/SKILL.md +59 -79
- package/.agent/skills/appflow-wireframe/SKILL.md +68 -83
- package/.agent/skills/apple-design/SKILL.md +65 -19
- package/.agent/skills/architecture/SKILL.md +59 -79
- package/.agent/skills/audit-and-fix/SKILL.md +62 -21
- package/.agent/skills/authentication-best-practices/SKILL.md +59 -81
- package/.agent/skills/backend-security-expert/SKILL.md +79 -82
- package/.agent/skills/baseline-ui/SKILL.md +65 -19
- package/.agent/skills/bash-linux/SKILL.md +59 -81
- package/.agent/skills/behavioral-modes/SKILL.md +60 -79
- package/.agent/skills/better-colors/SKILL.md +65 -19
- package/.agent/skills/better-typography/SKILL.md +70 -31
- package/.agent/skills/better-ui/SKILL.md +93 -18
- package/.agent/skills/bolder/SKILL.md +62 -21
- package/.agent/skills/brainstorming/SKILL.md +60 -78
- package/.agent/skills/browser-audit/SKILL.md +170 -0
- package/.agent/skills/browser-native-ai/SKILL.md +60 -41
- package/.agent/skills/build-primitive/SKILL.md +62 -21
- package/.agent/skills/building-native-ui/SKILL.md +59 -81
- package/.agent/skills/cicd-pro/SKILL.md +64 -31
- package/.agent/skills/clarify/SKILL.md +62 -21
- package/.agent/skills/clean-code/SKILL.md +68 -83
- package/.agent/skills/cloud-architect/SKILL.md +64 -31
- package/.agent/skills/cobejs/SKILL.md +62 -20
- package/.agent/skills/code-review-checklist/SKILL.md +59 -81
- package/.agent/skills/codebase-design/SKILL.md +74 -23
- package/.agent/skills/colorize/SKILL.md +62 -21
- package/.agent/skills/compact-landing/SKILL.md +62 -21
- package/.agent/skills/company-logos/SKILL.md +62 -21
- package/.agent/skills/config-validator/SKILL.md +59 -81
- package/.agent/skills/containerization-pro/SKILL.md +64 -31
- package/.agent/skills/context-engineering-pro/SKILL.md +81 -15
- package/.agent/skills/create-design-md/SKILL.md +65 -19
- package/.agent/skills/critique/SKILL.md +67 -19
- package/.agent/skills/csharp-developer/SKILL.md +59 -81
- package/.agent/skills/data-validation-schemas/SKILL.md +59 -81
- package/.agent/skills/database-design/SKILL.md +74 -84
- package/.agent/skills/delight/SKILL.md +62 -21
- package/.agent/skills/deployment-procedures/SKILL.md +59 -81
- package/.agent/skills/design-lab/SKILL.md +63 -21
- package/.agent/skills/devops-engineer/SKILL.md +59 -81
- package/.agent/skills/devops-incident-responder/SKILL.md +59 -81
- package/.agent/skills/diagnosing-bugs/SKILL.md +63 -27
- package/.agent/skills/distill/SKILL.md +62 -21
- package/.agent/skills/documentation-templates/SKILL.md +59 -81
- package/.agent/skills/domain-modeling/SKILL.md +62 -23
- package/.agent/skills/duckdb-analytical-sql/SKILL.md +80 -14
- package/.agent/skills/edge-ai-mobile/SKILL.md +80 -14
- package/.agent/skills/edge-computing/SKILL.md +59 -81
- package/.agent/skills/emil-design-eng/SKILL.md +64 -27
- package/.agent/skills/error-resilience/SKILL.md +78 -85
- package/.agent/skills/expo-router-v4/SKILL.md +79 -14
- package/.agent/skills/extract-design-system/SKILL.md +59 -81
- package/.agent/skills/fabel-protocol/SKILL.md +72 -15
- package/.agent/skills/fixing-accessibility/SKILL.md +65 -19
- package/.agent/skills/fixing-metadata/SKILL.md +62 -21
- package/.agent/skills/fixing-motion-performance/SKILL.md +65 -19
- package/.agent/skills/framer-motion-expert/SKILL.md +67 -77
- package/.agent/skills/frontend-design/SKILL.md +73 -15
- package/.agent/skills/frontend-security-expert/SKILL.md +59 -79
- package/.agent/skills/game-design-expert/SKILL.md +59 -81
- package/.agent/skills/game-engineering-expert/SKILL.md +59 -81
- package/.agent/skills/generative-ui-expert/SKILL.md +60 -41
- package/.agent/skills/geo-fundamentals/SKILL.md +59 -81
- package/.agent/skills/git-pro/SKILL.md +62 -33
- package/.agent/skills/github-operations/SKILL.md +59 -81
- package/.agent/skills/gpt-taste/SKILL.md +62 -21
- package/.agent/skills/gsap-core/SKILL.md +59 -89
- package/.agent/skills/gsap-frameworks/SKILL.md +59 -89
- package/.agent/skills/gsap-performance/SKILL.md +59 -87
- package/.agent/skills/gsap-plugins/SKILL.md +59 -87
- package/.agent/skills/gsap-react/SKILL.md +60 -32
- package/.agent/skills/gsap-scrolltrigger/SKILL.md +59 -89
- package/.agent/skills/gsap-timeline/SKILL.md +59 -87
- package/.agent/skills/gsap-utils/SKILL.md +59 -87
- package/.agent/skills/harden/SKILL.md +62 -21
- package/.agent/skills/harness-protocol/SKILL.md +60 -33
- package/.agent/skills/i18n-localization/SKILL.md +59 -81
- package/.agent/skills/impeccable/SKILL.md +62 -23
- package/.agent/skills/improve-codebase-architecture/SKILL.md +62 -22
- package/.agent/skills/improve-ui/SKILL.md +65 -19
- package/.agent/skills/intelligent-routing/SKILL.md +59 -33
- package/.agent/skills/knowledge-graph/SKILL.md +60 -33
- package/.agent/skills/landing-page/SKILL.md +62 -21
- package/.agent/skills/lint-and-validate/SKILL.md +59 -81
- package/.agent/skills/llm-engineering/SKILL.md +59 -81
- package/.agent/skills/local-first/SKILL.md +59 -81
- package/.agent/skills/local-first-architecture/SKILL.md +77 -20
- package/.agent/skills/lottie-animation/SKILL.md +62 -20
- package/.agent/skills/marquee-loop/SKILL.md +62 -21
- package/.agent/skills/masked-reveal/SKILL.md +245 -50
- package/.agent/skills/mcp-builder/SKILL.md +59 -81
- package/.agent/skills/micro-interaction/SKILL.md +254 -57
- package/.agent/skills/mobile-design/SKILL.md +59 -79
- package/.agent/skills/monorepo-management/SKILL.md +59 -81
- package/.agent/skills/morphing-icons/SKILL.md +365 -46
- package/.agent/skills/motion-engineering/SKILL.md +66 -21
- package/.agent/skills/nextjs-react-expert/SKILL.md +82 -84
- package/.agent/skills/nodejs-best-practices/SKILL.md +81 -80
- package/.agent/skills/observability/SKILL.md +59 -81
- package/.agent/skills/opentelemetry-observability/SKILL.md +80 -14
- package/.agent/skills/page-transition-animation/SKILL.md +62 -21
- package/.agent/skills/parallel-agents/SKILL.md +60 -81
- package/.agent/skills/performance-profiling/SKILL.md +60 -81
- package/.agent/skills/plan-writing/SKILL.md +83 -88
- package/.agent/skills/platform-engineer/SKILL.md +59 -81
- package/.agent/skills/platform-engineering-opentofu/SKILL.md +80 -15
- package/.agent/skills/playwright-ai-e2e/SKILL.md +81 -15
- package/.agent/skills/playwright-best-practices/SKILL.md +60 -81
- package/.agent/skills/polish/SKILL.md +62 -21
- package/.agent/skills/powershell-windows/SKILL.md +59 -81
- package/.agent/skills/pricing-page/SKILL.md +62 -21
- package/.agent/skills/product-aware-heuristics/SKILL.md +73 -16
- package/.agent/skills/progressive-blur/SKILL.md +62 -21
- package/.agent/skills/project-idioms/SKILL.md +58 -84
- package/.agent/skills/property-based-testing/SKILL.md +81 -15
- package/.agent/skills/python-patterns/SKILL.md +59 -81
- package/.agent/skills/python-pro/SKILL.md +81 -83
- package/.agent/skills/quieter/SKILL.md +62 -21
- package/.agent/skills/react-doctor/SKILL.md +62 -21
- package/.agent/skills/react-specialist/SKILL.md +73 -82
- package/.agent/skills/readme-builder/SKILL.md +59 -81
- package/.agent/skills/realtime-patterns/SKILL.md +59 -81
- package/.agent/skills/red-team-tactics/SKILL.md +59 -81
- package/.agent/skills/redesign-skill/SKILL.md +62 -21
- package/.agent/skills/review-animations/SKILL.md +64 -30
- package/.agent/skills/rust-pro/SKILL.md +77 -78
- package/.agent/skills/seo-fundamentals/SKILL.md +59 -81
- package/.agent/skills/server-management/SKILL.md +59 -81
- package/.agent/skills/shadcn-ui-expert/SKILL.md +59 -81
- package/.agent/skills/shape/SKILL.md +63 -21
- package/.agent/skills/skill-creator/SKILL.md +80 -88
- package/.agent/skills/soft-skill/SKILL.md +62 -21
- package/.agent/skills/sounds-on-the-web/SKILL.md +62 -21
- package/.agent/skills/sql-pro/SKILL.md +93 -80
- package/.agent/skills/supabase-postgres-best-practices/SKILL.md +59 -81
- package/.agent/skills/svg-animation/SKILL.md +368 -46
- package/.agent/skills/swiftui-expert/SKILL.md +59 -81
- package/.agent/skills/swiss-design/SKILL.md +62 -21
- package/.agent/skills/system-design-pro/SKILL.md +64 -29
- package/.agent/skills/systematic-debugging/SKILL.md +70 -82
- package/.agent/skills/systematic-debugging/condition-based-waiting.md +115 -0
- package/.agent/skills/systematic-debugging/defense-in-depth.md +122 -0
- package/.agent/skills/systematic-debugging/root-cause-tracing.md +169 -0
- package/.agent/skills/tailwind-patterns/SKILL.md +59 -81
- package/.agent/skills/taste-skill/SKILL.md +62 -21
- package/.agent/skills/tdd-workflow/SKILL.md +107 -26
- package/.agent/skills/test-result-analyzer/SKILL.md +59 -82
- package/.agent/skills/testing-patterns/SKILL.md +60 -81
- package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +62 -23
- package/.agent/skills/thinking-protocol/SKILL.md +73 -18
- package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +62 -20
- package/.agent/skills/transitions-dev/SKILL.md +62 -20
- package/.agent/skills/trend-researcher/SKILL.md +58 -82
- package/.agent/skills/typescript-advanced/SKILL.md +69 -85
- package/.agent/skills/typeset/SKILL.md +62 -21
- package/.agent/skills/ui-reasoning-engine/SKILL.md +73 -16
- package/.agent/skills/ui-skill-packs/SKILL.md +69 -19
- package/.agent/skills/ui-skills-root/SKILL.md +65 -19
- package/.agent/skills/ui-ux-pro-max/SKILL.md +81 -15
- package/.agent/skills/ui-ux-researcher/SKILL.md +58 -82
- package/.agent/skills/vector-search-pgvector/SKILL.md +80 -14
- package/.agent/skills/verification-before-completion/SKILL.md +178 -0
- package/.agent/skills/vue-expert/SKILL.md +59 -77
- package/.agent/skills/vulnerability-scanner/SKILL.md +59 -79
- package/.agent/skills/web-accessibility-auditor/SKILL.md +59 -81
- package/.agent/skills/web-design-guidelines/SKILL.md +73 -15
- package/.agent/skills/web-quality-audit/SKILL.md +62 -21
- package/.agent/skills/webapp-testing/SKILL.md +60 -81
- package/.agent/skills/webgpu-performance/SKILL.md +60 -41
- package/.agent/skills/whimsy-injector/SKILL.md +59 -81
- package/.agent/skills/workflow-optimizer/SKILL.md +59 -80
- package/.agent/skills/zero-trust-passkeys/SKILL.md +80 -14
- package/.agent/templates/DESIGN.md +680 -160
- package/.agent/templates/sdd/implementer-prompt.md +62 -0
- package/.agent/templates/sdd/re-review-prompt.md +36 -0
- package/.agent/templates/sdd/task-reviewer-prompt.md +78 -0
- package/.agent/workflows/acf.md +4 -0
- package/.agent/workflows/api-tester.md +5 -0
- package/.agent/workflows/audit-live.md +52 -0
- package/.agent/workflows/audit.md +5 -0
- package/.agent/workflows/brainstorm.md +17 -1
- package/.agent/workflows/changelog.md +5 -0
- package/.agent/workflows/compare-web.md +35 -0
- package/.agent/workflows/context.md +100 -0
- package/.agent/workflows/contract.md +19 -0
- package/.agent/workflows/create.md +6 -1
- package/.agent/workflows/debug.md +5 -0
- package/.agent/workflows/deploy.md +6 -1
- package/.agent/workflows/enhance.md +6 -1
- package/.agent/workflows/fix-ci.md +5 -0
- package/.agent/workflows/fix.md +5 -0
- package/.agent/workflows/generate.md +5 -0
- package/.agent/workflows/marathon.md +6 -1
- package/.agent/workflows/migrate.md +5 -0
- package/.agent/workflows/minimal.md +4 -0
- package/.agent/workflows/orchestrate.md +6 -1
- package/.agent/workflows/performance-benchmarker.md +6 -1
- package/.agent/workflows/pipeline.md +5 -0
- package/.agent/workflows/plan.md +7 -2
- package/.agent/workflows/preview.md +6 -1
- package/.agent/workflows/refactor.md +6 -0
- package/.agent/workflows/review-ai.md +5 -0
- package/.agent/workflows/review.md +5 -0
- package/.agent/workflows/sdd.md +122 -0
- package/.agent/workflows/session.md +5 -0
- package/.agent/workflows/skill-enhancement-engine.md +88 -0
- package/.agent/workflows/status.md +4 -0
- package/.agent/workflows/super-prompt.md +103 -19
- package/.agent/workflows/swarm.md +6 -1
- package/.agent/workflows/test.md +6 -1
- package/.agent/workflows/tribunal-backend.md +5 -0
- package/.agent/workflows/tribunal-cicd.md +5 -0
- package/.agent/workflows/tribunal-database.md +5 -0
- package/.agent/workflows/tribunal-full.md +8 -0
- package/.agent/workflows/tribunal-mobile.md +5 -0
- package/.agent/workflows/tribunal-performance.md +5 -0
- package/.agent/workflows/tribunal-speed.md +5 -0
- package/.agent/workflows/tribunal-ui.md +7 -0
- package/.agents/plugins/marketplace.json +20 -0
- package/.agents/skills/12-principles-of-animation/SKILL.md +126 -0
- package/.agents/skills/60fps-animation/SKILL.md +164 -0
- package/.agents/skills/accessible-animation/SKILL.md +266 -0
- package/.agents/skills/adapt/SKILL.md +131 -0
- package/.agents/skills/advanced-rag-pipelines/SKILL.md +169 -0
- package/.agents/skills/agent-organizer/SKILL.md +192 -0
- package/.agents/skills/agentic-patterns/SKILL.md +356 -0
- package/.agents/skills/agentic-workflows-2026/SKILL.md +157 -0
- package/.agents/skills/ai-app-hardening/SKILL.md +125 -0
- package/.agents/skills/ai-prompt-injection-defense/SKILL.md +237 -0
- package/.agents/skills/animation-on-scroll/SKILL.md +267 -0
- package/.agents/skills/animation-systems/SKILL.md +273 -0
- package/.agents/skills/antfu-conventions/SKILL.md +129 -0
- package/.agents/skills/api-patterns/SKILL.md +293 -0
- package/.agents/skills/api-patterns/scripts/api_validator.py +211 -0
- package/.agents/skills/api-security-auditor/SKILL.md +230 -0
- package/.agents/skills/app-builder/SKILL.md +610 -0
- package/.agents/skills/app-builder/templates/SKILL.md +108 -0
- package/.agents/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
- package/.agents/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
- package/.agents/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
- package/.agents/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
- package/.agents/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
- package/.agents/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
- package/.agents/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
- package/.agents/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -0
- package/.agents/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -0
- package/.agents/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -0
- package/.agents/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -0
- package/.agents/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
- package/.agents/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -0
- package/.agents/skills/appflow-wireframe/SKILL.md +173 -0
- package/.agents/skills/apple-design/SKILL.md +164 -0
- package/.agents/skills/architecture/SKILL.md +263 -0
- package/.agents/skills/audit-and-fix/SKILL.md +136 -0
- package/.agents/skills/authentication-best-practices/SKILL.md +232 -0
- package/.agents/skills/backend-security-expert/SKILL.md +148 -0
- package/.agents/skills/baseline-ui/SKILL.md +130 -0
- package/.agents/skills/bash-linux/SKILL.md +214 -0
- package/.agents/skills/behavioral-modes/SKILL.md +275 -0
- package/.agents/skills/better-colors/SKILL.md +191 -0
- package/.agents/skills/better-typography/SKILL.md +164 -0
- package/.agents/skills/better-ui/SKILL.md +193 -0
- package/.agents/skills/bolder/SKILL.md +124 -0
- package/.agents/skills/brainstorming/SKILL.md +534 -0
- package/.agents/skills/browser-audit/SKILL.md +170 -0
- package/.agents/skills/browser-native-ai/SKILL.md +147 -0
- package/.agents/skills/build-primitive/SKILL.md +125 -0
- package/.agents/skills/building-native-ui/SKILL.md +237 -0
- package/.agents/skills/cicd-pro/SKILL.md +487 -0
- package/.agents/skills/clarify/SKILL.md +130 -0
- package/.agents/skills/clean-code/SKILL.md +442 -0
- package/.agents/skills/cloud-architect/SKILL.md +484 -0
- package/.agents/skills/cobejs/SKILL.md +145 -0
- package/.agents/skills/code-review-checklist/SKILL.md +238 -0
- package/.agents/skills/codebase-design/SKILL.md +151 -0
- package/.agents/skills/colorize/SKILL.md +132 -0
- package/.agents/skills/compact-landing/SKILL.md +125 -0
- package/.agents/skills/company-logos/SKILL.md +129 -0
- package/.agents/skills/config-validator/SKILL.md +200 -0
- package/.agents/skills/containerization-pro/SKILL.md +497 -0
- package/.agents/skills/context-engineering-pro/SKILL.md +136 -0
- package/.agents/skills/create-design-md/SKILL.md +167 -0
- package/.agents/skills/critique/SKILL.md +154 -0
- package/.agents/skills/csharp-developer/SKILL.md +553 -0
- package/.agents/skills/data-validation-schemas/SKILL.md +372 -0
- package/.agents/skills/database-design/SKILL.md +294 -0
- package/.agents/skills/database-design/scripts/schema_validator.py +172 -0
- package/.agents/skills/delight/SKILL.md +121 -0
- package/.agents/skills/deployment-procedures/SKILL.md +207 -0
- package/.agents/skills/design-lab/SKILL.md +117 -0
- package/.agents/skills/devops-engineer/SKILL.md +380 -0
- package/.agents/skills/devops-incident-responder/SKILL.md +178 -0
- package/.agents/skills/diagnosing-bugs/SKILL.md +247 -0
- package/.agents/skills/distill/SKILL.md +120 -0
- package/.agents/skills/documentation-templates/SKILL.md +326 -0
- package/.agents/skills/domain-modeling/SKILL.md +136 -0
- package/.agents/skills/duckdb-analytical-sql/SKILL.md +125 -0
- package/.agents/skills/edge-ai-mobile/SKILL.md +116 -0
- package/.agents/skills/edge-computing/SKILL.md +218 -0
- package/.agents/skills/emil-design-eng/SKILL.md +209 -0
- package/.agents/skills/error-resilience/SKILL.md +478 -0
- package/.agents/skills/expo-router-v4/SKILL.md +146 -0
- package/.agents/skills/extract-design-system/SKILL.md +195 -0
- package/.agents/skills/fabel-protocol/SKILL.md +352 -0
- package/.agents/skills/fixing-accessibility/SKILL.md +162 -0
- package/.agents/skills/fixing-metadata/SKILL.md +158 -0
- package/.agents/skills/fixing-motion-performance/SKILL.md +153 -0
- package/.agents/skills/framer-motion-expert/SKILL.md +312 -0
- package/.agents/skills/frontend-design/SKILL.md +178 -0
- package/.agents/skills/frontend-design/scripts/accessibility_checker.py +183 -0
- package/.agents/skills/frontend-design/scripts/ux_audit.py +722 -0
- package/.agents/skills/frontend-security-expert/SKILL.md +131 -0
- package/.agents/skills/game-design-expert/SKILL.md +167 -0
- package/.agents/skills/game-engineering-expert/SKILL.md +183 -0
- package/.agents/skills/generative-ui-expert/SKILL.md +175 -0
- package/.agents/skills/geo-fundamentals/SKILL.md +183 -0
- package/.agents/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
- package/.agents/skills/git-pro/SKILL.md +476 -0
- package/.agents/skills/github-operations/SKILL.md +370 -0
- package/.agents/skills/gpt-taste/SKILL.md +125 -0
- package/.agents/skills/gsap-core/SKILL.md +352 -0
- package/.agents/skills/gsap-frameworks/SKILL.md +243 -0
- package/.agents/skills/gsap-performance/SKILL.md +169 -0
- package/.agents/skills/gsap-plugins/SKILL.md +516 -0
- package/.agents/skills/gsap-react/SKILL.md +288 -0
- package/.agents/skills/gsap-scrolltrigger/SKILL.md +387 -0
- package/.agents/skills/gsap-timeline/SKILL.md +197 -0
- package/.agents/skills/gsap-utils/SKILL.md +374 -0
- package/.agents/skills/harden/SKILL.md +130 -0
- package/.agents/skills/harness-protocol/SKILL.md +115 -0
- package/.agents/skills/i18n-localization/SKILL.md +209 -0
- package/.agents/skills/i18n-localization/scripts/i18n_checker.py +241 -0
- package/.agents/skills/impeccable/SKILL.md +127 -0
- package/.agents/skills/improve-codebase-architecture/SKILL.md +123 -0
- package/.agents/skills/improve-ui/SKILL.md +145 -0
- package/.agents/skills/intelligent-routing/SKILL.md +283 -0
- package/.agents/skills/knowledge-graph/SKILL.md +146 -0
- package/.agents/skills/landing-page/SKILL.md +140 -0
- package/.agents/skills/lint-and-validate/SKILL.md +299 -0
- package/.agents/skills/lint-and-validate/scripts/lint_runner.py +184 -0
- package/.agents/skills/lint-and-validate/scripts/type_coverage.py +173 -0
- package/.agents/skills/llm-engineering/SKILL.md +435 -0
- package/.agents/skills/local-first/SKILL.md +213 -0
- package/.agents/skills/local-first-architecture/SKILL.md +137 -0
- package/.agents/skills/lottie-animation/SKILL.md +137 -0
- package/.agents/skills/marquee-loop/SKILL.md +147 -0
- package/.agents/skills/masked-reveal/SKILL.md +305 -0
- package/.agents/skills/mcp-builder/SKILL.md +180 -0
- package/.agents/skills/micro-interaction/SKILL.md +321 -0
- package/.agents/skills/mobile-design/SKILL.md +320 -0
- package/.agents/skills/mobile-design/scripts/mobile_audit.py +670 -0
- package/.agents/skills/monorepo-management/SKILL.md +370 -0
- package/.agents/skills/morphing-icons/SKILL.md +423 -0
- package/.agents/skills/motion-engineering/SKILL.md +272 -0
- package/.agents/skills/nextjs-react-expert/SKILL.md +293 -0
- package/.agents/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
- package/.agents/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
- package/.agents/skills/nodejs-best-practices/SKILL.md +617 -0
- package/.agents/skills/observability/SKILL.md +378 -0
- package/.agents/skills/opentelemetry-observability/SKILL.md +125 -0
- package/.agents/skills/page-transition-animation/SKILL.md +161 -0
- package/.agents/skills/parallel-agents/SKILL.md +185 -0
- package/.agents/skills/performance-profiling/SKILL.md +305 -0
- package/.agents/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
- package/.agents/skills/plan-writing/SKILL.md +202 -0
- package/.agents/skills/platform-engineer/SKILL.md +183 -0
- package/.agents/skills/platform-engineering-opentofu/SKILL.md +133 -0
- package/.agents/skills/playwright-ai-e2e/SKILL.md +126 -0
- package/.agents/skills/playwright-best-practices/SKILL.md +224 -0
- package/.agents/skills/polish/SKILL.md +114 -0
- package/.agents/skills/powershell-windows/SKILL.md +197 -0
- package/.agents/skills/pricing-page/SKILL.md +123 -0
- package/.agents/skills/product-aware-heuristics/SKILL.md +465 -0
- package/.agents/skills/progressive-blur/SKILL.md +155 -0
- package/.agents/skills/project-idioms/SKILL.md +166 -0
- package/.agents/skills/property-based-testing/SKILL.md +124 -0
- package/.agents/skills/python-patterns/SKILL.md +295 -0
- package/.agents/skills/python-pro/SKILL.md +380 -0
- package/.agents/skills/quieter/SKILL.md +124 -0
- package/.agents/skills/react-doctor/SKILL.md +126 -0
- package/.agents/skills/react-specialist/SKILL.md +355 -0
- package/.agents/skills/readme-builder/SKILL.md +345 -0
- package/.agents/skills/realtime-patterns/SKILL.md +358 -0
- package/.agents/skills/red-team-tactics/SKILL.md +266 -0
- package/.agents/skills/redesign-skill/SKILL.md +121 -0
- package/.agents/skills/review-animations/SKILL.md +120 -0
- package/.agents/skills/review-animations/STANDARDS.md +87 -0
- package/.agents/skills/rust-pro/SKILL.md +727 -0
- package/.agents/skills/seo-fundamentals/SKILL.md +214 -0
- package/.agents/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
- package/.agents/skills/server-management/SKILL.md +253 -0
- package/.agents/skills/shadcn-ui-expert/SKILL.md +271 -0
- package/.agents/skills/shape/SKILL.md +131 -0
- package/.agents/skills/skill-creator/SKILL.md +136 -0
- package/.agents/skills/soft-skill/SKILL.md +128 -0
- package/.agents/skills/sounds-on-the-web/SKILL.md +151 -0
- package/.agents/skills/sql-pro/SKILL.md +699 -0
- package/.agents/skills/supabase-postgres-best-practices/SKILL.md +132 -0
- package/.agents/skills/svg-animation/SKILL.md +431 -0
- package/.agents/skills/swiftui-expert/SKILL.md +239 -0
- package/.agents/skills/swiss-design/SKILL.md +119 -0
- package/.agents/skills/system-design-pro/SKILL.md +393 -0
- package/.agents/skills/systematic-debugging/SKILL.md +198 -0
- package/.agents/skills/systematic-debugging/condition-based-waiting.md +115 -0
- package/.agents/skills/systematic-debugging/defense-in-depth.md +122 -0
- package/.agents/skills/systematic-debugging/root-cause-tracing.md +169 -0
- package/.agents/skills/tailwind-patterns/SKILL.md +658 -0
- package/.agents/skills/taste-skill/SKILL.md +127 -0
- package/.agents/skills/tdd-workflow/SKILL.md +179 -0
- package/.agents/skills/test-result-analyzer/SKILL.md +345 -0
- package/.agents/skills/testing-patterns/SKILL.md +609 -0
- package/.agents/skills/testing-patterns/scripts/test_runner.py +219 -0
- package/.agents/skills/thermo-nuclear-code-quality-review/SKILL.md +137 -0
- package/.agents/skills/thinking-protocol/SKILL.md +97 -0
- package/.agents/skills/to-spring-or-not-to-spring/SKILL.md +118 -0
- package/.agents/skills/transitions-dev/SKILL.md +165 -0
- package/.agents/skills/trend-researcher/SKILL.md +273 -0
- package/.agents/skills/typescript-advanced/SKILL.md +381 -0
- package/.agents/skills/typeset/SKILL.md +135 -0
- package/.agents/skills/ui-reasoning-engine/SKILL.md +230 -0
- package/.agents/skills/ui-skill-packs/SKILL.md +132 -0
- package/.agents/skills/ui-skills-root/SKILL.md +144 -0
- package/.agents/skills/ui-ux-pro-max/SKILL.md +185 -0
- package/.agents/skills/ui-ux-researcher/SKILL.md +274 -0
- package/.agents/skills/vector-search-pgvector/SKILL.md +144 -0
- package/.agents/skills/verification-before-completion/SKILL.md +178 -0
- package/.agents/skills/vue-expert/SKILL.md +334 -0
- package/.agents/skills/vulnerability-scanner/SKILL.md +453 -0
- package/.agents/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
- package/.agents/skills/web-accessibility-auditor/SKILL.md +254 -0
- package/.agents/skills/web-design-guidelines/SKILL.md +124 -0
- package/.agents/skills/web-quality-audit/SKILL.md +122 -0
- package/.agents/skills/webapp-testing/SKILL.md +203 -0
- package/.agents/skills/webapp-testing/scripts/playwright_runner.py +173 -0
- package/.agents/skills/webgpu-performance/SKILL.md +163 -0
- package/.agents/skills/whimsy-injector/SKILL.md +380 -0
- package/.agents/skills/workflow-optimizer/SKILL.md +263 -0
- package/.agents/skills/zero-trust-passkeys/SKILL.md +156 -0
- package/.claude-plugin/marketplace.json +14 -0
- package/.claude-plugin/plugin.json +26 -0
- package/.codex-plugin/plugin.json +45 -0
- package/.cursor-plugin/plugin.json +26 -0
- package/.devin-plugin/plugin.json +14 -0
- package/.hermes-plugin/__init__.py +102 -0
- package/.hermes-plugin/plugin.yaml +6 -0
- package/.kimi-plugin/plugin.json +38 -0
- package/.opencode/INSTALL.md +41 -0
- package/.opencode/plugins/tribunal.js +101 -0
- package/.opencode/rules.md +258 -0
- package/.pi/extensions/tribunal.ts +133 -0
- package/AGENTS.md +91 -0
- package/CLAUDE.md +442 -0
- package/CONTRIBUTING.md +1 -1
- package/README.md +273 -251
- package/bin/adapter-install.js +40 -16
- package/bin/mcp-server.js +426 -0
- package/bin/proxy-server.js +18 -9
- package/bin/spawn-agent.js +9 -3
- package/bin/wrapper.js +20 -4
- package/dist/browser/audit.js +229 -0
- package/dist/browser/case_bridge.js +189 -0
- package/dist/browser/cdp.js +513 -0
- package/dist/browser/compare.js +110 -0
- package/dist/browser/discovery.js +140 -0
- package/dist/browser/idpi.js +142 -0
- package/dist/browser/index.js +89 -0
- package/dist/browser/launcher.js +154 -0
- package/dist/browser/sentinel.js +202 -0
- package/dist/browser/synapse.js +251 -0
- package/dist/browser/trimmer.js +210 -0
- package/dist/cli.js +377 -355
- package/dist/commands/audit-web.js +112 -0
- package/dist/commands/browse.js +56 -0
- package/dist/commands/compare-web.js +61 -0
- package/dist/commands/deconstruct.js +58 -0
- package/dist/commands/heal.js +99 -0
- package/dist/commands/init.js +10 -1
- package/dist/commands/sdd.js +229 -0
- package/dist/commands/uninstall.js +12 -0
- package/dist/esm/index.mjs +142 -142
- package/dist/index.d.ts +349 -343
- package/gemini-extension.json +6 -0
- package/hooks/hooks-cursor.json +10 -0
- package/hooks/hooks.json +10 -0
- package/hooks/session-start.js +77 -0
- package/marketplace.json +14 -0
- package/package.json +176 -146
- package/plugin.json +26 -0
- package/scripts/audit_skill_sdo.js +87 -0
- package/scripts/clean-pycache.js +42 -0
- package/scripts/context_compiler.js +944 -0
- package/scripts/modernize_skills.js +254 -0
- package/scripts/package-cores.js +113 -0
- package/scripts/skill_enhancement_engine.js +473 -0
- package/scripts/sync-skills.js +61 -0
- package/skills/12-principles-of-animation/SKILL.md +126 -0
- package/skills/60fps-animation/SKILL.md +164 -0
- package/skills/accessible-animation/SKILL.md +266 -0
- package/skills/adapt/SKILL.md +131 -0
- package/skills/advanced-rag-pipelines/SKILL.md +169 -0
- package/skills/agent-organizer/SKILL.md +192 -0
- package/skills/agentic-patterns/SKILL.md +356 -0
- package/skills/agentic-workflows-2026/SKILL.md +157 -0
- package/skills/ai-app-hardening/SKILL.md +125 -0
- package/skills/ai-prompt-injection-defense/SKILL.md +237 -0
- package/skills/animation-on-scroll/SKILL.md +267 -0
- package/skills/animation-systems/SKILL.md +273 -0
- package/skills/antfu-conventions/SKILL.md +129 -0
- package/skills/api-patterns/SKILL.md +293 -0
- package/skills/api-patterns/scripts/api_validator.py +211 -0
- package/skills/api-security-auditor/SKILL.md +230 -0
- package/skills/app-builder/SKILL.md +610 -0
- package/skills/app-builder/templates/SKILL.md +108 -0
- package/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
- package/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
- package/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
- package/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
- package/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
- package/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
- package/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
- package/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -0
- package/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -0
- package/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -0
- package/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -0
- package/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
- package/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -0
- package/skills/appflow-wireframe/SKILL.md +173 -0
- package/skills/apple-design/SKILL.md +164 -0
- package/skills/architecture/SKILL.md +263 -0
- package/skills/audit-and-fix/SKILL.md +136 -0
- package/skills/authentication-best-practices/SKILL.md +232 -0
- package/skills/backend-security-expert/SKILL.md +148 -0
- package/skills/baseline-ui/SKILL.md +130 -0
- package/skills/bash-linux/SKILL.md +214 -0
- package/skills/behavioral-modes/SKILL.md +275 -0
- package/skills/better-colors/SKILL.md +191 -0
- package/skills/better-typography/SKILL.md +164 -0
- package/skills/better-ui/SKILL.md +193 -0
- package/skills/bolder/SKILL.md +124 -0
- package/skills/brainstorming/SKILL.md +534 -0
- package/skills/browser-audit/SKILL.md +170 -0
- package/skills/browser-native-ai/SKILL.md +147 -0
- package/skills/build-primitive/SKILL.md +125 -0
- package/skills/building-native-ui/SKILL.md +237 -0
- package/skills/cicd-pro/SKILL.md +487 -0
- package/skills/clarify/SKILL.md +130 -0
- package/skills/clean-code/SKILL.md +442 -0
- package/skills/cloud-architect/SKILL.md +484 -0
- package/skills/cobejs/SKILL.md +145 -0
- package/skills/code-review-checklist/SKILL.md +238 -0
- package/skills/codebase-design/SKILL.md +151 -0
- package/skills/colorize/SKILL.md +132 -0
- package/skills/compact-landing/SKILL.md +125 -0
- package/skills/company-logos/SKILL.md +129 -0
- package/skills/config-validator/SKILL.md +200 -0
- package/skills/containerization-pro/SKILL.md +497 -0
- package/skills/context-engineering-pro/SKILL.md +136 -0
- package/skills/create-design-md/SKILL.md +167 -0
- package/skills/critique/SKILL.md +154 -0
- package/skills/csharp-developer/SKILL.md +553 -0
- package/skills/data-validation-schemas/SKILL.md +372 -0
- package/skills/database-design/SKILL.md +294 -0
- package/skills/database-design/scripts/schema_validator.py +172 -0
- package/skills/delight/SKILL.md +121 -0
- package/skills/deployment-procedures/SKILL.md +207 -0
- package/skills/design-lab/SKILL.md +117 -0
- package/skills/devops-engineer/SKILL.md +380 -0
- package/skills/devops-incident-responder/SKILL.md +178 -0
- package/skills/diagnosing-bugs/SKILL.md +247 -0
- package/skills/distill/SKILL.md +120 -0
- package/skills/documentation-templates/SKILL.md +326 -0
- package/skills/domain-modeling/SKILL.md +136 -0
- package/skills/duckdb-analytical-sql/SKILL.md +125 -0
- package/skills/edge-ai-mobile/SKILL.md +116 -0
- package/skills/edge-computing/SKILL.md +218 -0
- package/skills/emil-design-eng/SKILL.md +209 -0
- package/skills/error-resilience/SKILL.md +478 -0
- package/skills/expo-router-v4/SKILL.md +146 -0
- package/skills/extract-design-system/SKILL.md +195 -0
- package/skills/fabel-protocol/SKILL.md +352 -0
- package/skills/fixing-accessibility/SKILL.md +162 -0
- package/skills/fixing-metadata/SKILL.md +158 -0
- package/skills/fixing-motion-performance/SKILL.md +153 -0
- package/skills/framer-motion-expert/SKILL.md +312 -0
- package/skills/frontend-design/SKILL.md +178 -0
- package/skills/frontend-design/scripts/accessibility_checker.py +183 -0
- package/skills/frontend-design/scripts/ux_audit.py +722 -0
- package/skills/frontend-security-expert/SKILL.md +131 -0
- package/skills/game-design-expert/SKILL.md +167 -0
- package/skills/game-engineering-expert/SKILL.md +183 -0
- package/skills/generative-ui-expert/SKILL.md +175 -0
- package/skills/geo-fundamentals/SKILL.md +183 -0
- package/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
- package/skills/git-pro/SKILL.md +476 -0
- package/skills/github-operations/SKILL.md +370 -0
- package/skills/gpt-taste/SKILL.md +125 -0
- package/skills/gsap-core/SKILL.md +352 -0
- package/skills/gsap-frameworks/SKILL.md +243 -0
- package/skills/gsap-performance/SKILL.md +169 -0
- package/skills/gsap-plugins/SKILL.md +516 -0
- package/skills/gsap-react/SKILL.md +288 -0
- package/skills/gsap-scrolltrigger/SKILL.md +387 -0
- package/skills/gsap-timeline/SKILL.md +197 -0
- package/skills/gsap-utils/SKILL.md +374 -0
- package/skills/harden/SKILL.md +130 -0
- package/skills/harness-protocol/SKILL.md +115 -0
- package/skills/i18n-localization/SKILL.md +209 -0
- package/skills/i18n-localization/scripts/i18n_checker.py +241 -0
- package/skills/impeccable/SKILL.md +127 -0
- package/skills/improve-codebase-architecture/SKILL.md +123 -0
- package/skills/improve-ui/SKILL.md +145 -0
- package/skills/intelligent-routing/SKILL.md +283 -0
- package/skills/knowledge-graph/SKILL.md +146 -0
- package/skills/landing-page/SKILL.md +140 -0
- package/skills/lint-and-validate/SKILL.md +299 -0
- package/skills/lint-and-validate/scripts/lint_runner.py +184 -0
- package/skills/lint-and-validate/scripts/type_coverage.py +173 -0
- package/skills/llm-engineering/SKILL.md +435 -0
- package/skills/local-first/SKILL.md +213 -0
- package/skills/local-first-architecture/SKILL.md +137 -0
- package/skills/lottie-animation/SKILL.md +137 -0
- package/skills/marquee-loop/SKILL.md +147 -0
- package/skills/masked-reveal/SKILL.md +305 -0
- package/skills/mcp-builder/SKILL.md +180 -0
- package/skills/micro-interaction/SKILL.md +321 -0
- package/skills/mobile-design/SKILL.md +320 -0
- package/skills/mobile-design/scripts/mobile_audit.py +670 -0
- package/skills/monorepo-management/SKILL.md +370 -0
- package/skills/morphing-icons/SKILL.md +423 -0
- package/skills/motion-engineering/SKILL.md +272 -0
- package/skills/nextjs-react-expert/SKILL.md +293 -0
- package/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
- package/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
- package/skills/nodejs-best-practices/SKILL.md +617 -0
- package/skills/observability/SKILL.md +378 -0
- package/skills/opentelemetry-observability/SKILL.md +125 -0
- package/skills/page-transition-animation/SKILL.md +161 -0
- package/skills/parallel-agents/SKILL.md +185 -0
- package/skills/performance-profiling/SKILL.md +305 -0
- package/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
- package/skills/plan-writing/SKILL.md +202 -0
- package/skills/platform-engineer/SKILL.md +183 -0
- package/skills/platform-engineering-opentofu/SKILL.md +133 -0
- package/skills/playwright-ai-e2e/SKILL.md +126 -0
- package/skills/playwright-best-practices/SKILL.md +224 -0
- package/skills/polish/SKILL.md +114 -0
- package/skills/powershell-windows/SKILL.md +197 -0
- package/skills/pricing-page/SKILL.md +123 -0
- package/skills/product-aware-heuristics/SKILL.md +465 -0
- package/skills/progressive-blur/SKILL.md +155 -0
- package/skills/project-idioms/SKILL.md +166 -0
- package/skills/property-based-testing/SKILL.md +124 -0
- package/skills/python-patterns/SKILL.md +295 -0
- package/skills/python-pro/SKILL.md +380 -0
- package/skills/quieter/SKILL.md +124 -0
- package/skills/react-doctor/SKILL.md +126 -0
- package/skills/react-specialist/SKILL.md +355 -0
- package/skills/readme-builder/SKILL.md +345 -0
- package/skills/realtime-patterns/SKILL.md +358 -0
- package/skills/red-team-tactics/SKILL.md +266 -0
- package/skills/redesign-skill/SKILL.md +121 -0
- package/skills/review-animations/SKILL.md +120 -0
- package/skills/review-animations/STANDARDS.md +87 -0
- package/skills/rust-pro/SKILL.md +727 -0
- package/skills/seo-fundamentals/SKILL.md +214 -0
- package/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
- package/skills/server-management/SKILL.md +253 -0
- package/skills/shadcn-ui-expert/SKILL.md +271 -0
- package/skills/shape/SKILL.md +131 -0
- package/skills/skill-creator/SKILL.md +136 -0
- package/skills/soft-skill/SKILL.md +128 -0
- package/skills/sounds-on-the-web/SKILL.md +151 -0
- package/skills/sql-pro/SKILL.md +699 -0
- package/skills/supabase-postgres-best-practices/SKILL.md +132 -0
- package/skills/svg-animation/SKILL.md +431 -0
- package/skills/swiftui-expert/SKILL.md +239 -0
- package/skills/swiss-design/SKILL.md +119 -0
- package/skills/system-design-pro/SKILL.md +393 -0
- package/skills/systematic-debugging/SKILL.md +198 -0
- package/skills/systematic-debugging/condition-based-waiting.md +115 -0
- package/skills/systematic-debugging/defense-in-depth.md +122 -0
- package/skills/systematic-debugging/root-cause-tracing.md +169 -0
- package/skills/tailwind-patterns/SKILL.md +658 -0
- package/skills/taste-skill/SKILL.md +127 -0
- package/skills/tdd-workflow/SKILL.md +179 -0
- package/skills/test-result-analyzer/SKILL.md +345 -0
- package/skills/testing-patterns/SKILL.md +609 -0
- package/skills/testing-patterns/scripts/test_runner.py +219 -0
- package/skills/thermo-nuclear-code-quality-review/SKILL.md +137 -0
- package/skills/thinking-protocol/SKILL.md +97 -0
- package/skills/to-spring-or-not-to-spring/SKILL.md +118 -0
- package/skills/transitions-dev/SKILL.md +165 -0
- package/skills/trend-researcher/SKILL.md +273 -0
- package/skills/typescript-advanced/SKILL.md +381 -0
- package/skills/typeset/SKILL.md +135 -0
- package/skills/ui-reasoning-engine/SKILL.md +230 -0
- package/skills/ui-skill-packs/SKILL.md +132 -0
- package/skills/ui-skills-root/SKILL.md +144 -0
- package/skills/ui-ux-pro-max/SKILL.md +185 -0
- package/skills/ui-ux-researcher/SKILL.md +274 -0
- package/skills/vector-search-pgvector/SKILL.md +144 -0
- package/skills/verification-before-completion/SKILL.md +178 -0
- package/skills/vue-expert/SKILL.md +334 -0
- package/skills/vulnerability-scanner/SKILL.md +453 -0
- package/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
- package/skills/web-accessibility-auditor/SKILL.md +254 -0
- package/skills/web-design-guidelines/SKILL.md +124 -0
- package/skills/web-quality-audit/SKILL.md +122 -0
- package/skills/webapp-testing/SKILL.md +203 -0
- package/skills/webapp-testing/scripts/playwright_runner.py +173 -0
- package/skills/webgpu-performance/SKILL.md +163 -0
- package/skills/whimsy-injector/SKILL.md +380 -0
- package/skills/workflow-optimizer/SKILL.md +263 -0
- package/skills/zero-trust-passkeys/SKILL.md +156 -0
- package/.agent/skills/api-patterns/scripts/__pycache__/api_validator.cpython-311.pyc +0 -0
- package/.agent/skills/database-design/scripts/__pycache__/schema_validator.cpython-311.pyc +0 -0
- package/.agent/skills/frontend-design/scripts/__pycache__/accessibility_checker.cpython-311.pyc +0 -0
- package/.agent/skills/frontend-design/scripts/__pycache__/ux_audit.cpython-311.pyc +0 -0
- package/.agent/skills/geo-fundamentals/scripts/__pycache__/geo_checker.cpython-311.pyc +0 -0
- package/.agent/skills/i18n-localization/scripts/__pycache__/i18n_checker.cpython-311.pyc +0 -0
- package/.agent/skills/lint-and-validate/scripts/__pycache__/lint_runner.cpython-311.pyc +0 -0
- package/.agent/skills/lint-and-validate/scripts/__pycache__/type_coverage.cpython-311.pyc +0 -0
- package/.agent/skills/mobile-design/scripts/__pycache__/mobile_audit.cpython-311.pyc +0 -0
- package/.agent/skills/nextjs-react-expert/scripts/__pycache__/convert_rules.cpython-311.pyc +0 -0
- package/.agent/skills/nextjs-react-expert/scripts/__pycache__/react_performance_checker.cpython-311.pyc +0 -0
- package/.agent/skills/performance-profiling/scripts/__pycache__/lighthouse_audit.cpython-311.pyc +0 -0
- package/.agent/skills/seo-fundamentals/scripts/__pycache__/seo_checker.cpython-311.pyc +0 -0
- package/.agent/skills/testing-patterns/scripts/__pycache__/test_runner.cpython-311.pyc +0 -0
- package/.agent/skills/vulnerability-scanner/scripts/__pycache__/security_scan.cpython-311.pyc +0 -0
- package/.agent/skills/webapp-testing/scripts/__pycache__/playwright_runner.cpython-311.pyc +0 -0
|
@@ -1,28 +1,54 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: property-based-testing
|
|
3
|
-
description: Generative input invariant testing using fast-check (TS/JS) and hypothesis (Python) to uncover hidden edge cases and boundary failures.
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
last-updated: 2026-08-05
|
|
7
|
-
script: .agent/scripts/test_runner.js
|
|
8
|
-
scripts-binding:
|
|
9
|
-
- .agent/scripts/test_runner.js
|
|
10
|
-
- .agent/scripts/inner_loop_validator.js
|
|
3
|
+
description: Use when Generative input invariant testing using fast-check (TS/JS) and hypothesis (Python) to uncover hidden edge cases and boundary failures.
|
|
4
|
+
version: 5.0.0
|
|
5
|
+
last-updated: 2026-09-13
|
|
11
6
|
skills:
|
|
12
7
|
- testing-patterns
|
|
13
8
|
- tdd-workflow
|
|
14
9
|
- clean-code
|
|
10
|
+
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
11
|
+
scripts-binding:
|
|
12
|
+
- .agent/scripts/test_runner.js
|
|
13
|
+
- .agent/scripts/inner_loop_validator.js
|
|
14
|
+
- .agent/scripts/lint_runner.js
|
|
15
|
+
- .agent/scripts/verify_all.js
|
|
15
16
|
---
|
|
16
17
|
|
|
17
18
|
# Property-Based Testing — Invariant Verification
|
|
18
19
|
|
|
19
20
|
## Mandatory Pre-Flight Context Inspection
|
|
20
21
|
|
|
21
|
-
Before
|
|
22
|
+
Before generating, refactoring, or reviewing code in the `property-based-testing` domain, inspect these 5 critical parameters:
|
|
23
|
+
|
|
24
|
+
1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
|
|
25
|
+
2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
|
|
26
|
+
3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
|
|
27
|
+
4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
|
|
28
|
+
5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
|
|
29
|
+
|
|
30
|
+
## Activation Boundaries
|
|
22
31
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
32
|
+
- **Activate when:** Use when Generative input invariant testing using fast-check (TS/JS) and hypothesis (Python) to uncover hidden edge cases and boundary failures.
|
|
33
|
+
- **DO NOT activate when:** The task falls outside the `property-based-testing` domain or is managed by a different dedicated specialist.
|
|
34
|
+
|
|
35
|
+
## 🔁 Multi-Pass Execution Protocol
|
|
36
|
+
|
|
37
|
+
Execute all non-trivial tasks through this 7-pass cognitive loop:
|
|
38
|
+
|
|
39
|
+
| Pass | Phase | Core Action |
|
|
40
|
+
|:---|:---|:---|
|
|
41
|
+
| **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. |
|
|
42
|
+
| **Pass 2** | **Plan** | Decompose the task into smallest logical steps; map dependencies and required tool calls. |
|
|
43
|
+
| **Pass 3** | **Execute** | Implement the solution with production-grade craft, zero placeholders, and strict typing. |
|
|
44
|
+
| **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. |
|
|
45
|
+
| **Pass 5** | **Attack** | Perform an adversarial review searching for edge-case failures, race conditions, and traps. |
|
|
46
|
+
| **Pass 6** | **Improve** | Eliminate discovered friction, optimize performance, and harden error boundaries. |
|
|
47
|
+
| **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. |
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## 🛠️ Technical Architecture & Reference Recipes
|
|
26
52
|
|
|
27
53
|
## Fast-Check Arbitrary Generator & Vitest Invariant Test
|
|
28
54
|
|
|
@@ -52,7 +78,47 @@ test('currency parser invariant: non-negative parsed numbers', () => {
|
|
|
52
78
|
});
|
|
53
79
|
```
|
|
54
80
|
|
|
55
|
-
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## 🚨 Edge-Case & Failure Mode Matrix
|
|
84
|
+
|
|
85
|
+
| Scenario | Risk | Mitigation Strategy |
|
|
86
|
+
|:---|:---|:---|
|
|
87
|
+
| **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
|
|
88
|
+
| **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
|
|
89
|
+
| **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
|
|
90
|
+
| **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
|
|
91
|
+
| **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## 🤖 LLM-Specific Traps Table
|
|
96
|
+
|
|
97
|
+
| Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
|
|
98
|
+
|:---|:---|:---|
|
|
99
|
+
| **Testing Implementation Details** | Asserting on private component state or internal helper functions | Assert on observable user behaviors, DOM roles, and network outcomes |
|
|
100
|
+
| **Flaky Async Assertion** | Using arbitrary setTimeout delays before asserting on asynchronous state | Use waitFor or findBy queries that poll with timeout bounds |
|
|
101
|
+
| **Shared Mutable State** | Reusing database records across concurrent test runners | Isolate test databases per worker or execute in rolled-back transactions |
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## 🏛️ Tribunal Verification & Guardrails
|
|
106
|
+
|
|
107
|
+
**Active Reviewers:** `test-engineer` · `qa-automation-engineer` · `logic-reviewer`
|
|
108
|
+
**Slash Command:** `/review` or `/tribunal-full`
|
|
109
|
+
|
|
110
|
+
### ✅ Pre-Flight Self-Audit Checklist
|
|
111
|
+
|
|
112
|
+
```
|
|
113
|
+
✅ Do tests follow behavioral GIVEN/WHEN/THEN specifications?
|
|
114
|
+
✅ Are happy path, failure paths, and boundary conditions (0, null, max) covered?
|
|
115
|
+
✅ Are test mocks isolated and reset between successive suites?
|
|
116
|
+
✅ Do E2E locators rely on stable ARIA attributes instead of brittle CSS selectors?
|
|
117
|
+
✅ Did I verify test suite passes without flaky race conditions?
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
56
121
|
|
|
57
|
-
|
|
58
|
-
-
|
|
122
|
+
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
123
|
+
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
124
|
+
- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: python-patterns
|
|
3
|
-
description: Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Teaches thinking, not copying.
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
last-updated: 2026-07-30
|
|
3
|
+
description: Use when Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Teaches thinking, not copying.
|
|
4
|
+
version: 5.0.0
|
|
5
|
+
last-updated: 2026-09-13
|
|
7
6
|
skills:
|
|
8
7
|
- python-pro
|
|
9
8
|
- clean-code
|
|
10
9
|
- data-validation-schemas
|
|
10
|
+
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
11
11
|
scripts-binding:
|
|
12
12
|
- .agent/scripts/lint_runner.js
|
|
13
13
|
- .agent/scripts/verify_all.js
|
|
@@ -15,15 +15,41 @@ scripts-binding:
|
|
|
15
15
|
|
|
16
16
|
# Python Development Principles
|
|
17
17
|
|
|
18
|
+
## Mandatory Pre-Flight Context Inspection
|
|
19
|
+
|
|
20
|
+
Before generating, refactoring, or reviewing code in the `python-patterns` domain, inspect these 5 critical parameters:
|
|
21
|
+
|
|
22
|
+
1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
|
|
23
|
+
2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
|
|
24
|
+
3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
|
|
25
|
+
4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
|
|
26
|
+
5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
|
|
27
|
+
|
|
28
|
+
## Activation Boundaries
|
|
29
|
+
|
|
30
|
+
- **Activate when:** Use when Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Teaches thinking, not copying.
|
|
31
|
+
- **DO NOT activate when:** The task falls outside the `python-patterns` domain or is managed by a different dedicated specialist.
|
|
32
|
+
|
|
33
|
+
## 🔁 Multi-Pass Execution Protocol
|
|
34
|
+
|
|
35
|
+
Execute all non-trivial tasks through this 7-pass cognitive loop:
|
|
36
|
+
|
|
37
|
+
| Pass | Phase | Core Action |
|
|
38
|
+
|:---|:---|:---|
|
|
39
|
+
| **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. |
|
|
40
|
+
| **Pass 2** | **Plan** | Decompose the task into smallest logical steps; map dependencies and required tool calls. |
|
|
41
|
+
| **Pass 3** | **Execute** | Implement the solution with production-grade craft, zero placeholders, and strict typing. |
|
|
42
|
+
| **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. |
|
|
43
|
+
| **Pass 5** | **Attack** | Perform an adversarial review searching for edge-case failures, race conditions, and traps. |
|
|
44
|
+
| **Pass 6** | **Improve** | Eliminate discovered friction, optimize performance, and harden error boundaries. |
|
|
45
|
+
| **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. |
|
|
46
|
+
|
|
18
47
|
---
|
|
19
48
|
|
|
20
|
-
##
|
|
49
|
+
## 🛠️ Technical Architecture & Reference Recipes
|
|
21
50
|
|
|
22
|
-
|
|
51
|
+
---
|
|
23
52
|
|
|
24
|
-
1. Typed Data Models over Dicts (Section 15) → Use Pydantic models or `@dataclass` for structured data; ban un-typed `dict` passing
|
|
25
|
-
2. Specific Exception Handling (Section 16) → Catch explicit exceptions (`ValueError`, `AppError`); ban bare `except:` or generic `except Exception:` swallowing
|
|
26
|
-
3. Pathlib Modern API (Section 17) → Use `pathlib.Path` for cross-platform filesystem operations; ban legacy `os.path`
|
|
27
53
|
|
|
28
54
|
## Hallucination Traps (Read First)
|
|
29
55
|
|
|
@@ -33,8 +59,6 @@ Before architecting Python projects or selecting frameworks, you MUST inspect:
|
|
|
33
59
|
|
|
34
60
|
---
|
|
35
61
|
|
|
36
|
-
# Python Development Principles
|
|
37
|
-
|
|
38
62
|
---
|
|
39
63
|
|
|
40
64
|
## Framework Selection
|
|
@@ -227,91 +251,45 @@ Do not mark status as VERIFIED until concrete terminal evidence is provided.
|
|
|
227
251
|
|
|
228
252
|
---
|
|
229
253
|
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
|
|
254
|
+
## 🚨 Edge-Case & Failure Mode Matrix
|
|
233
255
|
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
256
|
+
| Scenario | Risk | Mitigation Strategy |
|
|
257
|
+
|:---|:---|:---|
|
|
258
|
+
| **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
|
|
259
|
+
| **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
|
|
260
|
+
| **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
|
|
261
|
+
| **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
|
|
262
|
+
| **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
|
|
239
263
|
|
|
240
264
|
---
|
|
241
265
|
|
|
242
|
-
|
|
243
|
-
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
244
|
-
|
|
245
|
-
### ❌ Forbidden AI Tropes
|
|
246
|
-
|
|
247
|
-
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
248
|
-
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
249
|
-
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
266
|
+
## 🤖 LLM-Specific Traps Table
|
|
250
267
|
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
✅ Did I handle potential failure modes and edge cases?
|
|
257
|
-
✅ Have I avoided generic boilerplate that doesn't add value?
|
|
258
|
-
```
|
|
259
|
-
|
|
260
|
-
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
261
|
-
|
|
262
|
-
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
263
|
-
|
|
264
|
-
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
265
|
-
- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
|
|
266
|
-
|
|
267
|
-
## Pre-Flight Checklist
|
|
268
|
-
|
|
269
|
-
- [ ] Have I reviewed the user's specific constraints and requests?
|
|
270
|
-
- [ ] Have I checked the environment for relevant existing implementations?
|
|
271
|
-
|
|
272
|
-
## VBC Protocol (Verification-Before-Completion)
|
|
273
|
-
|
|
274
|
-
You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
|
|
275
|
-
|
|
276
|
-
---
|
|
277
|
-
|
|
278
|
-
## 🤖 LLM-Specific Traps
|
|
279
|
-
|
|
280
|
-
AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
|
|
281
|
-
|
|
282
|
-
1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
|
|
283
|
-
2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
|
|
284
|
-
3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
|
|
285
|
-
4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
286
|
-
5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
|
|
268
|
+
| Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
|
|
269
|
+
|:---|:---|:---|
|
|
270
|
+
| **Unchecked Payload Cast** | Casting request bodies to TypeScript types without runtime schema validation | Parse request payloads through Zod/Pydantic schemas before business logic |
|
|
271
|
+
| **Silent Error Swallowing** | Catching errors with empty catch blocks or logging without rethrowing | Propagate structured errors with status codes and contextual stack traces |
|
|
272
|
+
| **Unparameterized Query** | Concatenating user inputs into SQL/Prisma query strings | Always use parameterized bindings or type-safe ORM query builders |
|
|
287
273
|
|
|
288
274
|
---
|
|
289
275
|
|
|
290
|
-
## 🏛️ Tribunal
|
|
291
|
-
|
|
292
|
-
**Slash command: `/review` or `/tribunal-full`**
|
|
293
|
-
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
294
|
-
|
|
295
|
-
### ❌ Forbidden AI Tropes
|
|
276
|
+
## 🏛️ Tribunal Verification & Guardrails
|
|
296
277
|
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
278
|
+
**Active Reviewers:** `logic-reviewer` · `security-auditor` · `api-architect` · `resilience-reviewer`
|
|
279
|
+
**Slash Command:** `/review` or `/tribunal-full`
|
|
300
280
|
|
|
301
|
-
### ✅ Pre-Flight Self-Audit
|
|
302
|
-
|
|
303
|
-
Review these questions before confirming output:
|
|
281
|
+
### ✅ Pre-Flight Self-Audit Checklist
|
|
304
282
|
|
|
305
283
|
```
|
|
306
|
-
✅
|
|
307
|
-
✅
|
|
308
|
-
✅
|
|
309
|
-
✅
|
|
284
|
+
✅ Are all inputs and boundary payloads validated against schemas (Zod/Pydantic)?
|
|
285
|
+
✅ Are SQL and database queries parameterized with zero string concatenation?
|
|
286
|
+
✅ Are error boundaries and timeout/retry policies explicitly declared?
|
|
287
|
+
✅ Are authentication checks performed before business logic execution?
|
|
288
|
+
✅ Did I verify that imported dependencies exist in package.json/requirements.txt?
|
|
310
289
|
```
|
|
311
290
|
|
|
312
291
|
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
313
292
|
|
|
314
293
|
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
315
|
-
|
|
316
294
|
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
317
|
-
- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing
|
|
295
|
+
- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: python-pro
|
|
3
|
-
description: Python 3.12+ specialist. FastAPI, Pydantic v2, asyncio, modern types, pytest. Use when building Python APIs, data pipelines, automation, or any Python code.
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
last-updated: 2026-07-30
|
|
3
|
+
description: Use when Python 3.12+ specialist. FastAPI, Pydantic v2, asyncio, modern types, pytest. Use when building Python APIs, data pipelines, automation, or any Python code.
|
|
4
|
+
version: 5.0.0
|
|
5
|
+
last-updated: 2026-09-13
|
|
7
6
|
skills:
|
|
8
7
|
- python-patterns
|
|
9
8
|
- data-validation-schemas
|
|
10
9
|
- api-patterns
|
|
10
|
+
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
11
11
|
scripts-binding:
|
|
12
12
|
- .agent/scripts/lint_runner.js
|
|
13
13
|
- .agent/scripts/verify_all.js
|
|
@@ -15,28 +15,70 @@ scripts-binding:
|
|
|
15
15
|
|
|
16
16
|
# Python 3.12+ — Dense Reference
|
|
17
17
|
|
|
18
|
+
## Mandatory Pre-Flight Context Inspection
|
|
19
|
+
|
|
20
|
+
Before generating, refactoring, or reviewing code in the `python-pro` domain, inspect these 5 critical parameters:
|
|
21
|
+
|
|
22
|
+
1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
|
|
23
|
+
2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
|
|
24
|
+
3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
|
|
25
|
+
4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
|
|
26
|
+
5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
|
|
27
|
+
|
|
28
|
+
## Activation Boundaries
|
|
29
|
+
|
|
30
|
+
- **Activate when:** Use when Python 3.12+ specialist. FastAPI, Pydantic v2, asyncio, modern types, pytest. Use when building Python APIs, data pipelines, automation, or any Python code.
|
|
31
|
+
- **DO NOT activate when:** The task falls outside the `python-pro` domain or is managed by a different dedicated specialist.
|
|
32
|
+
|
|
33
|
+
## 🔁 Multi-Pass Execution Protocol
|
|
34
|
+
|
|
35
|
+
Execute all non-trivial tasks through this 7-pass cognitive loop:
|
|
36
|
+
|
|
37
|
+
| Pass | Phase | Core Action |
|
|
38
|
+
|:---|:---|:---|
|
|
39
|
+
| **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. |
|
|
40
|
+
| **Pass 2** | **Plan** | Decompose the task into smallest logical steps; map dependencies and required tool calls. |
|
|
41
|
+
| **Pass 3** | **Execute** | Implement the solution with production-grade craft, zero placeholders, and strict typing. |
|
|
42
|
+
| **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. |
|
|
43
|
+
| **Pass 5** | **Attack** | Perform an adversarial review searching for edge-case failures, race conditions, and traps. |
|
|
44
|
+
| **Pass 6** | **Improve** | Eliminate discovered friction, optimize performance, and harden error boundaries. |
|
|
45
|
+
| **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. |
|
|
46
|
+
|
|
18
47
|
---
|
|
19
48
|
|
|
20
|
-
##
|
|
49
|
+
## 🛠️ Technical Architecture & Reference Recipes
|
|
21
50
|
|
|
22
|
-
|
|
51
|
+
---
|
|
23
52
|
|
|
24
|
-
1. Pydantic v2 Migration Syntax (Section 17) → Use `model_dump()`, `model_dump_json()`, `model_validate()`, and `@field_validator`; ban v1 `.dict()` and `@validator`
|
|
25
|
-
2. Modern Native Generics (Section 16) → Use native `list[str]`, `dict[k,v]`, and `X | None` (Python 3.10+); ban legacy `typing.List` / `typing.Optional`
|
|
26
|
-
3. Non-Blocking Async Clients (Section 21) → Use `httpx.AsyncClient()` in async code; ban blocking `requests` library inside asyncio event loops
|
|
27
53
|
|
|
28
|
-
|
|
54
|
+
## 2026 Python 3.12+ Performance & Logic Invariants
|
|
55
|
+
|
|
56
|
+
1. **Structured Concurrency with `TaskGroup`**:
|
|
57
|
+
```python
|
|
58
|
+
async with asyncio.TaskGroup() as tg:
|
|
59
|
+
task1 = tg.create_task(fetch_user(user_id))
|
|
60
|
+
task2 = tg.create_task(fetch_orders(user_id))
|
|
61
|
+
# If either fails, the other is cancelled immediately; exceptions grouped in ExceptionGroup
|
|
62
|
+
```
|
|
63
|
+
2. **PEP 695 Native Type Aliases & Generics**:
|
|
64
|
+
```python
|
|
65
|
+
type Coordinates = tuple[float, float]
|
|
66
|
+
def get_first[T](items: list[T]) -> T | None:
|
|
67
|
+
return items[0] if items else None
|
|
68
|
+
```
|
|
69
|
+
3. **Pydantic v2 Zero-Copy Deserialization**: Use `TypeAdapter(list[Model]).validate_python(data)` for batch parsing.
|
|
70
|
+
4. **Connection Pooling & Lifespan**: Always manage client lifecycles using `lifespan` context managers rather than re-instantiating HTTP/DB clients per request.
|
|
29
71
|
|
|
30
72
|
## Hallucination Traps (Read First)
|
|
31
73
|
|
|
32
|
-
- ❌ `from typing import List, Dict, Optional, Union` → ✅ `list[str]`, `dict[k,v]`, `X | None`, `
|
|
74
|
+
- ❌ `from typing import List, Dict, Optional, Union, TypeVar` → ✅ Native `list[str]`, `dict[k,v]`, `X | None`, `type Alias = ...`
|
|
33
75
|
- ❌ `user.dict()` / `user.json()` / `UserCreate.parse_obj()` → ✅ Pydantic v2: `model_dump()`, `model_dump_json()`, `model_validate()`
|
|
34
76
|
- ❌ Pydantic `class Config: orm_mode = True` → ✅ `model_config = {"from_attributes": True}`
|
|
35
77
|
- ❌ `@validator` / `@root_validator` → ✅ `@field_validator` / `@model_validator`
|
|
36
|
-
- ❌ `@app.on_event("startup")` → ✅ `lifespan` context manager
|
|
37
|
-
- ❌ `import requests` in async code → ✅ `httpx.AsyncClient()`
|
|
38
|
-
- ❌ `asyncio.
|
|
39
|
-
- ❌ `except Exception as e: pass` → ✅
|
|
78
|
+
- ❌ `@app.on_event("startup")` → ✅ FastAPI `lifespan` context manager
|
|
79
|
+
- ❌ `import requests` in async code → ✅ `httpx.AsyncClient()`
|
|
80
|
+
- ❌ `asyncio.gather()` leaving orphaned tasks on error → ✅ `asyncio.TaskGroup()`
|
|
81
|
+
- ❌ `except Exception as e: pass` → ✅ Always log or re-raise
|
|
40
82
|
|
|
41
83
|
---
|
|
42
84
|
|
|
@@ -294,89 +336,45 @@ my-api/
|
|
|
294
336
|
|
|
295
337
|
---
|
|
296
338
|
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
|
|
300
|
-
2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
|
|
301
|
-
3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
|
|
302
|
-
4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
303
|
-
5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
|
|
304
|
-
|
|
305
|
-
---
|
|
306
|
-
|
|
307
|
-
**Slash command: `/review` or `/tribunal-full`**
|
|
308
|
-
**Active reviewers: `logic-reviewer` · `security-auditor`**
|
|
309
|
-
|
|
310
|
-
### ❌ Forbidden AI Tropes
|
|
339
|
+
## 🚨 Edge-Case & Failure Mode Matrix
|
|
311
340
|
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
✅ Did I rely ONLY on real, verified tools and methods?
|
|
320
|
-
✅ Is this solution appropriately scoped to the user's constraints?
|
|
321
|
-
✅ Did I handle potential failure modes and edge cases?
|
|
322
|
-
✅ Have I avoided generic boilerplate that doesn't add value?
|
|
323
|
-
```
|
|
324
|
-
|
|
325
|
-
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
326
|
-
|
|
327
|
-
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
328
|
-
|
|
329
|
-
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
330
|
-
- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
|
|
331
|
-
|
|
332
|
-
## Pre-Flight Checklist
|
|
333
|
-
|
|
334
|
-
- [ ] Have I reviewed the user's specific constraints and requests?
|
|
335
|
-
- [ ] Have I checked the environment for relevant existing implementations?
|
|
336
|
-
|
|
337
|
-
## VBC Protocol (Verification-Before-Completion)
|
|
338
|
-
|
|
339
|
-
You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
|
|
341
|
+
| Scenario | Risk | Mitigation Strategy |
|
|
342
|
+
|:---|:---|:---|
|
|
343
|
+
| **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
|
|
344
|
+
| **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
|
|
345
|
+
| **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
|
|
346
|
+
| **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
|
|
347
|
+
| **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
|
|
340
348
|
|
|
341
349
|
---
|
|
342
350
|
|
|
343
|
-
## 🤖 LLM-Specific Traps
|
|
344
|
-
|
|
345
|
-
AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
|
|
351
|
+
## 🤖 LLM-Specific Traps Table
|
|
346
352
|
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
353
|
+
| Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
|
|
354
|
+
|:---|:---|:---|
|
|
355
|
+
| **Unchecked Payload Cast** | Casting request bodies to TypeScript types without runtime schema validation | Parse request payloads through Zod/Pydantic schemas before business logic |
|
|
356
|
+
| **Silent Error Swallowing** | Catching errors with empty catch blocks or logging without rethrowing | Propagate structured errors with status codes and contextual stack traces |
|
|
357
|
+
| **Unparameterized Query** | Concatenating user inputs into SQL/Prisma query strings | Always use parameterized bindings or type-safe ORM query builders |
|
|
352
358
|
|
|
353
359
|
---
|
|
354
360
|
|
|
355
|
-
## 🏛️ Tribunal
|
|
361
|
+
## 🏛️ Tribunal Verification & Guardrails
|
|
356
362
|
|
|
357
|
-
**
|
|
358
|
-
**
|
|
363
|
+
**Active Reviewers:** `logic-reviewer` · `security-auditor` · `api-architect` · `resilience-reviewer`
|
|
364
|
+
**Slash Command:** `/review` or `/tribunal-full`
|
|
359
365
|
|
|
360
|
-
###
|
|
361
|
-
|
|
362
|
-
1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
|
|
363
|
-
2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
|
|
364
|
-
3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
|
|
365
|
-
|
|
366
|
-
### ✅ Pre-Flight Self-Audit
|
|
367
|
-
|
|
368
|
-
Review these questions before confirming output:
|
|
366
|
+
### ✅ Pre-Flight Self-Audit Checklist
|
|
369
367
|
|
|
370
368
|
```
|
|
371
|
-
✅
|
|
372
|
-
✅
|
|
373
|
-
✅
|
|
374
|
-
✅
|
|
369
|
+
✅ Are all inputs and boundary payloads validated against schemas (Zod/Pydantic)?
|
|
370
|
+
✅ Are SQL and database queries parameterized with zero string concatenation?
|
|
371
|
+
✅ Are error boundaries and timeout/retry policies explicitly declared?
|
|
372
|
+
✅ Are authentication checks performed before business logic execution?
|
|
373
|
+
✅ Did I verify that imported dependencies exist in package.json/requirements.txt?
|
|
375
374
|
```
|
|
376
375
|
|
|
377
376
|
### 🛑 Verification-Before-Completion (VBC) Protocol
|
|
378
377
|
|
|
379
378
|
**CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
|
|
380
|
-
|
|
381
379
|
- ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
|
|
382
|
-
- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing
|
|
380
|
+
- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.
|