@namch/agent-assistant 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/LICENSE +21 -0
- package/README.md +642 -0
- package/agents/backend-engineer.md +162 -0
- package/agents/brainstormer.md +175 -0
- package/agents/business-analyst.md +171 -0
- package/agents/database-architect.md +165 -0
- package/agents/debugger.md +161 -0
- package/agents/designer.md +155 -0
- package/agents/devops-engineer.md +162 -0
- package/agents/docs-manager.md +177 -0
- package/agents/frontend-engineer.md +166 -0
- package/agents/game-engineer.md +155 -0
- package/agents/mobile-engineer.md +156 -0
- package/agents/performance-engineer.md +159 -0
- package/agents/planner.md +167 -0
- package/agents/project-manager.md +166 -0
- package/agents/researcher.md +151 -0
- package/agents/reviewer.md +161 -0
- package/agents/scouter.md +163 -0
- package/agents/security-engineer.md +161 -0
- package/agents/tech-lead.md +166 -0
- package/agents/tester.md +162 -0
- package/cli/README.md +210 -0
- package/cli/install.js +1075 -0
- package/cli/install.test.js.example +120 -0
- package/code-assistants/antigravity-assistant/AntigravityGlobal.agent.md +200 -0
- package/code-assistants/antigravity-assistant/GEMINI.md +172 -0
- package/code-assistants/claude-assistant/CLAUDE.md +51 -0
- package/code-assistants/copilot-assistant/agent-assistant.agent.md +207 -0
- package/code-assistants/cursor-assistant/.cursorrules +147 -0
- package/code-assistants/cursor-assistant/rules/agent-assistant.mdc +181 -0
- package/commands/ask/fast.md +119 -0
- package/commands/ask/hard.md +161 -0
- package/commands/ask.md +64 -0
- package/commands/auto.md +111 -0
- package/commands/brainstorm/fast.md +166 -0
- package/commands/brainstorm/hard.md +195 -0
- package/commands/brainstorm.md +64 -0
- package/commands/code/fast.md +166 -0
- package/commands/code/hard.md +330 -0
- package/commands/code.md +64 -0
- package/commands/cook/fast.md +103 -0
- package/commands/cook/hard.md +202 -0
- package/commands/cook.md +64 -0
- package/commands/debug/fast.md +65 -0
- package/commands/debug/hard.md +96 -0
- package/commands/debug.md +64 -0
- package/commands/deploy/check.md +150 -0
- package/commands/deploy/preview.md +125 -0
- package/commands/deploy/production.md +160 -0
- package/commands/deploy/rollback.md +149 -0
- package/commands/deploy.md +71 -0
- package/commands/design/fast.md +134 -0
- package/commands/design/hard.md +209 -0
- package/commands/design.md +64 -0
- package/commands/docs/audit.md +167 -0
- package/commands/docs/business.md +167 -0
- package/commands/docs/core.md +161 -0
- package/commands/docs.md +178 -0
- package/commands/fix/fast.md +84 -0
- package/commands/fix/hard.md +116 -0
- package/commands/fix.md +64 -0
- package/commands/plan/fast.md +78 -0
- package/commands/plan/hard.md +131 -0
- package/commands/plan.md +64 -0
- package/commands/review/fast.md +65 -0
- package/commands/review/hard.md +96 -0
- package/commands/review.md +64 -0
- package/commands/test/fast.md +75 -0
- package/commands/test/hard.md +108 -0
- package/commands/test.md +64 -0
- package/documents/business/business-features.md +894 -0
- package/documents/business/business-glossary.md +553 -0
- package/documents/business/business-prd.md +399 -0
- package/documents/business/business-workflows.md +713 -0
- package/documents/knowledge-architecture.md +541 -0
- package/documents/knowledge-domain.md +600 -0
- package/documents/knowledge-overview.md +330 -0
- package/documents/knowledge-source-base.md +572 -0
- package/documents/knowledge-standards.md +632 -0
- package/package.json +67 -0
- package/rules/ADAPTIVE-EXECUTION.md +271 -0
- package/rules/AGENT-RULES.md +284 -0
- package/rules/BOOTSTRAP.md +298 -0
- package/rules/ERROR-RECOVERY.md +201 -0
- package/rules/EXECUTION-PROTOCOL.md +485 -0
- package/rules/ORCHESTRATION-LAWS.md +218 -0
- package/rules/QUICK-REFERENCE.md +193 -0
- package/rules/SKILL-DISCOVERY.md +347 -0
- package/skills/aesthetic/SKILL.md +134 -0
- package/skills/aesthetic/assets/design-guideline-template.md +163 -0
- package/skills/aesthetic/assets/design-story-template.md +135 -0
- package/skills/aesthetic/references/design-principles.md +62 -0
- package/skills/aesthetic/references/design-resources.md +86 -0
- package/skills/aesthetic/references/micro-interactions.md +53 -0
- package/skills/aesthetic/references/storytelling-design.md +50 -0
- package/skills/agent-framework-azure-hosted-agents/SKILL.md +335 -0
- package/skills/agent-framework-azure-hosted-agents/references/advanced.md +512 -0
- package/skills/agent-framework-azure-hosted-agents/references/mcp.md +301 -0
- package/skills/agent-framework-azure-hosted-agents/references/threads.md +300 -0
- package/skills/agent-framework-azure-hosted-agents/references/tools.md +278 -0
- package/skills/agile-product-owner/SKILL.md +31 -0
- package/skills/agile-product-owner/scripts/user_story_generator.py +387 -0
- package/skills/algorithmic-art/SKILL.md +136 -0
- package/skills/angular-architect/SKILL.md +97 -0
- package/skills/angular-architect/references/components.md +300 -0
- package/skills/angular-architect/references/ngrx.md +404 -0
- package/skills/angular-architect/references/routing.md +364 -0
- package/skills/angular-architect/references/rxjs.md +322 -0
- package/skills/angular-architect/references/testing.md +408 -0
- package/skills/api-designer/SKILL.md +101 -0
- package/skills/api-designer/references/error-handling.md +541 -0
- package/skills/api-designer/references/openapi.md +824 -0
- package/skills/api-designer/references/pagination.md +494 -0
- package/skills/api-designer/references/rest-patterns.md +335 -0
- package/skills/api-designer/references/versioning.md +391 -0
- package/skills/api-patterns/SKILL.md +81 -0
- package/skills/api-patterns/api-style.md +42 -0
- package/skills/api-patterns/auth.md +24 -0
- package/skills/api-patterns/documentation.md +26 -0
- package/skills/api-patterns/graphql.md +41 -0
- package/skills/api-patterns/rate-limiting.md +31 -0
- package/skills/api-patterns/response.md +37 -0
- package/skills/api-patterns/rest.md +40 -0
- package/skills/api-patterns/scripts/api_validator.py +211 -0
- package/skills/api-patterns/security-testing.md +122 -0
- package/skills/api-patterns/trpc.md +41 -0
- package/skills/api-patterns/versioning.md +22 -0
- package/skills/app-builder/SKILL.md +75 -0
- package/skills/app-builder/agent-coordination.md +71 -0
- package/skills/app-builder/feature-building.md +53 -0
- package/skills/app-builder/project-detection.md +34 -0
- package/skills/app-builder/scaffolding.md +118 -0
- package/skills/app-builder/tech-stack.md +40 -0
- package/skills/app-builder/templates/SKILL.md +39 -0
- package/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
- package/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
- package/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
- package/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
- package/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
- package/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
- package/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
- package/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +82 -0
- package/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +100 -0
- package/skills/app-builder/templates/nextjs-static/TEMPLATE.md +106 -0
- package/skills/app-builder/templates/nuxt-app/TEMPLATE.md +101 -0
- package/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
- package/skills/app-builder/templates/react-native-app/TEMPLATE.md +93 -0
- package/skills/architecture/SKILL.md +55 -0
- package/skills/architecture/context-discovery.md +43 -0
- package/skills/architecture/examples.md +94 -0
- package/skills/architecture/pattern-selection.md +68 -0
- package/skills/architecture/patterns-reference.md +50 -0
- package/skills/architecture/trade-off-analysis.md +77 -0
- package/skills/architecture-designer/SKILL.md +89 -0
- package/skills/architecture-designer/references/adr-template.md +119 -0
- package/skills/architecture-designer/references/architecture-patterns.md +114 -0
- package/skills/architecture-designer/references/database-selection.md +105 -0
- package/skills/architecture-designer/references/nfr-checklist.md +115 -0
- package/skills/architecture-designer/references/system-design.md +103 -0
- package/skills/artifacts-builder/SKILL.md +74 -0
- package/skills/artifacts-builder/scripts/bundle-artifact.sh +54 -0
- package/skills/artifacts-builder/scripts/init-artifact.sh +322 -0
- package/skills/artifacts-builder/scripts/shadcn-components.tar.gz +0 -0
- package/skills/ask-questions-if-underspecified/SKILL.md +81 -0
- package/skills/atlassian-mcp/SKILL.md +100 -0
- package/skills/atlassian-mcp/references/authentication-patterns.md +523 -0
- package/skills/atlassian-mcp/references/common-workflows.md +663 -0
- package/skills/atlassian-mcp/references/confluence-operations.md +531 -0
- package/skills/atlassian-mcp/references/jira-queries.md +424 -0
- package/skills/atlassian-mcp/references/mcp-server-setup.md +295 -0
- package/skills/aws-agentic-ai/SKILL.md +117 -0
- package/skills/aws-agentic-ai/cross-service/credential-management.md +450 -0
- package/skills/aws-agentic-ai/services/browser/README.md +363 -0
- package/skills/aws-agentic-ai/services/code-interpreter/README.md +232 -0
- package/skills/aws-agentic-ai/services/gateway/README.md +100 -0
- package/skills/aws-agentic-ai/services/gateway/deploy-template.sh +117 -0
- package/skills/aws-agentic-ai/services/gateway/deployment-strategies.md +416 -0
- package/skills/aws-agentic-ai/services/gateway/troubleshooting-guide.md +384 -0
- package/skills/aws-agentic-ai/services/gateway/validate-deployment.sh +186 -0
- package/skills/aws-agentic-ai/services/identity/README.md +186 -0
- package/skills/aws-agentic-ai/services/memory/README.md +253 -0
- package/skills/aws-agentic-ai/services/observability/README.md +517 -0
- package/skills/aws-agentic-ai/services/runtime/README.md +215 -0
- package/skills/aws-cdk-development/SKILL.md +278 -0
- package/skills/aws-cdk-development/references/cdk-patterns.md +431 -0
- package/skills/aws-cdk-development/scripts/validate-stack.sh +240 -0
- package/skills/aws-cost-operations/SKILL.md +317 -0
- package/skills/aws-cost-operations/references/cloudwatch-alarms.md +567 -0
- package/skills/aws-cost-operations/references/operations-patterns.md +394 -0
- package/skills/aws-serverless-eda/SKILL.md +757 -0
- package/skills/aws-serverless-eda/references/deployment-best-practices.md +830 -0
- package/skills/aws-serverless-eda/references/eda-patterns.md +1002 -0
- package/skills/aws-serverless-eda/references/observability-best-practices.md +770 -0
- package/skills/aws-serverless-eda/references/performance-optimization.md +671 -0
- package/skills/aws-serverless-eda/references/security-best-practices.md +625 -0
- package/skills/aws-serverless-eda/references/serverless-patterns.md +838 -0
- package/skills/azd-deployment/SKILL.md +298 -0
- package/skills/azd-deployment/references/azure-yaml-schema.md +369 -0
- package/skills/azd-deployment/references/bicep-patterns.md +371 -0
- package/skills/azd-deployment/references/troubleshooting.md +386 -0
- package/skills/azure-ai-agents-python/SKILL.md +277 -0
- package/skills/azure-ai-agents-python/references/async-patterns.md +494 -0
- package/skills/azure-ai-agents-python/references/streaming.md +337 -0
- package/skills/azure-ai-agents-python/references/tools.md +461 -0
- package/skills/azure-ai-search-python/SKILL.md +198 -0
- package/skills/azure-ai-search-python/references/agentic-retrieval.md +263 -0
- package/skills/azure-ai-search-python/scripts/setup_agentic_retrieval.py +164 -0
- package/skills/azure-ai-voicelive-skill/SKILL.md +294 -0
- package/skills/azure-ai-voicelive-skill/references/api-reference.md +344 -0
- package/skills/azure-ai-voicelive-skill/references/examples.md +558 -0
- package/skills/azure-ai-voicelive-skill/references/models.md +737 -0
- package/skills/backend-development/SKILL.md +155 -0
- package/skills/bash-linux/SKILL.md +199 -0
- package/skills/behavioral-modes/SKILL.md +242 -0
- package/skills/best-practices/SKILL.md +500 -0
- package/skills/best-practices/agents/best-practices-referencer.md +263 -0
- package/skills/best-practices/agents/codebase-context-builder.md +326 -0
- package/skills/best-practices/agents/task-intent-analyzer.md +245 -0
- package/skills/best-practices/references/anti-patterns.md +571 -0
- package/skills/best-practices/references/before-after-examples.md +1114 -0
- package/skills/best-practices/references/best-practices-guide.md +513 -0
- package/skills/best-practices/references/common-workflows.md +692 -0
- package/skills/best-practices/references/prompt-patterns.md +547 -0
- package/skills/better-auth/SKILL.md +204 -0
- package/skills/better-auth/references/advanced-features.md +553 -0
- package/skills/better-auth/references/database-integration.md +577 -0
- package/skills/better-auth/references/email-password-auth.md +416 -0
- package/skills/better-auth/references/oauth-providers.md +430 -0
- package/skills/better-auth/scripts/.coverage +0 -0
- package/skills/better-auth/scripts/better_auth_init.py +521 -0
- package/skills/better-auth/scripts/requirements.txt +15 -0
- package/skills/better-auth/scripts/tests/.coverage +0 -0
- package/skills/better-auth/scripts/tests/test_better_auth_init.py +421 -0
- package/skills/brainstorming/SKILL.md +54 -0
- package/skills/brand-guidelines/LICENSE.txt +202 -0
- package/skills/brand-guidelines/SKILL.md +73 -0
- package/skills/building-ai-agent-on-cloudflare/SKILL.md +391 -0
- package/skills/building-ai-agent-on-cloudflare/references/agent-patterns.md +461 -0
- package/skills/building-ai-agent-on-cloudflare/references/examples.md +188 -0
- package/skills/building-ai-agent-on-cloudflare/references/state-patterns.md +360 -0
- package/skills/building-ai-agent-on-cloudflare/references/troubleshooting.md +362 -0
- package/skills/building-mcp-server-on-cloudflare/SKILL.md +265 -0
- package/skills/building-mcp-server-on-cloudflare/references/examples.md +115 -0
- package/skills/building-mcp-server-on-cloudflare/references/oauth-setup.md +338 -0
- package/skills/building-mcp-server-on-cloudflare/references/troubleshooting.md +317 -0
- package/skills/canvas-design/LICENSE.txt +202 -0
- package/skills/canvas-design/SKILL.md +130 -0
- package/skills/canvas-design/canvas-fonts/ArsenalSC-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/ArsenalSC-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/BigShoulders-Bold.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/BigShoulders-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/BigShoulders-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Boldonse-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/Boldonse-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/BricolageGrotesque-Bold.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/BricolageGrotesque-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/BricolageGrotesque-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/CrimsonPro-Bold.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/CrimsonPro-Italic.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/CrimsonPro-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/CrimsonPro-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/DMMono-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/DMMono-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/EricaOne-OFL.txt +94 -0
- package/skills/canvas-design/canvas-fonts/EricaOne-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/GeistMono-Bold.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/GeistMono-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/GeistMono-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Gloock-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/Gloock-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/IBMPlexMono-Bold.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/IBMPlexMono-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/IBMPlexMono-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/IBMPlexSerif-Bold.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/IBMPlexSerif-BoldItalic.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/IBMPlexSerif-Italic.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/IBMPlexSerif-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/InstrumentSans-Bold.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/InstrumentSans-BoldItalic.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/InstrumentSans-Italic.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/InstrumentSans-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/InstrumentSans-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/InstrumentSerif-Italic.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/InstrumentSerif-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Italiana-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/Italiana-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/JetBrainsMono-Bold.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/JetBrainsMono-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/JetBrainsMono-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Jura-Light.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Jura-Medium.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Jura-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/LibreBaskerville-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/LibreBaskerville-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Lora-Bold.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Lora-BoldItalic.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Lora-Italic.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Lora-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/Lora-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/NationalPark-Bold.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/NationalPark-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/NationalPark-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/NothingYouCouldDo-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Outfit-Bold.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Outfit-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/Outfit-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/PixelifySans-Medium.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/PixelifySans-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/PoiretOne-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/PoiretOne-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/RedHatMono-Bold.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/RedHatMono-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/RedHatMono-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Silkscreen-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/Silkscreen-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/SmoochSans-Medium.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/SmoochSans-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/Tektur-Medium.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/Tektur-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/Tektur-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/WorkSans-Bold.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/WorkSans-BoldItalic.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/WorkSans-Italic.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/WorkSans-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/WorkSans-Regular.ttf +0 -0
- package/skills/canvas-design/canvas-fonts/YoungSerif-OFL.txt +93 -0
- package/skills/canvas-design/canvas-fonts/YoungSerif-Regular.ttf +0 -0
- package/skills/changelog-generator/SKILL.md +104 -0
- package/skills/chaos-engineer/SKILL.md +98 -0
- package/skills/chaos-engineer/references/chaos-tools.md +514 -0
- package/skills/chaos-engineer/references/experiment-design.md +232 -0
- package/skills/chaos-engineer/references/game-days.md +437 -0
- package/skills/chaos-engineer/references/infrastructure-chaos.md +351 -0
- package/skills/chaos-engineer/references/kubernetes-chaos.md +435 -0
- package/skills/chrome-devtools/SKILL.md +407 -0
- package/skills/chrome-devtools/references/cdp-domains.md +694 -0
- package/skills/chrome-devtools/references/performance-guide.md +999 -0
- package/skills/chrome-devtools/references/puppeteer-reference.md +953 -0
- package/skills/chrome-devtools/scripts/README.md +228 -0
- package/skills/chrome-devtools/scripts/__tests__/selector.test.js +210 -0
- package/skills/chrome-devtools/scripts/click.js +79 -0
- package/skills/chrome-devtools/scripts/console.js +75 -0
- package/skills/chrome-devtools/scripts/evaluate.js +49 -0
- package/skills/chrome-devtools/scripts/fill.js +72 -0
- package/skills/chrome-devtools/scripts/install-deps.sh +181 -0
- package/skills/chrome-devtools/scripts/install.sh +83 -0
- package/skills/chrome-devtools/scripts/lib/browser.js +122 -0
- package/skills/chrome-devtools/scripts/lib/selector.js +178 -0
- package/skills/chrome-devtools/scripts/navigate.js +46 -0
- package/skills/chrome-devtools/scripts/network.js +102 -0
- package/skills/chrome-devtools/scripts/package.json +15 -0
- package/skills/chrome-devtools/scripts/performance.js +145 -0
- package/skills/chrome-devtools/scripts/screenshot.js +180 -0
- package/skills/chrome-devtools/scripts/snapshot.js +131 -0
- package/skills/clean-code/SKILL.md +203 -0
- package/skills/cli-developer/SKILL.md +97 -0
- package/skills/cli-developer/references/design-patterns.md +224 -0
- package/skills/cli-developer/references/go-cli.md +543 -0
- package/skills/cli-developer/references/node-cli.md +386 -0
- package/skills/cli-developer/references/python-cli.md +425 -0
- package/skills/cli-developer/references/ux-patterns.md +451 -0
- package/skills/cloud-architect/SKILL.md +106 -0
- package/skills/cloud-architect/references/aws.md +394 -0
- package/skills/cloud-architect/references/azure.md +562 -0
- package/skills/cloud-architect/references/gcp.md +633 -0
- package/skills/cloudflare-expert/SKILL.md +227 -0
- package/skills/cloudflare-expert/references/agents-sdk/README.md +35 -0
- package/skills/cloudflare-expert/references/agents-sdk/api.md +100 -0
- package/skills/cloudflare-expert/references/agents-sdk/configuration.md +99 -0
- package/skills/cloudflare-expert/references/agents-sdk/gotchas.md +59 -0
- package/skills/cloudflare-expert/references/agents-sdk/patterns.md +89 -0
- package/skills/cloudflare-expert/references/ai-gateway/README.md +695 -0
- package/skills/cloudflare-expert/references/ai-search/README.md +14 -0
- package/skills/cloudflare-expert/references/ai-search/api.md +38 -0
- package/skills/cloudflare-expert/references/ai-search/configuration.md +52 -0
- package/skills/cloudflare-expert/references/ai-search/gotchas.md +41 -0
- package/skills/cloudflare-expert/references/ai-search/patterns.md +45 -0
- package/skills/cloudflare-expert/references/analytics-engine/README.md +14 -0
- package/skills/cloudflare-expert/references/analytics-engine/api.md +27 -0
- package/skills/cloudflare-expert/references/analytics-engine/configuration.md +45 -0
- package/skills/cloudflare-expert/references/analytics-engine/gotchas.md +3 -0
- package/skills/cloudflare-expert/references/analytics-engine/patterns.md +36 -0
- package/skills/cloudflare-expert/references/api/README.md +21 -0
- package/skills/cloudflare-expert/references/api/api.md +31 -0
- package/skills/cloudflare-expert/references/api/configuration.md +20 -0
- package/skills/cloudflare-expert/references/api/gotchas.md +28 -0
- package/skills/cloudflare-expert/references/api/patterns.md +47 -0
- package/skills/cloudflare-expert/references/api-shield/README.md +20 -0
- package/skills/cloudflare-expert/references/api-shield/api.md +78 -0
- package/skills/cloudflare-expert/references/api-shield/configuration.md +128 -0
- package/skills/cloudflare-expert/references/api-shield/gotchas.md +51 -0
- package/skills/cloudflare-expert/references/api-shield/patterns.md +145 -0
- package/skills/cloudflare-expert/references/argo-smart-routing/README.md +16 -0
- package/skills/cloudflare-expert/references/argo-smart-routing/api.md +50 -0
- package/skills/cloudflare-expert/references/argo-smart-routing/configuration.md +53 -0
- package/skills/cloudflare-expert/references/argo-smart-routing/gotchas.md +16 -0
- package/skills/cloudflare-expert/references/argo-smart-routing/patterns.md +45 -0
- package/skills/cloudflare-expert/references/bindings/README.md +14 -0
- package/skills/cloudflare-expert/references/bindings/api.md +3 -0
- package/skills/cloudflare-expert/references/bindings/configuration.md +58 -0
- package/skills/cloudflare-expert/references/bindings/gotchas.md +35 -0
- package/skills/cloudflare-expert/references/bindings/patterns.md +37 -0
- package/skills/cloudflare-expert/references/bot-management/README.md +71 -0
- package/skills/cloudflare-expert/references/bot-management/api.md +168 -0
- package/skills/cloudflare-expert/references/bot-management/configuration.md +114 -0
- package/skills/cloudflare-expert/references/bot-management/gotchas.md +99 -0
- package/skills/cloudflare-expert/references/bot-management/patterns.md +125 -0
- package/skills/cloudflare-expert/references/browser-rendering/README.md +16 -0
- package/skills/cloudflare-expert/references/browser-rendering/api.md +54 -0
- package/skills/cloudflare-expert/references/browser-rendering/configuration.md +47 -0
- package/skills/cloudflare-expert/references/browser-rendering/gotchas.md +29 -0
- package/skills/cloudflare-expert/references/browser-rendering/patterns.md +29 -0
- package/skills/cloudflare-expert/references/c3/README.md +264 -0
- package/skills/cloudflare-expert/references/cache-reserve/README.md +93 -0
- package/skills/cloudflare-expert/references/cache-reserve/api.md +176 -0
- package/skills/cloudflare-expert/references/cache-reserve/configuration.md +164 -0
- package/skills/cloudflare-expert/references/cache-reserve/gotchas.md +203 -0
- package/skills/cloudflare-expert/references/cache-reserve/patterns.md +180 -0
- package/skills/cloudflare-expert/references/containers/README.md +16 -0
- package/skills/cloudflare-expert/references/containers/api.md +43 -0
- package/skills/cloudflare-expert/references/containers/configuration.md +56 -0
- package/skills/cloudflare-expert/references/containers/gotchas.md +21 -0
- package/skills/cloudflare-expert/references/containers/patterns.md +40 -0
- package/skills/cloudflare-expert/references/cron-triggers/README.md +85 -0
- package/skills/cloudflare-expert/references/cron-triggers/api.md +198 -0
- package/skills/cloudflare-expert/references/cron-triggers/configuration.md +151 -0
- package/skills/cloudflare-expert/references/cron-triggers/gotchas.md +129 -0
- package/skills/cloudflare-expert/references/cron-triggers/patterns.md +122 -0
- package/skills/cloudflare-expert/references/d1/README.md +92 -0
- package/skills/cloudflare-expert/references/d1/api.md +141 -0
- package/skills/cloudflare-expert/references/d1/configuration.md +127 -0
- package/skills/cloudflare-expert/references/d1/gotchas.md +70 -0
- package/skills/cloudflare-expert/references/d1/patterns.md +144 -0
- package/skills/cloudflare-expert/references/ddos/README.md +34 -0
- package/skills/cloudflare-expert/references/ddos/api.md +136 -0
- package/skills/cloudflare-expert/references/ddos/configuration.md +67 -0
- package/skills/cloudflare-expert/references/ddos/gotchas.md +114 -0
- package/skills/cloudflare-expert/references/ddos/patterns.md +158 -0
- package/skills/cloudflare-expert/references/do-storage/README.md +62 -0
- package/skills/cloudflare-expert/references/do-storage/api.md +89 -0
- package/skills/cloudflare-expert/references/do-storage/configuration.md +116 -0
- package/skills/cloudflare-expert/references/do-storage/gotchas.md +93 -0
- package/skills/cloudflare-expert/references/do-storage/patterns.md +112 -0
- package/skills/cloudflare-expert/references/durable-objects/README.md +125 -0
- package/skills/cloudflare-expert/references/durable-objects/api.md +152 -0
- package/skills/cloudflare-expert/references/durable-objects/configuration.md +148 -0
- package/skills/cloudflare-expert/references/durable-objects/gotchas.md +158 -0
- package/skills/cloudflare-expert/references/durable-objects/patterns.md +255 -0
- package/skills/cloudflare-expert/references/email-routing/README.md +18 -0
- package/skills/cloudflare-expert/references/email-routing/api.md +46 -0
- package/skills/cloudflare-expert/references/email-routing/configuration.md +63 -0
- package/skills/cloudflare-expert/references/email-routing/gotchas.md +16 -0
- package/skills/cloudflare-expert/references/email-routing/patterns.md +46 -0
- package/skills/cloudflare-expert/references/email-workers/README.md +598 -0
- package/skills/cloudflare-expert/references/hyperdrive/README.md +62 -0
- package/skills/cloudflare-expert/references/hyperdrive/api.md +137 -0
- package/skills/cloudflare-expert/references/hyperdrive/configuration.md +133 -0
- package/skills/cloudflare-expert/references/hyperdrive/gotchas.md +184 -0
- package/skills/cloudflare-expert/references/hyperdrive/patterns.md +176 -0
- package/skills/cloudflare-expert/references/images/README.md +14 -0
- package/skills/cloudflare-expert/references/images/api.md +3 -0
- package/skills/cloudflare-expert/references/images/configuration.md +45 -0
- package/skills/cloudflare-expert/references/images/gotchas.md +23 -0
- package/skills/cloudflare-expert/references/images/patterns.md +31 -0
- package/skills/cloudflare-expert/references/kv/README.md +60 -0
- package/skills/cloudflare-expert/references/kv/api.md +114 -0
- package/skills/cloudflare-expert/references/kv/configuration.md +92 -0
- package/skills/cloudflare-expert/references/kv/gotchas.md +117 -0
- package/skills/cloudflare-expert/references/kv/patterns.md +139 -0
- package/skills/cloudflare-expert/references/miniflare/README.md +64 -0
- package/skills/cloudflare-expert/references/miniflare/api.md +144 -0
- package/skills/cloudflare-expert/references/miniflare/configuration.md +203 -0
- package/skills/cloudflare-expert/references/miniflare/gotchas.md +187 -0
- package/skills/cloudflare-expert/references/miniflare/patterns.md +211 -0
- package/skills/cloudflare-expert/references/network-interconnect/README.md +60 -0
- package/skills/cloudflare-expert/references/network-interconnect/api.md +240 -0
- package/skills/cloudflare-expert/references/network-interconnect/configuration.md +127 -0
- package/skills/cloudflare-expert/references/network-interconnect/gotchas.md +171 -0
- package/skills/cloudflare-expert/references/network-interconnect/patterns.md +171 -0
- package/skills/cloudflare-expert/references/observability/README.md +18 -0
- package/skills/cloudflare-expert/references/observability/api.md +51 -0
- package/skills/cloudflare-expert/references/observability/configuration.md +60 -0
- package/skills/cloudflare-expert/references/observability/gotchas.md +36 -0
- package/skills/cloudflare-expert/references/observability/patterns.md +42 -0
- package/skills/cloudflare-expert/references/pages/README.md +76 -0
- package/skills/cloudflare-expert/references/pages/api.md +200 -0
- package/skills/cloudflare-expert/references/pages/configuration.md +228 -0
- package/skills/cloudflare-expert/references/pages/gotchas.md +161 -0
- package/skills/cloudflare-expert/references/pages/patterns.md +145 -0
- package/skills/cloudflare-expert/references/pages-functions/README.md +57 -0
- package/skills/cloudflare-expert/references/pages-functions/api.md +201 -0
- package/skills/cloudflare-expert/references/pages-functions/configuration.md +159 -0
- package/skills/cloudflare-expert/references/pages-functions/gotchas.md +151 -0
- package/skills/cloudflare-expert/references/pages-functions/patterns.md +190 -0
- package/skills/cloudflare-expert/references/pipelines/README.md +664 -0
- package/skills/cloudflare-expert/references/pulumi/README.md +107 -0
- package/skills/cloudflare-expert/references/pulumi/api.md +194 -0
- package/skills/cloudflare-expert/references/pulumi/configuration.md +216 -0
- package/skills/cloudflare-expert/references/pulumi/gotchas.md +223 -0
- package/skills/cloudflare-expert/references/pulumi/patterns.md +139 -0
- package/skills/cloudflare-expert/references/queues/README.md +69 -0
- package/skills/cloudflare-expert/references/queues/api.md +138 -0
- package/skills/cloudflare-expert/references/queues/configuration.md +125 -0
- package/skills/cloudflare-expert/references/queues/gotchas.md +112 -0
- package/skills/cloudflare-expert/references/queues/patterns.md +155 -0
- package/skills/cloudflare-expert/references/r2/README.md +61 -0
- package/skills/cloudflare-expert/references/r2/api.md +127 -0
- package/skills/cloudflare-expert/references/r2/configuration.md +76 -0
- package/skills/cloudflare-expert/references/r2/gotchas.md +94 -0
- package/skills/cloudflare-expert/references/r2/patterns.md +127 -0
- package/skills/cloudflare-expert/references/r2-data-catalog/README.md +18 -0
- package/skills/cloudflare-expert/references/r2-data-catalog/api.md +29 -0
- package/skills/cloudflare-expert/references/r2-data-catalog/configuration.md +39 -0
- package/skills/cloudflare-expert/references/r2-data-catalog/gotchas.md +20 -0
- package/skills/cloudflare-expert/references/r2-data-catalog/patterns.md +46 -0
- package/skills/cloudflare-expert/references/r2-sql/README.md +512 -0
- package/skills/cloudflare-expert/references/realtime-sfu/README.md +21 -0
- package/skills/cloudflare-expert/references/realtime-sfu/api.md +135 -0
- package/skills/cloudflare-expert/references/realtime-sfu/configuration.md +63 -0
- package/skills/cloudflare-expert/references/realtime-sfu/gotchas.md +75 -0
- package/skills/cloudflare-expert/references/realtime-sfu/patterns.md +102 -0
- package/skills/cloudflare-expert/references/realtimekit/README.md +81 -0
- package/skills/cloudflare-expert/references/realtimekit/api.md +164 -0
- package/skills/cloudflare-expert/references/realtimekit/configuration.md +147 -0
- package/skills/cloudflare-expert/references/realtimekit/gotchas.md +172 -0
- package/skills/cloudflare-expert/references/realtimekit/patterns.md +155 -0
- package/skills/cloudflare-expert/references/sandbox/README.md +90 -0
- package/skills/cloudflare-expert/references/sandbox/api.md +178 -0
- package/skills/cloudflare-expert/references/sandbox/configuration.md +131 -0
- package/skills/cloudflare-expert/references/sandbox/gotchas.md +156 -0
- package/skills/cloudflare-expert/references/sandbox/patterns.md +203 -0
- package/skills/cloudflare-expert/references/secrets-store/README.md +58 -0
- package/skills/cloudflare-expert/references/secrets-store/api.md +182 -0
- package/skills/cloudflare-expert/references/secrets-store/configuration.md +140 -0
- package/skills/cloudflare-expert/references/secrets-store/gotchas.md +129 -0
- package/skills/cloudflare-expert/references/secrets-store/patterns.md +218 -0
- package/skills/cloudflare-expert/references/smart-placement/README.md +91 -0
- package/skills/cloudflare-expert/references/smart-placement/api.md +139 -0
- package/skills/cloudflare-expert/references/smart-placement/configuration.md +129 -0
- package/skills/cloudflare-expert/references/smart-placement/gotchas.md +87 -0
- package/skills/cloudflare-expert/references/smart-placement/patterns.md +135 -0
- package/skills/cloudflare-expert/references/snippets/README.md +15 -0
- package/skills/cloudflare-expert/references/snippets/api.md +47 -0
- package/skills/cloudflare-expert/references/snippets/configuration.md +33 -0
- package/skills/cloudflare-expert/references/snippets/gotchas.md +21 -0
- package/skills/cloudflare-expert/references/snippets/patterns.md +34 -0
- package/skills/cloudflare-expert/references/spectrum/README.md +16 -0
- package/skills/cloudflare-expert/references/spectrum/api.md +24 -0
- package/skills/cloudflare-expert/references/spectrum/configuration.md +43 -0
- package/skills/cloudflare-expert/references/spectrum/gotchas.md +42 -0
- package/skills/cloudflare-expert/references/spectrum/patterns.md +40 -0
- package/skills/cloudflare-expert/references/static-assets/README.md +14 -0
- package/skills/cloudflare-expert/references/static-assets/api.md +3 -0
- package/skills/cloudflare-expert/references/static-assets/configuration.md +47 -0
- package/skills/cloudflare-expert/references/static-assets/gotchas.md +44 -0
- package/skills/cloudflare-expert/references/static-assets/patterns.md +42 -0
- package/skills/cloudflare-expert/references/stream/README.md +103 -0
- package/skills/cloudflare-expert/references/stream/api.md +204 -0
- package/skills/cloudflare-expert/references/stream/configuration.md +127 -0
- package/skills/cloudflare-expert/references/stream/gotchas.md +131 -0
- package/skills/cloudflare-expert/references/stream/patterns.md +152 -0
- package/skills/cloudflare-expert/references/tail-workers/README.md +640 -0
- package/skills/cloudflare-expert/references/terraform/README.md +76 -0
- package/skills/cloudflare-expert/references/terraform/api.md +159 -0
- package/skills/cloudflare-expert/references/terraform/configuration.md +156 -0
- package/skills/cloudflare-expert/references/terraform/gotchas.md +207 -0
- package/skills/cloudflare-expert/references/terraform/patterns.md +135 -0
- package/skills/cloudflare-expert/references/tunnel/README.md +82 -0
- package/skills/cloudflare-expert/references/tunnel/api.md +105 -0
- package/skills/cloudflare-expert/references/tunnel/configuration.md +113 -0
- package/skills/cloudflare-expert/references/tunnel/gotchas.md +115 -0
- package/skills/cloudflare-expert/references/tunnel/patterns.md +157 -0
- package/skills/cloudflare-expert/references/turn/README.md +699 -0
- package/skills/cloudflare-expert/references/turnstile/README.md +14 -0
- package/skills/cloudflare-expert/references/turnstile/api.md +3 -0
- package/skills/cloudflare-expert/references/turnstile/configuration.md +19 -0
- package/skills/cloudflare-expert/references/turnstile/gotchas.md +27 -0
- package/skills/cloudflare-expert/references/turnstile/patterns.md +41 -0
- package/skills/cloudflare-expert/references/vectorize/README.md +682 -0
- package/skills/cloudflare-expert/references/waf/README.md +14 -0
- package/skills/cloudflare-expert/references/waf/api.md +3 -0
- package/skills/cloudflare-expert/references/waf/configuration.md +44 -0
- package/skills/cloudflare-expert/references/waf/gotchas.md +24 -0
- package/skills/cloudflare-expert/references/waf/patterns.md +29 -0
- package/skills/cloudflare-expert/references/web-analytics/README.md +19 -0
- package/skills/cloudflare-expert/references/web-analytics/api.md +52 -0
- package/skills/cloudflare-expert/references/web-analytics/configuration.md +31 -0
- package/skills/cloudflare-expert/references/web-analytics/gotchas.md +28 -0
- package/skills/cloudflare-expert/references/web-analytics/patterns.md +52 -0
- package/skills/cloudflare-expert/references/workerd/README.md +47 -0
- package/skills/cloudflare-expert/references/workerd/api.md +199 -0
- package/skills/cloudflare-expert/references/workerd/configuration.md +185 -0
- package/skills/cloudflare-expert/references/workerd/gotchas.md +203 -0
- package/skills/cloudflare-expert/references/workerd/patterns.md +216 -0
- package/skills/cloudflare-expert/references/workers/README.md +96 -0
- package/skills/cloudflare-expert/references/workers/api.md +137 -0
- package/skills/cloudflare-expert/references/workers/configuration.md +147 -0
- package/skills/cloudflare-expert/references/workers/gotchas.md +99 -0
- package/skills/cloudflare-expert/references/workers/patterns.md +149 -0
- package/skills/cloudflare-expert/references/workers-ai/README.md +116 -0
- package/skills/cloudflare-expert/references/workers-for-platforms/README.md +48 -0
- package/skills/cloudflare-expert/references/workers-for-platforms/api.md +169 -0
- package/skills/cloudflare-expert/references/workers-for-platforms/configuration.md +136 -0
- package/skills/cloudflare-expert/references/workers-for-platforms/gotchas.md +130 -0
- package/skills/cloudflare-expert/references/workers-for-platforms/patterns.md +170 -0
- package/skills/cloudflare-expert/references/workers-playground/README.md +16 -0
- package/skills/cloudflare-expert/references/workers-playground/api.md +20 -0
- package/skills/cloudflare-expert/references/workers-playground/configuration.md +3 -0
- package/skills/cloudflare-expert/references/workers-playground/gotchas.md +35 -0
- package/skills/cloudflare-expert/references/workers-playground/patterns.md +42 -0
- package/skills/cloudflare-expert/references/workers-vpc/README.md +579 -0
- package/skills/cloudflare-expert/references/workflows/README.md +62 -0
- package/skills/cloudflare-expert/references/workflows/api.md +125 -0
- package/skills/cloudflare-expert/references/workflows/configuration.md +177 -0
- package/skills/cloudflare-expert/references/workflows/gotchas.md +136 -0
- package/skills/cloudflare-expert/references/workflows/patterns.md +132 -0
- package/skills/cloudflare-expert/references/wrangler/README.md +90 -0
- package/skills/cloudflare-expert/references/wrangler/api.md +140 -0
- package/skills/cloudflare-expert/references/wrangler/configuration.md +128 -0
- package/skills/cloudflare-expert/references/wrangler/gotchas.md +93 -0
- package/skills/cloudflare-expert/references/wrangler/patterns.md +150 -0
- package/skills/cloudflare-expert/references/zaraz/README.md +360 -0
- package/skills/code-documentation/SKILL.md +263 -0
- package/skills/code-documenter/SKILL.md +95 -0
- package/skills/code-documenter/references/api-docs-fastapi-django.md +169 -0
- package/skills/code-documenter/references/api-docs-nestjs-express.md +223 -0
- package/skills/code-documenter/references/coverage-reports.md +128 -0
- package/skills/code-documenter/references/documentation-systems.md +336 -0
- package/skills/code-documenter/references/interactive-api-docs.md +534 -0
- package/skills/code-documenter/references/python-docstrings.md +124 -0
- package/skills/code-documenter/references/typescript-jsdoc.md +148 -0
- package/skills/code-documenter/references/user-guides-tutorials.md +533 -0
- package/skills/code-refactoring/SKILL.md +209 -0
- package/skills/code-review/SKILL.md +121 -0
- package/skills/code-review-checklist/SKILL.md +109 -0
- package/skills/code-reviewer/SKILL.md +209 -0
- package/skills/code-reviewer/references/code_review_checklist.md +103 -0
- package/skills/code-reviewer/references/coding_standards.md +103 -0
- package/skills/code-reviewer/references/common_antipatterns.md +103 -0
- package/skills/code-reviewer/scripts/code_quality_checker.py +114 -0
- package/skills/code-reviewer/scripts/pr_analyzer.py +114 -0
- package/skills/code-reviewer/scripts/review_report_generator.py +114 -0
- package/skills/competitive-ads-extractor/SKILL.md +293 -0
- package/skills/content-research-writer/SKILL.md +538 -0
- package/skills/cosmos-db-python-skill/SKILL.md +198 -0
- package/skills/cosmos-db-python-skill/assets/conftest_template.py +332 -0
- package/skills/cosmos-db-python-skill/assets/cosmos_client_template.py +225 -0
- package/skills/cosmos-db-python-skill/assets/service_template.py +314 -0
- package/skills/cosmos-db-python-skill/references/client-setup.md +214 -0
- package/skills/cosmos-db-python-skill/references/error-handling.md +382 -0
- package/skills/cosmos-db-python-skill/references/partitioning.md +270 -0
- package/skills/cosmos-db-python-skill/references/service-layer.md +305 -0
- package/skills/cosmos-db-python-skill/references/testing.md +495 -0
- package/skills/cpp-pro/SKILL.md +97 -0
- package/skills/cpp-pro/references/build-tooling.md +443 -0
- package/skills/cpp-pro/references/concurrency.md +440 -0
- package/skills/cpp-pro/references/memory-performance.md +400 -0
- package/skills/cpp-pro/references/modern-cpp.md +307 -0
- package/skills/cpp-pro/references/templates.md +360 -0
- package/skills/csharp-developer/SKILL.md +94 -0
- package/skills/csharp-developer/references/aspnet-core.md +397 -0
- package/skills/csharp-developer/references/blazor.md +556 -0
- package/skills/csharp-developer/references/entity-framework.md +412 -0
- package/skills/csharp-developer/references/modern-csharp.md +251 -0
- package/skills/csharp-developer/references/performance.md +501 -0
- package/skills/database-design/SKILL.md +177 -0
- package/skills/database-optimizer/SKILL.md +95 -0
- package/skills/database-optimizer/references/index-strategies.md +334 -0
- package/skills/database-optimizer/references/monitoring-analysis.md +504 -0
- package/skills/database-optimizer/references/mysql-tuning.md +454 -0
- package/skills/database-optimizer/references/postgresql-tuning.md +415 -0
- package/skills/database-optimizer/references/query-optimization.md +254 -0
- package/skills/databases/SKILL.md +232 -0
- package/skills/databases/references/mongodb-aggregation.md +447 -0
- package/skills/databases/references/mongodb-atlas.md +465 -0
- package/skills/databases/references/mongodb-crud.md +408 -0
- package/skills/databases/references/mongodb-indexing.md +442 -0
- package/skills/databases/references/postgresql-administration.md +594 -0
- package/skills/databases/references/postgresql-performance.md +527 -0
- package/skills/databases/references/postgresql-psql-cli.md +467 -0
- package/skills/databases/references/postgresql-queries.md +475 -0
- package/skills/databases/scripts/.coverage +0 -0
- package/skills/databases/scripts/db_backup.py +502 -0
- package/skills/databases/scripts/db_migrate.py +414 -0
- package/skills/databases/scripts/db_performance_check.py +444 -0
- package/skills/databases/scripts/requirements.txt +20 -0
- package/skills/databases/scripts/tests/coverage-db.json +1 -0
- package/skills/databases/scripts/tests/requirements.txt +4 -0
- package/skills/databases/scripts/tests/test_db_backup.py +340 -0
- package/skills/databases/scripts/tests/test_db_migrate.py +277 -0
- package/skills/databases/scripts/tests/test_db_performance_check.py +370 -0
- package/skills/debugging/SKILL.md +84 -0
- package/skills/debugging/references/defense-in-depth.md +124 -0
- package/skills/debugging/references/root-cause-tracing.md +122 -0
- package/skills/debugging/references/systematic-debugging.md +102 -0
- package/skills/debugging/references/verification.md +123 -0
- package/skills/debugging/scripts/find-polluter.sh +63 -0
- package/skills/debugging/scripts/find-polluter.test.md +102 -0
- package/skills/debugging-wizard/SKILL.md +93 -0
- package/skills/debugging-wizard/references/common-patterns.md +135 -0
- package/skills/debugging-wizard/references/debugging-tools.md +143 -0
- package/skills/debugging-wizard/references/quick-fixes.md +180 -0
- package/skills/debugging-wizard/references/strategies.md +145 -0
- package/skills/debugging-wizard/references/systematic-debugging.md +370 -0
- package/skills/deployment-procedures/SKILL.md +241 -0
- package/skills/developer-growth-analysis/SKILL.md +322 -0
- package/skills/devops/.env.example +76 -0
- package/skills/devops/SKILL.md +285 -0
- package/skills/devops/references/browser-rendering.md +305 -0
- package/skills/devops/references/cloudflare-d1-kv.md +123 -0
- package/skills/devops/references/cloudflare-platform.md +288 -0
- package/skills/devops/references/cloudflare-r2-storage.md +280 -0
- package/skills/devops/references/cloudflare-workers-advanced.md +312 -0
- package/skills/devops/references/cloudflare-workers-apis.md +309 -0
- package/skills/devops/references/cloudflare-workers-basics.md +418 -0
- package/skills/devops/references/docker-basics.md +297 -0
- package/skills/devops/references/docker-compose.md +292 -0
- package/skills/devops/references/gcloud-platform.md +297 -0
- package/skills/devops/references/gcloud-services.md +304 -0
- package/skills/devops/scripts/cloudflare_deploy.py +269 -0
- package/skills/devops/scripts/docker_optimize.py +320 -0
- package/skills/devops/scripts/requirements.txt +20 -0
- package/skills/devops/scripts/tests/requirements.txt +3 -0
- package/skills/devops/scripts/tests/test_cloudflare_deploy.py +285 -0
- package/skills/devops/scripts/tests/test_docker_optimize.py +436 -0
- package/skills/devops-engineer/SKILL.md +92 -0
- package/skills/devops-engineer/references/deployment-strategies.md +244 -0
- package/skills/devops-engineer/references/docker-patterns.md +116 -0
- package/skills/devops-engineer/references/github-actions.md +142 -0
- package/skills/devops-engineer/references/incident-response.md +334 -0
- package/skills/devops-engineer/references/kubernetes.md +157 -0
- package/skills/devops-engineer/references/platform-engineering.md +420 -0
- package/skills/devops-engineer/references/release-automation.md +530 -0
- package/skills/devops-engineer/references/terraform-iac.md +144 -0
- package/skills/django-expert/SKILL.md +89 -0
- package/skills/django-expert/references/authentication.md +148 -0
- package/skills/django-expert/references/drf-serializers.md +151 -0
- package/skills/django-expert/references/models-orm.md +154 -0
- package/skills/django-expert/references/testing-django.md +207 -0
- package/skills/django-expert/references/viewsets-views.md +156 -0
- package/skills/doc-coauthoring/SKILL.md +375 -0
- package/skills/docker-expert/SKILL.md +409 -0
- package/skills/docs-seeker/.env.example +15 -0
- package/skills/docs-seeker/SKILL.md +102 -0
- package/skills/docs-seeker/package.json +24 -0
- package/skills/docs-seeker/references/advanced.md +79 -0
- package/skills/docs-seeker/references/context7-patterns.md +68 -0
- package/skills/docs-seeker/references/errors.md +68 -0
- package/skills/docs-seeker/scripts/analyze-llms-txt.js +211 -0
- package/skills/docs-seeker/scripts/detect-topic.js +172 -0
- package/skills/docs-seeker/scripts/fetch-docs.js +213 -0
- package/skills/docs-seeker/scripts/tests/run-tests.js +72 -0
- package/skills/docs-seeker/scripts/tests/test-analyze-llms.js +119 -0
- package/skills/docs-seeker/scripts/tests/test-detect-topic.js +112 -0
- package/skills/docs-seeker/scripts/tests/test-fetch-docs.js +84 -0
- package/skills/docs-seeker/scripts/utils/env-loader.js +94 -0
- package/skills/docs-seeker/workflows/library-search.md +87 -0
- package/skills/docs-seeker/workflows/repo-analysis.md +91 -0
- package/skills/docs-seeker/workflows/topic-search.md +77 -0
- package/skills/document-skills/docx/LICENSE.txt +30 -0
- package/skills/document-skills/docx/SKILL.md +197 -0
- package/skills/document-skills/docx/docx-js.md +350 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
- package/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
- package/skills/document-skills/docx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
- package/skills/document-skills/docx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
- package/skills/document-skills/docx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
- package/skills/document-skills/docx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
- package/skills/document-skills/docx/ooxml/schemas/mce/mc.xsd +75 -0
- package/skills/document-skills/docx/ooxml/schemas/microsoft/wml-2010.xsd +560 -0
- package/skills/document-skills/docx/ooxml/schemas/microsoft/wml-2012.xsd +67 -0
- package/skills/document-skills/docx/ooxml/schemas/microsoft/wml-2018.xsd +14 -0
- package/skills/document-skills/docx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -0
- package/skills/document-skills/docx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -0
- package/skills/document-skills/docx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
- package/skills/document-skills/docx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -0
- package/skills/document-skills/docx/ooxml/scripts/pack.py +159 -0
- package/skills/document-skills/docx/ooxml/scripts/unpack.py +29 -0
- package/skills/document-skills/docx/ooxml/scripts/validate.py +69 -0
- package/skills/document-skills/docx/ooxml/scripts/validation/__init__.py +15 -0
- package/skills/document-skills/docx/ooxml/scripts/validation/base.py +951 -0
- package/skills/document-skills/docx/ooxml/scripts/validation/docx.py +274 -0
- package/skills/document-skills/docx/ooxml/scripts/validation/pptx.py +315 -0
- package/skills/document-skills/docx/ooxml/scripts/validation/redlining.py +279 -0
- package/skills/document-skills/docx/ooxml.md +610 -0
- package/skills/document-skills/docx/scripts/__init__.py +1 -0
- package/skills/document-skills/docx/scripts/document.py +1276 -0
- package/skills/document-skills/docx/scripts/templates/comments.xml +3 -0
- package/skills/document-skills/docx/scripts/templates/commentsExtended.xml +3 -0
- package/skills/document-skills/docx/scripts/templates/commentsExtensible.xml +3 -0
- package/skills/document-skills/docx/scripts/templates/commentsIds.xml +3 -0
- package/skills/document-skills/docx/scripts/templates/people.xml +3 -0
- package/skills/document-skills/docx/scripts/utilities.py +374 -0
- package/skills/document-skills/pdf/LICENSE.txt +30 -0
- package/skills/document-skills/pdf/SKILL.md +294 -0
- package/skills/document-skills/pdf/forms.md +205 -0
- package/skills/document-skills/pdf/reference.md +612 -0
- package/skills/document-skills/pdf/scripts/check_bounding_boxes.py +70 -0
- package/skills/document-skills/pdf/scripts/check_bounding_boxes_test.py +226 -0
- package/skills/document-skills/pdf/scripts/check_fillable_fields.py +12 -0
- package/skills/document-skills/pdf/scripts/convert_pdf_to_images.py +35 -0
- package/skills/document-skills/pdf/scripts/create_validation_image.py +41 -0
- package/skills/document-skills/pdf/scripts/extract_form_field_info.py +152 -0
- package/skills/document-skills/pdf/scripts/fill_fillable_fields.py +114 -0
- package/skills/document-skills/pdf/scripts/fill_pdf_form_with_annotations.py +108 -0
- package/skills/document-skills/pptx/LICENSE.txt +30 -0
- package/skills/document-skills/pptx/SKILL.md +484 -0
- package/skills/document-skills/pptx/html2pptx.md +625 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
- package/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
- package/skills/document-skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
- package/skills/document-skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
- package/skills/document-skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
- package/skills/document-skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
- package/skills/document-skills/pptx/ooxml/schemas/mce/mc.xsd +75 -0
- package/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-2010.xsd +560 -0
- package/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-2012.xsd +67 -0
- package/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-2018.xsd +14 -0
- package/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -0
- package/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -0
- package/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
- package/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -0
- package/skills/document-skills/pptx/ooxml/scripts/pack.py +159 -0
- package/skills/document-skills/pptx/ooxml/scripts/unpack.py +29 -0
- package/skills/document-skills/pptx/ooxml/scripts/validate.py +69 -0
- package/skills/document-skills/pptx/ooxml/scripts/validation/__init__.py +15 -0
- package/skills/document-skills/pptx/ooxml/scripts/validation/base.py +951 -0
- package/skills/document-skills/pptx/ooxml/scripts/validation/docx.py +274 -0
- package/skills/document-skills/pptx/ooxml/scripts/validation/pptx.py +315 -0
- package/skills/document-skills/pptx/ooxml/scripts/validation/redlining.py +279 -0
- package/skills/document-skills/pptx/ooxml.md +427 -0
- package/skills/document-skills/pptx/scripts/html2pptx.js +979 -0
- package/skills/document-skills/pptx/scripts/inventory.py +1020 -0
- package/skills/document-skills/pptx/scripts/rearrange.py +231 -0
- package/skills/document-skills/pptx/scripts/replace.py +385 -0
- package/skills/document-skills/pptx/scripts/thumbnail.py +450 -0
- package/skills/document-skills/xlsx/LICENSE.txt +30 -0
- package/skills/document-skills/xlsx/SKILL.md +289 -0
- package/skills/document-skills/xlsx/recalc.py +178 -0
- package/skills/documentation-templates/SKILL.md +194 -0
- package/skills/docx/SKILL.md +94 -0
- package/skills/domain-name-brainstormer/SKILL.md +212 -0
- package/skills/dotnet-core-expert/SKILL.md +96 -0
- package/skills/dotnet-core-expert/references/authentication.md +549 -0
- package/skills/dotnet-core-expert/references/clean-architecture.md +458 -0
- package/skills/dotnet-core-expert/references/cloud-native.md +551 -0
- package/skills/dotnet-core-expert/references/entity-framework.md +443 -0
- package/skills/dotnet-core-expert/references/minimal-apis.md +322 -0
- package/skills/embedded-systems/SKILL.md +98 -0
- package/skills/embedded-systems/references/communication-protocols.md +414 -0
- package/skills/embedded-systems/references/memory-optimization.md +470 -0
- package/skills/embedded-systems/references/microcontroller-programming.md +397 -0
- package/skills/embedded-systems/references/power-optimization.md +444 -0
- package/skills/embedded-systems/references/rtos-patterns.md +316 -0
- package/skills/expo-app-design/SKILL.md +22 -0
- package/skills/expo-deployment/SKILL.md +22 -0
- package/skills/fastapi-expert/SKILL.md +93 -0
- package/skills/fastapi-expert/references/async-sqlalchemy.md +150 -0
- package/skills/fastapi-expert/references/authentication.md +162 -0
- package/skills/fastapi-expert/references/endpoints-routing.md +145 -0
- package/skills/fastapi-expert/references/migration-from-django.md +1000 -0
- package/skills/fastapi-expert/references/pydantic-v2.md +138 -0
- package/skills/fastapi-expert/references/testing-async.md +162 -0
- package/skills/fastapi-router/SKILL.md +52 -0
- package/skills/fastapi-router/assets/template.py +142 -0
- package/skills/feature-forge/SKILL.md +90 -0
- package/skills/feature-forge/references/acceptance-criteria.md +107 -0
- package/skills/feature-forge/references/ears-syntax.md +102 -0
- package/skills/feature-forge/references/interview-questions.md +96 -0
- package/skills/feature-forge/references/specification-template.md +106 -0
- package/skills/file-organizer/SKILL.md +433 -0
- package/skills/fine-tuning-expert/SKILL.md +98 -0
- package/skills/fine-tuning-expert/references/dataset-preparation.md +543 -0
- package/skills/fine-tuning-expert/references/deployment-optimization.md +676 -0
- package/skills/fine-tuning-expert/references/evaluation-metrics.md +600 -0
- package/skills/fine-tuning-expert/references/hyperparameter-tuning.md +569 -0
- package/skills/fine-tuning-expert/references/lora-peft.md +350 -0
- package/skills/flutter-expert/SKILL.md +88 -0
- package/skills/flutter-expert/references/gorouter-navigation.md +122 -0
- package/skills/flutter-expert/references/performance.md +102 -0
- package/skills/flutter-expert/references/project-structure.md +121 -0
- package/skills/flutter-expert/references/riverpod-state.md +133 -0
- package/skills/flutter-expert/references/widget-patterns.md +126 -0
- package/skills/foundry-iq-agent/references/knowledge-sources.md +262 -0
- package/skills/foundry-iq-agent/scripts/create_agent.py +287 -0
- package/skills/foundry-iq-python/SKILL.md +278 -0
- package/skills/foundry-iq-python/references/knowledge-sources.md +262 -0
- package/skills/foundry-iq-python/references/patterns.md +295 -0
- package/skills/foundry-iq-python/scripts/create_agent.py +287 -0
- package/skills/foundry-nextgen-frontend/SKILL.md +555 -0
- package/skills/foundry-nextgen-frontend/assets/foundry-logo-dark.png +0 -0
- package/skills/foundry-nextgen-frontend/assets/foundry-logo-light.png +0 -0
- package/skills/foundry-nextgen-frontend/references/components.md +566 -0
- package/skills/foundry-nextgen-frontend/references/design-tokens.md +172 -0
- package/skills/foundry-nextgen-frontend/references/patterns.md +406 -0
- package/skills/foundry-nextgen-frontend/write_files.py +1993 -0
- package/skills/foundry-sdk-python/SKILL.md +290 -0
- package/skills/foundry-sdk-python/references/agents.md +295 -0
- package/skills/foundry-sdk-python/references/async-patterns.md +258 -0
- package/skills/foundry-sdk-python/references/connections.md +203 -0
- package/skills/foundry-sdk-python/references/datasets-indexes.md +177 -0
- package/skills/foundry-sdk-python/references/deployments.md +134 -0
- package/skills/foundry-sdk-python/references/evaluation.md +309 -0
- package/skills/foundry-sdk-python/references/tools.md +464 -0
- package/skills/frontend-design/SKILL.md +39 -0
- package/skills/frontend-development/SKILL.md +399 -0
- package/skills/frontend-development/resources/common-patterns.md +331 -0
- package/skills/frontend-development/resources/complete-examples.md +872 -0
- package/skills/frontend-development/resources/component-patterns.md +502 -0
- package/skills/frontend-development/resources/data-fetching.md +767 -0
- package/skills/frontend-development/resources/file-organization.md +502 -0
- package/skills/frontend-development/resources/loading-and-error-states.md +501 -0
- package/skills/frontend-development/resources/performance.md +406 -0
- package/skills/frontend-development/resources/routing-guide.md +364 -0
- package/skills/frontend-development/resources/styling-guide.md +428 -0
- package/skills/frontend-development/resources/typescript-standards.md +418 -0
- package/skills/fullstack-guardian/SKILL.md +99 -0
- package/skills/fullstack-guardian/references/api-design-standards.md +310 -0
- package/skills/fullstack-guardian/references/architecture-decisions.md +353 -0
- package/skills/fullstack-guardian/references/backend-patterns.md +240 -0
- package/skills/fullstack-guardian/references/common-patterns.md +137 -0
- package/skills/fullstack-guardian/references/deliverables-checklist.md +357 -0
- package/skills/fullstack-guardian/references/design-template.md +94 -0
- package/skills/fullstack-guardian/references/error-handling.md +138 -0
- package/skills/fullstack-guardian/references/frontend-patterns.md +343 -0
- package/skills/fullstack-guardian/references/integration-patterns.md +336 -0
- package/skills/fullstack-guardian/references/security-checklist.md +109 -0
- package/skills/game-developer/SKILL.md +94 -0
- package/skills/game-developer/references/ecs-patterns.md +504 -0
- package/skills/game-developer/references/multiplayer-networking.md +478 -0
- package/skills/game-developer/references/performance-optimization.md +425 -0
- package/skills/game-developer/references/unity-patterns.md +274 -0
- package/skills/game-developer/references/unreal-cpp.md +355 -0
- package/skills/game-development/2d-games/SKILL.md +119 -0
- package/skills/game-development/3d-games/SKILL.md +135 -0
- package/skills/game-development/SKILL.md +167 -0
- package/skills/game-development/game-art/SKILL.md +185 -0
- package/skills/game-development/game-audio/SKILL.md +190 -0
- package/skills/game-development/game-design/SKILL.md +129 -0
- package/skills/game-development/mobile-games/SKILL.md +108 -0
- package/skills/game-development/multiplayer/SKILL.md +132 -0
- package/skills/game-development/pc-games/SKILL.md +144 -0
- package/skills/game-development/vr-ar/SKILL.md +123 -0
- package/skills/game-development/web-games/SKILL.md +150 -0
- package/skills/geo-fundamentals/SKILL.md +156 -0
- package/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
- package/skills/golang-pro/SKILL.md +94 -0
- package/skills/golang-pro/references/concurrency.md +332 -0
- package/skills/golang-pro/references/generics.md +445 -0
- package/skills/golang-pro/references/interfaces.md +435 -0
- package/skills/golang-pro/references/project-structure.md +480 -0
- package/skills/golang-pro/references/testing.md +454 -0
- package/skills/graphql-architect/SKILL.md +97 -0
- package/skills/graphql-architect/references/federation.md +421 -0
- package/skills/graphql-architect/references/migration-from-rest.md +1144 -0
- package/skills/graphql-architect/references/resolvers.md +428 -0
- package/skills/graphql-architect/references/schema-design.md +396 -0
- package/skills/graphql-architect/references/security.md +572 -0
- package/skills/graphql-architect/references/subscriptions.md +513 -0
- package/skills/i18n-localization/SKILL.md +154 -0
- package/skills/i18n-localization/scripts/i18n_checker.py +241 -0
- package/skills/image-enhancer/SKILL.md +99 -0
- package/skills/internal-comms/LICENSE.txt +202 -0
- package/skills/internal-comms/SKILL.md +32 -0
- package/skills/internal-comms/examples/3p-updates.md +47 -0
- package/skills/internal-comms/examples/company-newsletter.md +65 -0
- package/skills/internal-comms/examples/faq-answers.md +30 -0
- package/skills/internal-comms/examples/general-comms.md +16 -0
- package/skills/invoice-organizer/SKILL.md +446 -0
- package/skills/issue-creator/SKILL.md +137 -0
- package/skills/java-architect/SKILL.md +95 -0
- package/skills/java-architect/references/jpa-optimization.md +396 -0
- package/skills/java-architect/references/reactive-webflux.md +359 -0
- package/skills/java-architect/references/spring-boot-setup.md +272 -0
- package/skills/java-architect/references/spring-security.md +448 -0
- package/skills/java-architect/references/testing-patterns.md +503 -0
- package/skills/javascript-pro/SKILL.md +95 -0
- package/skills/javascript-pro/references/async-patterns.md +337 -0
- package/skills/javascript-pro/references/browser-apis.md +401 -0
- package/skills/javascript-pro/references/modern-syntax.md +275 -0
- package/skills/javascript-pro/references/modules.md +360 -0
- package/skills/javascript-pro/references/node-essentials.md +474 -0
- package/skills/javascript-typescript/SKILL.md +142 -0
- package/skills/jira-issues/SKILL.md +181 -0
- package/skills/job-application/SKILL.md +90 -0
- package/skills/kotlin-specialist/SKILL.md +94 -0
- package/skills/kotlin-specialist/references/android-compose.md +422 -0
- package/skills/kotlin-specialist/references/coroutines-flow.md +279 -0
- package/skills/kotlin-specialist/references/dsl-idioms.md +424 -0
- package/skills/kotlin-specialist/references/ktor-server.md +429 -0
- package/skills/kotlin-specialist/references/multiplatform-kmp.md +383 -0
- package/skills/kubernetes-specialist/SKILL.md +117 -0
- package/skills/kubernetes-specialist/references/configuration.md +455 -0
- package/skills/kubernetes-specialist/references/cost-optimization.md +461 -0
- package/skills/kubernetes-specialist/references/custom-operators.md +566 -0
- package/skills/kubernetes-specialist/references/gitops.md +533 -0
- package/skills/kubernetes-specialist/references/helm-charts.md +915 -0
- package/skills/kubernetes-specialist/references/multi-cluster.md +510 -0
- package/skills/kubernetes-specialist/references/networking.md +450 -0
- package/skills/kubernetes-specialist/references/service-mesh.md +462 -0
- package/skills/kubernetes-specialist/references/storage.md +538 -0
- package/skills/kubernetes-specialist/references/troubleshooting.md +417 -0
- package/skills/kubernetes-specialist/references/workloads.md +380 -0
- package/skills/laravel-specialist/SKILL.md +101 -0
- package/skills/laravel-specialist/references/eloquent.md +354 -0
- package/skills/laravel-specialist/references/livewire.md +515 -0
- package/skills/laravel-specialist/references/queues.md +426 -0
- package/skills/laravel-specialist/references/routing.md +365 -0
- package/skills/laravel-specialist/references/testing.md +525 -0
- package/skills/lead-research-assistant/SKILL.md +199 -0
- package/skills/legacy-modernizer/SKILL.md +93 -0
- package/skills/legacy-modernizer/references/legacy-testing.md +384 -0
- package/skills/legacy-modernizer/references/migration-strategies.md +426 -0
- package/skills/legacy-modernizer/references/refactoring-patterns.md +398 -0
- package/skills/legacy-modernizer/references/strangler-fig-pattern.md +284 -0
- package/skills/legacy-modernizer/references/system-assessment.md +490 -0
- package/skills/lint-and-validate/SKILL.md +45 -0
- package/skills/lint-and-validate/scripts/lint_runner.py +172 -0
- package/skills/lint-and-validate/scripts/type_coverage.py +173 -0
- package/skills/llm-application-dev/SKILL.md +216 -0
- package/skills/mcp-builder/LICENSE.txt +202 -0
- package/skills/mcp-builder/SKILL.md +328 -0
- package/skills/mcp-builder/reference/evaluation.md +602 -0
- package/skills/mcp-builder/reference/mcp_best_practices.md +915 -0
- package/skills/mcp-builder/reference/node_mcp_server.md +916 -0
- package/skills/mcp-builder/reference/python_mcp_server.md +752 -0
- package/skills/mcp-builder/scripts/connections.py +151 -0
- package/skills/mcp-builder/scripts/evaluation.py +373 -0
- package/skills/mcp-builder/scripts/example_evaluation.xml +22 -0
- package/skills/mcp-builder/scripts/requirements.txt +2 -0
- package/skills/mcp-developer/SKILL.md +94 -0
- package/skills/mcp-developer/references/protocol.md +247 -0
- package/skills/mcp-developer/references/python-sdk.md +370 -0
- package/skills/mcp-developer/references/resources.md +557 -0
- package/skills/mcp-developer/references/tools.md +483 -0
- package/skills/mcp-developer/references/typescript-sdk.md +353 -0
- package/skills/media-processing/SKILL.md +358 -0
- package/skills/media-processing/references/ffmpeg-encoding.md +358 -0
- package/skills/media-processing/references/ffmpeg-filters.md +503 -0
- package/skills/media-processing/references/ffmpeg-streaming.md +403 -0
- package/skills/media-processing/references/format-compatibility.md +375 -0
- package/skills/media-processing/references/imagemagick-batch.md +612 -0
- package/skills/media-processing/references/imagemagick-editing.md +623 -0
- package/skills/media-processing/scripts/batch_resize.py +342 -0
- package/skills/media-processing/scripts/media_convert.py +311 -0
- package/skills/media-processing/scripts/requirements.txt +24 -0
- package/skills/media-processing/scripts/tests/.coverage +0 -0
- package/skills/media-processing/scripts/tests/requirements.txt +2 -0
- package/skills/media-processing/scripts/tests/test_batch_resize.py +372 -0
- package/skills/media-processing/scripts/tests/test_media_convert.py +259 -0
- package/skills/media-processing/scripts/tests/test_video_optimize.py +397 -0
- package/skills/media-processing/scripts/video_optimize.py +414 -0
- package/skills/meeting-insights-analyzer/SKILL.md +327 -0
- package/skills/microservices-architect/SKILL.md +102 -0
- package/skills/microservices-architect/references/communication.md +499 -0
- package/skills/microservices-architect/references/data.md +721 -0
- package/skills/microservices-architect/references/decomposition.md +344 -0
- package/skills/microservices-architect/references/observability.md +805 -0
- package/skills/microservices-architect/references/patterns.md +603 -0
- package/skills/ml-pipeline/SKILL.md +111 -0
- package/skills/ml-pipeline/references/experiment-tracking.md +843 -0
- package/skills/ml-pipeline/references/feature-engineering.md +639 -0
- package/skills/ml-pipeline/references/model-validation.md +989 -0
- package/skills/ml-pipeline/references/pipeline-orchestration.md +938 -0
- package/skills/ml-pipeline/references/training-pipelines.md +793 -0
- package/skills/mobile-design/SKILL.md +394 -0
- package/skills/mobile-design/decision-trees.md +516 -0
- package/skills/mobile-design/mobile-backend.md +491 -0
- package/skills/mobile-design/mobile-color-system.md +420 -0
- package/skills/mobile-design/mobile-debugging.md +122 -0
- package/skills/mobile-design/mobile-design-thinking.md +357 -0
- package/skills/mobile-design/mobile-navigation.md +458 -0
- package/skills/mobile-design/mobile-performance.md +767 -0
- package/skills/mobile-design/mobile-testing.md +356 -0
- package/skills/mobile-design/mobile-typography.md +433 -0
- package/skills/mobile-design/platform-android.md +666 -0
- package/skills/mobile-design/platform-ios.md +561 -0
- package/skills/mobile-design/scripts/mobile_audit.py +670 -0
- package/skills/mobile-design/touch-psychology.md +537 -0
- package/skills/mobile-development/SKILL.md +212 -0
- package/skills/mobile-development/references/mobile-android.md +604 -0
- package/skills/mobile-development/references/mobile-best-practices.md +545 -0
- package/skills/mobile-development/references/mobile-debugging.md +1089 -0
- package/skills/mobile-development/references/mobile-frameworks.md +465 -0
- package/skills/mobile-development/references/mobile-ios.md +496 -0
- package/skills/mobile-development/references/mobile-mindset.md +544 -0
- package/skills/monitoring-expert/SKILL.md +92 -0
- package/skills/monitoring-expert/references/alerting-rules.md +144 -0
- package/skills/monitoring-expert/references/application-profiling.md +334 -0
- package/skills/monitoring-expert/references/capacity-planning.md +347 -0
- package/skills/monitoring-expert/references/dashboards.md +129 -0
- package/skills/monitoring-expert/references/opentelemetry.md +126 -0
- package/skills/monitoring-expert/references/performance-testing.md +272 -0
- package/skills/monitoring-expert/references/prometheus-metrics.md +139 -0
- package/skills/monitoring-expert/references/structured-logging.md +145 -0
- package/skills/nestjs-expert/SKILL.md +552 -0
- package/skills/nextjs-best-practices/SKILL.md +203 -0
- package/skills/nextjs-developer/SKILL.md +97 -0
- package/skills/nextjs-developer/references/app-router.md +314 -0
- package/skills/nextjs-developer/references/data-fetching.md +485 -0
- package/skills/nextjs-developer/references/deployment.md +548 -0
- package/skills/nextjs-developer/references/server-actions.md +465 -0
- package/skills/nextjs-developer/references/server-components.md +387 -0
- package/skills/nodejs-best-practices/SKILL.md +333 -0
- package/skills/notebooklm-skill/AUTHENTICATION.md +154 -0
- package/skills/notebooklm-skill/SKILL.md +269 -0
- package/skills/notebooklm-skill/references/api_reference.md +309 -0
- package/skills/notebooklm-skill/references/troubleshooting.md +376 -0
- package/skills/notebooklm-skill/references/usage_patterns.md +338 -0
- package/skills/notebooklm-skill/scripts/__init__.py +81 -0
- package/skills/notebooklm-skill/scripts/ask_question.py +256 -0
- package/skills/notebooklm-skill/scripts/auth_manager.py +358 -0
- package/skills/notebooklm-skill/scripts/browser_session.py +255 -0
- package/skills/notebooklm-skill/scripts/browser_utils.py +107 -0
- package/skills/notebooklm-skill/scripts/cleanup_manager.py +302 -0
- package/skills/notebooklm-skill/scripts/config.py +44 -0
- package/skills/notebooklm-skill/scripts/notebook_manager.py +410 -0
- package/skills/notebooklm-skill/scripts/run.py +102 -0
- package/skills/notebooklm-skill/scripts/setup_environment.py +204 -0
- package/skills/pandas-pro/SKILL.md +96 -0
- package/skills/pandas-pro/references/aggregation-groupby.md +548 -0
- package/skills/pandas-pro/references/data-cleaning.md +503 -0
- package/skills/pandas-pro/references/dataframe-operations.md +423 -0
- package/skills/pandas-pro/references/merging-joining.md +599 -0
- package/skills/pandas-pro/references/performance-optimization.md +600 -0
- package/skills/parallel-agents/SKILL.md +175 -0
- package/skills/pdf/SKILL.md +104 -0
- package/skills/performance-profiling/SKILL.md +143 -0
- package/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
- package/skills/php-pro/SKILL.md +95 -0
- package/skills/php-pro/references/async-patterns.md +415 -0
- package/skills/php-pro/references/laravel-patterns.md +380 -0
- package/skills/php-pro/references/modern-php-features.md +326 -0
- package/skills/php-pro/references/symfony-patterns.md +474 -0
- package/skills/php-pro/references/testing-quality.md +469 -0
- package/skills/plan-writing/SKILL.md +152 -0
- package/skills/planning/SKILL.md +95 -0
- package/skills/planning/references/codebase-understanding.md +61 -0
- package/skills/planning/references/output-standards.md +87 -0
- package/skills/planning/references/plan-organization.md +115 -0
- package/skills/planning/references/research-phase.md +49 -0
- package/skills/planning/references/solution-design.md +63 -0
- package/skills/playwright-expert/SKILL.md +87 -0
- package/skills/playwright-expert/references/api-mocking.md +143 -0
- package/skills/playwright-expert/references/configuration.md +158 -0
- package/skills/playwright-expert/references/debugging-flaky.md +153 -0
- package/skills/playwright-expert/references/page-object-model.md +155 -0
- package/skills/playwright-expert/references/selectors-locators.md +122 -0
- package/skills/playwright-skill/API_REFERENCE.md +653 -0
- package/skills/playwright-skill/SKILL.md +453 -0
- package/skills/playwright-skill/lib/helpers.js +441 -0
- package/skills/playwright-skill/package.json +26 -0
- package/skills/playwright-skill/run.js +228 -0
- package/skills/podcast-generation/SKILL.md +123 -0
- package/skills/podcast-generation/references/architecture.md +87 -0
- package/skills/podcast-generation/references/code-examples.md +189 -0
- package/skills/podcast-generation/scripts/pcm_to_wav.py +73 -0
- package/skills/postgres-pro/SKILL.md +98 -0
- package/skills/postgres-pro/references/extensions.md +407 -0
- package/skills/postgres-pro/references/jsonb.md +324 -0
- package/skills/postgres-pro/references/maintenance.md +484 -0
- package/skills/postgres-pro/references/performance.md +268 -0
- package/skills/postgres-pro/references/replication.md +449 -0
- package/skills/powershell-windows/SKILL.md +167 -0
- package/skills/pptx/SKILL.md +114 -0
- package/skills/prisma-expert/SKILL.md +355 -0
- package/skills/problem-solving/SKILL.md +96 -0
- package/skills/problem-solving/references/attribution.md +69 -0
- package/skills/problem-solving/references/collision-zone-thinking.md +79 -0
- package/skills/problem-solving/references/inversion-exercise.md +91 -0
- package/skills/problem-solving/references/meta-pattern-recognition.md +87 -0
- package/skills/problem-solving/references/scale-game.md +95 -0
- package/skills/problem-solving/references/simplification-cascades.md +80 -0
- package/skills/problem-solving/references/when-stuck.md +72 -0
- package/skills/product-manager-toolkit/SKILL.md +351 -0
- package/skills/product-manager-toolkit/references/prd_templates.md +317 -0
- package/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py +441 -0
- package/skills/product-manager-toolkit/scripts/rice_prioritizer.py +296 -0
- package/skills/product-strategist/SKILL.md +26 -0
- package/skills/product-strategist/scripts/okr_cascade_generator.py +478 -0
- package/skills/prompt-engineer/SKILL.md +99 -0
- package/skills/prompt-engineer/references/evaluation-frameworks.md +781 -0
- package/skills/prompt-engineer/references/prompt-optimization.md +563 -0
- package/skills/prompt-engineer/references/prompt-patterns.md +509 -0
- package/skills/prompt-engineer/references/structured-outputs.md +723 -0
- package/skills/prompt-engineer/references/system-prompts.md +547 -0
- package/skills/pydantic-models/SKILL.md +58 -0
- package/skills/pydantic-models/assets/template.py +124 -0
- package/skills/python-development/SKILL.md +139 -0
- package/skills/python-patterns/SKILL.md +441 -0
- package/skills/python-pro/SKILL.md +92 -0
- package/skills/python-pro/references/async-patterns.md +359 -0
- package/skills/python-pro/references/packaging.md +463 -0
- package/skills/python-pro/references/standard-library.md +381 -0
- package/skills/python-pro/references/testing.md +407 -0
- package/skills/python-pro/references/type-system.md +293 -0
- package/skills/qa-regression/SKILL.md +337 -0
- package/skills/raffle-winner-picker/SKILL.md +159 -0
- package/skills/rag-architect/SKILL.md +100 -0
- package/skills/rag-architect/references/chunking-strategies.md +881 -0
- package/skills/rag-architect/references/embedding-models.md +564 -0
- package/skills/rag-architect/references/rag-evaluation.md +836 -0
- package/skills/rag-architect/references/retrieval-optimization.md +798 -0
- package/skills/rag-architect/references/vector-databases.md +592 -0
- package/skills/rails-expert/SKILL.md +97 -0
- package/skills/rails-expert/references/active-record.md +247 -0
- package/skills/rails-expert/references/api-development.md +404 -0
- package/skills/rails-expert/references/background-jobs.md +275 -0
- package/skills/rails-expert/references/hotwire-turbo.md +231 -0
- package/skills/rails-expert/references/rspec-testing.md +370 -0
- package/skills/react-best-practices/AGENTS.md +2934 -0
- package/skills/react-best-practices/README.md +123 -0
- package/skills/react-best-practices/SKILL.md +136 -0
- package/skills/react-best-practices/metadata.json +15 -0
- package/skills/react-best-practices/rules/_sections.md +46 -0
- package/skills/react-best-practices/rules/_template.md +28 -0
- package/skills/react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- package/skills/react-best-practices/rules/advanced-init-once.md +42 -0
- package/skills/react-best-practices/rules/advanced-use-latest.md +39 -0
- package/skills/react-best-practices/rules/async-api-routes.md +38 -0
- package/skills/react-best-practices/rules/async-defer-await.md +80 -0
- package/skills/react-best-practices/rules/async-dependencies.md +51 -0
- package/skills/react-best-practices/rules/async-parallel.md +28 -0
- package/skills/react-best-practices/rules/async-suspense-boundaries.md +99 -0
- package/skills/react-best-practices/rules/bundle-barrel-imports.md +59 -0
- package/skills/react-best-practices/rules/bundle-conditional.md +31 -0
- package/skills/react-best-practices/rules/bundle-defer-third-party.md +49 -0
- package/skills/react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- package/skills/react-best-practices/rules/bundle-preload.md +50 -0
- package/skills/react-best-practices/rules/client-event-listeners.md +74 -0
- package/skills/react-best-practices/rules/client-localstorage-schema.md +71 -0
- package/skills/react-best-practices/rules/client-passive-event-listeners.md +48 -0
- package/skills/react-best-practices/rules/client-swr-dedup.md +56 -0
- package/skills/react-best-practices/rules/js-batch-dom-css.md +107 -0
- package/skills/react-best-practices/rules/js-cache-function-results.md +80 -0
- package/skills/react-best-practices/rules/js-cache-property-access.md +28 -0
- package/skills/react-best-practices/rules/js-cache-storage.md +70 -0
- package/skills/react-best-practices/rules/js-combine-iterations.md +32 -0
- package/skills/react-best-practices/rules/js-early-exit.md +50 -0
- package/skills/react-best-practices/rules/js-hoist-regexp.md +45 -0
- package/skills/react-best-practices/rules/js-index-maps.md +37 -0
- package/skills/react-best-practices/rules/js-length-check-first.md +49 -0
- package/skills/react-best-practices/rules/js-min-max-loop.md +82 -0
- package/skills/react-best-practices/rules/js-set-map-lookups.md +24 -0
- package/skills/react-best-practices/rules/js-tosorted-immutable.md +57 -0
- package/skills/react-best-practices/rules/rendering-activity.md +26 -0
- package/skills/react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- package/skills/react-best-practices/rules/rendering-conditional-render.md +40 -0
- package/skills/react-best-practices/rules/rendering-content-visibility.md +38 -0
- package/skills/react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- package/skills/react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- package/skills/react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
- package/skills/react-best-practices/rules/rendering-svg-precision.md +28 -0
- package/skills/react-best-practices/rules/rendering-usetransition-loading.md +75 -0
- package/skills/react-best-practices/rules/rerender-defer-reads.md +39 -0
- package/skills/react-best-practices/rules/rerender-dependencies.md +45 -0
- package/skills/react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
- package/skills/react-best-practices/rules/rerender-derived-state.md +29 -0
- package/skills/react-best-practices/rules/rerender-functional-setstate.md +74 -0
- package/skills/react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- package/skills/react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
- package/skills/react-best-practices/rules/rerender-memo.md +44 -0
- package/skills/react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
- package/skills/react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
- package/skills/react-best-practices/rules/rerender-transitions.md +40 -0
- package/skills/react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
- package/skills/react-best-practices/rules/server-after-nonblocking.md +73 -0
- package/skills/react-best-practices/rules/server-auth-actions.md +96 -0
- package/skills/react-best-practices/rules/server-cache-lru.md +41 -0
- package/skills/react-best-practices/rules/server-cache-react.md +76 -0
- package/skills/react-best-practices/rules/server-dedup-props.md +65 -0
- package/skills/react-best-practices/rules/server-parallel-fetching.md +83 -0
- package/skills/react-best-practices/rules/server-serialization.md +38 -0
- package/skills/react-expert/SKILL.md +98 -0
- package/skills/react-expert/references/hooks-patterns.md +165 -0
- package/skills/react-expert/references/migration-class-to-modern.md +1122 -0
- package/skills/react-expert/references/performance.md +171 -0
- package/skills/react-expert/references/react-19-features.md +177 -0
- package/skills/react-expert/references/server-components.md +146 -0
- package/skills/react-expert/references/state-management.md +174 -0
- package/skills/react-expert/references/testing-react.md +177 -0
- package/skills/react-flow-node/SKILL.md +66 -0
- package/skills/react-flow-node/assets/template.tsx +108 -0
- package/skills/react-flow-node/assets/types.template.ts +34 -0
- package/skills/react-native-expert/SKILL.md +88 -0
- package/skills/react-native-expert/references/expo-router.md +190 -0
- package/skills/react-native-expert/references/list-optimization.md +207 -0
- package/skills/react-native-expert/references/platform-handling.md +191 -0
- package/skills/react-native-expert/references/project-structure.md +174 -0
- package/skills/react-native-expert/references/storage-hooks.md +176 -0
- package/skills/react-patterns/SKILL.md +198 -0
- package/skills/receiving-code-review/SKILL.md +213 -0
- package/skills/red-team-tactics/SKILL.md +199 -0
- package/skills/repomix/SKILL.md +275 -0
- package/skills/repomix/references/configuration.md +211 -0
- package/skills/repomix/references/usage-patterns.md +291 -0
- package/skills/repomix/scripts/.coverage +0 -0
- package/skills/repomix/scripts/README.md +179 -0
- package/skills/repomix/scripts/repomix_batch.py +455 -0
- package/skills/repomix/scripts/repos.example.json +15 -0
- package/skills/repomix/scripts/requirements.txt +15 -0
- package/skills/repomix/scripts/tests/test_repomix_batch.py +531 -0
- package/skills/requesting-code-review/SKILL.md +105 -0
- package/skills/requesting-code-review/code-reviewer.md +146 -0
- package/skills/research/SKILL.md +191 -0
- package/skills/rust-engineer/SKILL.md +96 -0
- package/skills/rust-engineer/references/async.md +461 -0
- package/skills/rust-engineer/references/error-handling.md +337 -0
- package/skills/rust-engineer/references/ownership.md +281 -0
- package/skills/rust-engineer/references/testing.md +473 -0
- package/skills/rust-engineer/references/traits.md +416 -0
- package/skills/salesforce-developer/SKILL.md +105 -0
- package/skills/salesforce-developer/references/apex-development.md +789 -0
- package/skills/salesforce-developer/references/deployment-devops.md +863 -0
- package/skills/salesforce-developer/references/integration-patterns.md +951 -0
- package/skills/salesforce-developer/references/lightning-web-components.md +908 -0
- package/skills/salesforce-developer/references/soql-sosl.md +683 -0
- package/skills/secure-code-guardian/SKILL.md +93 -0
- package/skills/secure-code-guardian/references/authentication.md +139 -0
- package/skills/secure-code-guardian/references/input-validation.md +149 -0
- package/skills/secure-code-guardian/references/owasp-prevention.md +138 -0
- package/skills/secure-code-guardian/references/security-headers.md +136 -0
- package/skills/secure-code-guardian/references/xss-csrf.md +160 -0
- package/skills/security-reviewer/SKILL.md +94 -0
- package/skills/security-reviewer/references/infrastructure-security.md +271 -0
- package/skills/security-reviewer/references/penetration-testing.md +271 -0
- package/skills/security-reviewer/references/report-template.md +173 -0
- package/skills/security-reviewer/references/sast-tools.md +120 -0
- package/skills/security-reviewer/references/secret-scanning.md +128 -0
- package/skills/security-reviewer/references/vulnerability-patterns.md +155 -0
- package/skills/senior-architect/SKILL.md +209 -0
- package/skills/senior-architect/references/architecture_patterns.md +103 -0
- package/skills/senior-architect/references/system_design_workflows.md +103 -0
- package/skills/senior-architect/references/tech_decision_guide.md +103 -0
- package/skills/senior-architect/scripts/architecture_diagram_generator.py +114 -0
- package/skills/senior-architect/scripts/dependency_analyzer.py +114 -0
- package/skills/senior-architect/scripts/project_architect.py +114 -0
- package/skills/senior-backend/SKILL.md +209 -0
- package/skills/senior-backend/references/api_design_patterns.md +103 -0
- package/skills/senior-backend/references/backend_security_practices.md +103 -0
- package/skills/senior-backend/references/database_optimization_guide.md +103 -0
- package/skills/senior-backend/scripts/api_load_tester.py +114 -0
- package/skills/senior-backend/scripts/api_scaffolder.py +114 -0
- package/skills/senior-backend/scripts/database_migration_tool.py +114 -0
- package/skills/senior-computer-vision/SKILL.md +226 -0
- package/skills/senior-computer-vision/references/computer_vision_architectures.md +80 -0
- package/skills/senior-computer-vision/references/object_detection_optimization.md +80 -0
- package/skills/senior-computer-vision/references/production_vision_systems.md +80 -0
- package/skills/senior-computer-vision/scripts/dataset_pipeline_builder.py +100 -0
- package/skills/senior-computer-vision/scripts/inference_optimizer.py +100 -0
- package/skills/senior-computer-vision/scripts/vision_model_trainer.py +100 -0
- package/skills/senior-data-engineer/SKILL.md +226 -0
- package/skills/senior-data-engineer/references/data_modeling_patterns.md +80 -0
- package/skills/senior-data-engineer/references/data_pipeline_architecture.md +80 -0
- package/skills/senior-data-engineer/references/dataops_best_practices.md +80 -0
- package/skills/senior-data-engineer/scripts/data_quality_validator.py +100 -0
- package/skills/senior-data-engineer/scripts/etl_performance_optimizer.py +100 -0
- package/skills/senior-data-engineer/scripts/pipeline_orchestrator.py +100 -0
- package/skills/senior-data-scientist/SKILL.md +226 -0
- package/skills/senior-data-scientist/references/experiment_design_frameworks.md +80 -0
- package/skills/senior-data-scientist/references/feature_engineering_patterns.md +80 -0
- package/skills/senior-data-scientist/references/statistical_methods_advanced.md +80 -0
- package/skills/senior-data-scientist/scripts/experiment_designer.py +100 -0
- package/skills/senior-data-scientist/scripts/feature_engineering_pipeline.py +100 -0
- package/skills/senior-data-scientist/scripts/model_evaluation_suite.py +100 -0
- package/skills/senior-devops/SKILL.md +209 -0
- package/skills/senior-devops/references/cicd_pipeline_guide.md +103 -0
- package/skills/senior-devops/references/deployment_strategies.md +103 -0
- package/skills/senior-devops/references/infrastructure_as_code.md +103 -0
- package/skills/senior-devops/scripts/deployment_manager.py +114 -0
- package/skills/senior-devops/scripts/pipeline_generator.py +114 -0
- package/skills/senior-devops/scripts/terraform_scaffolder.py +114 -0
- package/skills/senior-frontend/SKILL.md +209 -0
- package/skills/senior-frontend/references/frontend_best_practices.md +103 -0
- package/skills/senior-frontend/references/nextjs_optimization_guide.md +103 -0
- package/skills/senior-frontend/references/react_patterns.md +103 -0
- package/skills/senior-frontend/scripts/bundle_analyzer.py +114 -0
- package/skills/senior-frontend/scripts/component_generator.py +114 -0
- package/skills/senior-frontend/scripts/frontend_scaffolder.py +114 -0
- package/skills/senior-fullstack/SKILL.md +209 -0
- package/skills/senior-fullstack/references/architecture_patterns.md +103 -0
- package/skills/senior-fullstack/references/development_workflows.md +103 -0
- package/skills/senior-fullstack/references/tech_stack_guide.md +103 -0
- package/skills/senior-fullstack/scripts/code_quality_analyzer.py +114 -0
- package/skills/senior-fullstack/scripts/fullstack_scaffolder.py +114 -0
- package/skills/senior-fullstack/scripts/project_scaffolder.py +114 -0
- package/skills/senior-ml-engineer/SKILL.md +226 -0
- package/skills/senior-ml-engineer/references/llm_integration_guide.md +80 -0
- package/skills/senior-ml-engineer/references/mlops_production_patterns.md +80 -0
- package/skills/senior-ml-engineer/references/rag_system_architecture.md +80 -0
- package/skills/senior-ml-engineer/scripts/ml_monitoring_suite.py +100 -0
- package/skills/senior-ml-engineer/scripts/model_deployment_pipeline.py +100 -0
- package/skills/senior-ml-engineer/scripts/rag_system_builder.py +100 -0
- package/skills/senior-prompt-engineer/SKILL.md +226 -0
- package/skills/senior-prompt-engineer/references/agentic_system_design.md +80 -0
- package/skills/senior-prompt-engineer/references/llm_evaluation_frameworks.md +80 -0
- package/skills/senior-prompt-engineer/references/prompt_engineering_patterns.md +80 -0
- package/skills/senior-prompt-engineer/scripts/agent_orchestrator.py +100 -0
- package/skills/senior-prompt-engineer/scripts/prompt_optimizer.py +100 -0
- package/skills/senior-prompt-engineer/scripts/rag_evaluator.py +100 -0
- package/skills/senior-qa/SKILL.md +209 -0
- package/skills/senior-qa/references/qa_best_practices.md +103 -0
- package/skills/senior-qa/references/test_automation_patterns.md +103 -0
- package/skills/senior-qa/references/testing_strategies.md +103 -0
- package/skills/senior-qa/scripts/coverage_analyzer.py +114 -0
- package/skills/senior-qa/scripts/e2e_test_scaffolder.py +114 -0
- package/skills/senior-qa/scripts/test_suite_generator.py +114 -0
- package/skills/senior-secops/SKILL.md +209 -0
- package/skills/senior-secops/references/compliance_requirements.md +103 -0
- package/skills/senior-secops/references/security_standards.md +103 -0
- package/skills/senior-secops/references/vulnerability_management_guide.md +103 -0
- package/skills/senior-secops/scripts/compliance_checker.py +114 -0
- package/skills/senior-secops/scripts/security_scanner.py +114 -0
- package/skills/senior-secops/scripts/vulnerability_assessor.py +114 -0
- package/skills/senior-security/SKILL.md +209 -0
- package/skills/senior-security/references/cryptography_implementation.md +103 -0
- package/skills/senior-security/references/penetration_testing_guide.md +103 -0
- package/skills/senior-security/references/security_architecture_patterns.md +103 -0
- package/skills/senior-security/scripts/pentest_automator.py +114 -0
- package/skills/senior-security/scripts/security_auditor.py +114 -0
- package/skills/senior-security/scripts/threat_modeler.py +114 -0
- package/skills/seo-fundamentals/SKILL.md +129 -0
- package/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
- package/skills/sequential-thinking/.env.example +8 -0
- package/skills/sequential-thinking/README.md +189 -0
- package/skills/sequential-thinking/SKILL.md +94 -0
- package/skills/sequential-thinking/package.json +30 -0
- package/skills/sequential-thinking/references/advanced-strategies.md +79 -0
- package/skills/sequential-thinking/references/advanced-techniques.md +76 -0
- package/skills/sequential-thinking/references/core-patterns.md +95 -0
- package/skills/sequential-thinking/references/examples-api.md +88 -0
- package/skills/sequential-thinking/references/examples-architecture.md +94 -0
- package/skills/sequential-thinking/references/examples-debug.md +90 -0
- package/skills/sequential-thinking/scripts/format-thought.js +159 -0
- package/skills/sequential-thinking/scripts/process-thought.js +236 -0
- package/skills/sequential-thinking/tests/format-thought.test.js +133 -0
- package/skills/sequential-thinking/tests/process-thought.test.js +215 -0
- package/skills/server-management/SKILL.md +161 -0
- package/skills/shopify-expert/SKILL.md +102 -0
- package/skills/shopify-expert/references/app-development.md +897 -0
- package/skills/shopify-expert/references/checkout-customization.md +877 -0
- package/skills/shopify-expert/references/liquid-templating.md +693 -0
- package/skills/shopify-expert/references/performance-optimization.md +725 -0
- package/skills/shopify-expert/references/storefront-api.md +939 -0
- package/skills/skill-creator/LICENSE.txt +202 -0
- package/skills/skill-creator/SKILL.md +209 -0
- package/skills/skill-creator/scripts/init_skill.py +303 -0
- package/skills/skill-creator/scripts/package_skill.py +110 -0
- package/skills/skill-creator/scripts/quick_validate.py +65 -0
- package/skills/skill-share/SKILL.md +80 -0
- package/skills/slack-gif-creator/LICENSE.txt +202 -0
- package/skills/slack-gif-creator/SKILL.md +646 -0
- package/skills/slack-gif-creator/core/color_palettes.py +302 -0
- package/skills/slack-gif-creator/core/easing.py +230 -0
- package/skills/slack-gif-creator/core/frame_composer.py +469 -0
- package/skills/slack-gif-creator/core/gif_builder.py +246 -0
- package/skills/slack-gif-creator/core/typography.py +357 -0
- package/skills/slack-gif-creator/core/validators.py +264 -0
- package/skills/slack-gif-creator/core/visual_effects.py +494 -0
- package/skills/slack-gif-creator/requirements.txt +4 -0
- package/skills/slack-gif-creator/templates/bounce.py +106 -0
- package/skills/slack-gif-creator/templates/explode.py +331 -0
- package/skills/slack-gif-creator/templates/fade.py +329 -0
- package/skills/slack-gif-creator/templates/flip.py +291 -0
- package/skills/slack-gif-creator/templates/kaleidoscope.py +211 -0
- package/skills/slack-gif-creator/templates/morph.py +329 -0
- package/skills/slack-gif-creator/templates/move.py +293 -0
- package/skills/slack-gif-creator/templates/pulse.py +268 -0
- package/skills/slack-gif-creator/templates/shake.py +127 -0
- package/skills/slack-gif-creator/templates/slide.py +291 -0
- package/skills/slack-gif-creator/templates/spin.py +269 -0
- package/skills/slack-gif-creator/templates/wiggle.py +300 -0
- package/skills/slack-gif-creator/templates/zoom.py +312 -0
- package/skills/spark-engineer/SKILL.md +100 -0
- package/skills/spark-engineer/references/partitioning-caching.md +546 -0
- package/skills/spark-engineer/references/performance-tuning.md +547 -0
- package/skills/spark-engineer/references/rdd-operations.md +602 -0
- package/skills/spark-engineer/references/spark-sql-dataframes.md +477 -0
- package/skills/spark-engineer/references/streaming-patterns.md +789 -0
- package/skills/spec-miner/SKILL.md +88 -0
- package/skills/spec-miner/references/analysis-checklist.md +68 -0
- package/skills/spec-miner/references/analysis-process.md +73 -0
- package/skills/spec-miner/references/ears-format.md +89 -0
- package/skills/spec-miner/references/specification-template.md +103 -0
- package/skills/spring-boot-engineer/SKILL.md +104 -0
- package/skills/spring-boot-engineer/references/cloud.md +501 -0
- package/skills/spring-boot-engineer/references/data.md +384 -0
- package/skills/spring-boot-engineer/references/security.md +462 -0
- package/skills/spring-boot-engineer/references/testing.md +548 -0
- package/skills/spring-boot-engineer/references/web.md +298 -0
- package/skills/sql-pro/SKILL.md +97 -0
- package/skills/sql-pro/references/database-design.md +405 -0
- package/skills/sql-pro/references/dialect-differences.md +422 -0
- package/skills/sql-pro/references/optimization.md +387 -0
- package/skills/sql-pro/references/query-patterns.md +288 -0
- package/skills/sql-pro/references/window-functions.md +331 -0
- package/skills/sre-engineer/SKILL.md +98 -0
- package/skills/sre-engineer/references/automation-toil.md +495 -0
- package/skills/sre-engineer/references/error-budget-policy.md +337 -0
- package/skills/sre-engineer/references/incident-chaos.md +578 -0
- package/skills/sre-engineer/references/monitoring-alerting.md +427 -0
- package/skills/sre-engineer/references/slo-sli-management.md +241 -0
- package/skills/swift-expert/SKILL.md +94 -0
- package/skills/swift-expert/references/async-concurrency.md +363 -0
- package/skills/swift-expert/references/memory-performance.md +380 -0
- package/skills/swift-expert/references/protocol-oriented.md +357 -0
- package/skills/swift-expert/references/swiftui-patterns.md +294 -0
- package/skills/swift-expert/references/testing-patterns.md +402 -0
- package/skills/systematic-debugging/SKILL.md +109 -0
- package/skills/tailwind-patterns/SKILL.md +269 -0
- package/skills/tdd-workflow/SKILL.md +149 -0
- package/skills/template-skill/SKILL.md +6 -0
- package/skills/terraform-engineer/SKILL.md +97 -0
- package/skills/terraform-engineer/references/best-practices.md +586 -0
- package/skills/terraform-engineer/references/module-patterns.md +300 -0
- package/skills/terraform-engineer/references/providers.md +455 -0
- package/skills/terraform-engineer/references/state-management.md +374 -0
- package/skills/terraform-engineer/references/testing.md +489 -0
- package/skills/test-master/SKILL.md +104 -0
- package/skills/test-master/references/automation-frameworks.md +297 -0
- package/skills/test-master/references/e2e-testing.md +131 -0
- package/skills/test-master/references/integration-testing.md +123 -0
- package/skills/test-master/references/performance-testing.md +121 -0
- package/skills/test-master/references/qa-methodology.md +250 -0
- package/skills/test-master/references/security-testing.md +130 -0
- package/skills/test-master/references/tdd-iron-laws.md +177 -0
- package/skills/test-master/references/test-reports.md +107 -0
- package/skills/test-master/references/testing-anti-patterns.md +234 -0
- package/skills/test-master/references/unit-testing.md +116 -0
- package/skills/testing-patterns/SKILL.md +178 -0
- package/skills/testing-patterns/scripts/test_runner.py +219 -0
- package/skills/theme-factory/LICENSE.txt +202 -0
- package/skills/theme-factory/SKILL.md +59 -0
- package/skills/theme-factory/theme-showcase.pdf +0 -0
- package/skills/theme-factory/themes/arctic-frost.md +19 -0
- package/skills/theme-factory/themes/botanical-garden.md +19 -0
- package/skills/theme-factory/themes/desert-rose.md +19 -0
- package/skills/theme-factory/themes/forest-canopy.md +19 -0
- package/skills/theme-factory/themes/golden-hour.md +19 -0
- package/skills/theme-factory/themes/midnight-galaxy.md +19 -0
- package/skills/theme-factory/themes/modern-minimalist.md +19 -0
- package/skills/theme-factory/themes/ocean-depths.md +19 -0
- package/skills/theme-factory/themes/sunset-boulevard.md +19 -0
- package/skills/theme-factory/themes/tech-innovation.md +19 -0
- package/skills/threejs/SKILL.md +89 -0
- package/skills/threejs/references/01-getting-started.md +177 -0
- package/skills/threejs/references/02-loaders.md +169 -0
- package/skills/threejs/references/03-textures.md +170 -0
- package/skills/threejs/references/04-cameras.md +195 -0
- package/skills/threejs/references/05-lights.md +183 -0
- package/skills/threejs/references/06-animations.md +214 -0
- package/skills/threejs/references/07-math.md +260 -0
- package/skills/threejs/references/08-interaction.md +267 -0
- package/skills/threejs/references/09-postprocessing.md +240 -0
- package/skills/threejs/references/10-controls.md +259 -0
- package/skills/threejs/references/11-materials-advanced.md +270 -0
- package/skills/threejs/references/12-performance.md +269 -0
- package/skills/threejs/references/13-node-materials.md +298 -0
- package/skills/threejs/references/14-physics-vr.md +304 -0
- package/skills/threejs/references/15-specialized-loaders.md +333 -0
- package/skills/threejs/references/16-webgpu.md +302 -0
- package/skills/typescript-expert/SKILL.md +429 -0
- package/skills/typescript-expert/references/tsconfig-strict.json +92 -0
- package/skills/typescript-expert/references/typescript-cheatsheet.md +383 -0
- package/skills/typescript-expert/references/utility-types.ts +335 -0
- package/skills/typescript-expert/scripts/ts_diagnostic.py +203 -0
- package/skills/typescript-pro/SKILL.md +94 -0
- package/skills/typescript-pro/references/advanced-types.md +262 -0
- package/skills/typescript-pro/references/configuration.md +448 -0
- package/skills/typescript-pro/references/patterns.md +487 -0
- package/skills/typescript-pro/references/type-guards.md +355 -0
- package/skills/typescript-pro/references/utility-types.md +332 -0
- package/skills/ui-design-system/SKILL.md +32 -0
- package/skills/ui-design-system/scripts/design_token_generator.py +529 -0
- package/skills/ui-styling/LICENSE.txt +202 -0
- package/skills/ui-styling/SKILL.md +321 -0
- package/skills/ui-styling/canvas-fonts/ArsenalSC-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/ArsenalSC-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/BigShoulders-Bold.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/BigShoulders-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/BigShoulders-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Boldonse-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/Boldonse-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/BricolageGrotesque-Bold.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/BricolageGrotesque-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/BricolageGrotesque-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/CrimsonPro-Bold.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/CrimsonPro-Italic.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/CrimsonPro-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/CrimsonPro-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/DMMono-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/DMMono-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/EricaOne-OFL.txt +94 -0
- package/skills/ui-styling/canvas-fonts/EricaOne-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/GeistMono-Bold.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/GeistMono-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/GeistMono-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Gloock-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/Gloock-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/IBMPlexMono-Bold.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/IBMPlexMono-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/IBMPlexMono-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/IBMPlexSerif-Bold.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/IBMPlexSerif-BoldItalic.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/IBMPlexSerif-Italic.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/IBMPlexSerif-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/InstrumentSans-Bold.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/InstrumentSans-BoldItalic.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/InstrumentSans-Italic.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/InstrumentSans-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/InstrumentSans-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/InstrumentSerif-Italic.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/InstrumentSerif-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Italiana-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/Italiana-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/JetBrainsMono-Bold.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/JetBrainsMono-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/JetBrainsMono-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Jura-Light.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Jura-Medium.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Jura-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/LibreBaskerville-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/LibreBaskerville-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Lora-Bold.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Lora-BoldItalic.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Lora-Italic.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Lora-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/Lora-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/NationalPark-Bold.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/NationalPark-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/NationalPark-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/NothingYouCouldDo-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Outfit-Bold.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Outfit-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/Outfit-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/PixelifySans-Medium.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/PixelifySans-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/PoiretOne-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/PoiretOne-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/RedHatMono-Bold.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/RedHatMono-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/RedHatMono-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Silkscreen-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/Silkscreen-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/SmoochSans-Medium.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/SmoochSans-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/Tektur-Medium.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/Tektur-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/Tektur-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/WorkSans-Bold.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/WorkSans-BoldItalic.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/WorkSans-Italic.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/WorkSans-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/WorkSans-Regular.ttf +0 -0
- package/skills/ui-styling/canvas-fonts/YoungSerif-OFL.txt +93 -0
- package/skills/ui-styling/canvas-fonts/YoungSerif-Regular.ttf +0 -0
- package/skills/ui-styling/references/canvas-design-system.md +320 -0
- package/skills/ui-styling/references/shadcn-accessibility.md +471 -0
- package/skills/ui-styling/references/shadcn-components.md +424 -0
- package/skills/ui-styling/references/shadcn-theming.md +373 -0
- package/skills/ui-styling/references/tailwind-customization.md +483 -0
- package/skills/ui-styling/references/tailwind-responsive.md +382 -0
- package/skills/ui-styling/references/tailwind-utilities.md +455 -0
- package/skills/ui-styling/scripts/.coverage +0 -0
- package/skills/ui-styling/scripts/requirements.txt +17 -0
- package/skills/ui-styling/scripts/shadcn_add.py +292 -0
- package/skills/ui-styling/scripts/tailwind_config_gen.py +456 -0
- package/skills/ui-styling/scripts/tests/coverage-ui.json +1 -0
- package/skills/ui-styling/scripts/tests/requirements.txt +3 -0
- package/skills/ui-styling/scripts/tests/test_shadcn_add.py +266 -0
- package/skills/ui-styling/scripts/tests/test_tailwind_config_gen.py +336 -0
- package/skills/ui-ux-pro-max/SKILL.md +365 -0
- package/skills/ui-ux-pro-max/data/charts.csv +26 -0
- package/skills/ui-ux-pro-max/data/colors.csv +97 -0
- package/skills/ui-ux-pro-max/data/icons.csv +101 -0
- package/skills/ui-ux-pro-max/data/landing.csv +31 -0
- package/skills/ui-ux-pro-max/data/products.csv +97 -0
- package/skills/ui-ux-pro-max/data/prompts.csv +24 -0
- package/skills/ui-ux-pro-max/data/react-performance.csv +45 -0
- package/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
- package/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
- package/skills/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
- package/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
- package/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
- package/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
- package/skills/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
- package/skills/ui-ux-pro-max/data/stacks/react.csv +54 -0
- package/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
- package/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
- package/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
- package/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -0
- package/skills/ui-ux-pro-max/data/styles.csv +59 -0
- package/skills/ui-ux-pro-max/data/typography.csv +58 -0
- package/skills/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
- package/skills/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
- package/skills/ui-ux-pro-max/data/web-interface.csv +31 -0
- package/skills/ui-ux-pro-max/scripts/core.py +258 -0
- package/skills/ui-ux-pro-max/scripts/design_system.py +487 -0
- package/skills/ui-ux-pro-max/scripts/search.py +76 -0
- package/skills/upgrading-expo/SKILL.md +22 -0
- package/skills/using-git-worktrees/SKILL.md +217 -0
- package/skills/ux-researcher-designer/SKILL.md +30 -0
- package/skills/ux-researcher-designer/scripts/persona_generator.py +508 -0
- package/skills/vercel-deploy/SKILL.md +22 -0
- package/skills/video-downloader/SKILL.md +106 -0
- package/skills/vue-expert/SKILL.md +374 -0
- package/skills/vue-expert/references/component-template.vue +232 -0
- package/skills/vue-expert/references/composables-template.ts +247 -0
- package/skills/vue-expert/references/composition-api-cheatsheet.md +281 -0
- package/skills/vue-expert/references/pinia-store-template.ts +141 -0
- package/skills/vue-expert/scripts/vue_diagnostic.py +144 -0
- package/skills/vue-expert-js/SKILL.md +91 -0
- package/skills/vue-expert-js/references/jsdoc-typing.md +538 -0
- package/skills/vulnerability-scanner/SKILL.md +276 -0
- package/skills/vulnerability-scanner/checklists.md +121 -0
- package/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
- package/skills/web-artifacts-builder/LICENSE.txt +202 -0
- package/skills/web-artifacts-builder/SKILL.md +74 -0
- package/skills/web-artifacts-builder/scripts/bundle-artifact.sh +54 -0
- package/skills/web-artifacts-builder/scripts/init-artifact.sh +322 -0
- package/skills/web-artifacts-builder/scripts/shadcn-components.tar.gz +0 -0
- package/skills/web-design-guidelines/SKILL.md +39 -0
- package/skills/web-frameworks/SKILL.md +324 -0
- package/skills/web-frameworks/references/nextjs-app-router.md +465 -0
- package/skills/web-frameworks/references/nextjs-data-fetching.md +459 -0
- package/skills/web-frameworks/references/nextjs-optimization.md +511 -0
- package/skills/web-frameworks/references/nextjs-server-components.md +495 -0
- package/skills/web-frameworks/references/remix-icon-integration.md +603 -0
- package/skills/web-frameworks/references/turborepo-caching.md +551 -0
- package/skills/web-frameworks/references/turborepo-pipelines.md +517 -0
- package/skills/web-frameworks/references/turborepo-setup.md +542 -0
- package/skills/web-frameworks/scripts/.coverage +0 -0
- package/skills/web-frameworks/scripts/__init__.py +0 -0
- package/skills/web-frameworks/scripts/nextjs_init.py +547 -0
- package/skills/web-frameworks/scripts/requirements.txt +16 -0
- package/skills/web-frameworks/scripts/tests/coverage-web.json +1 -0
- package/skills/web-frameworks/scripts/tests/requirements.txt +3 -0
- package/skills/web-frameworks/scripts/tests/test_nextjs_init.py +319 -0
- package/skills/web-frameworks/scripts/tests/test_turborepo_migrate.py +374 -0
- package/skills/web-frameworks/scripts/turborepo_migrate.py +394 -0
- package/skills/webapp-testing/LICENSE.txt +202 -0
- package/skills/webapp-testing/SKILL.md +96 -0
- package/skills/webapp-testing/examples/console_logging.py +35 -0
- package/skills/webapp-testing/examples/element_discovery.py +40 -0
- package/skills/webapp-testing/examples/static_html_automation.py +33 -0
- package/skills/webapp-testing/scripts/with_server.py +106 -0
- package/skills/websocket-engineer/SKILL.md +96 -0
- package/skills/websocket-engineer/references/alternatives.md +391 -0
- package/skills/websocket-engineer/references/patterns.md +400 -0
- package/skills/websocket-engineer/references/protocol.md +195 -0
- package/skills/websocket-engineer/references/scaling.md +333 -0
- package/skills/websocket-engineer/references/security.md +474 -0
- package/skills/wordpress-pro/SKILL.md +105 -0
- package/skills/wordpress-pro/references/gutenberg-blocks.md +873 -0
- package/skills/wordpress-pro/references/hooks-filters.md +848 -0
- package/skills/wordpress-pro/references/performance-security.md +1015 -0
- package/skills/wordpress-pro/references/plugin-architecture.md +1044 -0
- package/skills/wordpress-pro/references/theme-development.md +861 -0
- package/skills/writing-plans/SKILL.md +116 -0
- package/skills/writing-skills/SKILL.md +655 -0
- package/skills/writing-skills/anthropic-best-practices.md +1150 -0
- package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
- package/skills/writing-skills/graphviz-conventions.dot +172 -0
- package/skills/writing-skills/persuasion-principles.md +187 -0
- package/skills/writing-skills/render-graphs.js +168 -0
- package/skills/writing-skills/testing-skills-with-subagents.md +384 -0
- package/skills/xlsx/SKILL.md +100 -0
- package/skills/youtube-transcript/SKILL.md +415 -0
- package/skills/zustand-store/SKILL.md +68 -0
- package/skills/zustand-store/assets/template.ts +117 -0
|
@@ -0,0 +1,836 @@
|
|
|
1
|
+
# RAG Evaluation
|
|
2
|
+
|
|
3
|
+
> Reference for: RAG Architect
|
|
4
|
+
> Load when: Measuring retrieval quality, evaluation frameworks, debugging RAG pipelines, RAGAS, TruLens
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Evaluation Framework Overview
|
|
9
|
+
|
|
10
|
+
| Framework | Focus | Strengths | Use Case |
|
|
11
|
+
|-----------|-------|-----------|----------|
|
|
12
|
+
| **RAGAS** | RAG-specific metrics | Faithfulness, relevance | Production RAG evaluation |
|
|
13
|
+
| **TruLens** | LLM app observability | Tracing, feedback functions | Debugging and monitoring |
|
|
14
|
+
| **LangSmith** | LangChain ecosystem | Traces, datasets, testing | LangChain projects |
|
|
15
|
+
| **Custom** | Specific requirements | Full control | Domain-specific needs |
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Core Metrics
|
|
20
|
+
|
|
21
|
+
### Retrieval Metrics
|
|
22
|
+
|
|
23
|
+
| Metric | Formula | What It Measures |
|
|
24
|
+
|--------|---------|------------------|
|
|
25
|
+
| **Precision@k** | Relevant in top-k / k | Are retrieved docs relevant? |
|
|
26
|
+
| **Recall@k** | Relevant in top-k / Total relevant | Did we get all relevant docs? |
|
|
27
|
+
| **MRR** | 1 / Rank of first relevant | How quickly do we find relevant? |
|
|
28
|
+
| **NDCG@k** | DCG@k / IDCG@k | Is ranking order correct? |
|
|
29
|
+
| **Hit Rate** | Queries with relevant in top-k / Total queries | Binary success rate |
|
|
30
|
+
|
|
31
|
+
### Generation Metrics
|
|
32
|
+
|
|
33
|
+
| Metric | What It Measures |
|
|
34
|
+
|--------|------------------|
|
|
35
|
+
| **Faithfulness** | Is answer grounded in retrieved context? |
|
|
36
|
+
| **Answer Relevance** | Does answer address the question? |
|
|
37
|
+
| **Context Relevance** | Is retrieved context relevant to question? |
|
|
38
|
+
| **Context Utilization** | How much context was actually used? |
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
## Implementing Core Metrics
|
|
43
|
+
|
|
44
|
+
### Precision, Recall, and Hit Rate
|
|
45
|
+
|
|
46
|
+
```python
|
|
47
|
+
from dataclasses import dataclass
|
|
48
|
+
from typing import Set
|
|
49
|
+
|
|
50
|
+
@dataclass
|
|
51
|
+
class RetrievalMetrics:
|
|
52
|
+
precision_at_k: float
|
|
53
|
+
recall_at_k: float
|
|
54
|
+
hit_rate: float
|
|
55
|
+
mrr: float
|
|
56
|
+
|
|
57
|
+
def calculate_retrieval_metrics(
|
|
58
|
+
retrieved_ids: list[str],
|
|
59
|
+
relevant_ids: set[str],
|
|
60
|
+
k: int
|
|
61
|
+
) -> RetrievalMetrics:
|
|
62
|
+
"""Calculate core retrieval metrics."""
|
|
63
|
+
top_k = retrieved_ids[:k]
|
|
64
|
+
top_k_set = set(top_k)
|
|
65
|
+
|
|
66
|
+
# Precision@k: relevant in top-k / k
|
|
67
|
+
relevant_in_top_k = len(top_k_set & relevant_ids)
|
|
68
|
+
precision = relevant_in_top_k / k if k > 0 else 0
|
|
69
|
+
|
|
70
|
+
# Recall@k: relevant in top-k / total relevant
|
|
71
|
+
recall = relevant_in_top_k / len(relevant_ids) if relevant_ids else 0
|
|
72
|
+
|
|
73
|
+
# Hit Rate: 1 if any relevant in top-k, else 0
|
|
74
|
+
hit_rate = 1.0 if relevant_in_top_k > 0 else 0.0
|
|
75
|
+
|
|
76
|
+
# MRR: 1 / rank of first relevant result
|
|
77
|
+
mrr = 0.0
|
|
78
|
+
for i, doc_id in enumerate(top_k, 1):
|
|
79
|
+
if doc_id in relevant_ids:
|
|
80
|
+
mrr = 1.0 / i
|
|
81
|
+
break
|
|
82
|
+
|
|
83
|
+
return RetrievalMetrics(
|
|
84
|
+
precision_at_k=precision,
|
|
85
|
+
recall_at_k=recall,
|
|
86
|
+
hit_rate=hit_rate,
|
|
87
|
+
mrr=mrr
|
|
88
|
+
)
|
|
89
|
+
|
|
90
|
+
# Usage
|
|
91
|
+
retrieved = ["doc1", "doc2", "doc3", "doc4", "doc5"]
|
|
92
|
+
relevant = {"doc2", "doc5", "doc7"} # Ground truth
|
|
93
|
+
|
|
94
|
+
metrics = calculate_retrieval_metrics(retrieved, relevant, k=5)
|
|
95
|
+
print(f"Precision@5: {metrics.precision_at_k:.2f}") # 2/5 = 0.40
|
|
96
|
+
print(f"Recall@5: {metrics.recall_at_k:.2f}") # 2/3 = 0.67
|
|
97
|
+
print(f"MRR: {metrics.mrr:.2f}") # 1/2 = 0.50
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### NDCG (Normalized Discounted Cumulative Gain)
|
|
101
|
+
|
|
102
|
+
```python
|
|
103
|
+
import numpy as np
|
|
104
|
+
|
|
105
|
+
def dcg_at_k(relevance_scores: list[float], k: int) -> float:
|
|
106
|
+
"""Calculate Discounted Cumulative Gain."""
|
|
107
|
+
relevance_scores = np.array(relevance_scores[:k])
|
|
108
|
+
if len(relevance_scores) == 0:
|
|
109
|
+
return 0.0
|
|
110
|
+
|
|
111
|
+
# DCG = sum(rel_i / log2(i + 1)) for i in 1..k
|
|
112
|
+
discounts = np.log2(np.arange(2, len(relevance_scores) + 2))
|
|
113
|
+
return np.sum(relevance_scores / discounts)
|
|
114
|
+
|
|
115
|
+
def ndcg_at_k(
|
|
116
|
+
retrieved_ids: list[str],
|
|
117
|
+
relevance_scores: dict[str, float],
|
|
118
|
+
k: int
|
|
119
|
+
) -> float:
|
|
120
|
+
"""
|
|
121
|
+
Calculate NDCG@k.
|
|
122
|
+
relevance_scores: dict mapping doc_id to relevance (e.g., 0, 1, 2, 3)
|
|
123
|
+
"""
|
|
124
|
+
# Get relevance scores for retrieved docs
|
|
125
|
+
retrieved_relevance = [
|
|
126
|
+
relevance_scores.get(doc_id, 0)
|
|
127
|
+
for doc_id in retrieved_ids[:k]
|
|
128
|
+
]
|
|
129
|
+
|
|
130
|
+
# Calculate DCG for retrieved order
|
|
131
|
+
dcg = dcg_at_k(retrieved_relevance, k)
|
|
132
|
+
|
|
133
|
+
# Calculate ideal DCG (perfect ranking)
|
|
134
|
+
ideal_relevance = sorted(relevance_scores.values(), reverse=True)[:k]
|
|
135
|
+
idcg = dcg_at_k(ideal_relevance, k)
|
|
136
|
+
|
|
137
|
+
return dcg / idcg if idcg > 0 else 0.0
|
|
138
|
+
|
|
139
|
+
# Usage with graded relevance
|
|
140
|
+
retrieved = ["doc1", "doc2", "doc3", "doc4", "doc5"]
|
|
141
|
+
relevance = {
|
|
142
|
+
"doc1": 0, # Not relevant
|
|
143
|
+
"doc2": 3, # Highly relevant
|
|
144
|
+
"doc3": 1, # Somewhat relevant
|
|
145
|
+
"doc5": 2, # Relevant
|
|
146
|
+
"doc7": 3, # Highly relevant (not retrieved)
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
ndcg = ndcg_at_k(retrieved, relevance, k=5)
|
|
150
|
+
print(f"NDCG@5: {ndcg:.3f}")
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
---
|
|
154
|
+
|
|
155
|
+
## RAGAS Framework
|
|
156
|
+
|
|
157
|
+
### Installation and Setup
|
|
158
|
+
|
|
159
|
+
```python
|
|
160
|
+
# pip install ragas
|
|
161
|
+
|
|
162
|
+
from ragas import evaluate
|
|
163
|
+
from ragas.metrics import (
|
|
164
|
+
faithfulness,
|
|
165
|
+
answer_relevancy,
|
|
166
|
+
context_precision,
|
|
167
|
+
context_recall,
|
|
168
|
+
context_utilization,
|
|
169
|
+
)
|
|
170
|
+
from datasets import Dataset
|
|
171
|
+
|
|
172
|
+
# Prepare evaluation dataset
|
|
173
|
+
eval_data = {
|
|
174
|
+
"question": [
|
|
175
|
+
"What is the capital of France?",
|
|
176
|
+
"How do I install Python?"
|
|
177
|
+
],
|
|
178
|
+
"answer": [
|
|
179
|
+
"The capital of France is Paris.",
|
|
180
|
+
"You can install Python by downloading it from python.org."
|
|
181
|
+
],
|
|
182
|
+
"contexts": [
|
|
183
|
+
["Paris is the capital and largest city of France."],
|
|
184
|
+
["Python can be installed from the official website python.org.",
|
|
185
|
+
"You can also use package managers like brew or apt."]
|
|
186
|
+
],
|
|
187
|
+
"ground_truth": [
|
|
188
|
+
"Paris is the capital of France.",
|
|
189
|
+
"Install Python from python.org or use a package manager."
|
|
190
|
+
]
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
dataset = Dataset.from_dict(eval_data)
|
|
194
|
+
|
|
195
|
+
# Run evaluation
|
|
196
|
+
results = evaluate(
|
|
197
|
+
dataset,
|
|
198
|
+
metrics=[
|
|
199
|
+
faithfulness,
|
|
200
|
+
answer_relevancy,
|
|
201
|
+
context_precision,
|
|
202
|
+
context_recall,
|
|
203
|
+
]
|
|
204
|
+
)
|
|
205
|
+
|
|
206
|
+
print(results)
|
|
207
|
+
# {'faithfulness': 0.95, 'answer_relevancy': 0.88, ...}
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
### Custom RAGAS Evaluation
|
|
211
|
+
|
|
212
|
+
```python
|
|
213
|
+
from ragas.metrics import Metric
|
|
214
|
+
from ragas.llms import LangchainLLM
|
|
215
|
+
from langchain_openai import ChatOpenAI
|
|
216
|
+
|
|
217
|
+
# Use custom LLM
|
|
218
|
+
custom_llm = LangchainLLM(llm=ChatOpenAI(model="gpt-4o-mini"))
|
|
219
|
+
|
|
220
|
+
# Evaluate with custom settings
|
|
221
|
+
results = evaluate(
|
|
222
|
+
dataset,
|
|
223
|
+
metrics=[faithfulness, answer_relevancy],
|
|
224
|
+
llm=custom_llm,
|
|
225
|
+
raise_exceptions=False # Continue on errors
|
|
226
|
+
)
|
|
227
|
+
|
|
228
|
+
# Per-sample scores
|
|
229
|
+
for i, row in enumerate(results.to_pandas().itertuples()):
|
|
230
|
+
print(f"Q{i+1}: Faithfulness={row.faithfulness:.2f}, "
|
|
231
|
+
f"Relevancy={row.answer_relevancy:.2f}")
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
### RAGAS Metrics Explained
|
|
235
|
+
|
|
236
|
+
```python
|
|
237
|
+
"""
|
|
238
|
+
RAGAS Core Metrics:
|
|
239
|
+
|
|
240
|
+
1. Faithfulness (0-1):
|
|
241
|
+
- Measures if answer is grounded in context
|
|
242
|
+
- LLM extracts claims from answer, verifies against context
|
|
243
|
+
- High score = answer doesn't hallucinate
|
|
244
|
+
|
|
245
|
+
2. Answer Relevancy (0-1):
|
|
246
|
+
- Measures if answer addresses the question
|
|
247
|
+
- Generates questions from answer, compares to original
|
|
248
|
+
- High score = answer is on-topic
|
|
249
|
+
|
|
250
|
+
3. Context Precision (0-1):
|
|
251
|
+
- Measures if retrieved contexts are relevant
|
|
252
|
+
- Ranks contexts by relevance, calculates precision at each rank
|
|
253
|
+
- High score = top contexts are most relevant
|
|
254
|
+
|
|
255
|
+
4. Context Recall (0-1):
|
|
256
|
+
- Measures if all ground truth info is in context
|
|
257
|
+
- Checks if ground truth sentences are supported by context
|
|
258
|
+
- High score = context contains needed information
|
|
259
|
+
"""
|
|
260
|
+
|
|
261
|
+
# Debugging low scores
|
|
262
|
+
def diagnose_ragas_scores(results_df):
|
|
263
|
+
"""Identify problematic samples."""
|
|
264
|
+
issues = []
|
|
265
|
+
|
|
266
|
+
for idx, row in results_df.iterrows():
|
|
267
|
+
if row.get('faithfulness', 1) < 0.5:
|
|
268
|
+
issues.append({
|
|
269
|
+
"index": idx,
|
|
270
|
+
"issue": "Low faithfulness - answer may contain hallucinations",
|
|
271
|
+
"question": row['question'],
|
|
272
|
+
"answer": row['answer'][:200]
|
|
273
|
+
})
|
|
274
|
+
|
|
275
|
+
if row.get('context_recall', 1) < 0.5:
|
|
276
|
+
issues.append({
|
|
277
|
+
"index": idx,
|
|
278
|
+
"issue": "Low context recall - retrieval missing relevant docs",
|
|
279
|
+
"question": row['question']
|
|
280
|
+
})
|
|
281
|
+
|
|
282
|
+
return issues
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
---
|
|
286
|
+
|
|
287
|
+
## TruLens Evaluation
|
|
288
|
+
|
|
289
|
+
### Setup and Basic Usage
|
|
290
|
+
|
|
291
|
+
```python
|
|
292
|
+
# pip install trulens-eval
|
|
293
|
+
|
|
294
|
+
from trulens_eval import Tru, TruChain, Feedback
|
|
295
|
+
from trulens_eval.feedback import Groundedness
|
|
296
|
+
from trulens_eval.feedback.provider import OpenAI as fOpenAI
|
|
297
|
+
|
|
298
|
+
# Initialize TruLens
|
|
299
|
+
tru = Tru()
|
|
300
|
+
|
|
301
|
+
# Create feedback provider
|
|
302
|
+
provider = fOpenAI()
|
|
303
|
+
|
|
304
|
+
# Define feedback functions
|
|
305
|
+
f_groundedness = Feedback(
|
|
306
|
+
provider.groundedness_measure_with_cot_reasons,
|
|
307
|
+
name="Groundedness"
|
|
308
|
+
).on(
|
|
309
|
+
TruChain.select_context().node.text # Retrieved context
|
|
310
|
+
).on_output()
|
|
311
|
+
|
|
312
|
+
f_relevance = Feedback(
|
|
313
|
+
provider.relevance_with_cot_reasons,
|
|
314
|
+
name="Answer Relevance"
|
|
315
|
+
).on_input().on_output()
|
|
316
|
+
|
|
317
|
+
f_context_relevance = Feedback(
|
|
318
|
+
provider.context_relevance_with_cot_reasons,
|
|
319
|
+
name="Context Relevance"
|
|
320
|
+
).on_input().on(
|
|
321
|
+
TruChain.select_context().node.text
|
|
322
|
+
)
|
|
323
|
+
|
|
324
|
+
# Wrap your RAG chain
|
|
325
|
+
from langchain.chains import RetrievalQA
|
|
326
|
+
|
|
327
|
+
rag_chain = RetrievalQA.from_chain_type(
|
|
328
|
+
llm=llm,
|
|
329
|
+
retriever=vector_store.as_retriever()
|
|
330
|
+
)
|
|
331
|
+
|
|
332
|
+
tru_recorder = TruChain(
|
|
333
|
+
rag_chain,
|
|
334
|
+
app_id="rag-v1",
|
|
335
|
+
feedbacks=[f_groundedness, f_relevance, f_context_relevance]
|
|
336
|
+
)
|
|
337
|
+
|
|
338
|
+
# Run with recording
|
|
339
|
+
with tru_recorder as recording:
|
|
340
|
+
response = rag_chain.invoke({"query": "How do I configure authentication?"})
|
|
341
|
+
|
|
342
|
+
# View results
|
|
343
|
+
tru.run_dashboard() # Opens web UI
|
|
344
|
+
# Or get programmatically
|
|
345
|
+
records = tru.get_records_and_feedback(app_ids=["rag-v1"])
|
|
346
|
+
```
|
|
347
|
+
|
|
348
|
+
### Custom Feedback Functions
|
|
349
|
+
|
|
350
|
+
```python
|
|
351
|
+
from trulens_eval import Feedback, Select
|
|
352
|
+
|
|
353
|
+
def custom_citation_check(response: str, context: str) -> float:
|
|
354
|
+
"""Check if response cites sources from context."""
|
|
355
|
+
# Extract citations from response (e.g., [1], [Source: X])
|
|
356
|
+
import re
|
|
357
|
+
citations = re.findall(r'\[[\d\w\s:]+\]', response)
|
|
358
|
+
|
|
359
|
+
if not citations:
|
|
360
|
+
return 0.0 # No citations
|
|
361
|
+
|
|
362
|
+
# Verify citations reference actual context
|
|
363
|
+
valid_citations = sum(1 for c in citations if c.lower() in context.lower())
|
|
364
|
+
return valid_citations / len(citations)
|
|
365
|
+
|
|
366
|
+
f_citation = Feedback(
|
|
367
|
+
custom_citation_check,
|
|
368
|
+
name="Citation Accuracy"
|
|
369
|
+
).on_output().on(Select.RecordCalls.retriever.get_relevant_documents.rets.page_content)
|
|
370
|
+
```
|
|
371
|
+
|
|
372
|
+
---
|
|
373
|
+
|
|
374
|
+
## Building Custom Evaluation Pipelines
|
|
375
|
+
|
|
376
|
+
### LLM-as-Judge Evaluation
|
|
377
|
+
|
|
378
|
+
```python
|
|
379
|
+
from openai import OpenAI
|
|
380
|
+
from dataclasses import dataclass
|
|
381
|
+
from typing import Literal
|
|
382
|
+
|
|
383
|
+
client = OpenAI()
|
|
384
|
+
|
|
385
|
+
@dataclass
|
|
386
|
+
class EvalResult:
|
|
387
|
+
score: float
|
|
388
|
+
reasoning: str
|
|
389
|
+
criteria: str
|
|
390
|
+
|
|
391
|
+
def evaluate_with_llm(
|
|
392
|
+
question: str,
|
|
393
|
+
answer: str,
|
|
394
|
+
context: str,
|
|
395
|
+
criteria: Literal["faithfulness", "relevance", "completeness"]
|
|
396
|
+
) -> EvalResult:
|
|
397
|
+
"""Use LLM as judge for evaluation."""
|
|
398
|
+
|
|
399
|
+
criteria_prompts = {
|
|
400
|
+
"faithfulness": """
|
|
401
|
+
Evaluate if the answer is fully supported by the provided context.
|
|
402
|
+
Score 1.0 if every claim in the answer is verifiable from context.
|
|
403
|
+
Score 0.5 if most claims are supported but some are not.
|
|
404
|
+
Score 0.0 if the answer contains significant unsupported claims.
|
|
405
|
+
""",
|
|
406
|
+
"relevance": """
|
|
407
|
+
Evaluate if the answer directly addresses the question.
|
|
408
|
+
Score 1.0 if the answer fully addresses the question.
|
|
409
|
+
Score 0.5 if the answer partially addresses the question.
|
|
410
|
+
Score 0.0 if the answer is off-topic or doesn't address the question.
|
|
411
|
+
""",
|
|
412
|
+
"completeness": """
|
|
413
|
+
Evaluate if the answer covers all aspects of the question.
|
|
414
|
+
Score 1.0 if the answer is comprehensive and complete.
|
|
415
|
+
Score 0.5 if the answer covers main points but misses details.
|
|
416
|
+
Score 0.0 if the answer is significantly incomplete.
|
|
417
|
+
"""
|
|
418
|
+
}
|
|
419
|
+
|
|
420
|
+
response = client.chat.completions.create(
|
|
421
|
+
model="gpt-4o-mini",
|
|
422
|
+
messages=[
|
|
423
|
+
{
|
|
424
|
+
"role": "system",
|
|
425
|
+
"content": f"""You are an expert evaluator for RAG systems.
|
|
426
|
+
{criteria_prompts[criteria]}
|
|
427
|
+
|
|
428
|
+
Respond in JSON format:
|
|
429
|
+
{{"score": <0.0-1.0>, "reasoning": "<explanation>"}}"""
|
|
430
|
+
},
|
|
431
|
+
{
|
|
432
|
+
"role": "user",
|
|
433
|
+
"content": f"""Question: {question}
|
|
434
|
+
|
|
435
|
+
Context:
|
|
436
|
+
{context}
|
|
437
|
+
|
|
438
|
+
Answer: {answer}
|
|
439
|
+
|
|
440
|
+
Evaluate the answer for {criteria}:"""
|
|
441
|
+
}
|
|
442
|
+
],
|
|
443
|
+
response_format={"type": "json_object"}
|
|
444
|
+
)
|
|
445
|
+
|
|
446
|
+
import json
|
|
447
|
+
result = json.loads(response.choices[0].message.content)
|
|
448
|
+
|
|
449
|
+
return EvalResult(
|
|
450
|
+
score=result["score"],
|
|
451
|
+
reasoning=result["reasoning"],
|
|
452
|
+
criteria=criteria
|
|
453
|
+
)
|
|
454
|
+
|
|
455
|
+
# Usage
|
|
456
|
+
eval_result = evaluate_with_llm(
|
|
457
|
+
question="How do I configure OAuth2?",
|
|
458
|
+
answer="Configure OAuth2 by setting client_id and client_secret in config.yaml.",
|
|
459
|
+
context="OAuth2 configuration requires client_id, client_secret, and redirect_uri in config.yaml.",
|
|
460
|
+
criteria="faithfulness"
|
|
461
|
+
)
|
|
462
|
+
print(f"Faithfulness: {eval_result.score:.2f}")
|
|
463
|
+
print(f"Reasoning: {eval_result.reasoning}")
|
|
464
|
+
```
|
|
465
|
+
|
|
466
|
+
### Batch Evaluation Pipeline
|
|
467
|
+
|
|
468
|
+
```python
|
|
469
|
+
import asyncio
|
|
470
|
+
from tqdm.asyncio import tqdm_asyncio
|
|
471
|
+
|
|
472
|
+
async def evaluate_batch(
|
|
473
|
+
test_cases: list[dict],
|
|
474
|
+
retriever,
|
|
475
|
+
generator,
|
|
476
|
+
metrics: list[str] = ["precision", "faithfulness", "relevance"]
|
|
477
|
+
) -> dict:
|
|
478
|
+
"""Run batch evaluation on test cases."""
|
|
479
|
+
|
|
480
|
+
results = {
|
|
481
|
+
"per_sample": [],
|
|
482
|
+
"aggregated": {}
|
|
483
|
+
}
|
|
484
|
+
|
|
485
|
+
async def evaluate_single(case: dict) -> dict:
|
|
486
|
+
# Retrieve
|
|
487
|
+
retrieved = await retriever.aretrieve(case["question"])
|
|
488
|
+
retrieved_ids = [r.id for r in retrieved]
|
|
489
|
+
|
|
490
|
+
# Generate
|
|
491
|
+
answer = await generator.agenerate(
|
|
492
|
+
question=case["question"],
|
|
493
|
+
context=[r.text for r in retrieved]
|
|
494
|
+
)
|
|
495
|
+
|
|
496
|
+
# Calculate metrics
|
|
497
|
+
sample_result = {
|
|
498
|
+
"question": case["question"],
|
|
499
|
+
"answer": answer,
|
|
500
|
+
"retrieved_ids": retrieved_ids
|
|
501
|
+
}
|
|
502
|
+
|
|
503
|
+
if "relevant_ids" in case and "precision" in metrics:
|
|
504
|
+
retrieval_metrics = calculate_retrieval_metrics(
|
|
505
|
+
retrieved_ids,
|
|
506
|
+
set(case["relevant_ids"]),
|
|
507
|
+
k=5
|
|
508
|
+
)
|
|
509
|
+
sample_result["precision@5"] = retrieval_metrics.precision_at_k
|
|
510
|
+
sample_result["recall@5"] = retrieval_metrics.recall_at_k
|
|
511
|
+
|
|
512
|
+
if "faithfulness" in metrics:
|
|
513
|
+
faith_eval = evaluate_with_llm(
|
|
514
|
+
case["question"],
|
|
515
|
+
answer,
|
|
516
|
+
"\n".join([r.text for r in retrieved]),
|
|
517
|
+
"faithfulness"
|
|
518
|
+
)
|
|
519
|
+
sample_result["faithfulness"] = faith_eval.score
|
|
520
|
+
|
|
521
|
+
return sample_result
|
|
522
|
+
|
|
523
|
+
# Run evaluations concurrently
|
|
524
|
+
tasks = [evaluate_single(case) for case in test_cases]
|
|
525
|
+
results["per_sample"] = await tqdm_asyncio.gather(*tasks)
|
|
526
|
+
|
|
527
|
+
# Aggregate results
|
|
528
|
+
for metric in ["precision@5", "recall@5", "faithfulness"]:
|
|
529
|
+
scores = [r.get(metric) for r in results["per_sample"] if r.get(metric) is not None]
|
|
530
|
+
if scores:
|
|
531
|
+
results["aggregated"][metric] = {
|
|
532
|
+
"mean": sum(scores) / len(scores),
|
|
533
|
+
"min": min(scores),
|
|
534
|
+
"max": max(scores)
|
|
535
|
+
}
|
|
536
|
+
|
|
537
|
+
return results
|
|
538
|
+
```
|
|
539
|
+
|
|
540
|
+
---
|
|
541
|
+
|
|
542
|
+
## Debugging Poor Retrieval
|
|
543
|
+
|
|
544
|
+
### Retrieval Diagnostics
|
|
545
|
+
|
|
546
|
+
```python
|
|
547
|
+
def diagnose_retrieval(
|
|
548
|
+
query: str,
|
|
549
|
+
retrieved_docs: list,
|
|
550
|
+
expected_docs: list,
|
|
551
|
+
embedding_model
|
|
552
|
+
) -> dict:
|
|
553
|
+
"""Diagnose why retrieval might be failing."""
|
|
554
|
+
|
|
555
|
+
query_embedding = embedding_model.encode(query)
|
|
556
|
+
retrieved_embeddings = [embedding_model.encode(d) for d in retrieved_docs]
|
|
557
|
+
expected_embeddings = [embedding_model.encode(d) for d in expected_docs]
|
|
558
|
+
|
|
559
|
+
from sklearn.metrics.pairwise import cosine_similarity
|
|
560
|
+
import numpy as np
|
|
561
|
+
|
|
562
|
+
diagnosis = {
|
|
563
|
+
"query": query,
|
|
564
|
+
"issues": []
|
|
565
|
+
}
|
|
566
|
+
|
|
567
|
+
# Check query-document similarity
|
|
568
|
+
for i, (doc, emb) in enumerate(zip(retrieved_docs, retrieved_embeddings)):
|
|
569
|
+
sim = cosine_similarity([query_embedding], [emb])[0][0]
|
|
570
|
+
if sim < 0.5:
|
|
571
|
+
diagnosis["issues"].append({
|
|
572
|
+
"type": "low_similarity",
|
|
573
|
+
"doc_index": i,
|
|
574
|
+
"similarity": float(sim),
|
|
575
|
+
"doc_preview": doc[:100]
|
|
576
|
+
})
|
|
577
|
+
|
|
578
|
+
# Check if expected docs would score higher
|
|
579
|
+
for i, (doc, emb) in enumerate(zip(expected_docs, expected_embeddings)):
|
|
580
|
+
sim = cosine_similarity([query_embedding], [emb])[0][0]
|
|
581
|
+
retrieved_max_sim = max(
|
|
582
|
+
cosine_similarity([query_embedding], [e])[0][0]
|
|
583
|
+
for e in retrieved_embeddings
|
|
584
|
+
)
|
|
585
|
+
|
|
586
|
+
if sim > retrieved_max_sim:
|
|
587
|
+
diagnosis["issues"].append({
|
|
588
|
+
"type": "missed_better_doc",
|
|
589
|
+
"expected_doc_index": i,
|
|
590
|
+
"expected_sim": float(sim),
|
|
591
|
+
"best_retrieved_sim": float(retrieved_max_sim),
|
|
592
|
+
"doc_preview": doc[:100]
|
|
593
|
+
})
|
|
594
|
+
|
|
595
|
+
# Check for vocabulary mismatch
|
|
596
|
+
query_terms = set(query.lower().split())
|
|
597
|
+
for i, doc in enumerate(retrieved_docs):
|
|
598
|
+
doc_terms = set(doc.lower().split())
|
|
599
|
+
overlap = query_terms & doc_terms
|
|
600
|
+
if len(overlap) < len(query_terms) * 0.3:
|
|
601
|
+
diagnosis["issues"].append({
|
|
602
|
+
"type": "vocabulary_mismatch",
|
|
603
|
+
"doc_index": i,
|
|
604
|
+
"query_terms": list(query_terms),
|
|
605
|
+
"overlapping_terms": list(overlap)
|
|
606
|
+
})
|
|
607
|
+
|
|
608
|
+
return diagnosis
|
|
609
|
+
|
|
610
|
+
# Usage
|
|
611
|
+
diagnosis = diagnose_retrieval(
|
|
612
|
+
query="How to configure OAuth authentication",
|
|
613
|
+
retrieved_docs=retrieved_texts,
|
|
614
|
+
expected_docs=expected_texts,
|
|
615
|
+
embedding_model=sentence_transformer
|
|
616
|
+
)
|
|
617
|
+
|
|
618
|
+
for issue in diagnosis["issues"]:
|
|
619
|
+
print(f"Issue: {issue['type']}")
|
|
620
|
+
print(f"Details: {issue}")
|
|
621
|
+
```
|
|
622
|
+
|
|
623
|
+
### Query Analysis
|
|
624
|
+
|
|
625
|
+
```python
|
|
626
|
+
def analyze_query_performance(
|
|
627
|
+
query_logs: list[dict],
|
|
628
|
+
threshold_precision: float = 0.6
|
|
629
|
+
) -> dict:
|
|
630
|
+
"""Analyze query patterns to find systematic issues."""
|
|
631
|
+
|
|
632
|
+
analysis = {
|
|
633
|
+
"total_queries": len(query_logs),
|
|
634
|
+
"low_performing": [],
|
|
635
|
+
"patterns": {}
|
|
636
|
+
}
|
|
637
|
+
|
|
638
|
+
for log in query_logs:
|
|
639
|
+
if log.get("precision@5", 1.0) < threshold_precision:
|
|
640
|
+
analysis["low_performing"].append(log)
|
|
641
|
+
|
|
642
|
+
# Analyze low-performing queries
|
|
643
|
+
if analysis["low_performing"]:
|
|
644
|
+
# Check for common patterns
|
|
645
|
+
low_perf_queries = [l["query"] for l in analysis["low_performing"]]
|
|
646
|
+
|
|
647
|
+
# Query length analysis
|
|
648
|
+
avg_length = sum(len(q.split()) for q in low_perf_queries) / len(low_perf_queries)
|
|
649
|
+
analysis["patterns"]["avg_low_perf_query_length"] = avg_length
|
|
650
|
+
|
|
651
|
+
# Common terms in failing queries
|
|
652
|
+
from collections import Counter
|
|
653
|
+
all_terms = []
|
|
654
|
+
for q in low_perf_queries:
|
|
655
|
+
all_terms.extend(q.lower().split())
|
|
656
|
+
analysis["patterns"]["common_failing_terms"] = Counter(all_terms).most_common(10)
|
|
657
|
+
|
|
658
|
+
# Question type analysis
|
|
659
|
+
question_words = ["how", "what", "why", "when", "where", "who"]
|
|
660
|
+
question_types = Counter()
|
|
661
|
+
for q in low_perf_queries:
|
|
662
|
+
for qw in question_words:
|
|
663
|
+
if q.lower().startswith(qw):
|
|
664
|
+
question_types[qw] += 1
|
|
665
|
+
break
|
|
666
|
+
else:
|
|
667
|
+
question_types["other"] += 1
|
|
668
|
+
analysis["patterns"]["failing_question_types"] = dict(question_types)
|
|
669
|
+
|
|
670
|
+
return analysis
|
|
671
|
+
```
|
|
672
|
+
|
|
673
|
+
---
|
|
674
|
+
|
|
675
|
+
## Continuous Monitoring
|
|
676
|
+
|
|
677
|
+
### Production Metrics Dashboard
|
|
678
|
+
|
|
679
|
+
```python
|
|
680
|
+
import time
|
|
681
|
+
from dataclasses import dataclass, field
|
|
682
|
+
from collections import deque
|
|
683
|
+
from threading import Lock
|
|
684
|
+
|
|
685
|
+
@dataclass
|
|
686
|
+
class RAGMetricsCollector:
|
|
687
|
+
"""Collect and track RAG metrics in production."""
|
|
688
|
+
|
|
689
|
+
window_size: int = 1000
|
|
690
|
+
_latencies: deque = field(default_factory=lambda: deque(maxlen=1000))
|
|
691
|
+
_retrieval_scores: deque = field(default_factory=lambda: deque(maxlen=1000))
|
|
692
|
+
_generation_scores: deque = field(default_factory=lambda: deque(maxlen=1000))
|
|
693
|
+
_lock: Lock = field(default_factory=Lock)
|
|
694
|
+
|
|
695
|
+
def record_query(
|
|
696
|
+
self,
|
|
697
|
+
latency_ms: float,
|
|
698
|
+
retrieval_score: float | None = None,
|
|
699
|
+
generation_score: float | None = None
|
|
700
|
+
):
|
|
701
|
+
"""Record metrics for a single query."""
|
|
702
|
+
with self._lock:
|
|
703
|
+
self._latencies.append(latency_ms)
|
|
704
|
+
if retrieval_score is not None:
|
|
705
|
+
self._retrieval_scores.append(retrieval_score)
|
|
706
|
+
if generation_score is not None:
|
|
707
|
+
self._generation_scores.append(generation_score)
|
|
708
|
+
|
|
709
|
+
def get_summary(self) -> dict:
|
|
710
|
+
"""Get current metrics summary."""
|
|
711
|
+
with self._lock:
|
|
712
|
+
import numpy as np
|
|
713
|
+
|
|
714
|
+
summary = {
|
|
715
|
+
"queries_in_window": len(self._latencies),
|
|
716
|
+
"latency": {
|
|
717
|
+
"p50": np.percentile(self._latencies, 50) if self._latencies else 0,
|
|
718
|
+
"p95": np.percentile(self._latencies, 95) if self._latencies else 0,
|
|
719
|
+
"p99": np.percentile(self._latencies, 99) if self._latencies else 0,
|
|
720
|
+
},
|
|
721
|
+
"retrieval_score": {
|
|
722
|
+
"mean": np.mean(self._retrieval_scores) if self._retrieval_scores else 0,
|
|
723
|
+
"std": np.std(self._retrieval_scores) if self._retrieval_scores else 0,
|
|
724
|
+
},
|
|
725
|
+
"generation_score": {
|
|
726
|
+
"mean": np.mean(self._generation_scores) if self._generation_scores else 0,
|
|
727
|
+
"std": np.std(self._generation_scores) if self._generation_scores else 0,
|
|
728
|
+
}
|
|
729
|
+
}
|
|
730
|
+
|
|
731
|
+
return summary
|
|
732
|
+
|
|
733
|
+
# Usage
|
|
734
|
+
metrics = RAGMetricsCollector()
|
|
735
|
+
|
|
736
|
+
# In your RAG endpoint
|
|
737
|
+
start = time.time()
|
|
738
|
+
response = rag_pipeline.query(question)
|
|
739
|
+
latency = (time.time() - start) * 1000
|
|
740
|
+
|
|
741
|
+
metrics.record_query(
|
|
742
|
+
latency_ms=latency,
|
|
743
|
+
retrieval_score=response.get("retrieval_score"),
|
|
744
|
+
generation_score=response.get("generation_score")
|
|
745
|
+
)
|
|
746
|
+
|
|
747
|
+
# Periodically check
|
|
748
|
+
print(metrics.get_summary())
|
|
749
|
+
```
|
|
750
|
+
|
|
751
|
+
### Alerting on Quality Degradation
|
|
752
|
+
|
|
753
|
+
```python
|
|
754
|
+
class RAGQualityMonitor:
|
|
755
|
+
"""Monitor RAG quality and alert on degradation."""
|
|
756
|
+
|
|
757
|
+
def __init__(
|
|
758
|
+
self,
|
|
759
|
+
baseline_precision: float = 0.8,
|
|
760
|
+
alert_threshold: float = 0.1, # Alert if drops by 10%
|
|
761
|
+
window_size: int = 100
|
|
762
|
+
):
|
|
763
|
+
self.baseline = baseline_precision
|
|
764
|
+
self.threshold = alert_threshold
|
|
765
|
+
self.window_size = window_size
|
|
766
|
+
self.recent_scores = deque(maxlen=window_size)
|
|
767
|
+
|
|
768
|
+
def record_score(self, precision: float) -> dict | None:
|
|
769
|
+
"""Record score and return alert if quality degraded."""
|
|
770
|
+
self.recent_scores.append(precision)
|
|
771
|
+
|
|
772
|
+
if len(self.recent_scores) < self.window_size // 2:
|
|
773
|
+
return None # Not enough data
|
|
774
|
+
|
|
775
|
+
current_mean = sum(self.recent_scores) / len(self.recent_scores)
|
|
776
|
+
degradation = self.baseline - current_mean
|
|
777
|
+
|
|
778
|
+
if degradation > self.threshold:
|
|
779
|
+
return {
|
|
780
|
+
"alert": "QUALITY_DEGRADATION",
|
|
781
|
+
"baseline": self.baseline,
|
|
782
|
+
"current": current_mean,
|
|
783
|
+
"degradation": degradation,
|
|
784
|
+
"window_size": len(self.recent_scores)
|
|
785
|
+
}
|
|
786
|
+
|
|
787
|
+
return None
|
|
788
|
+
|
|
789
|
+
# Usage
|
|
790
|
+
monitor = RAGQualityMonitor(baseline_precision=0.85)
|
|
791
|
+
|
|
792
|
+
for query_result in production_queries:
|
|
793
|
+
alert = monitor.record_score(query_result["precision@5"])
|
|
794
|
+
if alert:
|
|
795
|
+
send_alert(alert) # Slack, PagerDuty, etc.
|
|
796
|
+
```
|
|
797
|
+
|
|
798
|
+
---
|
|
799
|
+
|
|
800
|
+
## Evaluation Best Practices
|
|
801
|
+
|
|
802
|
+
| Practice | Description |
|
|
803
|
+
|----------|-------------|
|
|
804
|
+
| **Golden test set** | Maintain 50-200 curated Q&A pairs with ground truth |
|
|
805
|
+
| **Stratified sampling** | Include diverse query types in test set |
|
|
806
|
+
| **Human baselines** | Compare LLM judges against human annotators |
|
|
807
|
+
| **Version control** | Track evaluation results alongside model versions |
|
|
808
|
+
| **Regular re-evaluation** | Re-run golden tests on every retrieval change |
|
|
809
|
+
| **A/B testing** | Compare new retrieval strategies on live traffic |
|
|
810
|
+
|
|
811
|
+
---
|
|
812
|
+
|
|
813
|
+
## Quick Reference
|
|
814
|
+
|
|
815
|
+
| Goal | Metric | Target |
|
|
816
|
+
|------|--------|--------|
|
|
817
|
+
| Are docs relevant? | Precision@5 | > 0.7 |
|
|
818
|
+
| Did we get all docs? | Recall@5 | > 0.8 |
|
|
819
|
+
| Is ranking good? | NDCG@5 | > 0.7 |
|
|
820
|
+
| Is answer grounded? | Faithfulness | > 0.9 |
|
|
821
|
+
| Does answer fit question? | Answer Relevance | > 0.8 |
|
|
822
|
+
| Is context useful? | Context Relevance | > 0.7 |
|
|
823
|
+
|
|
824
|
+
| Framework | Best For |
|
|
825
|
+
|-----------|----------|
|
|
826
|
+
| RAGAS | Quick RAG-specific evaluation |
|
|
827
|
+
| TruLens | Production monitoring and tracing |
|
|
828
|
+
| Custom LLM-judge | Domain-specific criteria |
|
|
829
|
+
| Manual annotation | Ground truth creation |
|
|
830
|
+
|
|
831
|
+
## Related Skills
|
|
832
|
+
|
|
833
|
+
- **RAG Architect** - System design
|
|
834
|
+
- **ML Pipeline** - Evaluation automation
|
|
835
|
+
- **Data Scientist** - Statistical analysis
|
|
836
|
+
- **Monitoring Expert** - Production observability
|