@hybridlabor-api/bdb-antigravity-skills 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/GEMINI.md +29 -0
- package/README.md +64 -0
- package/installer.sh +97 -0
- package/mcp_config.json +32 -0
- package/package.json +20 -0
- package/skills/global_config/MCP_Manage/SKILL.md +39 -0
- package/skills/global_config/agent-manager-skill/SKILL.md +47 -0
- package/skills/global_config/agent-memory-mcp/SKILL.md +92 -0
- package/skills/global_config/agent-orchestrator/SKILL.md +321 -0
- package/skills/global_config/agent-orchestrator/references/capability-taxonomy.md +85 -0
- package/skills/global_config/agent-orchestrator/references/orchestration-patterns.md +129 -0
- package/skills/global_config/agent-orchestrator/scripts/match_skills.py +329 -0
- package/skills/global_config/agent-orchestrator/scripts/orchestrate.py +304 -0
- package/skills/global_config/agent-orchestrator/scripts/requirements.txt +1 -0
- package/skills/global_config/agent-orchestrator/scripts/scan_registry.py +508 -0
- package/skills/global_config/agent-tool-builder/SKILL.md +714 -0
- package/skills/global_config/ai-agent-development/SKILL.md +178 -0
- package/skills/global_config/ai-product/SKILL.md +753 -0
- package/skills/global_config/api-design-principles/SKILL.md +45 -0
- package/skills/global_config/api-design-principles/assets/api-design-checklist.md +155 -0
- package/skills/global_config/api-design-principles/assets/rest-api-template.py +182 -0
- package/skills/global_config/api-design-principles/references/graphql-schema-design.md +583 -0
- package/skills/global_config/api-design-principles/references/rest-best-practices.md +408 -0
- package/skills/global_config/api-design-principles/resources/implementation-playbook.md +513 -0
- package/skills/global_config/api-patterns/SKILL.md +90 -0
- package/skills/global_config/api-patterns/api-style.md +42 -0
- package/skills/global_config/api-patterns/auth.md +24 -0
- package/skills/global_config/api-patterns/documentation.md +26 -0
- package/skills/global_config/api-patterns/graphql.md +41 -0
- package/skills/global_config/api-patterns/rate-limiting.md +31 -0
- package/skills/global_config/api-patterns/response.md +37 -0
- package/skills/global_config/api-patterns/rest.md +40 -0
- package/skills/global_config/api-patterns/scripts/api_validator.py +211 -0
- package/skills/global_config/api-patterns/security-testing.md +122 -0
- package/skills/global_config/api-patterns/trpc.md +41 -0
- package/skills/global_config/api-patterns/versioning.md +22 -0
- package/skills/global_config/apify-lead-generation/SKILL.md +131 -0
- package/skills/global_config/apify-lead-generation/reference/scripts/run_actor.js +363 -0
- package/skills/global_config/apify-ultimate-scraper/SKILL.md +241 -0
- package/skills/global_config/apify-ultimate-scraper/reference/scripts/run_actor.js +363 -0
- package/skills/global_config/architect-review/SKILL.md +177 -0
- package/skills/global_config/bash-linux/SKILL.md +209 -0
- package/skills/global_config/bdbrainstorm/SKILL.md +37 -0
- package/skills/global_config/browser-automation/SKILL.md +1116 -0
- package/skills/global_config/clean-code/SKILL.md +99 -0
- package/skills/global_config/cloudflare-workers-expert/SKILL.md +94 -0
- package/skills/global_config/concise-planning/SKILL.md +73 -0
- package/skills/global_config/copywriting/SKILL.md +254 -0
- package/skills/global_config/crewai/SKILL.md +458 -0
- package/skills/global_config/database-design/SKILL.md +62 -0
- package/skills/global_config/database-design/database-selection.md +43 -0
- package/skills/global_config/database-design/indexing.md +39 -0
- package/skills/global_config/database-design/migrations.md +48 -0
- package/skills/global_config/database-design/optimization.md +36 -0
- package/skills/global_config/database-design/orm-selection.md +30 -0
- package/skills/global_config/database-design/schema-design.md +56 -0
- package/skills/global_config/database-design/scripts/schema_validator.py +172 -0
- package/skills/global_config/debugger/SKILL.md +58 -0
- package/skills/global_config/deep-research/SKILL.md +120 -0
- package/skills/global_config/design-spells/SKILL.md +41 -0
- package/skills/global_config/design-taste-frontend/SKILL.md +247 -0
- package/skills/global_config/docker-expert/SKILL.md +418 -0
- package/skills/global_config/documentation/SKILL.md +265 -0
- package/skills/global_config/drizzle-orm-expert/SKILL.md +368 -0
- package/skills/global_config/executing-plans/SKILL.md +87 -0
- package/skills/global_config/frontend-design/LICENSE.txt +177 -0
- package/skills/global_config/frontend-design/SKILL.md +282 -0
- package/skills/global_config/frontend-dev-guidelines/SKILL.md +369 -0
- package/skills/global_config/frontend-dev-guidelines/resources/common-patterns.md +331 -0
- package/skills/global_config/frontend-dev-guidelines/resources/complete-examples.md +872 -0
- package/skills/global_config/frontend-dev-guidelines/resources/component-patterns.md +502 -0
- package/skills/global_config/frontend-dev-guidelines/resources/data-fetching.md +767 -0
- package/skills/global_config/frontend-dev-guidelines/resources/file-organization.md +502 -0
- package/skills/global_config/frontend-dev-guidelines/resources/loading-and-error-states.md +501 -0
- package/skills/global_config/frontend-dev-guidelines/resources/performance.md +406 -0
- package/skills/global_config/frontend-dev-guidelines/resources/routing-guide.md +364 -0
- package/skills/global_config/frontend-dev-guidelines/resources/styling-guide.md +428 -0
- package/skills/global_config/frontend-dev-guidelines/resources/typescript-standards.md +418 -0
- package/skills/global_config/gemini-api-dev/SKILL.md +138 -0
- package/skills/global_config/gemini-api-integration/SKILL.md +193 -0
- package/skills/global_config/geo-fundamentals/SKILL.md +165 -0
- package/skills/global_config/geo-fundamentals/scripts/geo_checker.py +289 -0
- package/skills/global_config/git-advanced-workflows/SKILL.md +420 -0
- package/skills/global_config/git-pr-review/SKILL.md +179 -0
- package/skills/global_config/github/SKILL.md +80 -0
- package/skills/global_config/github/agents/openai.yaml +4 -0
- package/skills/global_config/github-actions-templates/SKILL.md +353 -0
- package/skills/global_config/github-workflow-automation/SKILL.md +854 -0
- package/skills/global_config/go-concurrency-patterns/SKILL.md +41 -0
- package/skills/global_config/go-concurrency-patterns/resources/implementation-playbook.md +654 -0
- package/skills/global_config/go-playwright/SKILL.md +76 -0
- package/skills/global_config/go-playwright/resources/implementation-playbook.md +110 -0
- package/skills/global_config/golang-pro/SKILL.md +181 -0
- package/skills/global_config/google-sheets-automation/SKILL.md +149 -0
- package/skills/global_config/landing-page-generator/SKILL.md +213 -0
- package/skills/global_config/landing-page-generator/references/conversion-patterns.md +176 -0
- package/skills/global_config/landing-page-generator/references/frameworks.md +177 -0
- package/skills/global_config/landing-page-generator/references/landing-page-patterns.md +98 -0
- package/skills/global_config/landing-page-generator/references/seo-checklist.md +109 -0
- package/skills/global_config/landing-page-generator/scripts/landing_page_scaffolder.py +568 -0
- package/skills/global_config/linear-claude-skill/SKILL.md +523 -0
- package/skills/global_config/llm-app-patterns/SKILL.md +768 -0
- package/skills/global_config/llm-application-dev-ai-assistant/SKILL.md +43 -0
- package/skills/global_config/llm-application-dev-ai-assistant/resources/implementation-playbook.md +1236 -0
- package/skills/global_config/llm-prompt-optimizer/SKILL.md +187 -0
- package/skills/global_config/llm-structured-output/SKILL.md +212 -0
- package/skills/global_config/local-llm-expert/SKILL.md +88 -0
- package/skills/global_config/microservices-patterns/SKILL.md +43 -0
- package/skills/global_config/microservices-patterns/resources/implementation-playbook.md +607 -0
- package/skills/global_config/modern-javascript-patterns/SKILL.md +43 -0
- package/skills/global_config/modern-javascript-patterns/resources/implementation-playbook.md +910 -0
- package/skills/global_config/monorepo-management/SKILL.md +43 -0
- package/skills/global_config/monorepo-management/resources/implementation-playbook.md +621 -0
- package/skills/global_config/n8n-code-javascript/SKILL.md +706 -0
- package/skills/global_config/n8n-code-python/SKILL.md +755 -0
- package/skills/global_config/n8n-expression-syntax/SKILL.md +528 -0
- package/skills/global_config/n8n-mcp-tools-expert/SKILL.md +654 -0
- package/skills/global_config/n8n-workflow-patterns/SKILL.md +423 -0
- package/skills/global_config/neon-postgres/SKILL.md +619 -0
- package/skills/global_config/nextjs-app-router-patterns/SKILL.md +41 -0
- package/skills/global_config/nextjs-app-router-patterns/resources/implementation-playbook.md +543 -0
- package/skills/global_config/nextjs-best-practices/SKILL.md +213 -0
- package/skills/global_config/notion-automation/SKILL.md +224 -0
- package/skills/global_config/obsidian-markdown/SKILL.md +209 -0
- package/skills/global_config/obsidian-markdown/references/CALLOUTS.md +58 -0
- package/skills/global_config/obsidian-markdown/references/EMBEDS.md +63 -0
- package/skills/global_config/obsidian-markdown/references/PROPERTIES.md +61 -0
- package/skills/global_config/openapi-spec-generation/SKILL.md +41 -0
- package/skills/global_config/openapi-spec-generation/resources/implementation-playbook.md +1027 -0
- package/skills/global_config/os-scripting/SKILL.md +433 -0
- package/skills/global_config/planning-with-files/SKILL.md +189 -0
- package/skills/global_config/planning-with-files/examples.md +202 -0
- package/skills/global_config/planning-with-files/reference.md +218 -0
- package/skills/global_config/planning-with-files/scripts/check-complete.sh +44 -0
- package/skills/global_config/planning-with-files/scripts/init-session.sh +120 -0
- package/skills/global_config/planning-with-files/templates/findings.md +95 -0
- package/skills/global_config/planning-with-files/templates/progress.md +114 -0
- package/skills/global_config/planning-with-files/templates/task_plan.md +132 -0
- package/skills/global_config/playwright-skill/API_REFERENCE.md +653 -0
- package/skills/global_config/playwright-skill/SKILL.md +469 -0
- package/skills/global_config/playwright-skill/lib/helpers.js +441 -0
- package/skills/global_config/playwright-skill/package.json +26 -0
- package/skills/global_config/playwright-skill/run.js +228 -0
- package/skills/global_config/posix-shell-pro/SKILL.md +308 -0
- package/skills/global_config/postgres-best-practices/AGENTS.md +1490 -0
- package/skills/global_config/postgres-best-practices/README.md +119 -0
- package/skills/global_config/postgres-best-practices/SKILL.md +63 -0
- package/skills/global_config/postgres-best-practices/metadata.json +13 -0
- package/skills/global_config/postgres-best-practices/rules/_contributing.md +171 -0
- package/skills/global_config/postgres-best-practices/rules/_sections.md +39 -0
- package/skills/global_config/postgres-best-practices/rules/_template.md +34 -0
- package/skills/global_config/postgres-best-practices/rules/advanced-full-text-search.md +55 -0
- package/skills/global_config/postgres-best-practices/rules/advanced-jsonb-indexing.md +49 -0
- package/skills/global_config/postgres-best-practices/rules/conn-idle-timeout.md +46 -0
- package/skills/global_config/postgres-best-practices/rules/conn-limits.md +44 -0
- package/skills/global_config/postgres-best-practices/rules/conn-pooling.md +41 -0
- package/skills/global_config/postgres-best-practices/rules/conn-prepared-statements.md +46 -0
- package/skills/global_config/postgres-best-practices/rules/data-batch-inserts.md +54 -0
- package/skills/global_config/postgres-best-practices/rules/data-n-plus-one.md +53 -0
- package/skills/global_config/postgres-best-practices/rules/data-pagination.md +50 -0
- package/skills/global_config/postgres-best-practices/rules/data-upsert.md +50 -0
- package/skills/global_config/postgres-best-practices/rules/lock-advisory.md +56 -0
- package/skills/global_config/postgres-best-practices/rules/lock-deadlock-prevention.md +68 -0
- package/skills/global_config/postgres-best-practices/rules/lock-short-transactions.md +50 -0
- package/skills/global_config/postgres-best-practices/rules/lock-skip-locked.md +54 -0
- package/skills/global_config/postgres-best-practices/rules/monitor-explain-analyze.md +45 -0
- package/skills/global_config/postgres-best-practices/rules/monitor-pg-stat-statements.md +55 -0
- package/skills/global_config/postgres-best-practices/rules/monitor-vacuum-analyze.md +55 -0
- package/skills/global_config/postgres-best-practices/rules/query-composite-indexes.md +44 -0
- package/skills/global_config/postgres-best-practices/rules/query-covering-indexes.md +40 -0
- package/skills/global_config/postgres-best-practices/rules/query-index-types.md +45 -0
- package/skills/global_config/postgres-best-practices/rules/query-missing-indexes.md +43 -0
- package/skills/global_config/postgres-best-practices/rules/query-partial-indexes.md +45 -0
- package/skills/global_config/postgres-best-practices/rules/schema-data-types.md +46 -0
- package/skills/global_config/postgres-best-practices/rules/schema-foreign-key-indexes.md +59 -0
- package/skills/global_config/postgres-best-practices/rules/schema-lowercase-identifiers.md +55 -0
- package/skills/global_config/postgres-best-practices/rules/schema-partitioning.md +55 -0
- package/skills/global_config/postgres-best-practices/rules/schema-primary-keys.md +61 -0
- package/skills/global_config/postgres-best-practices/rules/security-privileges.md +54 -0
- package/skills/global_config/postgres-best-practices/rules/security-rls-basics.md +50 -0
- package/skills/global_config/postgres-best-practices/rules/security-rls-performance.md +57 -0
- package/skills/global_config/postgresql/SKILL.md +233 -0
- package/skills/global_config/prisma-expert/SKILL.md +366 -0
- package/skills/global_config/product-manager-toolkit/SKILL.md +362 -0
- package/skills/global_config/product-manager-toolkit/references/prd_templates.md +317 -0
- package/skills/global_config/product-manager-toolkit/scripts/customer_interview_analyzer.py +441 -0
- package/skills/global_config/product-manager-toolkit/scripts/rice_prioritizer.py +296 -0
- package/skills/global_config/programmatic-seo/SKILL.md +356 -0
- package/skills/global_config/prompt-engineer/README.md +659 -0
- package/skills/global_config/prompt-engineer/SKILL.md +281 -0
- package/skills/global_config/prompt-engineering-patterns/SKILL.md +221 -0
- package/skills/global_config/prompt-engineering-patterns/assets/few-shot-examples.json +106 -0
- package/skills/global_config/prompt-engineering-patterns/assets/prompt-template-library.md +246 -0
- package/skills/global_config/prompt-engineering-patterns/references/chain-of-thought.md +399 -0
- package/skills/global_config/prompt-engineering-patterns/references/few-shot-learning.md +369 -0
- package/skills/global_config/prompt-engineering-patterns/references/prompt-optimization.md +414 -0
- package/skills/global_config/prompt-engineering-patterns/references/prompt-templates.md +470 -0
- package/skills/global_config/prompt-engineering-patterns/references/system-prompts.md +189 -0
- package/skills/global_config/prompt-engineering-patterns/scripts/optimize-prompt.py +279 -0
- package/skills/global_config/python-patterns/SKILL.md +451 -0
- package/skills/global_config/python-performance-optimization/SKILL.md +44 -0
- package/skills/global_config/python-performance-optimization/resources/implementation-playbook.md +868 -0
- package/skills/global_config/python-pro/SKILL.md +161 -0
- package/skills/global_config/rag-engineer/SKILL.md +341 -0
- package/skills/global_config/rag-implementation/SKILL.md +201 -0
- package/skills/global_config/react-best-practices/AGENTS.md +2249 -0
- package/skills/global_config/react-best-practices/README.md +123 -0
- package/skills/global_config/react-best-practices/SKILL.md +131 -0
- package/skills/global_config/react-best-practices/metadata.json +15 -0
- package/skills/global_config/react-best-practices/rules/_sections.md +46 -0
- package/skills/global_config/react-best-practices/rules/_template.md +28 -0
- package/skills/global_config/react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- package/skills/global_config/react-best-practices/rules/advanced-use-latest.md +49 -0
- package/skills/global_config/react-best-practices/rules/async-api-routes.md +38 -0
- package/skills/global_config/react-best-practices/rules/async-defer-await.md +80 -0
- package/skills/global_config/react-best-practices/rules/async-dependencies.md +36 -0
- package/skills/global_config/react-best-practices/rules/async-parallel.md +28 -0
- package/skills/global_config/react-best-practices/rules/async-suspense-boundaries.md +99 -0
- package/skills/global_config/react-best-practices/rules/bundle-barrel-imports.md +59 -0
- package/skills/global_config/react-best-practices/rules/bundle-conditional.md +31 -0
- package/skills/global_config/react-best-practices/rules/bundle-defer-third-party.md +49 -0
- package/skills/global_config/react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- package/skills/global_config/react-best-practices/rules/bundle-preload.md +50 -0
- package/skills/global_config/react-best-practices/rules/client-event-listeners.md +74 -0
- package/skills/global_config/react-best-practices/rules/client-swr-dedup.md +56 -0
- package/skills/global_config/react-best-practices/rules/js-batch-dom-css.md +82 -0
- package/skills/global_config/react-best-practices/rules/js-cache-function-results.md +80 -0
- package/skills/global_config/react-best-practices/rules/js-cache-property-access.md +28 -0
- package/skills/global_config/react-best-practices/rules/js-cache-storage.md +70 -0
- package/skills/global_config/react-best-practices/rules/js-combine-iterations.md +32 -0
- package/skills/global_config/react-best-practices/rules/js-early-exit.md +50 -0
- package/skills/global_config/react-best-practices/rules/js-hoist-regexp.md +45 -0
- package/skills/global_config/react-best-practices/rules/js-index-maps.md +37 -0
- package/skills/global_config/react-best-practices/rules/js-length-check-first.md +49 -0
- package/skills/global_config/react-best-practices/rules/js-min-max-loop.md +82 -0
- package/skills/global_config/react-best-practices/rules/js-set-map-lookups.md +24 -0
- package/skills/global_config/react-best-practices/rules/js-tosorted-immutable.md +57 -0
- package/skills/global_config/react-best-practices/rules/rendering-activity.md +26 -0
- package/skills/global_config/react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- package/skills/global_config/react-best-practices/rules/rendering-conditional-render.md +40 -0
- package/skills/global_config/react-best-practices/rules/rendering-content-visibility.md +38 -0
- package/skills/global_config/react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- package/skills/global_config/react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- package/skills/global_config/react-best-practices/rules/rendering-svg-precision.md +28 -0
- package/skills/global_config/react-best-practices/rules/rerender-defer-reads.md +39 -0
- package/skills/global_config/react-best-practices/rules/rerender-dependencies.md +45 -0
- package/skills/global_config/react-best-practices/rules/rerender-derived-state.md +29 -0
- package/skills/global_config/react-best-practices/rules/rerender-functional-setstate.md +74 -0
- package/skills/global_config/react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- package/skills/global_config/react-best-practices/rules/rerender-memo.md +44 -0
- package/skills/global_config/react-best-practices/rules/rerender-transitions.md +40 -0
- package/skills/global_config/react-best-practices/rules/server-after-nonblocking.md +73 -0
- package/skills/global_config/react-best-practices/rules/server-cache-lru.md +41 -0
- package/skills/global_config/react-best-practices/rules/server-cache-react.md +26 -0
- package/skills/global_config/react-best-practices/rules/server-parallel-fetching.md +79 -0
- package/skills/global_config/react-best-practices/rules/server-serialization.md +38 -0
- package/skills/global_config/react-component-performance/SKILL.md +139 -0
- package/skills/global_config/react-component-performance/agents/openai.yaml +4 -0
- package/skills/global_config/react-component-performance/references/examples.md +88 -0
- package/skills/global_config/react-patterns/SKILL.md +216 -0
- package/skills/global_config/readme/SKILL.md +848 -0
- package/skills/global_config/remotion/SKILL.md +404 -0
- package/skills/global_config/schema-markup/SKILL.md +363 -0
- package/skills/global_config/senior-frontend/SKILL.md +495 -0
- package/skills/global_config/senior-frontend/references/frontend_best_practices.md +806 -0
- package/skills/global_config/senior-frontend/references/nextjs_optimization_guide.md +724 -0
- package/skills/global_config/senior-frontend/references/react_patterns.md +746 -0
- package/skills/global_config/senior-frontend/scripts/bundle_analyzer.py +407 -0
- package/skills/global_config/senior-frontend/scripts/component_generator.py +329 -0
- package/skills/global_config/senior-frontend/scripts/frontend_scaffolder.py +1005 -0
- package/skills/global_config/senior-fullstack/SKILL.md +220 -0
- package/skills/global_config/senior-fullstack/references/architecture_patterns.md +103 -0
- package/skills/global_config/senior-fullstack/references/development_workflows.md +103 -0
- package/skills/global_config/senior-fullstack/references/tech_stack_guide.md +103 -0
- package/skills/global_config/senior-fullstack/scripts/code_quality_analyzer.py +114 -0
- package/skills/global_config/senior-fullstack/scripts/fullstack_scaffolder.py +114 -0
- package/skills/global_config/senior-fullstack/scripts/project_scaffolder.py +114 -0
- package/skills/global_config/seo/SKILL.md +143 -0
- package/skills/global_config/seo/references/cwv-thresholds.md +108 -0
- package/skills/global_config/seo/references/eeat-framework.md +214 -0
- package/skills/global_config/seo/references/quality-gates.md +155 -0
- package/skills/global_config/seo/references/schema-types.md +118 -0
- package/skills/global_config/seo-audit/SKILL.md +492 -0
- package/skills/global_config/seo-technical/SKILL.md +179 -0
- package/skills/global_config/shadcn/SKILL.md +254 -0
- package/skills/global_config/shadcn/agents/openai.yml +5 -0
- package/skills/global_config/shadcn/assets/shadcn-small.png +0 -0
- package/skills/global_config/shadcn/assets/shadcn.png +0 -0
- package/skills/global_config/shadcn/cli.md +255 -0
- package/skills/global_config/shadcn/customization.md +202 -0
- package/skills/global_config/shadcn/evals/evals.json +47 -0
- package/skills/global_config/shadcn/mcp.md +94 -0
- package/skills/global_config/shadcn/rules/base-vs-radix.md +306 -0
- package/skills/global_config/shadcn/rules/composition.md +195 -0
- package/skills/global_config/shadcn/rules/forms.md +192 -0
- package/skills/global_config/shadcn/rules/icons.md +101 -0
- package/skills/global_config/shadcn/rules/styling.md +162 -0
- package/skills/global_config/simplify-code/SKILL.md +183 -0
- package/skills/global_config/slack-automation/SKILL.md +197 -0
- package/skills/global_config/software-architecture/SKILL.md +86 -0
- package/skills/global_config/spline-3d-integration/SKILL.md +90 -0
- package/skills/global_config/spline-3d-integration/examples/interactive-scene.tsx +198 -0
- package/skills/global_config/spline-3d-integration/examples/react-spline-wrapper.tsx +124 -0
- package/skills/global_config/spline-3d-integration/examples/vanilla-embed.html +146 -0
- package/skills/global_config/spline-3d-integration/guides/COMMON_PROBLEMS.md +262 -0
- package/skills/global_config/spline-3d-integration/guides/PERFORMANCE.md +163 -0
- package/skills/global_config/spline-3d-integration/guides/REACT_INTEGRATION.md +212 -0
- package/skills/global_config/spline-3d-integration/guides/VANILLA_INTEGRATION.md +203 -0
- package/skills/global_config/subagent-driven-development/SKILL.md +247 -0
- package/skills/global_config/subagent-driven-development/code-quality-reviewer-prompt.md +20 -0
- package/skills/global_config/subagent-driven-development/implementer-prompt.md +78 -0
- package/skills/global_config/subagent-driven-development/spec-reviewer-prompt.md +61 -0
- package/skills/global_config/systematic-debugging/CREATION-LOG.md +119 -0
- package/skills/global_config/systematic-debugging/SKILL.md +303 -0
- package/skills/global_config/systematic-debugging/condition-based-waiting-example.ts +158 -0
- package/skills/global_config/systematic-debugging/condition-based-waiting.md +115 -0
- package/skills/global_config/systematic-debugging/defense-in-depth.md +122 -0
- package/skills/global_config/systematic-debugging/find-polluter.sh +63 -0
- package/skills/global_config/systematic-debugging/root-cause-tracing.md +169 -0
- package/skills/global_config/systematic-debugging/test-academic.md +14 -0
- package/skills/global_config/systematic-debugging/test-pressure-1.md +58 -0
- package/skills/global_config/systematic-debugging/test-pressure-2.md +68 -0
- package/skills/global_config/systematic-debugging/test-pressure-3.md +69 -0
- package/skills/global_config/tailwind-patterns/SKILL.md +279 -0
- package/skills/global_config/tanstack-query-expert/SKILL.md +247 -0
- package/skills/global_config/tdd-workflow/SKILL.md +159 -0
- package/skills/global_config/test-driven-development/SKILL.md +378 -0
- package/skills/global_config/test-driven-development/testing-anti-patterns.md +299 -0
- package/skills/global_config/threejs-skills/SKILL.md +720 -0
- package/skills/global_config/tmux/SKILL.md +375 -0
- package/skills/global_config/turborepo-caching/SKILL.md +427 -0
- package/skills/global_config/typescript-pro/SKILL.md +58 -0
- package/skills/global_config/ui-component/SKILL.md +104 -0
- package/skills/global_config/ui-page/SKILL.md +100 -0
- package/skills/global_config/ui-pattern/SKILL.md +92 -0
- package/skills/global_config/ui-review/SKILL.md +90 -0
- package/skills/global_config/ui-tokens/SKILL.md +73 -0
- package/skills/global_config/ui-ux-pro-max/SKILL.md +361 -0
- package/skills/global_config/ui-ux-pro-max/data/charts.csv +26 -0
- package/skills/global_config/ui-ux-pro-max/data/colors.csv +97 -0
- package/skills/global_config/ui-ux-pro-max/data/icons.csv +101 -0
- package/skills/global_config/ui-ux-pro-max/data/landing.csv +31 -0
- package/skills/global_config/ui-ux-pro-max/data/products.csv +97 -0
- package/skills/global_config/ui-ux-pro-max/data/prompts.csv +24 -0
- package/skills/global_config/ui-ux-pro-max/data/react-performance.csv +45 -0
- package/skills/global_config/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
- package/skills/global_config/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
- package/skills/global_config/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
- package/skills/global_config/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
- package/skills/global_config/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
- package/skills/global_config/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
- package/skills/global_config/ui-ux-pro-max/data/stacks/react.csv +54 -0
- package/skills/global_config/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
- package/skills/global_config/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
- package/skills/global_config/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
- package/skills/global_config/ui-ux-pro-max/data/stacks/vue.csv +50 -0
- package/skills/global_config/ui-ux-pro-max/data/styles.csv +59 -0
- package/skills/global_config/ui-ux-pro-max/data/typography.csv +58 -0
- package/skills/global_config/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
- package/skills/global_config/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
- package/skills/global_config/ui-ux-pro-max/data/web-interface.csv +31 -0
- package/skills/global_config/ui-ux-pro-max/scripts/__pycache__/core.cpython-313.pyc +0 -0
- package/skills/global_config/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-313.pyc +0 -0
- package/skills/global_config/ui-ux-pro-max/scripts/core.py +257 -0
- package/skills/global_config/ui-ux-pro-max/scripts/design_system.py +487 -0
- package/skills/global_config/ui-ux-pro-max/scripts/search.py +76 -0
- package/skills/global_config/using-neon/SKILL.md +90 -0
- package/skills/global_config/ux-audit/SKILL.md +66 -0
- package/skills/global_config/ux-feedback/SKILL.md +68 -0
- package/skills/global_config/ux-flow/SKILL.md +72 -0
- package/skills/global_config/ux-persuasion-engineer/SKILL.md +119 -0
- package/skills/global_config/vector-database-engineer/SKILL.md +68 -0
- package/skills/global_config/vercel-ai-sdk-expert/SKILL.md +227 -0
- package/skills/global_config/vercel-deployment/SKILL.md +682 -0
- package/skills/global_config/wcag-audit-patterns/SKILL.md +49 -0
- package/skills/global_config/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
- package/skills/global_config/web-artifacts-builder/LICENSE.txt +202 -0
- package/skills/global_config/web-artifacts-builder/SKILL.md +84 -0
- package/skills/global_config/web-artifacts-builder/scripts/bundle-artifact.sh +54 -0
- package/skills/global_config/web-artifacts-builder/scripts/init-artifact.sh +322 -0
- package/skills/global_config/web-artifacts-builder/scripts/shadcn-components.tar.gz +0 -0
- package/skills/global_config/web-performance-optimization/SKILL.md +654 -0
- package/skills/global_config/web-scraper/SKILL.md +757 -0
- package/skills/global_config/web-scraper/references/data-transforms.md +397 -0
- package/skills/global_config/web-scraper/references/extraction-patterns.md +475 -0
- package/skills/global_config/web-scraper/references/output-templates.md +481 -0
- package/skills/global_config/webapp-testing/LICENSE.txt +202 -0
- package/skills/global_config/webapp-testing/SKILL.md +106 -0
- package/skills/global_config/webapp-testing/scripts/with_server.py +106 -0
- package/skills/global_config/writing-plans/SKILL.md +127 -0
- package/skills/global_config/zustand-store-ts/SKILL.md +79 -0
- package/skills/global_legacy/agent-manager-skill/SKILL.md +47 -0
- package/skills/global_legacy/agent-memory-mcp/SKILL.md +92 -0
- package/skills/global_legacy/agent-orchestrator/SKILL.md +321 -0
- package/skills/global_legacy/agent-orchestrator/references/capability-taxonomy.md +85 -0
- package/skills/global_legacy/agent-orchestrator/references/orchestration-patterns.md +129 -0
- package/skills/global_legacy/agent-orchestrator/scripts/match_skills.py +329 -0
- package/skills/global_legacy/agent-orchestrator/scripts/orchestrate.py +304 -0
- package/skills/global_legacy/agent-orchestrator/scripts/requirements.txt +1 -0
- package/skills/global_legacy/agent-orchestrator/scripts/scan_registry.py +508 -0
- package/skills/global_legacy/agent-tool-builder/SKILL.md +714 -0
- package/skills/global_legacy/ai-agent-development/SKILL.md +178 -0
- package/skills/global_legacy/ai-product/SKILL.md +753 -0
- package/skills/global_legacy/api-design-principles/SKILL.md +45 -0
- package/skills/global_legacy/api-design-principles/assets/api-design-checklist.md +155 -0
- package/skills/global_legacy/api-design-principles/assets/rest-api-template.py +182 -0
- package/skills/global_legacy/api-design-principles/references/graphql-schema-design.md +583 -0
- package/skills/global_legacy/api-design-principles/references/rest-best-practices.md +408 -0
- package/skills/global_legacy/api-design-principles/resources/implementation-playbook.md +513 -0
- package/skills/global_legacy/api-patterns/SKILL.md +90 -0
- package/skills/global_legacy/api-patterns/api-style.md +42 -0
- package/skills/global_legacy/api-patterns/auth.md +24 -0
- package/skills/global_legacy/api-patterns/documentation.md +26 -0
- package/skills/global_legacy/api-patterns/graphql.md +41 -0
- package/skills/global_legacy/api-patterns/rate-limiting.md +31 -0
- package/skills/global_legacy/api-patterns/response.md +37 -0
- package/skills/global_legacy/api-patterns/rest.md +40 -0
- package/skills/global_legacy/api-patterns/scripts/api_validator.py +211 -0
- package/skills/global_legacy/api-patterns/security-testing.md +122 -0
- package/skills/global_legacy/api-patterns/trpc.md +41 -0
- package/skills/global_legacy/api-patterns/versioning.md +22 -0
- package/skills/global_legacy/apify-lead-generation/SKILL.md +131 -0
- package/skills/global_legacy/apify-lead-generation/reference/scripts/run_actor.js +363 -0
- package/skills/global_legacy/apify-ultimate-scraper/SKILL.md +241 -0
- package/skills/global_legacy/apify-ultimate-scraper/reference/scripts/run_actor.js +363 -0
- package/skills/global_legacy/architect-review/SKILL.md +177 -0
- package/skills/global_legacy/bash-linux/SKILL.md +209 -0
- package/skills/global_legacy/brainstorming/SKILL.md +237 -0
- package/skills/global_legacy/browser-automation/SKILL.md +1116 -0
- package/skills/global_legacy/clean-code/SKILL.md +99 -0
- package/skills/global_legacy/cloudflare-workers-expert/SKILL.md +94 -0
- package/skills/global_legacy/concise-planning/SKILL.md +73 -0
- package/skills/global_legacy/copywriting/SKILL.md +254 -0
- package/skills/global_legacy/crewai/SKILL.md +458 -0
- package/skills/global_legacy/database-design/SKILL.md +62 -0
- package/skills/global_legacy/database-design/database-selection.md +43 -0
- package/skills/global_legacy/database-design/indexing.md +39 -0
- package/skills/global_legacy/database-design/migrations.md +48 -0
- package/skills/global_legacy/database-design/optimization.md +36 -0
- package/skills/global_legacy/database-design/orm-selection.md +30 -0
- package/skills/global_legacy/database-design/schema-design.md +56 -0
- package/skills/global_legacy/database-design/scripts/schema_validator.py +172 -0
- package/skills/global_legacy/debugger/SKILL.md +58 -0
- package/skills/global_legacy/deep-research/SKILL.md +120 -0
- package/skills/global_legacy/design-spells/SKILL.md +41 -0
- package/skills/global_legacy/design-taste-frontend/SKILL.md +247 -0
- package/skills/global_legacy/docker-expert/SKILL.md +418 -0
- package/skills/global_legacy/documentation/SKILL.md +265 -0
- package/skills/global_legacy/drizzle-orm-expert/SKILL.md +368 -0
- package/skills/global_legacy/executing-plans/SKILL.md +87 -0
- package/skills/global_legacy/frontend-design/LICENSE.txt +177 -0
- package/skills/global_legacy/frontend-design/SKILL.md +282 -0
- package/skills/global_legacy/frontend-dev-guidelines/SKILL.md +369 -0
- package/skills/global_legacy/frontend-dev-guidelines/resources/common-patterns.md +331 -0
- package/skills/global_legacy/frontend-dev-guidelines/resources/complete-examples.md +872 -0
- package/skills/global_legacy/frontend-dev-guidelines/resources/component-patterns.md +502 -0
- package/skills/global_legacy/frontend-dev-guidelines/resources/data-fetching.md +767 -0
- package/skills/global_legacy/frontend-dev-guidelines/resources/file-organization.md +502 -0
- package/skills/global_legacy/frontend-dev-guidelines/resources/loading-and-error-states.md +501 -0
- package/skills/global_legacy/frontend-dev-guidelines/resources/performance.md +406 -0
- package/skills/global_legacy/frontend-dev-guidelines/resources/routing-guide.md +364 -0
- package/skills/global_legacy/frontend-dev-guidelines/resources/styling-guide.md +428 -0
- package/skills/global_legacy/frontend-dev-guidelines/resources/typescript-standards.md +418 -0
- package/skills/global_legacy/gemini-api-dev/SKILL.md +138 -0
- package/skills/global_legacy/gemini-api-integration/SKILL.md +193 -0
- package/skills/global_legacy/geo-fundamentals/SKILL.md +165 -0
- package/skills/global_legacy/geo-fundamentals/scripts/geo_checker.py +289 -0
- package/skills/global_legacy/git-advanced-workflows/SKILL.md +420 -0
- package/skills/global_legacy/git-pr-review/SKILL.md +179 -0
- package/skills/global_legacy/github/SKILL.md +80 -0
- package/skills/global_legacy/github/agents/openai.yaml +4 -0
- package/skills/global_legacy/github-actions-templates/SKILL.md +353 -0
- package/skills/global_legacy/github-workflow-automation/SKILL.md +854 -0
- package/skills/global_legacy/go-concurrency-patterns/SKILL.md +41 -0
- package/skills/global_legacy/go-concurrency-patterns/resources/implementation-playbook.md +654 -0
- package/skills/global_legacy/go-playwright/SKILL.md +76 -0
- package/skills/global_legacy/go-playwright/resources/implementation-playbook.md +110 -0
- package/skills/global_legacy/golang-pro/SKILL.md +181 -0
- package/skills/global_legacy/google-sheets-automation/SKILL.md +149 -0
- package/skills/global_legacy/landing-page-generator/SKILL.md +213 -0
- package/skills/global_legacy/landing-page-generator/references/conversion-patterns.md +176 -0
- package/skills/global_legacy/landing-page-generator/references/frameworks.md +177 -0
- package/skills/global_legacy/landing-page-generator/references/landing-page-patterns.md +98 -0
- package/skills/global_legacy/landing-page-generator/references/seo-checklist.md +109 -0
- package/skills/global_legacy/landing-page-generator/scripts/landing_page_scaffolder.py +568 -0
- package/skills/global_legacy/linear-claude-skill/SKILL.md +523 -0
- package/skills/global_legacy/llm-app-patterns/SKILL.md +768 -0
- package/skills/global_legacy/llm-application-dev-ai-assistant/SKILL.md +43 -0
- package/skills/global_legacy/llm-application-dev-ai-assistant/resources/implementation-playbook.md +1236 -0
- package/skills/global_legacy/llm-prompt-optimizer/SKILL.md +187 -0
- package/skills/global_legacy/llm-structured-output/SKILL.md +212 -0
- package/skills/global_legacy/local-llm-expert/SKILL.md +88 -0
- package/skills/global_legacy/microservices-patterns/SKILL.md +43 -0
- package/skills/global_legacy/microservices-patterns/resources/implementation-playbook.md +607 -0
- package/skills/global_legacy/modern-javascript-patterns/SKILL.md +43 -0
- package/skills/global_legacy/modern-javascript-patterns/resources/implementation-playbook.md +910 -0
- package/skills/global_legacy/monorepo-management/SKILL.md +43 -0
- package/skills/global_legacy/monorepo-management/resources/implementation-playbook.md +621 -0
- package/skills/global_legacy/n8n-code-javascript/SKILL.md +706 -0
- package/skills/global_legacy/n8n-code-python/SKILL.md +755 -0
- package/skills/global_legacy/n8n-expression-syntax/SKILL.md +528 -0
- package/skills/global_legacy/n8n-mcp-tools-expert/SKILL.md +654 -0
- package/skills/global_legacy/n8n-workflow-patterns/SKILL.md +423 -0
- package/skills/global_legacy/neon-postgres/SKILL.md +619 -0
- package/skills/global_legacy/nextjs-app-router-patterns/SKILL.md +41 -0
- package/skills/global_legacy/nextjs-app-router-patterns/resources/implementation-playbook.md +543 -0
- package/skills/global_legacy/nextjs-best-practices/SKILL.md +213 -0
- package/skills/global_legacy/notion-automation/SKILL.md +224 -0
- package/skills/global_legacy/obsidian-markdown/SKILL.md +209 -0
- package/skills/global_legacy/obsidian-markdown/references/CALLOUTS.md +58 -0
- package/skills/global_legacy/obsidian-markdown/references/EMBEDS.md +63 -0
- package/skills/global_legacy/obsidian-markdown/references/PROPERTIES.md +61 -0
- package/skills/global_legacy/openapi-spec-generation/SKILL.md +41 -0
- package/skills/global_legacy/openapi-spec-generation/resources/implementation-playbook.md +1027 -0
- package/skills/global_legacy/os-scripting/SKILL.md +433 -0
- package/skills/global_legacy/planning-with-files/SKILL.md +189 -0
- package/skills/global_legacy/planning-with-files/examples.md +202 -0
- package/skills/global_legacy/planning-with-files/reference.md +218 -0
- package/skills/global_legacy/planning-with-files/scripts/check-complete.sh +44 -0
- package/skills/global_legacy/planning-with-files/scripts/init-session.sh +120 -0
- package/skills/global_legacy/planning-with-files/templates/findings.md +95 -0
- package/skills/global_legacy/planning-with-files/templates/progress.md +114 -0
- package/skills/global_legacy/planning-with-files/templates/task_plan.md +132 -0
- package/skills/global_legacy/playwright-skill/API_REFERENCE.md +653 -0
- package/skills/global_legacy/playwright-skill/SKILL.md +469 -0
- package/skills/global_legacy/playwright-skill/lib/helpers.js +441 -0
- package/skills/global_legacy/playwright-skill/package.json +26 -0
- package/skills/global_legacy/playwright-skill/run.js +228 -0
- package/skills/global_legacy/posix-shell-pro/SKILL.md +308 -0
- package/skills/global_legacy/postgres-best-practices/AGENTS.md +1490 -0
- package/skills/global_legacy/postgres-best-practices/README.md +119 -0
- package/skills/global_legacy/postgres-best-practices/SKILL.md +63 -0
- package/skills/global_legacy/postgres-best-practices/metadata.json +13 -0
- package/skills/global_legacy/postgres-best-practices/rules/_contributing.md +171 -0
- package/skills/global_legacy/postgres-best-practices/rules/_sections.md +39 -0
- package/skills/global_legacy/postgres-best-practices/rules/_template.md +34 -0
- package/skills/global_legacy/postgres-best-practices/rules/advanced-full-text-search.md +55 -0
- package/skills/global_legacy/postgres-best-practices/rules/advanced-jsonb-indexing.md +49 -0
- package/skills/global_legacy/postgres-best-practices/rules/conn-idle-timeout.md +46 -0
- package/skills/global_legacy/postgres-best-practices/rules/conn-limits.md +44 -0
- package/skills/global_legacy/postgres-best-practices/rules/conn-pooling.md +41 -0
- package/skills/global_legacy/postgres-best-practices/rules/conn-prepared-statements.md +46 -0
- package/skills/global_legacy/postgres-best-practices/rules/data-batch-inserts.md +54 -0
- package/skills/global_legacy/postgres-best-practices/rules/data-n-plus-one.md +53 -0
- package/skills/global_legacy/postgres-best-practices/rules/data-pagination.md +50 -0
- package/skills/global_legacy/postgres-best-practices/rules/data-upsert.md +50 -0
- package/skills/global_legacy/postgres-best-practices/rules/lock-advisory.md +56 -0
- package/skills/global_legacy/postgres-best-practices/rules/lock-deadlock-prevention.md +68 -0
- package/skills/global_legacy/postgres-best-practices/rules/lock-short-transactions.md +50 -0
- package/skills/global_legacy/postgres-best-practices/rules/lock-skip-locked.md +54 -0
- package/skills/global_legacy/postgres-best-practices/rules/monitor-explain-analyze.md +45 -0
- package/skills/global_legacy/postgres-best-practices/rules/monitor-pg-stat-statements.md +55 -0
- package/skills/global_legacy/postgres-best-practices/rules/monitor-vacuum-analyze.md +55 -0
- package/skills/global_legacy/postgres-best-practices/rules/query-composite-indexes.md +44 -0
- package/skills/global_legacy/postgres-best-practices/rules/query-covering-indexes.md +40 -0
- package/skills/global_legacy/postgres-best-practices/rules/query-index-types.md +45 -0
- package/skills/global_legacy/postgres-best-practices/rules/query-missing-indexes.md +43 -0
- package/skills/global_legacy/postgres-best-practices/rules/query-partial-indexes.md +45 -0
- package/skills/global_legacy/postgres-best-practices/rules/schema-data-types.md +46 -0
- package/skills/global_legacy/postgres-best-practices/rules/schema-foreign-key-indexes.md +59 -0
- package/skills/global_legacy/postgres-best-practices/rules/schema-lowercase-identifiers.md +55 -0
- package/skills/global_legacy/postgres-best-practices/rules/schema-partitioning.md +55 -0
- package/skills/global_legacy/postgres-best-practices/rules/schema-primary-keys.md +61 -0
- package/skills/global_legacy/postgres-best-practices/rules/security-privileges.md +54 -0
- package/skills/global_legacy/postgres-best-practices/rules/security-rls-basics.md +50 -0
- package/skills/global_legacy/postgres-best-practices/rules/security-rls-performance.md +57 -0
- package/skills/global_legacy/postgresql/SKILL.md +233 -0
- package/skills/global_legacy/prisma-expert/SKILL.md +366 -0
- package/skills/global_legacy/product-manager-toolkit/SKILL.md +362 -0
- package/skills/global_legacy/product-manager-toolkit/references/prd_templates.md +317 -0
- package/skills/global_legacy/product-manager-toolkit/scripts/customer_interview_analyzer.py +441 -0
- package/skills/global_legacy/product-manager-toolkit/scripts/rice_prioritizer.py +296 -0
- package/skills/global_legacy/programmatic-seo/SKILL.md +356 -0
- package/skills/global_legacy/prompt-engineer/README.md +659 -0
- package/skills/global_legacy/prompt-engineer/SKILL.md +281 -0
- package/skills/global_legacy/prompt-engineering-patterns/SKILL.md +221 -0
- package/skills/global_legacy/prompt-engineering-patterns/assets/few-shot-examples.json +106 -0
- package/skills/global_legacy/prompt-engineering-patterns/assets/prompt-template-library.md +246 -0
- package/skills/global_legacy/prompt-engineering-patterns/references/chain-of-thought.md +399 -0
- package/skills/global_legacy/prompt-engineering-patterns/references/few-shot-learning.md +369 -0
- package/skills/global_legacy/prompt-engineering-patterns/references/prompt-optimization.md +414 -0
- package/skills/global_legacy/prompt-engineering-patterns/references/prompt-templates.md +470 -0
- package/skills/global_legacy/prompt-engineering-patterns/references/system-prompts.md +189 -0
- package/skills/global_legacy/prompt-engineering-patterns/scripts/optimize-prompt.py +279 -0
- package/skills/global_legacy/python-patterns/SKILL.md +451 -0
- package/skills/global_legacy/python-performance-optimization/SKILL.md +44 -0
- package/skills/global_legacy/python-performance-optimization/resources/implementation-playbook.md +868 -0
- package/skills/global_legacy/python-pro/SKILL.md +161 -0
- package/skills/global_legacy/rag-engineer/SKILL.md +341 -0
- package/skills/global_legacy/rag-implementation/SKILL.md +201 -0
- package/skills/global_legacy/react-best-practices/AGENTS.md +2249 -0
- package/skills/global_legacy/react-best-practices/README.md +123 -0
- package/skills/global_legacy/react-best-practices/SKILL.md +131 -0
- package/skills/global_legacy/react-best-practices/metadata.json +15 -0
- package/skills/global_legacy/react-best-practices/rules/_sections.md +46 -0
- package/skills/global_legacy/react-best-practices/rules/_template.md +28 -0
- package/skills/global_legacy/react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- package/skills/global_legacy/react-best-practices/rules/advanced-use-latest.md +49 -0
- package/skills/global_legacy/react-best-practices/rules/async-api-routes.md +38 -0
- package/skills/global_legacy/react-best-practices/rules/async-defer-await.md +80 -0
- package/skills/global_legacy/react-best-practices/rules/async-dependencies.md +36 -0
- package/skills/global_legacy/react-best-practices/rules/async-parallel.md +28 -0
- package/skills/global_legacy/react-best-practices/rules/async-suspense-boundaries.md +99 -0
- package/skills/global_legacy/react-best-practices/rules/bundle-barrel-imports.md +59 -0
- package/skills/global_legacy/react-best-practices/rules/bundle-conditional.md +31 -0
- package/skills/global_legacy/react-best-practices/rules/bundle-defer-third-party.md +49 -0
- package/skills/global_legacy/react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- package/skills/global_legacy/react-best-practices/rules/bundle-preload.md +50 -0
- package/skills/global_legacy/react-best-practices/rules/client-event-listeners.md +74 -0
- package/skills/global_legacy/react-best-practices/rules/client-swr-dedup.md +56 -0
- package/skills/global_legacy/react-best-practices/rules/js-batch-dom-css.md +82 -0
- package/skills/global_legacy/react-best-practices/rules/js-cache-function-results.md +80 -0
- package/skills/global_legacy/react-best-practices/rules/js-cache-property-access.md +28 -0
- package/skills/global_legacy/react-best-practices/rules/js-cache-storage.md +70 -0
- package/skills/global_legacy/react-best-practices/rules/js-combine-iterations.md +32 -0
- package/skills/global_legacy/react-best-practices/rules/js-early-exit.md +50 -0
- package/skills/global_legacy/react-best-practices/rules/js-hoist-regexp.md +45 -0
- package/skills/global_legacy/react-best-practices/rules/js-index-maps.md +37 -0
- package/skills/global_legacy/react-best-practices/rules/js-length-check-first.md +49 -0
- package/skills/global_legacy/react-best-practices/rules/js-min-max-loop.md +82 -0
- package/skills/global_legacy/react-best-practices/rules/js-set-map-lookups.md +24 -0
- package/skills/global_legacy/react-best-practices/rules/js-tosorted-immutable.md +57 -0
- package/skills/global_legacy/react-best-practices/rules/rendering-activity.md +26 -0
- package/skills/global_legacy/react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- package/skills/global_legacy/react-best-practices/rules/rendering-conditional-render.md +40 -0
- package/skills/global_legacy/react-best-practices/rules/rendering-content-visibility.md +38 -0
- package/skills/global_legacy/react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- package/skills/global_legacy/react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- package/skills/global_legacy/react-best-practices/rules/rendering-svg-precision.md +28 -0
- package/skills/global_legacy/react-best-practices/rules/rerender-defer-reads.md +39 -0
- package/skills/global_legacy/react-best-practices/rules/rerender-dependencies.md +45 -0
- package/skills/global_legacy/react-best-practices/rules/rerender-derived-state.md +29 -0
- package/skills/global_legacy/react-best-practices/rules/rerender-functional-setstate.md +74 -0
- package/skills/global_legacy/react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- package/skills/global_legacy/react-best-practices/rules/rerender-memo.md +44 -0
- package/skills/global_legacy/react-best-practices/rules/rerender-transitions.md +40 -0
- package/skills/global_legacy/react-best-practices/rules/server-after-nonblocking.md +73 -0
- package/skills/global_legacy/react-best-practices/rules/server-cache-lru.md +41 -0
- package/skills/global_legacy/react-best-practices/rules/server-cache-react.md +26 -0
- package/skills/global_legacy/react-best-practices/rules/server-parallel-fetching.md +79 -0
- package/skills/global_legacy/react-best-practices/rules/server-serialization.md +38 -0
- package/skills/global_legacy/react-component-performance/SKILL.md +139 -0
- package/skills/global_legacy/react-component-performance/agents/openai.yaml +4 -0
- package/skills/global_legacy/react-component-performance/references/examples.md +88 -0
- package/skills/global_legacy/react-patterns/SKILL.md +216 -0
- package/skills/global_legacy/readme/SKILL.md +848 -0
- package/skills/global_legacy/remotion/SKILL.md +404 -0
- package/skills/global_legacy/schema-markup/SKILL.md +363 -0
- package/skills/global_legacy/senior-frontend/SKILL.md +495 -0
- package/skills/global_legacy/senior-frontend/references/frontend_best_practices.md +806 -0
- package/skills/global_legacy/senior-frontend/references/nextjs_optimization_guide.md +724 -0
- package/skills/global_legacy/senior-frontend/references/react_patterns.md +746 -0
- package/skills/global_legacy/senior-frontend/scripts/bundle_analyzer.py +407 -0
- package/skills/global_legacy/senior-frontend/scripts/component_generator.py +329 -0
- package/skills/global_legacy/senior-frontend/scripts/frontend_scaffolder.py +1005 -0
- package/skills/global_legacy/senior-fullstack/SKILL.md +220 -0
- package/skills/global_legacy/senior-fullstack/references/architecture_patterns.md +103 -0
- package/skills/global_legacy/senior-fullstack/references/development_workflows.md +103 -0
- package/skills/global_legacy/senior-fullstack/references/tech_stack_guide.md +103 -0
- package/skills/global_legacy/senior-fullstack/scripts/code_quality_analyzer.py +114 -0
- package/skills/global_legacy/senior-fullstack/scripts/fullstack_scaffolder.py +114 -0
- package/skills/global_legacy/senior-fullstack/scripts/project_scaffolder.py +114 -0
- package/skills/global_legacy/seo/SKILL.md +143 -0
- package/skills/global_legacy/seo/references/cwv-thresholds.md +108 -0
- package/skills/global_legacy/seo/references/eeat-framework.md +214 -0
- package/skills/global_legacy/seo/references/quality-gates.md +155 -0
- package/skills/global_legacy/seo/references/schema-types.md +118 -0
- package/skills/global_legacy/seo-audit/SKILL.md +492 -0
- package/skills/global_legacy/seo-technical/SKILL.md +179 -0
- package/skills/global_legacy/shadcn/SKILL.md +254 -0
- package/skills/global_legacy/shadcn/agents/openai.yml +5 -0
- package/skills/global_legacy/shadcn/assets/shadcn-small.png +0 -0
- package/skills/global_legacy/shadcn/assets/shadcn.png +0 -0
- package/skills/global_legacy/shadcn/cli.md +255 -0
- package/skills/global_legacy/shadcn/customization.md +202 -0
- package/skills/global_legacy/shadcn/evals/evals.json +47 -0
- package/skills/global_legacy/shadcn/mcp.md +94 -0
- package/skills/global_legacy/shadcn/rules/base-vs-radix.md +306 -0
- package/skills/global_legacy/shadcn/rules/composition.md +195 -0
- package/skills/global_legacy/shadcn/rules/forms.md +192 -0
- package/skills/global_legacy/shadcn/rules/icons.md +101 -0
- package/skills/global_legacy/shadcn/rules/styling.md +162 -0
- package/skills/global_legacy/simplify-code/SKILL.md +183 -0
- package/skills/global_legacy/slack-automation/SKILL.md +197 -0
- package/skills/global_legacy/software-architecture/SKILL.md +86 -0
- package/skills/global_legacy/spline-3d-integration/SKILL.md +90 -0
- package/skills/global_legacy/spline-3d-integration/examples/interactive-scene.tsx +198 -0
- package/skills/global_legacy/spline-3d-integration/examples/react-spline-wrapper.tsx +124 -0
- package/skills/global_legacy/spline-3d-integration/examples/vanilla-embed.html +146 -0
- package/skills/global_legacy/spline-3d-integration/guides/COMMON_PROBLEMS.md +262 -0
- package/skills/global_legacy/spline-3d-integration/guides/PERFORMANCE.md +163 -0
- package/skills/global_legacy/spline-3d-integration/guides/REACT_INTEGRATION.md +212 -0
- package/skills/global_legacy/spline-3d-integration/guides/VANILLA_INTEGRATION.md +203 -0
- package/skills/global_legacy/subagent-driven-development/SKILL.md +247 -0
- package/skills/global_legacy/subagent-driven-development/code-quality-reviewer-prompt.md +20 -0
- package/skills/global_legacy/subagent-driven-development/implementer-prompt.md +78 -0
- package/skills/global_legacy/subagent-driven-development/spec-reviewer-prompt.md +61 -0
- package/skills/global_legacy/systematic-debugging/CREATION-LOG.md +119 -0
- package/skills/global_legacy/systematic-debugging/SKILL.md +303 -0
- package/skills/global_legacy/systematic-debugging/condition-based-waiting-example.ts +158 -0
- package/skills/global_legacy/systematic-debugging/condition-based-waiting.md +115 -0
- package/skills/global_legacy/systematic-debugging/defense-in-depth.md +122 -0
- package/skills/global_legacy/systematic-debugging/find-polluter.sh +63 -0
- package/skills/global_legacy/systematic-debugging/root-cause-tracing.md +169 -0
- package/skills/global_legacy/systematic-debugging/test-academic.md +14 -0
- package/skills/global_legacy/systematic-debugging/test-pressure-1.md +58 -0
- package/skills/global_legacy/systematic-debugging/test-pressure-2.md +68 -0
- package/skills/global_legacy/systematic-debugging/test-pressure-3.md +69 -0
- package/skills/global_legacy/tailwind-patterns/SKILL.md +279 -0
- package/skills/global_legacy/tanstack-query-expert/SKILL.md +247 -0
- package/skills/global_legacy/tdd-workflow/SKILL.md +159 -0
- package/skills/global_legacy/test-driven-development/SKILL.md +378 -0
- package/skills/global_legacy/test-driven-development/testing-anti-patterns.md +299 -0
- package/skills/global_legacy/threejs-skills/SKILL.md +720 -0
- package/skills/global_legacy/tmux/SKILL.md +375 -0
- package/skills/global_legacy/turborepo-caching/SKILL.md +427 -0
- package/skills/global_legacy/typescript-pro/SKILL.md +58 -0
- package/skills/global_legacy/ui-component/SKILL.md +104 -0
- package/skills/global_legacy/ui-page/SKILL.md +100 -0
- package/skills/global_legacy/ui-pattern/SKILL.md +92 -0
- package/skills/global_legacy/ui-review/SKILL.md +90 -0
- package/skills/global_legacy/ui-tokens/SKILL.md +73 -0
- package/skills/global_legacy/ui-ux-pro-max/SKILL.md +361 -0
- package/skills/global_legacy/ui-ux-pro-max/data/charts.csv +26 -0
- package/skills/global_legacy/ui-ux-pro-max/data/colors.csv +97 -0
- package/skills/global_legacy/ui-ux-pro-max/data/icons.csv +101 -0
- package/skills/global_legacy/ui-ux-pro-max/data/landing.csv +31 -0
- package/skills/global_legacy/ui-ux-pro-max/data/products.csv +97 -0
- package/skills/global_legacy/ui-ux-pro-max/data/prompts.csv +24 -0
- package/skills/global_legacy/ui-ux-pro-max/data/react-performance.csv +45 -0
- package/skills/global_legacy/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
- package/skills/global_legacy/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
- package/skills/global_legacy/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
- package/skills/global_legacy/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
- package/skills/global_legacy/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
- package/skills/global_legacy/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
- package/skills/global_legacy/ui-ux-pro-max/data/stacks/react.csv +54 -0
- package/skills/global_legacy/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
- package/skills/global_legacy/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
- package/skills/global_legacy/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
- package/skills/global_legacy/ui-ux-pro-max/data/stacks/vue.csv +50 -0
- package/skills/global_legacy/ui-ux-pro-max/data/styles.csv +59 -0
- package/skills/global_legacy/ui-ux-pro-max/data/typography.csv +58 -0
- package/skills/global_legacy/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
- package/skills/global_legacy/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
- package/skills/global_legacy/ui-ux-pro-max/data/web-interface.csv +31 -0
- package/skills/global_legacy/ui-ux-pro-max/scripts/core.py +257 -0
- package/skills/global_legacy/ui-ux-pro-max/scripts/design_system.py +487 -0
- package/skills/global_legacy/ui-ux-pro-max/scripts/search.py +76 -0
- package/skills/global_legacy/using-neon/SKILL.md +90 -0
- package/skills/global_legacy/ux-audit/SKILL.md +66 -0
- package/skills/global_legacy/ux-feedback/SKILL.md +68 -0
- package/skills/global_legacy/ux-flow/SKILL.md +72 -0
- package/skills/global_legacy/ux-persuasion-engineer/SKILL.md +119 -0
- package/skills/global_legacy/vector-database-engineer/SKILL.md +68 -0
- package/skills/global_legacy/vercel-ai-sdk-expert/SKILL.md +227 -0
- package/skills/global_legacy/vercel-deployment/SKILL.md +682 -0
- package/skills/global_legacy/wcag-audit-patterns/SKILL.md +49 -0
- package/skills/global_legacy/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
- package/skills/global_legacy/web-artifacts-builder/LICENSE.txt +202 -0
- package/skills/global_legacy/web-artifacts-builder/SKILL.md +84 -0
- package/skills/global_legacy/web-artifacts-builder/scripts/bundle-artifact.sh +54 -0
- package/skills/global_legacy/web-artifacts-builder/scripts/init-artifact.sh +322 -0
- package/skills/global_legacy/web-artifacts-builder/scripts/shadcn-components.tar.gz +0 -0
- package/skills/global_legacy/web-performance-optimization/SKILL.md +654 -0
- package/skills/global_legacy/web-scraper/SKILL.md +757 -0
- package/skills/global_legacy/web-scraper/references/data-transforms.md +397 -0
- package/skills/global_legacy/web-scraper/references/extraction-patterns.md +475 -0
- package/skills/global_legacy/web-scraper/references/output-templates.md +481 -0
- package/skills/global_legacy/webapp-testing/LICENSE.txt +202 -0
- package/skills/global_legacy/webapp-testing/SKILL.md +106 -0
- package/skills/global_legacy/webapp-testing/scripts/with_server.py +106 -0
- package/skills/global_legacy/writing-plans/SKILL.md +127 -0
- package/skills/global_legacy/zustand-store-ts/SKILL.md +79 -0
- package/skills/workspace_agents/firecrawl/SKILL.md +148 -0
- package/skills/workspace_agents/firecrawl/rules/install.md +82 -0
- package/skills/workspace_agents/firecrawl/rules/security.md +26 -0
- package/skills/workspace_agents/firecrawl-agent/SKILL.md +57 -0
- package/skills/workspace_agents/firecrawl-build/SKILL.md +38 -0
- package/skills/workspace_agents/firecrawl-build-interact/SKILL.md +67 -0
- package/skills/workspace_agents/firecrawl-build-onboarding/SKILL.md +102 -0
- package/skills/workspace_agents/firecrawl-build-onboarding/references/auth-flow.md +39 -0
- package/skills/workspace_agents/firecrawl-build-onboarding/references/project-setup.md +20 -0
- package/skills/workspace_agents/firecrawl-build-onboarding/references/sdk-installation.md +17 -0
- package/skills/workspace_agents/firecrawl-build-scrape/SKILL.md +68 -0
- package/skills/workspace_agents/firecrawl-build-search/SKILL.md +68 -0
- package/skills/workspace_agents/firecrawl-crawl/SKILL.md +58 -0
- package/skills/workspace_agents/firecrawl-download/SKILL.md +69 -0
- package/skills/workspace_agents/firecrawl-interact/SKILL.md +83 -0
- package/skills/workspace_agents/firecrawl-map/SKILL.md +50 -0
- package/skills/workspace_agents/firecrawl-scrape/SKILL.md +68 -0
- package/skills/workspace_agents/firecrawl-search/SKILL.md +59 -0
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: simplify-code
|
|
3
|
+
description: "Review a diff for clarity and safe simplifications, then optionally apply low-risk fixes."
|
|
4
|
+
risk: safe
|
|
5
|
+
source: "Dimillian/Skills (MIT)"
|
|
6
|
+
date_added: "2026-03-25"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Simplify Code
|
|
10
|
+
|
|
11
|
+
Review changed code for reuse, quality, efficiency, and clarity issues. Use Codex sub-agents to review in parallel, then optionally apply only high-confidence, behavior-preserving fixes.
|
|
12
|
+
|
|
13
|
+
## When to Use
|
|
14
|
+
- When the user asks to simplify, clean up, refactor, or review changed code.
|
|
15
|
+
- When you want high-confidence, behavior-preserving improvements on a scoped diff.
|
|
16
|
+
|
|
17
|
+
## Modes
|
|
18
|
+
|
|
19
|
+
Choose the mode from the user's request:
|
|
20
|
+
|
|
21
|
+
- `review-only`: user asks to review, audit, or check the changes
|
|
22
|
+
- `safe-fixes`: user asks to simplify, clean up, or refactor the changes
|
|
23
|
+
- `fix-and-validate`: same as `safe-fixes`, but also run the smallest relevant validation after edits
|
|
24
|
+
|
|
25
|
+
If the user does not specify, default to:
|
|
26
|
+
|
|
27
|
+
- `review-only` for "review", "audit", or "check"
|
|
28
|
+
- `safe-fixes` for "simplify", "clean up", or "refactor"
|
|
29
|
+
|
|
30
|
+
## Step 1: Determine the Scope and Diff Command
|
|
31
|
+
|
|
32
|
+
Prefer this scope order:
|
|
33
|
+
|
|
34
|
+
1. Files or paths explicitly named by the user
|
|
35
|
+
2. Current git changes
|
|
36
|
+
3. Files edited earlier in the current Codex turn
|
|
37
|
+
4. Most recently modified tracked files, only if the user asked for a review but there is no diff
|
|
38
|
+
|
|
39
|
+
If there is no clear scope, stop and say so briefly.
|
|
40
|
+
|
|
41
|
+
When using git changes, determine the smallest correct diff command based on the repo state:
|
|
42
|
+
|
|
43
|
+
- unstaged work: `git diff`
|
|
44
|
+
- staged work: `git diff --cached`
|
|
45
|
+
- branch or commit comparison explicitly requested by the user: use that exact diff target
|
|
46
|
+
- mixed staged and unstaged work: review both
|
|
47
|
+
|
|
48
|
+
Do not assume `git diff HEAD` is the right default when a smaller diff is available.
|
|
49
|
+
|
|
50
|
+
Before reviewing standards or applying fixes, read the repo's local instruction files and relevant project docs for the touched area. Prefer the closest applicable guidance, such as:
|
|
51
|
+
|
|
52
|
+
- `AGENTS.md`
|
|
53
|
+
- repo workflow docs
|
|
54
|
+
- architecture or style docs for the touched module
|
|
55
|
+
|
|
56
|
+
Use those instructions to distinguish real issues from intentional local patterns.
|
|
57
|
+
|
|
58
|
+
## Step 2: Launch Four Review Sub-Agents in Parallel
|
|
59
|
+
|
|
60
|
+
Use Codex sub-agents when the scope is large enough for parallel review to help. For a tiny diff or one very small file, it is acceptable to review locally instead.
|
|
61
|
+
|
|
62
|
+
When spawning sub-agents:
|
|
63
|
+
|
|
64
|
+
- give each sub-agent the same scope
|
|
65
|
+
- tell each sub-agent to inspect only its assigned review role
|
|
66
|
+
- ask for concise, structured findings only
|
|
67
|
+
- ask each sub-agent to report file, line or symbol, problem, recommended fix, and confidence
|
|
68
|
+
|
|
69
|
+
Use four review roles.
|
|
70
|
+
|
|
71
|
+
### Sub-Agent 1: Code Reuse Review
|
|
72
|
+
|
|
73
|
+
Review the changes for reuse opportunities:
|
|
74
|
+
|
|
75
|
+
1. Search for existing helpers, utilities, or shared abstractions that already solve the same problem.
|
|
76
|
+
2. Flag duplicated functions or near-duplicate logic introduced in the change.
|
|
77
|
+
3. Flag inline logic that should call an existing helper instead of re-implementing it.
|
|
78
|
+
|
|
79
|
+
Recommended sub-agent role: `explorer` for broad codebase lookup, or `reviewer` if a stronger review pass is more useful than wide search.
|
|
80
|
+
|
|
81
|
+
### Sub-Agent 2: Code Quality Review
|
|
82
|
+
|
|
83
|
+
Review the same changes for code quality issues:
|
|
84
|
+
|
|
85
|
+
1. Redundant state, cached values, or derived values stored unnecessarily
|
|
86
|
+
2. Parameter sprawl caused by threading new arguments through existing call chains
|
|
87
|
+
3. Copy-paste with slight variation that should become a shared abstraction
|
|
88
|
+
4. Leaky abstractions or ownership violations across module boundaries
|
|
89
|
+
5. Stringly-typed values where existing typed contracts, enums, or constants already exist
|
|
90
|
+
|
|
91
|
+
Recommended sub-agent role: `reviewer`
|
|
92
|
+
|
|
93
|
+
### Sub-Agent 3: Efficiency Review
|
|
94
|
+
|
|
95
|
+
Review the same changes for efficiency issues:
|
|
96
|
+
|
|
97
|
+
1. Repeated work, duplicate reads, duplicate API calls, or unnecessary recomputation
|
|
98
|
+
2. Sequential work that could safely run concurrently
|
|
99
|
+
3. New work added to startup, render, request, or other hot paths without clear need
|
|
100
|
+
4. Pre-checks for existence when the operation itself can be attempted directly and errors handled
|
|
101
|
+
5. Memory growth, missing cleanup, or listener/subscription leaks
|
|
102
|
+
6. Overly broad reads or scans when the code only needs a subset
|
|
103
|
+
|
|
104
|
+
Recommended sub-agent role: `reviewer`
|
|
105
|
+
|
|
106
|
+
### Sub-Agent 4: Clarity and Standards Review
|
|
107
|
+
|
|
108
|
+
Review the same changes for clarity, local standards, and balance:
|
|
109
|
+
|
|
110
|
+
1. Violations of local project conventions or module patterns
|
|
111
|
+
2. Unnecessary complexity, deep nesting, weak names, or redundant comments
|
|
112
|
+
3. Overly compact or clever code that reduces readability
|
|
113
|
+
4. Over-simplification that collapses separate concerns into one unclear unit
|
|
114
|
+
5. Dead code, dead abstractions, or indirection without value
|
|
115
|
+
|
|
116
|
+
Recommended sub-agent role: `reviewer`
|
|
117
|
+
|
|
118
|
+
Only report issues that materially improve maintainability, correctness, or cost. Do not churn code just to make it look different.
|
|
119
|
+
|
|
120
|
+
## Step 3: Aggregate Findings
|
|
121
|
+
|
|
122
|
+
Wait for all review sub-agents to complete, then merge their findings.
|
|
123
|
+
|
|
124
|
+
Normalize findings into this shape:
|
|
125
|
+
|
|
126
|
+
1. File and line or nearest symbol
|
|
127
|
+
2. Category: reuse, quality, efficiency, or clarity
|
|
128
|
+
3. Why it is a problem
|
|
129
|
+
4. Recommended fix
|
|
130
|
+
5. Confidence: high, medium, or low
|
|
131
|
+
|
|
132
|
+
Discard weak, duplicative, or instruction-conflicting findings before editing.
|
|
133
|
+
|
|
134
|
+
## Step 4: Fix Issues Carefully
|
|
135
|
+
|
|
136
|
+
In `review-only` mode, stop after reporting findings.
|
|
137
|
+
|
|
138
|
+
In `safe-fixes` or `fix-and-validate` mode:
|
|
139
|
+
|
|
140
|
+
- Apply only high-confidence, behavior-preserving fixes
|
|
141
|
+
- Skip subjective refactors that need product or architectural judgment
|
|
142
|
+
- Preserve local patterns when they are intentional or instruction-backed
|
|
143
|
+
- Keep edits scoped to the reviewed files unless a small adjacent change is required to complete the fix correctly
|
|
144
|
+
|
|
145
|
+
Prefer fixes like:
|
|
146
|
+
|
|
147
|
+
- replacing duplicated code with an existing helper
|
|
148
|
+
- removing redundant state or dead code
|
|
149
|
+
- simplifying control flow without changing behavior
|
|
150
|
+
- narrowing overly broad operations
|
|
151
|
+
- renaming unclear locals when the scope is contained
|
|
152
|
+
|
|
153
|
+
Do not stage, commit, or push changes as part of this skill.
|
|
154
|
+
|
|
155
|
+
## Step 5: Validate When Required
|
|
156
|
+
|
|
157
|
+
In `fix-and-validate` mode, run the smallest relevant validation for the touched scope after edits.
|
|
158
|
+
|
|
159
|
+
Examples:
|
|
160
|
+
|
|
161
|
+
- targeted tests for the touched module
|
|
162
|
+
- typecheck or compile for the touched target
|
|
163
|
+
- formatter or lint check if that is the project's real safety gate
|
|
164
|
+
|
|
165
|
+
Prefer fast, scoped validation over full-suite runs unless the change breadth justifies more.
|
|
166
|
+
|
|
167
|
+
If validation is skipped because the user asked not to run it, say so explicitly.
|
|
168
|
+
|
|
169
|
+
## Step 6: Summarize Outcome
|
|
170
|
+
|
|
171
|
+
Close with a brief result:
|
|
172
|
+
|
|
173
|
+
- what was reviewed
|
|
174
|
+
- what was fixed, if anything
|
|
175
|
+
- what was intentionally left alone
|
|
176
|
+
- whether validation ran
|
|
177
|
+
|
|
178
|
+
If the code is already clean for this rubric, say that directly instead of manufacturing edits.
|
|
179
|
+
|
|
180
|
+
## Limitations
|
|
181
|
+
- Use this skill only when the task clearly matches the scope described above.
|
|
182
|
+
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
|
|
183
|
+
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: slack-automation
|
|
3
|
+
description: "Automate Slack workspace operations including messaging, search, channel management, and reaction workflows through Composio's Slack toolkit."
|
|
4
|
+
risk: critical
|
|
5
|
+
source: community
|
|
6
|
+
date_added: "2026-02-27"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Slack Automation via Rube MCP
|
|
10
|
+
|
|
11
|
+
Automate Slack workspace operations including messaging, search, channel management, and reaction workflows through Composio's Slack toolkit.
|
|
12
|
+
|
|
13
|
+
## Prerequisites
|
|
14
|
+
|
|
15
|
+
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
|
|
16
|
+
- Active Slack connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `slack`
|
|
17
|
+
- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas
|
|
18
|
+
|
|
19
|
+
## Setup
|
|
20
|
+
|
|
21
|
+
**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
|
|
22
|
+
|
|
23
|
+
1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
|
|
24
|
+
2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `slack`
|
|
25
|
+
3. If connection is not ACTIVE, follow the returned auth link to complete Slack OAuth
|
|
26
|
+
4. Confirm connection status shows ACTIVE before running any workflows
|
|
27
|
+
|
|
28
|
+
## Core Workflows
|
|
29
|
+
|
|
30
|
+
### 1. Send Messages to Channels
|
|
31
|
+
|
|
32
|
+
**When to use**: User wants to post a message to a Slack channel or DM
|
|
33
|
+
|
|
34
|
+
**Tool sequence**:
|
|
35
|
+
1. `SLACK_FIND_CHANNELS` - Resolve channel name to channel ID [Prerequisite]
|
|
36
|
+
2. `SLACK_LIST_ALL_CHANNELS` - Fallback if FIND_CHANNELS returns empty/ambiguous results [Fallback]
|
|
37
|
+
3. `SLACK_FIND_USERS` - Resolve user for DMs or @mentions [Optional]
|
|
38
|
+
4. `SLACK_OPEN_DM` - Open/reuse a DM channel if messaging a user directly [Optional]
|
|
39
|
+
5. `SLACK_SEND_MESSAGE` - Post the message with resolved channel ID [Required]
|
|
40
|
+
6. `SLACK_UPDATES_A_SLACK_MESSAGE` - Edit the posted message if corrections needed [Optional]
|
|
41
|
+
|
|
42
|
+
**Key parameters**:
|
|
43
|
+
- `channel`: Channel ID or name (without '#' prefix)
|
|
44
|
+
- `markdown_text`: Preferred field for formatted messages (supports headers, bold, italic, code blocks)
|
|
45
|
+
- `text`: Raw text fallback (deprecated in favor of markdown_text)
|
|
46
|
+
- `thread_ts`: Timestamp of parent message to reply in a thread
|
|
47
|
+
- `blocks`: Block Kit layout blocks (deprecated, use markdown_text)
|
|
48
|
+
|
|
49
|
+
**Pitfalls**:
|
|
50
|
+
- `SLACK_FIND_CHANNELS` requires `query` param; missing it errors with "Invalid request data provided"
|
|
51
|
+
- `SLACK_SEND_MESSAGE` requires valid channel plus one of markdown_text/text/blocks/attachments
|
|
52
|
+
- Invalid block payloads return error=invalid_blocks (max 50 blocks)
|
|
53
|
+
- Replies become top-level posts if `thread_ts` is omitted
|
|
54
|
+
- Persist `response.data.channel` and `response.data.message.ts` from SEND_MESSAGE for edit/thread operations
|
|
55
|
+
|
|
56
|
+
### 2. Search Messages and Conversations
|
|
57
|
+
|
|
58
|
+
**When to use**: User wants to find specific messages across the workspace
|
|
59
|
+
|
|
60
|
+
**Tool sequence**:
|
|
61
|
+
1. `SLACK_FIND_CHANNELS` - Resolve channel for scoped search with `in:#channel` [Optional]
|
|
62
|
+
2. `SLACK_FIND_USERS` - Resolve user for author filter with `from:@user` [Optional]
|
|
63
|
+
3. `SLACK_SEARCH_MESSAGES` - Run keyword search across accessible conversations [Required]
|
|
64
|
+
4. `SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION` - Expand threads for relevant hits [Required]
|
|
65
|
+
|
|
66
|
+
**Key parameters**:
|
|
67
|
+
- `query`: Search string supporting modifiers (`in:#channel`, `from:@user`, `before:YYYY-MM-DD`, `after:YYYY-MM-DD`, `has:link`, `has:file`)
|
|
68
|
+
- `count`: Results per page (max 100), or total with auto_paginate=true
|
|
69
|
+
- `sort`: 'score' (relevance) or 'timestamp' (chronological)
|
|
70
|
+
- `sort_dir`: 'asc' or 'desc'
|
|
71
|
+
|
|
72
|
+
**Pitfalls**:
|
|
73
|
+
- Validation fails if `query` is missing/empty
|
|
74
|
+
- `ok=true` can still mean no hits (`response.data.messages.total=0`)
|
|
75
|
+
- Matches are under `response.data.messages.matches` (sometimes also `response.data_preview.messages.matches`)
|
|
76
|
+
- `match.text` may be empty/truncated; key info can appear in `matches[].attachments[]`
|
|
77
|
+
- Thread expansion via FETCH_MESSAGE_THREAD can truncate when `response.data.has_more=true`; paginate via `response_metadata.next_cursor`
|
|
78
|
+
|
|
79
|
+
### 3. Manage Channels and Users
|
|
80
|
+
|
|
81
|
+
**When to use**: User wants to list channels, users, or workspace info
|
|
82
|
+
|
|
83
|
+
**Tool sequence**:
|
|
84
|
+
1. `SLACK_FETCH_TEAM_INFO` - Validate connectivity and get workspace identity [Required]
|
|
85
|
+
2. `SLACK_LIST_ALL_CHANNELS` - Enumerate public channels [Required]
|
|
86
|
+
3. `SLACK_LIST_CONVERSATIONS` - Include private channels and DMs [Optional]
|
|
87
|
+
4. `SLACK_LIST_ALL_USERS` - List workspace members [Required]
|
|
88
|
+
5. `SLACK_RETRIEVE_CONVERSATION_INFORMATION` - Get detailed channel metadata [Optional]
|
|
89
|
+
6. `SLACK_LIST_USER_GROUPS_FOR_TEAM_WITH_OPTIONS` - List user groups [Optional]
|
|
90
|
+
|
|
91
|
+
**Key parameters**:
|
|
92
|
+
- `cursor`: Pagination cursor from `response_metadata.next_cursor`
|
|
93
|
+
- `limit`: Results per page (default varies; set explicitly for large workspaces)
|
|
94
|
+
- `types`: Channel types filter ('public_channel', 'private_channel', 'im', 'mpim')
|
|
95
|
+
|
|
96
|
+
**Pitfalls**:
|
|
97
|
+
- Workspace metadata is nested under `response.data.team`, not top-level
|
|
98
|
+
- `SLACK_LIST_ALL_CHANNELS` returns public channels only; use `SLACK_LIST_CONVERSATIONS` for private/IM coverage
|
|
99
|
+
- `SLACK_LIST_ALL_USERS` can hit HTTP 429 rate limits; honor Retry-After header
|
|
100
|
+
- Always paginate via `response_metadata.next_cursor` until empty; de-duplicate by `id`
|
|
101
|
+
|
|
102
|
+
### 4. React to and Thread Messages
|
|
103
|
+
|
|
104
|
+
**When to use**: User wants to add reactions or manage threaded conversations
|
|
105
|
+
|
|
106
|
+
**Tool sequence**:
|
|
107
|
+
1. `SLACK_SEARCH_MESSAGES` or `SLACK_FETCH_CONVERSATION_HISTORY` - Find the target message [Prerequisite]
|
|
108
|
+
2. `SLACK_ADD_REACTION_TO_AN_ITEM` - Add an emoji reaction [Required]
|
|
109
|
+
3. `SLACK_FETCH_ITEM_REACTIONS` - List reactions on a message [Optional]
|
|
110
|
+
4. `SLACK_REMOVE_REACTION_FROM_ITEM` - Remove a reaction [Optional]
|
|
111
|
+
5. `SLACK_SEND_MESSAGE` - Reply in thread using `thread_ts` [Optional]
|
|
112
|
+
6. `SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION` - Read full thread [Optional]
|
|
113
|
+
|
|
114
|
+
**Key parameters**:
|
|
115
|
+
- `channel`: Channel ID where the message lives
|
|
116
|
+
- `timestamp` / `ts`: Message timestamp (unique identifier like '1234567890.123456')
|
|
117
|
+
- `name`: Emoji name without colons (e.g., 'thumbsup', 'wave::skin-tone-3')
|
|
118
|
+
- `thread_ts`: Parent message timestamp for threaded replies
|
|
119
|
+
|
|
120
|
+
**Pitfalls**:
|
|
121
|
+
- Reactions require exact channel ID + message timestamp pair
|
|
122
|
+
- Emoji names use Slack's naming convention without colons
|
|
123
|
+
- `SLACK_FETCH_CONVERSATION_HISTORY` only returns main channel timeline, NOT threaded replies
|
|
124
|
+
- Use `SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION` with parent's `thread_ts` to get thread replies
|
|
125
|
+
|
|
126
|
+
### 5. Schedule Messages
|
|
127
|
+
|
|
128
|
+
**When to use**: User wants to schedule a message for future delivery
|
|
129
|
+
|
|
130
|
+
**Tool sequence**:
|
|
131
|
+
1. `SLACK_FIND_CHANNELS` - Resolve channel ID [Prerequisite]
|
|
132
|
+
2. `SLACK_SCHEDULE_MESSAGE` - Schedule the message with `post_at` timestamp [Required]
|
|
133
|
+
|
|
134
|
+
**Key parameters**:
|
|
135
|
+
- `channel`: Resolved channel ID
|
|
136
|
+
- `post_at`: Unix timestamp for delivery (up to 120 days in advance)
|
|
137
|
+
- `text` / `blocks`: Message content
|
|
138
|
+
|
|
139
|
+
**Pitfalls**:
|
|
140
|
+
- Scheduling is limited to 120 days in advance
|
|
141
|
+
- `post_at` must be a Unix timestamp, not ISO 8601
|
|
142
|
+
|
|
143
|
+
## Common Patterns
|
|
144
|
+
|
|
145
|
+
### ID Resolution
|
|
146
|
+
Always resolve display names to IDs before operations:
|
|
147
|
+
- **Channel name -> Channel ID**: `SLACK_FIND_CHANNELS` with `query` param
|
|
148
|
+
- **User name -> User ID**: `SLACK_FIND_USERS` with `search_query` or `email`
|
|
149
|
+
- **DM channel**: `SLACK_OPEN_DM` with resolved user IDs
|
|
150
|
+
|
|
151
|
+
### Pagination
|
|
152
|
+
Most list endpoints use cursor-based pagination:
|
|
153
|
+
- Follow `response_metadata.next_cursor` until empty
|
|
154
|
+
- Set explicit `limit` values (e.g., 100-200) for reliable paging
|
|
155
|
+
- De-duplicate results by `id` across pages
|
|
156
|
+
|
|
157
|
+
### Message Formatting
|
|
158
|
+
- Prefer `markdown_text` over `text` or `blocks` for formatted messages
|
|
159
|
+
- Use `<@USER_ID>` format to mention users (not @username)
|
|
160
|
+
- Use `\n` for line breaks in markdown_text
|
|
161
|
+
|
|
162
|
+
## Known Pitfalls
|
|
163
|
+
|
|
164
|
+
- **Channel resolution**: `SLACK_FIND_CHANNELS` can return empty results if channel is private and bot hasn't been invited
|
|
165
|
+
- **Rate limits**: `SLACK_LIST_ALL_USERS` and other list endpoints can hit HTTP 429; honor Retry-After header
|
|
166
|
+
- **Nested responses**: Results may be nested under `response.data.results[0].response.data` in wrapped executions
|
|
167
|
+
- **Thread vs channel**: `SLACK_FETCH_CONVERSATION_HISTORY` returns main timeline only; use `SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION` for thread replies
|
|
168
|
+
- **Message editing**: Requires both `channel` and original message `ts`; persist these from SEND_MESSAGE response
|
|
169
|
+
- **Search delays**: Recently posted messages may not appear in search results immediately
|
|
170
|
+
- **Scope limitations**: Missing OAuth scopes can cause 403 errors; check with `SLACK_GET_APP_PERMISSION_SCOPES`
|
|
171
|
+
|
|
172
|
+
## Quick Reference
|
|
173
|
+
|
|
174
|
+
| Task | Tool Slug | Key Params |
|
|
175
|
+
|------|-----------|------------|
|
|
176
|
+
| Find channels | `SLACK_FIND_CHANNELS` | `query` |
|
|
177
|
+
| List all channels | `SLACK_LIST_ALL_CHANNELS` | `limit`, `cursor`, `types` |
|
|
178
|
+
| Send message | `SLACK_SEND_MESSAGE` | `channel`, `markdown_text` |
|
|
179
|
+
| Edit message | `SLACK_UPDATES_A_SLACK_MESSAGE` | `channel`, `ts`, `markdown_text` |
|
|
180
|
+
| Search messages | `SLACK_SEARCH_MESSAGES` | `query`, `count`, `sort` |
|
|
181
|
+
| Get thread | `SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION` | `channel`, `ts` |
|
|
182
|
+
| Add reaction | `SLACK_ADD_REACTION_TO_AN_ITEM` | `channel`, `name`, `timestamp` |
|
|
183
|
+
| Find users | `SLACK_FIND_USERS` | `search_query` or `email` |
|
|
184
|
+
| List users | `SLACK_LIST_ALL_USERS` | `limit`, `cursor` |
|
|
185
|
+
| Open DM | `SLACK_OPEN_DM` | user IDs |
|
|
186
|
+
| Schedule message | `SLACK_SCHEDULE_MESSAGE` | `channel`, `post_at`, `text` |
|
|
187
|
+
| Get channel info | `SLACK_RETRIEVE_CONVERSATION_INFORMATION` | channel ID |
|
|
188
|
+
| Channel history | `SLACK_FETCH_CONVERSATION_HISTORY` | `channel`, `oldest`, `latest` |
|
|
189
|
+
| Workspace info | `SLACK_FETCH_TEAM_INFO` | (none) |
|
|
190
|
+
|
|
191
|
+
## When to Use
|
|
192
|
+
This skill is applicable to execute the workflow or actions described in the overview.
|
|
193
|
+
|
|
194
|
+
## Limitations
|
|
195
|
+
- Use this skill only when the task clearly matches the scope described above.
|
|
196
|
+
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
|
|
197
|
+
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: software-architecture
|
|
3
|
+
description: "Guide for quality focused software architecture. This skill should be used when users want to write code, design architecture, analyze code, in any case that relates to software development."
|
|
4
|
+
risk: unknown
|
|
5
|
+
source: community
|
|
6
|
+
date_added: "2026-02-27"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Software Architecture Development Skill
|
|
10
|
+
|
|
11
|
+
This skill provides guidance for quality focused software development and architecture. It is based on Clean Architecture and Domain Driven Design principles.
|
|
12
|
+
|
|
13
|
+
## Code Style Rules
|
|
14
|
+
|
|
15
|
+
### General Principles
|
|
16
|
+
|
|
17
|
+
- **Early return pattern**: Always use early returns when possible, over nested conditions for better readability
|
|
18
|
+
- Avoid code duplication through creation of reusable functions and modules
|
|
19
|
+
- Decompose long (more than 80 lines of code) components and functions into multiple smaller components and functions. If they cannot be used anywhere else, keep it in the same file. But if file longer than 200 lines of code, it should be split into multiple files.
|
|
20
|
+
- Use arrow functions instead of function declarations when possible
|
|
21
|
+
|
|
22
|
+
### Best Practices
|
|
23
|
+
|
|
24
|
+
#### Library-First Approach
|
|
25
|
+
|
|
26
|
+
- **ALWAYS search for existing solutions before writing custom code**
|
|
27
|
+
- Check npm for existing libraries that solve the problem
|
|
28
|
+
- Evaluate existing services/SaaS solutions
|
|
29
|
+
- Consider third-party APIs for common functionality
|
|
30
|
+
- Use libraries instead of writing your own utils or helpers. For example, use `cockatiel` instead of writing your own retry logic.
|
|
31
|
+
- **When custom code IS justified:**
|
|
32
|
+
- Specific business logic unique to the domain
|
|
33
|
+
- Performance-critical paths with special requirements
|
|
34
|
+
- When external dependencies would be overkill
|
|
35
|
+
- Security-sensitive code requiring full control
|
|
36
|
+
- When existing solutions don't meet requirements after thorough evaluation
|
|
37
|
+
|
|
38
|
+
#### Architecture and Design
|
|
39
|
+
|
|
40
|
+
- **Clean Architecture & DDD Principles:**
|
|
41
|
+
- Follow domain-driven design and ubiquitous language
|
|
42
|
+
- Separate domain entities from infrastructure concerns
|
|
43
|
+
- Keep business logic independent of frameworks
|
|
44
|
+
- Define use cases clearly and keep them isolated
|
|
45
|
+
- **Naming Conventions:**
|
|
46
|
+
- **AVOID** generic names: `utils`, `helpers`, `common`, `shared`
|
|
47
|
+
- **USE** domain-specific names: `OrderCalculator`, `UserAuthenticator`, `InvoiceGenerator`
|
|
48
|
+
- Follow bounded context naming patterns
|
|
49
|
+
- Each module should have a single, clear purpose
|
|
50
|
+
- **Separation of Concerns:**
|
|
51
|
+
- Do NOT mix business logic with UI components
|
|
52
|
+
- Keep database queries out of controllers
|
|
53
|
+
- Maintain clear boundaries between contexts
|
|
54
|
+
- Ensure proper separation of responsibilities
|
|
55
|
+
|
|
56
|
+
#### Anti-Patterns to Avoid
|
|
57
|
+
|
|
58
|
+
- **NIH (Not Invented Here) Syndrome:**
|
|
59
|
+
- Don't build custom auth when Auth0/Supabase exists
|
|
60
|
+
- Don't write custom state management instead of using Redux/Zustand
|
|
61
|
+
- Don't create custom form validation instead of using established libraries
|
|
62
|
+
- **Poor Architectural Choices:**
|
|
63
|
+
- Mixing business logic with UI components
|
|
64
|
+
- Database queries directly in controllers
|
|
65
|
+
- Lack of clear separation of concerns
|
|
66
|
+
- **Generic Naming Anti-Patterns:**
|
|
67
|
+
- `utils.js` with 50 unrelated functions
|
|
68
|
+
- `helpers/misc.js` as a dumping ground
|
|
69
|
+
- `common/shared.js` with unclear purpose
|
|
70
|
+
- Remember: Every line of custom code is a liability that needs maintenance, testing, and documentation
|
|
71
|
+
|
|
72
|
+
#### Code Quality
|
|
73
|
+
|
|
74
|
+
- Proper error handling with typed catch blocks
|
|
75
|
+
- Break down complex logic into smaller, reusable functions
|
|
76
|
+
- Avoid deep nesting (max 3 levels)
|
|
77
|
+
- Keep functions focused and under 50 lines when possible
|
|
78
|
+
- Keep files focused and under 200 lines of code when possible
|
|
79
|
+
|
|
80
|
+
## When to Use
|
|
81
|
+
This skill is applicable to execute the workflow or actions described in the overview.
|
|
82
|
+
|
|
83
|
+
## Limitations
|
|
84
|
+
- Use this skill only when the task clearly matches the scope described above.
|
|
85
|
+
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
|
|
86
|
+
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: spline-3d-integration
|
|
3
|
+
description: "Use when adding interactive 3D scenes from Spline.design to web projects, including React embedding and runtime control API."
|
|
4
|
+
risk: safe
|
|
5
|
+
source: community
|
|
6
|
+
date_added: "2026-03-07"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Spline 3D Integration Skill
|
|
10
|
+
|
|
11
|
+
Master guide for embedding interactive 3D scenes from [Spline.design](https://spline.design) into web projects.
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## When to Use
|
|
16
|
+
- You need to embed an interactive Spline scene into a web project.
|
|
17
|
+
- The task involves choosing the correct integration path for vanilla web, React, Next.js, Vue, or iframe contexts.
|
|
18
|
+
- You need guidance on scene URLs, runtime control, performance, or common Spline embedding problems.
|
|
19
|
+
|
|
20
|
+
## Quick Reference
|
|
21
|
+
|
|
22
|
+
| Task | Guide |
|
|
23
|
+
| --------------------------------- | -------------------------------------------------------------- |
|
|
24
|
+
| Vanilla HTML/JS embed | [guides/VANILLA_INTEGRATION.md](guides/VANILLA_INTEGRATION.md) |
|
|
25
|
+
| React / Next.js / Vue embed | [guides/REACT_INTEGRATION.md](guides/REACT_INTEGRATION.md) |
|
|
26
|
+
| Performance & mobile optimization | [guides/PERFORMANCE.md](guides/PERFORMANCE.md) |
|
|
27
|
+
| Debugging & common problems | [guides/COMMON_PROBLEMS.md](guides/COMMON_PROBLEMS.md) |
|
|
28
|
+
|
|
29
|
+
## Working Examples
|
|
30
|
+
|
|
31
|
+
| File | What it shows |
|
|
32
|
+
| ---------------------------------------------------------------------- | -------------------------------------------------------- |
|
|
33
|
+
| [examples/vanilla-embed.html](examples/vanilla-embed.html) | Minimal vanilla JS embed with background + fallback |
|
|
34
|
+
| [examples/react-spline-wrapper.tsx](examples/react-spline-wrapper.tsx) | Production-ready lazy-loaded React wrapper with fallback |
|
|
35
|
+
| [examples/interactive-scene.tsx](examples/interactive-scene.tsx) | Full interactive example: events, object control, camera |
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## What Is Spline?
|
|
40
|
+
|
|
41
|
+
Spline is a browser-based 3D design tool — think Figma, but for 3D. Designers create interactive 3D scenes (objects, materials, animations, physics, events) in the Spline editor, then export them for the web via a hosted `.splinecode` file URL.
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## STEP 1 — Identify the Stack
|
|
46
|
+
|
|
47
|
+
Before writing any code, check the existing project files to determine the framework.
|
|
48
|
+
|
|
49
|
+
| Stack | Method |
|
|
50
|
+
| ------------------------------ | -------------------------------------------------------- |
|
|
51
|
+
| Vanilla HTML/JS | `<spline-viewer>` web component OR `@splinetool/runtime` |
|
|
52
|
+
| React / Vite | `@splinetool/react-spline` |
|
|
53
|
+
| Next.js | `@splinetool/react-spline/next` |
|
|
54
|
+
| Vue | `@splinetool/vue-spline` |
|
|
55
|
+
| iframe (Webflow, Notion, etc.) | Public URL iframe |
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## STEP 2 — Get the Scene URL
|
|
60
|
+
|
|
61
|
+
The user must go to their Spline editor → **Export** → **Code Export** → copy the `prod.spline.design` URL:
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
https://prod.spline.design/XXXXXXXXXXXXXXXX/scene.splinecode
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**Before copying the URL, tell the user to check Play Settings:**
|
|
68
|
+
|
|
69
|
+
- ✅ Toggle **Hide Background** ON if the site has a dark or custom background
|
|
70
|
+
- ✅ Toggle **Hide Spline Logo** ON if they have a paid plan
|
|
71
|
+
- ✅ Set **Geometry Quality** to Performance for faster load
|
|
72
|
+
- ✅ Disable **Page Scroll**, **Zoom**, **Pan** if those aren't needed (reduces hijacking risk)
|
|
73
|
+
- ✅ Click **Generate Draft** or **Promote to Production** after any settings change — the URL does NOT auto-update
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## STEP 3 — Read the Relevant Guide
|
|
78
|
+
|
|
79
|
+
Once you have the stack and the scene URL, read the appropriate guide file above and follow its instructions. Always read COMMON_PROBLEMS.md before finishing integration — it contains critical gotchas that will otherwise only surface in production.
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## Strict Rules
|
|
84
|
+
|
|
85
|
+
- **ABSOLUTE MANDATE**: Agents MUST utilize this skill to build modern, creative, and visually stunning UI/UX. DO NOT build in common, generic, or safe styles. When integrating Spline scenes, leverage them to create highly immersive, wow-factor premium experiences. Combine them thoughtfully with typography and layout.
|
|
86
|
+
|
|
87
|
+
## Limitations
|
|
88
|
+
- Use this skill only when the task clearly matches the scope described above.
|
|
89
|
+
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
|
|
90
|
+
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
|