skillfullstack 0.0.0-stage → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.skillsRegistry/catalog.json +231 -0
- package/AGENTS.md +89 -0
- package/README.md +210 -2
- package/bin/index.js +508 -0
- package/package.json +57 -4
- package/skills/backend/apiEngineering/SKILL.md +102 -0
- package/skills/backend/apiEngineering/evals/evalApiEngineering.py +81 -0
- package/skills/backend/apiEngineering/evals/fixtures/invalid/sampleInvalidOpenApi.json +40 -0
- package/skills/backend/apiEngineering/evals/fixtures/valid/sampleValidOpenApi.json +47 -0
- package/skills/backend/apiEngineering/policies/compatibility.md +42 -0
- package/skills/backend/apiEngineering/policies/mandatory.md +48 -0
- package/skills/backend/apiEngineering/policies/performance.md +39 -0
- package/skills/backend/apiEngineering/policies/security.md +36 -0
- package/skills/backend/apiEngineering/references/apiObservability.md +39 -0
- package/skills/backend/apiEngineering/references/apiReference.md +3 -0
- package/skills/backend/apiEngineering/references/apiSecurityOwasp.md +47 -0
- package/skills/backend/apiEngineering/references/contractCompatibility.md +26 -0
- package/skills/backend/apiEngineering/references/databaseTransactions.md +40 -0
- package/skills/backend/apiEngineering/references/distributedReliability.md +26 -0
- package/skills/backend/apiEngineering/references/multiTenancy.md +27 -0
- package/skills/backend/apiEngineering/references/openApi32Standards.md +58 -0
- package/skills/backend/apiEngineering/references/paginationVersioning.md +57 -0
- package/skills/backend/apiEngineering/references/responseStandards.md +94 -0
- package/skills/backend/apiEngineering/scripts/auditApiContract.py +123 -0
- package/skills/backend/apiEngineering/scripts/checkBreakingChanges.py +77 -0
- package/skills/backend/apiEngineering/scripts/generateResponseEnvelope.py +88 -0
- package/skills/backend/apiEngineering/templates/apiChecklist.md +27 -0
- package/skills/backend/apiEngineering/templates/openapi.yaml +125 -0
- package/skills/backend/apiEngineering/templates/problemDetails.json +44 -0
- package/skills/backend/databaseArchitecture/SKILL.md +118 -0
- package/skills/backend/databaseArchitecture/evals/evalDatabaseArchitecture.py +85 -0
- package/skills/backend/databaseArchitecture/evals/fixtures/dangerousMigration.sql +4 -0
- package/skills/backend/databaseArchitecture/evals/fixtures/invalidSchema.sql +23 -0
- package/skills/backend/databaseArchitecture/evals/fixtures/safeMigration.sql +3 -0
- package/skills/backend/databaseArchitecture/evals/fixtures/validSchema.sql +37 -0
- package/skills/backend/databaseArchitecture/policies/integrity.md +25 -0
- package/skills/backend/databaseArchitecture/policies/mandatory.md +32 -0
- package/skills/backend/databaseArchitecture/policies/migration.md +22 -0
- package/skills/backend/databaseArchitecture/policies/normalization.md +25 -0
- package/skills/backend/databaseArchitecture/policies/performance.md +26 -0
- package/skills/backend/databaseArchitecture/policies/recovery.md +23 -0
- package/skills/backend/databaseArchitecture/policies/security.md +26 -0
- package/skills/backend/databaseArchitecture/policies/tableCreationChecklist.md +70 -0
- package/skills/backend/databaseArchitecture/references/analyticsWarehousing.md +32 -0
- package/skills/backend/databaseArchitecture/references/apiReference.md +3 -0
- package/skills/backend/databaseArchitecture/references/backupDisasterRecovery.md +27 -0
- package/skills/backend/databaseArchitecture/references/dataModelingLifecycle.md +30 -0
- package/skills/backend/databaseArchitecture/references/databaseTaxonomy.md +32 -0
- package/skills/backend/databaseArchitecture/references/indexingOptimization.md +32 -0
- package/skills/backend/databaseArchitecture/references/normalizationTheory.md +61 -0
- package/skills/backend/databaseArchitecture/references/scalabilitySharding.md +37 -0
- package/skills/backend/databaseArchitecture/references/transactionConcurrency.md +39 -0
- package/skills/backend/databaseArchitecture/scripts/analyzeMigration.py +99 -0
- package/skills/backend/databaseArchitecture/scripts/auditDatabaseSchema.py +177 -0
- package/skills/backend/databaseArchitecture/scripts/inspectDatabaseIndexes.py +149 -0
- package/skills/backend/databaseArchitecture/templates/adrTemplate.md +32 -0
- package/skills/backend/databaseArchitecture/templates/databaseChecklist.md +29 -0
- package/skills/backend/databaseArchitecture/templates/migrationPlan.md +40 -0
- package/skills/backend/durableBackgroundJobs/SKILL.md +112 -0
- package/skills/backend/durableBackgroundJobs/evals/durableJobVerification.json +14 -0
- package/skills/backend/durableBackgroundJobs/references/apiReference.md +3 -0
- package/skills/backend/durableBackgroundJobs/references/durableStepPatterns.md +6 -0
- package/skills/backend/durableBackgroundJobs/references/idempotencyKeys.md +5 -0
- package/skills/backend/durableBackgroundJobs/scripts/testWorkflowDispatch.py +24 -0
- package/skills/backend/golangStandard/SKILL.md +155 -0
- package/skills/backend/golangStandard/evals/goVerification.json +14 -0
- package/skills/backend/golangStandard/references/apiReference.md +3 -0
- package/skills/backend/golangStandard/references/layoutGuide.md +26 -0
- package/skills/backend/golangStandard/references/slogPatterns.md +26 -0
- package/skills/backend/golangStandard/scripts/scaffoldGoModule.py +105 -0
- package/skills/backend/pythonStandard/SKILL.md +138 -0
- package/skills/backend/pythonStandard/evals/pythonVerification.json +14 -0
- package/skills/backend/pythonStandard/references/apiReference.md +3 -0
- package/skills/backend/pythonStandard/references/pydanticPatterns.md +16 -0
- package/skills/backend/pythonStandard/references/pyprojectSpecs.md +37 -0
- package/skills/backend/pythonStandard/scripts/scaffoldUvProject.py +79 -0
- package/skills/backend/upstash/SKILL.md +98 -0
- package/skills/backend/upstash/evals/upstashVerification.json +14 -0
- package/skills/backend/upstash/references/apiReference.md +3 -0
- package/skills/backend/upstash/references/qstashFlowControl.md +34 -0
- package/skills/backend/upstash/references/ratelimitPatterns.md +53 -0
- package/skills/backend/upstash/references/workflowPatterns.md +35 -0
- package/skills/backend/upstash/scripts/testRedisConnection.py +36 -0
- package/skills/cicdDevops/cicdPipeline/SKILL.md +148 -0
- package/skills/cicdDevops/cicdPipeline/evals/evalCicd.py +37 -0
- package/skills/cicdDevops/cicdPipeline/references/apiReference.md +3 -0
- package/skills/cicdDevops/cicdPipeline/references/cicdDeploymentPatterns.md +27 -0
- package/skills/cicdDevops/cicdPipeline/scripts/auditDockerfileSecurity.py +56 -0
- package/skills/dataAi/mcpServerDevelopment/SKILL.md +123 -0
- package/skills/dataAi/mcpServerDevelopment/evals/mcpVerification.json +14 -0
- package/skills/dataAi/mcpServerDevelopment/references/apiReference.md +3 -0
- package/skills/dataAi/mcpServerDevelopment/references/mcpClientConfigs.md +38 -0
- package/skills/dataAi/mcpServerDevelopment/references/toolSchemaDesign.md +6 -0
- package/skills/dataAi/mcpServerDevelopment/scripts/runFastMcpBoilerplate.py +36 -0
- package/skills/dataAi/ragPipelineProduction/SKILL.md +113 -0
- package/skills/dataAi/ragPipelineProduction/evals/ragVerification.json +14 -0
- package/skills/dataAi/ragPipelineProduction/references/apiReference.md +3 -0
- package/skills/dataAi/ragPipelineProduction/references/chunkingStrategies.md +10 -0
- package/skills/dataAi/ragPipelineProduction/references/rrfAlgorithm.md +13 -0
- package/skills/dataAi/ragPipelineProduction/scripts/runHybridRrfSearch.py +33 -0
- package/skills/devopsCloud/cloudflare/SKILL.md +282 -0
- package/skills/devopsCloud/cloudflare/assets/README.md +48 -0
- package/skills/devopsCloud/cloudflare/assets/ai/agents-sdk.md +118 -0
- package/skills/devopsCloud/cloudflare/assets/ai/ai-gateway.md +105 -0
- package/skills/devopsCloud/cloudflare/assets/ai/ai-search.md +129 -0
- package/skills/devopsCloud/cloudflare/assets/ai/workers-ai.md +127 -0
- package/skills/devopsCloud/cloudflare/assets/cli/c3.md +292 -0
- package/skills/devopsCloud/cloudflare/assets/cli/cf-cli.md +90 -0
- package/skills/devopsCloud/cloudflare/assets/cli/wrangler.md +43 -0
- package/skills/devopsCloud/cloudflare/assets/compute/cron-triggers.md +486 -0
- package/skills/devopsCloud/cloudflare/assets/compute/service-bindings.md +251 -0
- package/skills/devopsCloud/cloudflare/assets/compute/smart-placement.md +435 -0
- package/skills/devopsCloud/cloudflare/assets/compute/static-assets.md +220 -0
- package/skills/devopsCloud/cloudflare/assets/compute/workers.md +129 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/d1.md +105 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/durable-objects.md +122 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/hyperdrive.md +210 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/kv.md +198 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/queues.md +105 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/r2.md +105 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/vectorize.md +97 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/workflows.md +141 -0
- package/skills/devopsCloud/cloudflare/assets/llms.txt +143 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/cache-cdn.md +109 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/dns.md +71 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/rate-limiting.md +130 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/tunnels.md +57 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/waf.md +143 -0
- package/skills/devopsCloud/cloudflare/assets/troubleshooting/1xxx-errors.md +209 -0
- package/skills/devopsCloud/cloudflare/assets/troubleshooting/5xx-errors.md +111 -0
- package/skills/devopsCloud/cloudflare/assets/troubleshooting/http-status-codes.md +38 -0
- package/skills/devopsCloud/cloudflare/evals/evals.json +75 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/README.md +27 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/dynamic-routing.md +15 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/features.md +22 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/sdk-integration.md +19 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/troubleshooting.md +16 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/README.md +25 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/gotchas.md +13 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/bindings/README.md +16 -0
- package/skills/devopsCloud/cloudflare/references/bindings/api.md +19 -0
- package/skills/devopsCloud/cloudflare/references/bindings/configuration.md +20 -0
- package/skills/devopsCloud/cloudflare/references/bindings/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/bindings/patterns.md +20 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/README.md +18 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/api.md +12 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/configuration.md +12 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/patterns.md +12 -0
- package/skills/devopsCloud/cloudflare/references/cliComparison.md +93 -0
- package/skills/devopsCloud/cloudflare/references/containers/README.md +23 -0
- package/skills/devopsCloud/cloudflare/references/containers/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/containers/configuration.md +15 -0
- package/skills/devopsCloud/cloudflare/references/containers/gotchas.md +16 -0
- package/skills/devopsCloud/cloudflare/references/containers/patterns.md +18 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/README.md +20 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/gotchas.md +17 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/patterns.md +18 -0
- package/skills/devopsCloud/cloudflare/references/d1/README.md +15 -0
- package/skills/devopsCloud/cloudflare/references/d1/api.md +18 -0
- package/skills/devopsCloud/cloudflare/references/d1/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/d1/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/d1/patterns.md +21 -0
- package/skills/devopsCloud/cloudflare/references/frameworkCompatibility.md +110 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/README.md +28 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/api.md +26 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/configuration.md +34 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/gotchas.md +20 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/images/README.md +12 -0
- package/skills/devopsCloud/cloudflare/references/images/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/images/configuration.md +17 -0
- package/skills/devopsCloud/cloudflare/references/images/gotchas.md +16 -0
- package/skills/devopsCloud/cloudflare/references/images/patterns.md +16 -0
- package/skills/devopsCloud/cloudflare/references/kv/README.md +15 -0
- package/skills/devopsCloud/cloudflare/references/kv/api.md +18 -0
- package/skills/devopsCloud/cloudflare/references/kv/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/kv/gotchas.md +17 -0
- package/skills/devopsCloud/cloudflare/references/kv/patterns.md +21 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/README.md +22 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/patterns.md +19 -0
- package/skills/devopsCloud/cloudflare/references/observability/README.md +27 -0
- package/skills/devopsCloud/cloudflare/references/observability/api.md +20 -0
- package/skills/devopsCloud/cloudflare/references/observability/configuration.md +23 -0
- package/skills/devopsCloud/cloudflare/references/observability/gotchas.md +25 -0
- package/skills/devopsCloud/cloudflare/references/observability/patterns.md +14 -0
- package/skills/devopsCloud/cloudflare/references/pages/README.md +20 -0
- package/skills/devopsCloud/cloudflare/references/pages/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/pages/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/pages/gotchas.md +19 -0
- package/skills/devopsCloud/cloudflare/references/pages/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/README.md +20 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/configuration.md +14 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/gotchas.md +17 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/patterns.md +16 -0
- package/skills/devopsCloud/cloudflare/references/productSelectionMatrix.md +54 -0
- package/skills/devopsCloud/cloudflare/references/queues/README.md +24 -0
- package/skills/devopsCloud/cloudflare/references/queues/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/queues/configuration.md +20 -0
- package/skills/devopsCloud/cloudflare/references/queues/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/queues/patterns.md +21 -0
- package/skills/devopsCloud/cloudflare/references/r2/README.md +26 -0
- package/skills/devopsCloud/cloudflare/references/r2/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/r2/configuration.md +19 -0
- package/skills/devopsCloud/cloudflare/references/r2/gotchas.md +17 -0
- package/skills/devopsCloud/cloudflare/references/r2/patterns.md +18 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/README.md +22 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/api.md +21 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/configuration.md +25 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/gotchas.md +19 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/patterns.md +27 -0
- package/skills/devopsCloud/cloudflare/references/skill-feedback.md +41 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/README.md +21 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/patterns.md +17 -0
- package/skills/devopsCloud/cloudflare/references/stream/README.md +22 -0
- package/skills/devopsCloud/cloudflare/references/stream/api-live.md +18 -0
- package/skills/devopsCloud/cloudflare/references/stream/api.md +21 -0
- package/skills/devopsCloud/cloudflare/references/stream/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/stream/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/stream/patterns.md +22 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/README.md +21 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/configuration.md +15 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/gotchas.md +16 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/README.md +20 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/api.md +14 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/configuration.md +14 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/networking.md +14 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/README.md +22 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/api.md +18 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/configuration.md +19 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/patterns.md +24 -0
- package/skills/devopsCloud/cloudflare/references/waf/README.md +21 -0
- package/skills/devopsCloud/cloudflare/references/waf/api.md +17 -0
- package/skills/devopsCloud/cloudflare/references/waf/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/waf/gotchas.md +19 -0
- package/skills/devopsCloud/cloudflare/references/waf/patterns.md +17 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/README.md +24 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/patterns.md +14 -0
- package/skills/devopsCloud/cloudflare/references/workflows/README.md +23 -0
- package/skills/devopsCloud/cloudflare/references/workflows/api.md +17 -0
- package/skills/devopsCloud/cloudflare/references/workflows/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/workflows/gotchas.md +19 -0
- package/skills/devopsCloud/cloudflare/references/workflows/patterns.md +30 -0
- package/skills/devopsCloud/cloudflare/scripts/auditCloudflareProduction.py +95 -0
- package/skills/foundation/promptEvalTesting/SKILL.md +114 -0
- package/skills/foundation/promptEvalTesting/evals/promptEvalVerification.json +14 -0
- package/skills/foundation/promptEvalTesting/references/apiReference.md +3 -0
- package/skills/foundation/promptEvalTesting/references/evalMetricsCatalog.md +7 -0
- package/skills/foundation/promptEvalTesting/references/promptfooConfigSpecs.md +16 -0
- package/skills/foundation/promptEvalTesting/scripts/runPromptEvalSuite.py +29 -0
- package/skills/frontend/astro/SKILL.md +327 -0
- package/skills/frontend/astro/assets/README.md +71 -0
- package/skills/frontend/astro/assets/add-content-to-your-site/content-collections.md +1061 -0
- package/skills/frontend/astro/assets/add-content-to-your-site/data-fetching.md +109 -0
- package/skills/frontend/astro/assets/add-content-to-your-site/images.md +719 -0
- package/skills/frontend/astro/assets/add-content-to-your-site/markdown.md +725 -0
- package/skills/frontend/astro/assets/build-your-ui/components.md +402 -0
- package/skills/frontend/astro/assets/build-your-ui/fonts.md +437 -0
- package/skills/frontend/astro/assets/build-your-ui/front-end-frameworks.md +245 -0
- package/skills/frontend/astro/assets/build-your-ui/layouts.md +267 -0
- package/skills/frontend/astro/assets/build-your-ui/scripts-and-event-handling.md +229 -0
- package/skills/frontend/astro/assets/build-your-ui/styles-and-css.md +782 -0
- package/skills/frontend/astro/assets/build-your-ui/syntax-highlighting.md +269 -0
- package/skills/frontend/astro/assets/configuration/build-with-ai.md +389 -0
- package/skills/frontend/astro/assets/configuration/configuration-overview.md +122 -0
- package/skills/frontend/astro/assets/configuration/dev-toolbar.md +86 -0
- package/skills/frontend/astro/assets/configuration/editor-setup.md +166 -0
- package/skills/frontend/astro/assets/configuration/environment-variables.md +352 -0
- package/skills/frontend/astro/assets/configuration/typescript.md +379 -0
- package/skills/frontend/astro/assets/configuration/working-with-integrations.md +606 -0
- package/skills/frontend/astro/assets/reference/adapter-reference.md +1242 -0
- package/skills/frontend/astro/assets/reference/cli-reference.md +575 -0
- package/skills/frontend/astro/assets/reference/configuration-reference.md +3144 -0
- package/skills/frontend/astro/assets/reference/content-loader-reference.md +1682 -0
- package/skills/frontend/astro/assets/reference/directives-reference.md +324 -0
- package/skills/frontend/astro/assets/reference/image-service-reference.md +346 -0
- package/skills/frontend/astro/assets/reference/integrations-reference.md +2813 -0
- package/skills/frontend/astro/assets/reference/modules/astro-actions.md +604 -0
- package/skills/frontend/astro/assets/reference/modules/astro-app.md +460 -0
- package/skills/frontend/astro/assets/reference/modules/astro-assets.md +1657 -0
- package/skills/frontend/astro/assets/reference/modules/astro-config.md +395 -0
- package/skills/frontend/astro/assets/reference/modules/astro-content.md +720 -0
- package/skills/frontend/astro/assets/reference/modules/astro-env.md +46 -0
- package/skills/frontend/astro/assets/reference/modules/astro-fetch.md +346 -0
- package/skills/frontend/astro/assets/reference/modules/astro-hono.md +37 -0
- package/skills/frontend/astro/assets/reference/modules/astro-i18n.md +462 -0
- package/skills/frontend/astro/assets/reference/modules/astro-middleware.md +292 -0
- package/skills/frontend/astro/assets/reference/modules/astro-static-paths.md +74 -0
- package/skills/frontend/astro/assets/reference/modules/astro-transitions.md +595 -0
- package/skills/frontend/astro/assets/reference/modules/astro-zod.md +120 -0
- package/skills/frontend/astro/assets/reference/session-driver-reference.md +205 -0
- package/skills/frontend/astro/assets/routing-and-navigation/endpoints.md +251 -0
- package/skills/frontend/astro/assets/routing-and-navigation/internationalization.md +374 -0
- package/skills/frontend/astro/assets/routing-and-navigation/middleware.md +288 -0
- package/skills/frontend/astro/assets/routing-and-navigation/pages.md +205 -0
- package/skills/frontend/astro/assets/routing-and-navigation/prefetch.md +273 -0
- package/skills/frontend/astro/assets/routing-and-navigation/routing.md +760 -0
- package/skills/frontend/astro/assets/routing-and-navigation/view-transitions.md +792 -0
- package/skills/frontend/astro/assets/server-rendering/actions.md +770 -0
- package/skills/frontend/astro/assets/server-rendering/caching.md +255 -0
- package/skills/frontend/astro/assets/server-rendering/on-demand-rendering.md +289 -0
- package/skills/frontend/astro/assets/server-rendering/server-islands.md +126 -0
- package/skills/frontend/astro/assets/server-rendering/sessions.md +270 -0
- package/skills/frontend/astro/assets/start-a-new-project/develop-and-build.md +147 -0
- package/skills/frontend/astro/assets/start-a-new-project/installation.md +342 -0
- package/skills/frontend/astro/assets/start-a-new-project/project-structure.md +137 -0
- package/skills/frontend/astro/assets/upgrade-and-troubleshooting/testing.md +412 -0
- package/skills/frontend/astro/assets/upgrade-and-troubleshooting/troubleshooting.md +229 -0
- package/skills/frontend/astro/assets/upgrade-and-troubleshooting/upgrade-astro.md +205 -0
- package/skills/frontend/astro/assets/welcome/courses.md +46 -0
- package/skills/frontend/astro/assets/welcome/islands-architecture.md +135 -0
- package/skills/frontend/astro/assets/welcome/why-astro.md +90 -0
- package/skills/frontend/astro/evals/evals.json +66 -0
- package/skills/frontend/astro/references/contentCollections.md +164 -0
- package/skills/frontend/astro/references/islandsArchitecture.md +128 -0
- package/skills/frontend/astro/references/serverIslandsAndActions.md +187 -0
- package/skills/frontend/astro/scripts/auditAstroProduction.py +78 -0
- package/skills/frontend/generativeUi/SKILL.md +128 -0
- package/skills/frontend/generativeUi/evals/generativeUiVerification.json +14 -0
- package/skills/frontend/generativeUi/references/apiReference.md +3 -0
- package/skills/frontend/generativeUi/references/clientToolComponentMapping.md +8 -0
- package/skills/frontend/generativeUi/references/dataStreamProtocol.md +10 -0
- package/skills/frontend/generativeUi/scripts/generateUiComponentStub.py +46 -0
- package/skills/frontend/nextjs/SKILL.md +138 -0
- package/skills/frontend/nextjs/assets/README.md +67 -0
- package/skills/frontend/nextjs/assets/api-reference/cli/create-next-app.md +210 -0
- package/skills/frontend/nextjs/assets/api-reference/cli/next.md +484 -0
- package/skills/frontend/nextjs/assets/api-reference/components/font.md +952 -0
- package/skills/frontend/nextjs/assets/api-reference/components/form.md +387 -0
- package/skills/frontend/nextjs/assets/api-reference/components/image.md +1372 -0
- package/skills/frontend/nextjs/assets/api-reference/components/link.md +954 -0
- package/skills/frontend/nextjs/assets/api-reference/components/script.md +421 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-private.md +211 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-remote.md +652 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-cache.md +848 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-client.md +149 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-server.md +234 -0
- package/skills/frontend/nextjs/assets/api-reference/edge-runtime.md +188 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/default.md +80 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/dynamic-routes.md +417 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/error.md +361 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/forbidden.md +75 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation-client.md +308 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation.md +177 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/intercepting-routes.md +78 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/layout.md +803 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/loading.md +209 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/mdx-components.md +84 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/app-icons.md +302 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/manifest.md +90 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/opengraph-image.md +580 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/robots.md +234 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/sitemap.md +459 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/not-found.md +278 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/page.md +283 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/parallel-routes.md +517 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/proxy.md +857 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/public-folder.md +47 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-groups.md +40 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/dynamicParams.md +40 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/ensureStatic.md +195 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/instant.md +204 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/maxDuration.md +42 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/preferredRegion.md +55 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/prefetch.md +113 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/runtime.md +43 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route.md +772 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/src-folder.md +42 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/template.md +174 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/unauthorized.md +143 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/after.md +332 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/cacheLife.md +642 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/cacheTag.md +272 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/catchError.md +267 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/connection.md +114 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/cookies.md +349 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/draft-mode.md +173 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/fetch.md +141 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/forbidden.md +327 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-image-metadata.md +311 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-metadata.md +1510 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-sitemaps.md +102 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-static-params.md +606 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-viewport.md +347 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/headers.md +92 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/image-response.md +225 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/io.md +131 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/navigation.md +220 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/next-request.md +116 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/next-response.md +219 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/next-root-params.md +479 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/not-found.md +269 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/permanentRedirect.md +92 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/prefetch.md +202 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/redirect.md +255 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/refresh.md +91 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/revalidatePath.md +248 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/revalidateTag.md +175 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/unauthorized.md +389 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/unstable_cache.md +131 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/unstable_noStore.md +61 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/unstable_rethrow.md +79 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/updateTag.md +173 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-link-status.md +268 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-offline.md +222 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-params.md +102 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-pathname.md +189 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-report-web-vitals.md +175 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-router.md +214 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-search-params.md +416 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segment.md +214 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segments.md +116 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-server-inserted-html.md +145 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/userAgent.md +95 -0
- package/skills/frontend/nextjs/assets/api-reference/turbopack.md +552 -0
- package/skills/frontend/nextjs/assets/architecture/accessibility.md +47 -0
- package/skills/frontend/nextjs/assets/architecture/fast-refresh.md +122 -0
- package/skills/frontend/nextjs/assets/architecture/nextjs-compiler.md +376 -0
- package/skills/frontend/nextjs/assets/architecture/supported-browsers.md +146 -0
- package/skills/frontend/nextjs/assets/community/contribution-guide.md +459 -0
- package/skills/frontend/nextjs/assets/community/rspack.md +25 -0
- package/skills/frontend/nextjs/assets/getting-started/caching.md +626 -0
- package/skills/frontend/nextjs/assets/getting-started/css.md +336 -0
- package/skills/frontend/nextjs/assets/getting-started/deploying.md +115 -0
- package/skills/frontend/nextjs/assets/getting-started/error-handling.md +485 -0
- package/skills/frontend/nextjs/assets/getting-started/fetching-data.md +743 -0
- package/skills/frontend/nextjs/assets/getting-started/fonts.md +232 -0
- package/skills/frontend/nextjs/assets/getting-started/images.md +272 -0
- package/skills/frontend/nextjs/assets/getting-started/installation.md +446 -0
- package/skills/frontend/nextjs/assets/getting-started/layouts-and-pages.md +386 -0
- package/skills/frontend/nextjs/assets/getting-started/linking-and-navigating.md +475 -0
- package/skills/frontend/nextjs/assets/getting-started/metadata-and-og-images.md +370 -0
- package/skills/frontend/nextjs/assets/getting-started/mutating-data.md +679 -0
- package/skills/frontend/nextjs/assets/getting-started/project-structure.md +290 -0
- package/skills/frontend/nextjs/assets/getting-started/proxy.md +107 -0
- package/skills/frontend/nextjs/assets/getting-started/revalidating.md +241 -0
- package/skills/frontend/nextjs/assets/getting-started/route-handlers.md +233 -0
- package/skills/frontend/nextjs/assets/getting-started/server-and-client-components.md +683 -0
- package/skills/frontend/nextjs/assets/getting-started/upgrading.md +137 -0
- package/skills/frontend/nextjs/assets/glossary.md +315 -0
- package/skills/frontend/nextjs/evals/nextjsVerification.json +14 -0
- package/skills/frontend/nextjs/references/apiReference.md +3 -0
- package/skills/frontend/nextjs/references/dataAccessLayer.md +39 -0
- package/skills/frontend/nextjs/references/nextjsFeatureMap.md +276 -0
- package/skills/frontend/nextjs/references/productionChecklist.md +49 -0
- package/skills/frontend/nextjs/references/securityHeadersCsp.md +44 -0
- package/skills/frontend/nextjs/scripts/auditProductionReadiness.py +85 -0
- package/skills/frontend/shadcn-ui/SKILL.md +102 -0
- package/skills/frontend/shadcn-ui/assets/README.md +82 -0
- package/skills/frontend/shadcn-ui/assets/advanced/javascript.md +44 -0
- package/skills/frontend/shadcn-ui/assets/advanced/monorepo.md +254 -0
- package/skills/frontend/shadcn-ui/assets/advanced/react-19.md +166 -0
- package/skills/frontend/shadcn-ui/assets/advanced/tailwind-v4.md +333 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/chain-of-thought.md +519 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/chat.md +581 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/checkpoint.md +243 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/confirmation.md +382 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/context.md +188 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/file-tree.md +248 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/index.md +307 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/inline-citation.md +219 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/message.md +298 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/model-selector.md +368 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/plan.md +398 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/prompt-input.md +403 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/queue.md +517 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/reasoning.md +349 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/sources.md +303 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/stack-trace.md +514 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/subagent.md +551 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/suggestion.md +246 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/task.md +380 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/terminal.md +463 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/test-results.md +641 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/tool.md +915 -0
- package/skills/frontend/shadcn-ui/assets/components/accordion.md +490 -0
- package/skills/frontend/shadcn-ui/assets/components/alert-dialog.md +520 -0
- package/skills/frontend/shadcn-ui/assets/components/alert.md +351 -0
- package/skills/frontend/shadcn-ui/assets/components/aspect-ratio.md +206 -0
- package/skills/frontend/shadcn-ui/assets/components/attachment.md +715 -0
- package/skills/frontend/shadcn-ui/assets/components/avatar.md +581 -0
- package/skills/frontend/shadcn-ui/assets/components/badge.md +276 -0
- package/skills/frontend/shadcn-ui/assets/components/breadcrumb.md +556 -0
- package/skills/frontend/shadcn-ui/assets/components/bubble.md +706 -0
- package/skills/frontend/shadcn-ui/assets/components/button-group.md +969 -0
- package/skills/frontend/shadcn-ui/assets/components/button.md +523 -0
- package/skills/frontend/shadcn-ui/assets/components/calendar.md +959 -0
- package/skills/frontend/shadcn-ui/assets/components/card.md +684 -0
- package/skills/frontend/shadcn-ui/assets/components/carousel.md +643 -0
- package/skills/frontend/shadcn-ui/assets/components/chart.md +1295 -0
- package/skills/frontend/shadcn-ui/assets/components/checkbox.md +553 -0
- package/skills/frontend/shadcn-ui/assets/components/code-block.md +2041 -0
- package/skills/frontend/shadcn-ui/assets/components/collapsible.md +504 -0
- package/skills/frontend/shadcn-ui/assets/components/combobox.md +1102 -0
- package/skills/frontend/shadcn-ui/assets/components/command.md +682 -0
- package/skills/frontend/shadcn-ui/assets/components/context-menu.md +949 -0
- package/skills/frontend/shadcn-ui/assets/components/data-table.md +1667 -0
- package/skills/frontend/shadcn-ui/assets/components/date-picker.md +698 -0
- package/skills/frontend/shadcn-ui/assets/components/dialog.md +454 -0
- package/skills/frontend/shadcn-ui/assets/components/direction.md +205 -0
- package/skills/frontend/shadcn-ui/assets/components/drawer.md +806 -0
- package/skills/frontend/shadcn-ui/assets/components/dropdown-menu.md +1315 -0
- package/skills/frontend/shadcn-ui/assets/components/empty.md +562 -0
- package/skills/frontend/shadcn-ui/assets/components/field.md +1321 -0
- package/skills/frontend/shadcn-ui/assets/components/hover-card.md +342 -0
- package/skills/frontend/shadcn-ui/assets/components/index.md +82 -0
- package/skills/frontend/shadcn-ui/assets/components/input-group.md +980 -0
- package/skills/frontend/shadcn-ui/assets/components/input-otp.md +551 -0
- package/skills/frontend/shadcn-ui/assets/components/input.md +555 -0
- package/skills/frontend/shadcn-ui/assets/components/item.md +937 -0
- package/skills/frontend/shadcn-ui/assets/components/kbd.md +290 -0
- package/skills/frontend/shadcn-ui/assets/components/label.md +327 -0
- package/skills/frontend/shadcn-ui/assets/components/marker.md +445 -0
- package/skills/frontend/shadcn-ui/assets/components/menubar.md +804 -0
- package/skills/frontend/shadcn-ui/assets/components/message-scroller.md +2770 -0
- package/skills/frontend/shadcn-ui/assets/components/message.md +618 -0
- package/skills/frontend/shadcn-ui/assets/components/native-select.md +321 -0
- package/skills/frontend/shadcn-ui/assets/components/navigation-menu.md +568 -0
- package/skills/frontend/shadcn-ui/assets/components/pagination.md +425 -0
- package/skills/frontend/shadcn-ui/assets/components/popover.md +402 -0
- package/skills/frontend/shadcn-ui/assets/components/progress.md +240 -0
- package/skills/frontend/shadcn-ui/assets/components/questionnaire.md +2055 -0
- package/skills/frontend/shadcn-ui/assets/components/radio-group.md +440 -0
- package/skills/frontend/shadcn-ui/assets/components/resizable.md +302 -0
- package/skills/frontend/shadcn-ui/assets/components/scroll-area.md +226 -0
- package/skills/frontend/shadcn-ui/assets/components/select.md +647 -0
- package/skills/frontend/shadcn-ui/assets/components/separator.md +235 -0
- package/skills/frontend/shadcn-ui/assets/components/sheet.md +354 -0
- package/skills/frontend/shadcn-ui/assets/components/sidebar.md +1156 -0
- package/skills/frontend/shadcn-ui/assets/components/skeleton.md +217 -0
- package/skills/frontend/shadcn-ui/assets/components/slider.md +253 -0
- package/skills/frontend/shadcn-ui/assets/components/spinner.md +352 -0
- package/skills/frontend/shadcn-ui/assets/components/switch.md +296 -0
- package/skills/frontend/shadcn-ui/assets/components/table.md +572 -0
- package/skills/frontend/shadcn-ui/assets/components/tabs.md +425 -0
- package/skills/frontend/shadcn-ui/assets/components/textarea.md +218 -0
- package/skills/frontend/shadcn-ui/assets/components/toast.md +260 -0
- package/skills/frontend/shadcn-ui/assets/components/toggle-group.md +419 -0
- package/skills/frontend/shadcn-ui/assets/components/toggle.md +220 -0
- package/skills/frontend/shadcn-ui/assets/components/tooltip.md +332 -0
- package/skills/frontend/shadcn-ui/assets/components/trace.md +1890 -0
- package/skills/frontend/shadcn-ui/assets/components/typography.md +561 -0
- package/skills/frontend/shadcn-ui/assets/dark-mode/next.md +108 -0
- package/skills/frontend/shadcn-ui/assets/dark-mode/overview.md +75 -0
- package/skills/frontend/shadcn-ui/assets/dark-mode/vite.md +144 -0
- package/skills/frontend/shadcn-ui/assets/forms/next.md +716 -0
- package/skills/frontend/shadcn-ui/assets/forms/overview.md +60 -0
- package/skills/frontend/shadcn-ui/assets/forms/react-hook-form.md +2055 -0
- package/skills/frontend/shadcn-ui/assets/forms/tanstack-form.md +2236 -0
- package/skills/frontend/shadcn-ui/assets/installation/astro.md +252 -0
- package/skills/frontend/shadcn-ui/assets/installation/manual.md +255 -0
- package/skills/frontend/shadcn-ui/assets/installation/next.md +256 -0
- package/skills/frontend/shadcn-ui/assets/installation/react-router.md +226 -0
- package/skills/frontend/shadcn-ui/assets/installation/remix.md +52 -0
- package/skills/frontend/shadcn-ui/assets/installation/vite.md +314 -0
- package/skills/frontend/shadcn-ui/assets/mcp/mcp.md +338 -0
- package/skills/frontend/shadcn-ui/assets/overview/changelog.md +6 -0
- package/skills/frontend/shadcn-ui/assets/overview/cli.md +738 -0
- package/skills/frontend/shadcn-ui/assets/overview/components-json.md +379 -0
- package/skills/frontend/shadcn-ui/assets/overview/directory.md +74 -0
- package/skills/frontend/shadcn-ui/assets/overview/introduction.md +77 -0
- package/skills/frontend/shadcn-ui/assets/overview/skills.md +71 -0
- package/skills/frontend/shadcn-ui/assets/overview/theming.md +304 -0
- package/skills/frontend/shadcn-ui/assets/overview/typeset.md +242 -0
- package/skills/frontend/shadcn-ui/assets/registry/getting-started.md +648 -0
- package/skills/frontend/shadcn-ui/assets/registry/overview.md +90 -0
- package/skills/frontend/shadcn-ui/assets/registry/registry-item-json.md +483 -0
- package/skills/frontend/shadcn-ui/assets/registry/registry-json.md +178 -0
- package/skills/frontend/shadcn-ui/evals/componentVerification.json +19 -0
- package/skills/frontend/shadcn-ui/references/aiComponentsCatalog.md +51 -0
- package/skills/frontend/shadcn-ui/references/apiReference.md +3 -0
- package/skills/frontend/shadcn-ui/references/blocksCatalog.md +32 -0
- package/skills/frontend/shadcn-ui/references/cliCommands.md +47 -0
- package/skills/frontend/shadcn-ui/references/componentMarkdownSources.md +48 -0
- package/skills/frontend/shadcn-ui/scripts/fetchComponentDocs.py +43 -0
- package/skills/frontend/tsxReactStandard/SKILL.md +150 -0
- package/skills/frontend/tsxReactStandard/evals/tsxVerification.json +14 -0
- package/skills/frontend/tsxReactStandard/references/apiReference.md +3 -0
- package/skills/frontend/tsxReactStandard/references/discriminatedUnions.md +31 -0
- package/skills/frontend/tsxReactStandard/references/tsconfigStrict.md +36 -0
- package/skills/frontend/tsxReactStandard/scripts/validateTsxTypes.py +44 -0
- package/skills/gitVersionControl/gitWorkflow/SKILL.md +128 -0
- package/skills/gitVersionControl/gitWorkflow/assets/README.md +23 -0
- package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-environment.md +87 -0
- package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-formatting.md +156 -0
- package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-reference.md +2363 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-git.md +156 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-remote-repositories.md +65 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/associating-text-editors-with-git.md +93 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/caching-your-github-credentials.md +115 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/getting-changes-from-a-remote-repository.md +76 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/ignoring-files.md +51 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/managing-remote-repositories.md +231 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/pushing-commits-to-a-remote-repository.md +119 -0
- package/skills/gitVersionControl/gitWorkflow/evals/evalGitWorkflow.py +43 -0
- package/skills/gitVersionControl/gitWorkflow/references/apiReference.md +3 -0
- package/skills/gitVersionControl/gitWorkflow/references/branchingModels.md +32 -0
- package/skills/gitVersionControl/gitWorkflow/scripts/diagnoseGitGraph.py +68 -0
- package/skills/github/assets/README.md +39 -0
- package/skills/github/assets/cli/gh-environment.md +87 -0
- package/skills/github/assets/cli/gh-formatting.md +156 -0
- package/skills/github/assets/cli/gh-reference.md +2363 -0
- package/skills/github/assets/docs-api/github-docs-api.md +60 -0
- package/skills/github/assets/rest-api/actions-secrets.md +1272 -0
- package/skills/github/assets/rest-api/actions-variables.md +1247 -0
- package/skills/github/assets/rest-api/actions-workflow-runs.md +1697 -0
- package/skills/github/assets/rest-api/actions-workflows.md +348 -0
- package/skills/github/assets/rest-api/authenticating.md +174 -0
- package/skills/github/assets/rest-api/branches.md +727 -0
- package/skills/github/assets/rest-api/checks-runs.md +1013 -0
- package/skills/github/assets/rest-api/checks-suites.md +1142 -0
- package/skills/github/assets/rest-api/code-scanning.md +2957 -0
- package/skills/github/assets/rest-api/collaborators.md +547 -0
- package/skills/github/assets/rest-api/commits.md +957 -0
- package/skills/github/assets/rest-api/dependabot-alerts.md +895 -0
- package/skills/github/assets/rest-api/orgs.md +1172 -0
- package/skills/github/assets/rest-api/overview.md +875 -0
- package/skills/github/assets/rest-api/pull-reviews.md +722 -0
- package/skills/github/assets/rest-api/pulls.md +1605 -0
- package/skills/github/assets/rest-api/quickstart.md +344 -0
- package/skills/github/assets/rest-api/releases.md +650 -0
- package/skills/github/assets/rest-api/repos.md +2957 -0
- package/skills/github/assets/rest-api/rules.md +1507 -0
- package/skills/github/assets/rest-api/secret-scanning.md +947 -0
- package/skills/github/assets/rest-api/teams.md +1690 -0
- package/skills/github/githubAction/SKILL.md +159 -0
- package/skills/github/githubAction/assets/README.md +38 -0
- package/skills/github/githubAction/assets/reference/contexts.md +918 -0
- package/skills/github/githubAction/assets/reference/dependency-caching.md +393 -0
- package/skills/github/githubAction/assets/reference/events-that-trigger-workflows.md +1348 -0
- package/skills/github/githubAction/assets/reference/expressions.md +441 -0
- package/skills/github/githubAction/assets/reference/metadata-syntax.md +803 -0
- package/skills/github/githubAction/assets/reference/variables.md +149 -0
- package/skills/github/githubAction/assets/reference/workflow-cancellation.md +22 -0
- package/skills/github/githubAction/assets/reference/workflow-commands.md +1056 -0
- package/skills/github/githubAction/assets/reference/workflow-syntax.md +1721 -0
- package/skills/github/githubAction/assets/rest-api/secrets.md +1272 -0
- package/skills/github/githubAction/assets/rest-api/workflow-runs.md +1697 -0
- package/skills/github/githubAction/assets/rest-api/workflows.md +348 -0
- package/skills/github/githubAction/assets/starter-workflows/automation/stale.yml +27 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/blank.yml +36 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/docker-image.yml +18 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/go.yml +28 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/maven.yml +35 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/node.js.yml +31 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/python-app.yml +39 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/rust.yml +22 -0
- package/skills/github/githubAction/assets/starter-workflows/code-scanning/codeql.yml +97 -0
- package/skills/github/githubAction/evals/actionVerification.json +14 -0
- package/skills/github/githubAction/references/apiReference.md +3 -0
- package/skills/github/githubAction/references/workflowPatterns.md +81 -0
- package/skills/github/githubAction/scripts/validateWorkflowYaml.py +53 -0
- package/skills/github/githubQuality/SKILL.md +136 -0
- package/skills/github/githubQuality/assets/README.md +24 -0
- package/skills/github/githubQuality/assets/pull-requests/about-code-owners.md +178 -0
- package/skills/github/githubQuality/assets/pull-requests/about-merge-methods.md +48 -0
- package/skills/github/githubQuality/assets/pull-requests/creating-a-pull-request.md +170 -0
- package/skills/github/githubQuality/assets/pull-requests/giving-reviews.md +48 -0
- package/skills/github/githubQuality/assets/pull-requests/managing-a-merge-queue.md +134 -0
- package/skills/github/githubQuality/assets/pull-requests/merging-a-pull-request.md +101 -0
- package/skills/github/githubQuality/assets/pull-requests/resolving-reviews.md +59 -0
- package/skills/github/githubQuality/assets/pull-requests/status-checks.md +135 -0
- package/skills/github/githubQuality/assets/rest-api/checks-runs.md +1013 -0
- package/skills/github/githubQuality/assets/rest-api/checks-suites.md +1142 -0
- package/skills/github/githubQuality/assets/rest-api/commits.md +957 -0
- package/skills/github/githubQuality/assets/rest-api/pulls.md +1605 -0
- package/skills/github/githubQuality/assets/rest-api/reviews.md +722 -0
- package/skills/github/githubQuality/evals/qualityVerification.json +14 -0
- package/skills/github/githubQuality/references/apiReference.md +3 -0
- package/skills/github/githubQuality/references/codeownersExample.md +26 -0
- package/skills/github/githubQuality/references/prTemplate.md +20 -0
- package/skills/github/githubQuality/scripts/auditPrQuality.py +52 -0
- package/skills/github/githubSecurity/SKILL.md +170 -0
- package/skills/github/githubSecurity/assets/README.md +32 -0
- package/skills/github/githubSecurity/assets/code-scanning/code-scanning-alerts.md +133 -0
- package/skills/github/githubSecurity/assets/code-scanning/code-scanning.md +67 -0
- package/skills/github/githubSecurity/assets/code-scanning/codeql-code-scanning.md +79 -0
- package/skills/github/githubSecurity/assets/code-scanning/configure-code-scanning.md +121 -0
- package/skills/github/githubSecurity/assets/dependabot/about-the-dependabot-yml-file.md +74 -0
- package/skills/github/githubSecurity/assets/dependabot/dependabot-alerts.md +133 -0
- package/skills/github/githubSecurity/assets/dependabot/dependabot-security-updates.md +95 -0
- package/skills/github/githubSecurity/assets/dependabot/dependabot-version-updates.md +80 -0
- package/skills/github/githubSecurity/assets/rest-api/code-scanning.md +2957 -0
- package/skills/github/githubSecurity/assets/rest-api/dependabot-alerts.md +895 -0
- package/skills/github/githubSecurity/assets/rest-api/secret-scanning.md +947 -0
- package/skills/github/githubSecurity/assets/secret-scanning/enable-secret-scanning.md +59 -0
- package/skills/github/githubSecurity/assets/secret-scanning/secret-scanning.md +105 -0
- package/skills/github/githubSecurity/assets/security-advisories/github-advisory-database.md +148 -0
- package/skills/github/githubSecurity/evals/securityVerification.json +14 -0
- package/skills/github/githubSecurity/references/apiReference.md +3 -0
- package/skills/github/githubSecurity/references/codeqlAnalysis.yml +42 -0
- package/skills/github/githubSecurity/references/dependabotConfig.yml +27 -0
- package/skills/github/githubSecurity/scripts/auditRepoSecurity.py +47 -0
- package/skills/github/githubSetup/SKILL.md +137 -0
- package/skills/github/githubSetup/assets/README.md +40 -0
- package/skills/github/githubSetup/assets/branches/about-protected-branches.md +198 -0
- package/skills/github/githubSetup/assets/branches/changing-the-default-branch.md +49 -0
- package/skills/github/githubSetup/assets/branches/deleting-and-restoring-branches.md +44 -0
- package/skills/github/githubSetup/assets/branches/managing-a-branch-protection-rule.md +115 -0
- package/skills/github/githubSetup/assets/branches/renaming-a-branch.md +74 -0
- package/skills/github/githubSetup/assets/branches/viewing-branches-in-your-repository.md +30 -0
- package/skills/github/githubSetup/assets/repositories/about-repositories.md +127 -0
- package/skills/github/githubSetup/assets/repositories/cloning-a-repository.md +114 -0
- package/skills/github/githubSetup/assets/repositories/creating-a-new-repository.md +82 -0
- package/skills/github/githubSetup/assets/repositories/creating-a-repository-from-a-template.md +51 -0
- package/skills/github/githubSetup/assets/repositories/deleting-a-repository.md +34 -0
- package/skills/github/githubSetup/assets/repositories/managing-teams-and-people-with-access.md +69 -0
- package/skills/github/githubSetup/assets/repositories/renaming-a-repository.md +47 -0
- package/skills/github/githubSetup/assets/repositories/restoring-a-deleted-repository.md +61 -0
- package/skills/github/githubSetup/assets/repositories/setting-repository-visibility.md +137 -0
- package/skills/github/githubSetup/assets/rest-api/branches.md +727 -0
- package/skills/github/githubSetup/assets/rest-api/quickstart.md +344 -0
- package/skills/github/githubSetup/assets/rest-api/repos.md +2957 -0
- package/skills/github/githubSetup/assets/rulesets/about-rulesets.md +72 -0
- package/skills/github/githubSetup/assets/rulesets/available-rules-for-rulesets.md +383 -0
- package/skills/github/githubSetup/assets/rulesets/converting-branch-protections-to-rulesets.md +92 -0
- package/skills/github/githubSetup/assets/rulesets/creating-rulesets-for-a-repository.md +108 -0
- package/skills/github/githubSetup/assets/rulesets/managing-rulesets-for-a-repository.md +149 -0
- package/skills/github/githubSetup/assets/rulesets/troubleshooting-rules.md +122 -0
- package/skills/github/githubSetup/evals/setupVerification.json +14 -0
- package/skills/github/githubSetup/references/apiReference.md +3 -0
- package/skills/github/githubSetup/references/repoSettingsBlueprint.md +13 -0
- package/skills/github/githubSetup/references/rulesetTemplates.json +42 -0
- package/skills/github/githubSetup/scripts/configureRepoBaseline.py +46 -0
- package/skills/github/githubTeam/SKILL.md +115 -0
- package/skills/github/githubTeam/assets/README.md +21 -0
- package/skills/github/githubTeam/assets/organizations/about-organizations.md +69 -0
- package/skills/github/githubTeam/assets/organizations/repository-roles-for-an-organization.md +94 -0
- package/skills/github/githubTeam/assets/rest-api/collaborators.md +547 -0
- package/skills/github/githubTeam/assets/rest-api/orgs.md +1172 -0
- package/skills/github/githubTeam/assets/rest-api/teams.md +1690 -0
- package/skills/github/githubTeam/assets/teams/about-teams.md +82 -0
- package/skills/github/githubTeam/assets/teams/adding-members-to-a-team.md +55 -0
- package/skills/github/githubTeam/evals/teamVerification.json +14 -0
- package/skills/github/githubTeam/references/apiReference.md +3 -0
- package/skills/github/githubTeam/references/permissionMatrix.md +17 -0
- package/skills/github/githubTeam/references/reviewAssignment.md +17 -0
- package/skills/github/githubTeam/scripts/manageTeamSync.py +31 -0
- package/skills/securityQa/llmSecurityRedteaming/SKILL.md +86 -0
- package/skills/securityQa/llmSecurityRedteaming/evals/securityRedteamVerification.json +14 -0
- package/skills/securityQa/llmSecurityRedteaming/references/apiReference.md +3 -0
- package/skills/securityQa/llmSecurityRedteaming/references/jailbreakTaxonomy.md +6 -0
- package/skills/securityQa/llmSecurityRedteaming/references/owaspLlmTopTen.md +12 -0
- package/skills/securityQa/llmSecurityRedteaming/scripts/testPromptInjection.py +34 -0
- package/skills/softwareDevelopment/requirementsEngineering/SKILL.md +110 -0
- package/skills/softwareDevelopment/requirementsEngineering/evals/evalRequirements.py +33 -0
- package/skills/softwareDevelopment/requirementsEngineering/references/apiReference.md +3 -0
- package/skills/softwareDevelopment/requirementsEngineering/references/requirementsAnalysisModels.md +34 -0
- package/skills/softwareDevelopment/requirementsEngineering/scripts/validateUserStories.py +49 -0
- package/skills/testing/testDrivenDevelopment/SKILL.md +122 -0
- package/skills/testing/testDrivenDevelopment/evals/evalTdd.py +25 -0
- package/skills/testing/testDrivenDevelopment/references/apiReference.md +3 -0
- package/skills/testing/testDrivenDevelopment/references/testPyramidDoubles.md +35 -0
- package/skills/testing/testDrivenDevelopment/scripts/auditTestPyramid.py +58 -0
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
runHybridRrfSearch.py
|
|
4
|
+
Self-contained Reciprocal Rank Fusion (RRF) ranker utility for merging search results.
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
import json
|
|
8
|
+
import argparse
|
|
9
|
+
|
|
10
|
+
def rrf(bm25_list, vector_list, k=60, top_n=5):
|
|
11
|
+
scores = {}
|
|
12
|
+
docs = {}
|
|
13
|
+
|
|
14
|
+
for rank, doc in enumerate(bm25_list, 1):
|
|
15
|
+
doc_id = doc["id"]
|
|
16
|
+
docs[doc_id] = doc
|
|
17
|
+
scores[doc_id] = scores.get(doc_id, 0.0) + (1.0 / (k + rank))
|
|
18
|
+
|
|
19
|
+
for rank, doc in enumerate(vector_list, 1):
|
|
20
|
+
doc_id = doc["id"]
|
|
21
|
+
docs[doc_id] = doc
|
|
22
|
+
scores[doc_id] = scores.get(doc_id, 0.0) + (1.0 / (k + rank))
|
|
23
|
+
|
|
24
|
+
ranked = sorted(scores.keys(), key=lambda x: scores[x], reverse=True)
|
|
25
|
+
return [{"id": d_id, "score": scores[d_id], "text": docs[d_id].get("text", "")} for d_id in ranked[:top_n]]
|
|
26
|
+
|
|
27
|
+
if __name__ == "__main__":
|
|
28
|
+
# Quick self-test
|
|
29
|
+
bm25_mock = [{"id": "doc1", "text": "Error ERR-901 in database"}, {"id": "doc2", "text": "Setup configuration"}]
|
|
30
|
+
vector_mock = [{"id": "doc3", "text": "Connection troubleshooting"}, {"id": "doc1", "text": "Error ERR-901 in database"}]
|
|
31
|
+
|
|
32
|
+
fused = rrf(bm25_mock, vector_mock, k=60, top_n=2)
|
|
33
|
+
print(f"Fused RRF Top Result: {fused[0]['id']} with score {fused[0]['score']:.4f}")
|
|
@@ -0,0 +1,282 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cloudflare
|
|
3
|
+
description: Master Cloudflare engineering guide. Architect, scaffold, implement, deploy, and troubleshoot applications across the entire Cloudflare ecosystem (Workers, Static Assets, D1, R2, KV, Durable Objects, Queues, Workflows, Hyperdrive, Vectorize, WAF, Tunnels, Workers AI, and Agents SDK). Supports both Wrangler CLI and cf CLI.
|
|
4
|
+
version: 2026.x
|
|
5
|
+
last-verified: 2026-11-17
|
|
6
|
+
compatibility: Workers runtime (workerd), Wrangler v3+, cf CLI (beta), TypeScript 5+, Node.js 20+
|
|
7
|
+
slash-commands:
|
|
8
|
+
- command: /cf-architect
|
|
9
|
+
description: End-to-end Cloudflare system design, product selection, and cost estimation
|
|
10
|
+
argument-hint: "[--workload=fullstack|api|ai|storage|iot]"
|
|
11
|
+
- command: /cf-worker
|
|
12
|
+
description: Scaffold and configure Cloudflare Workers with Static Assets and Service Bindings
|
|
13
|
+
argument-hint: "[--entry=src/index.ts] [--assets=./dist]"
|
|
14
|
+
- command: /cf-database
|
|
15
|
+
description: Schema design, migrations, and bindings for D1, Hyperdrive, or Vectorize
|
|
16
|
+
argument-hint: "[--engine=d1|hyperdrive|vectorize]"
|
|
17
|
+
- command: /cf-storage
|
|
18
|
+
description: State and storage architecture for R2, KV, Durable Objects, Queues, or Workflows
|
|
19
|
+
argument-hint: "[--type=r2|kv|do|queues|workflows]"
|
|
20
|
+
- command: /cf-security
|
|
21
|
+
description: Cloudflare WAF, Rate Limiting, Zero Trust Tunnels, and DNS configuration
|
|
22
|
+
argument-hint: "[--domain=example.com]"
|
|
23
|
+
- command: /cf-ai
|
|
24
|
+
description: Workers AI, AI Gateway, Agents SDK, and Vectorize implementation
|
|
25
|
+
argument-hint: "[--model=@cf/meta/llama-3.3-70b-instruct]"
|
|
26
|
+
- command: /cf-troubleshoot
|
|
27
|
+
description: Diagnose proxied HTTP errors (52x status, 1xxx error codes, WAF 403 blocks)
|
|
28
|
+
argument-hint: "[--status=522|524|1020|403]"
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
# Cloudflare Master Engineering Guide (2026)
|
|
32
|
+
|
|
33
|
+
Cloudflare is a unified global developer platform built on V8 isolates, anycast networking, and distributed storage primitives. It eliminates traditional container cold starts, delivers sub-10ms response times worldwide, and provides zero-egress object storage and serverless SQL.
|
|
34
|
+
|
|
35
|
+
> [!IMPORTANT]
|
|
36
|
+
> **Zero-Hallucination Protocol**: Always consult local offline documentation in [`assets/`](assets/README.md) and official deep product references in [`references/`](references/) before generating configuration, bindings, or CLI commands.
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## 1. Cloudflare Platform Architecture
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
CLOUDFLARE EDGE (300+ Cities)
|
|
44
|
+
┌─────────────────────────────────────────────────────────────────────────────────────────────┐
|
|
45
|
+
│ Anycast DNS ──► WAF / DDoS Mitigation ──► Edge Cache / CDN ──► Cloudflare Workers (workerd) │
|
|
46
|
+
│ │ │
|
|
47
|
+
│ ┌────────────────────┬────────────────────┬────────────────────┐ │ │
|
|
48
|
+
│ ▼ ▼ ▼ ▼ │ │
|
|
49
|
+
│ D1 SQL KV Store R2 Storage Durable │ │
|
|
50
|
+
│ (SQLite Replica) (Global Read-Heavy) (Zero-Egress Object) Objects │ │
|
|
51
|
+
│ │ │
|
|
52
|
+
│ ┌────────────────────┬────────────────────┬────────────────────┐ │ │
|
|
53
|
+
│ ▼ ▼ ▼ ▼ │ │
|
|
54
|
+
│ Hyperdrive Queues Workflows Workers │ │
|
|
55
|
+
│ (Postgres Accel) (Async Batching) (Durable Steps) AI (GPUs) │ │
|
|
56
|
+
└────────────────────────────────────────────────────────────────────────┴────────────────────┘
|
|
57
|
+
│ (Outbound Encrypted WireGuard)
|
|
58
|
+
▼
|
|
59
|
+
Cloudflare Tunnel (cloudflared)
|
|
60
|
+
│
|
|
61
|
+
Origin Servers / VPC / Docker
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
1. **V8 Isolates (`workerd`)**: Workers run in lightweight V8 isolates instead of Docker containers. Cold starts are under 5ms, memory overhead is microscopic (< 5 MB), and compute scales automatically across 300+ data centers.
|
|
65
|
+
2. **Global Anycast Network**: Traffic hits the closest geographic data center automatically without regional load balancers.
|
|
66
|
+
3. **Workers Static Assets (Modern Replacement for Pages)**: Serve static SPAs, frontend bundles, and static files directly from CDN edge storage while combining dynamic serverless logic in the same worker.
|
|
67
|
+
4. **Service Bindings**: Direct memory-to-memory RPC calls between separate Workers with zero HTTP serialization, zero DNS lookups, and zero network latency.
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## 2. CLI Strategy: `wrangler` vs `cf` CLI
|
|
72
|
+
|
|
73
|
+
Cloudflare operates two official CLIs in 2026:
|
|
74
|
+
|
|
75
|
+
| Scenario | Tool to Choose | Reason |
|
|
76
|
+
| :--- | :--- | :--- |
|
|
77
|
+
| **Existing Worker with `wrangler.jsonc` or `wrangler.toml`** | **`wrangler`** | Preserve existing deployment pipeline and scripts. |
|
|
78
|
+
| **New Full-Stack App (Next.js, Astro, Remix, SvelteKit)** | **`wrangler`** (`npm create cloudflare@latest`) | Framework adapters (OpenNext, Astro) currently hook into Wrangler build targets. |
|
|
79
|
+
| **Account-Level Infrastructure (DNS, Tunnels, WAF, AI Gateway)** | **`cf` CLI** | Declarative multi-resource management across your entire account. |
|
|
80
|
+
| **AI Coding Agent Workflows / MCP** | **`cf` CLI** + **Cloudflare MCP** | Machine-readable outputs and `cf cli search` command discovery. |
|
|
81
|
+
|
|
82
|
+
> [!TIP]
|
|
83
|
+
> Do not mix CLIs haphazardly within a single project. Use `wrangler` for worker code and deployment; use `cf` for account-wide infrastructure orchestration.
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## 3. Product Selection Decision Tree
|
|
88
|
+
|
|
89
|
+
Consult [`references/productSelectionMatrix.md`](references/productSelectionMatrix.md) for full trade-off specifications:
|
|
90
|
+
|
|
91
|
+
- **Relational SQL**: Use **D1** for native serverless SQLite with read replication. Use **Hyperdrive** when connecting to existing external PostgreSQL/MySQL to pool connections and cache queries at the edge.
|
|
92
|
+
- **Key-Value Data**: Use **KV** for low-write, massive-read global caches (e.g. feature flags, auth config, redirect tables). Eventual consistency converges globally in ~60s.
|
|
93
|
+
- **Blob / File Storage**: Use **R2** for images, videos, backups, and user uploads. Zero egress fees and full S3 API compatibility.
|
|
94
|
+
- **Stateful Actors & WebSockets**: Use **Durable Objects (DO)** when you need strong serializable consistency, in-memory coordination, distributed mutex locks, or persistent WebSocket connections.
|
|
95
|
+
- **Asynchronous Decoupling**: Use **Queues** for fire-and-forget message processing with automatic batching, dead-letter queues, and retries.
|
|
96
|
+
- **Durable Step Pipelines**: Use **Workflows** for multi-step jobs that sleep for hours/days, require deterministic retries, or coordinate external human approval.
|
|
97
|
+
- **AI & Vector Embeddings**: Use **Workers AI** for on-demand GPU inference (Llama, DeepSeek, Whisper) and **Vectorize** for low-latency similarity search.
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## 4. Modern Configuration Standard (`wrangler.jsonc`)
|
|
102
|
+
|
|
103
|
+
Always use `wrangler.jsonc` (JSON with comments) over legacy `wrangler.toml`:
|
|
104
|
+
|
|
105
|
+
```jsonc
|
|
106
|
+
{
|
|
107
|
+
"$schema": "node_modules/wrangler/config-schema.json",
|
|
108
|
+
"name": "enterprise-api",
|
|
109
|
+
"main": "src/index.ts",
|
|
110
|
+
"compatibility_date": "2026-11-01",
|
|
111
|
+
"compatibility_flags": ["nodejs_compat"],
|
|
112
|
+
|
|
113
|
+
// 1. Static Assets (SPA / Frontend)
|
|
114
|
+
"assets": {
|
|
115
|
+
"directory": "./dist",
|
|
116
|
+
"binding": "ASSETS",
|
|
117
|
+
"html_handling": "auto-trailing-slash",
|
|
118
|
+
"not_found_handling": "single-page-application"
|
|
119
|
+
},
|
|
120
|
+
|
|
121
|
+
// 2. D1 Relational Database
|
|
122
|
+
"d1_databases": [
|
|
123
|
+
{
|
|
124
|
+
"binding": "DB",
|
|
125
|
+
"database_name": "production-db",
|
|
126
|
+
"database_id": "xxxx-xxxx-xxxx-xxxx"
|
|
127
|
+
}
|
|
128
|
+
],
|
|
129
|
+
|
|
130
|
+
// 3. R2 Object Storage
|
|
131
|
+
"r2_buckets": [
|
|
132
|
+
{
|
|
133
|
+
"binding": "STORAGE",
|
|
134
|
+
"bucket_name": "user-media-production"
|
|
135
|
+
}
|
|
136
|
+
],
|
|
137
|
+
|
|
138
|
+
// 4. KV Namespace
|
|
139
|
+
"kv_namespaces": [
|
|
140
|
+
{
|
|
141
|
+
"binding": "CONFIG_KV",
|
|
142
|
+
"id": "yyyy-yyyy-yyyy-yyyy"
|
|
143
|
+
}
|
|
144
|
+
],
|
|
145
|
+
|
|
146
|
+
// 5. Workers AI
|
|
147
|
+
"ai": {
|
|
148
|
+
"binding": "AI"
|
|
149
|
+
},
|
|
150
|
+
|
|
151
|
+
// 6. Service Binding (RPC to microservice)
|
|
152
|
+
"services": [
|
|
153
|
+
{
|
|
154
|
+
"binding": "AUTH_SERVICE",
|
|
155
|
+
"service": "auth-microservice"
|
|
156
|
+
}
|
|
157
|
+
]
|
|
158
|
+
}
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
---
|
|
162
|
+
|
|
163
|
+
## 5. Implementation Standard Patterns
|
|
164
|
+
|
|
165
|
+
### A. Core Worker ESM Entrypoint (`src/index.ts`)
|
|
166
|
+
```typescript
|
|
167
|
+
import { WorkerEntrypoint } from 'cloudflare:workers';
|
|
168
|
+
|
|
169
|
+
export interface Env {
|
|
170
|
+
DB: D1Database;
|
|
171
|
+
STORAGE: R2Bucket;
|
|
172
|
+
CONFIG_KV: KVNamespace;
|
|
173
|
+
AI: Ai;
|
|
174
|
+
AUTH_SERVICE: Service<AuthService>;
|
|
175
|
+
JWT_SECRET: string; // Secret set via `wrangler secret put`
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
export default {
|
|
179
|
+
async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
|
|
180
|
+
const url = new URL(request.url);
|
|
181
|
+
|
|
182
|
+
// 1. Query D1 with parameterized SQL
|
|
183
|
+
if (url.pathname === '/api/users') {
|
|
184
|
+
const { results } = await env.DB.prepare('SELECT id, name, email FROM users LIMIT ?').bind(20).all();
|
|
185
|
+
return Response.json(results);
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
// 2. Serve / upload to R2
|
|
189
|
+
if (url.pathname.startsWith('/api/files/')) {
|
|
190
|
+
const key = url.pathname.replace('/api/files/', '');
|
|
191
|
+
if (request.method === 'PUT') {
|
|
192
|
+
await env.STORAGE.put(key, request.body);
|
|
193
|
+
return new Response('Uploaded', { status: 201 });
|
|
194
|
+
}
|
|
195
|
+
const object = await env.STORAGE.get(key);
|
|
196
|
+
if (!object) return new Response('Not Found', { status: 404 });
|
|
197
|
+
return new Response(object.body);
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
// 3. Run AI Inference on Cloudflare GPUs
|
|
201
|
+
if (url.pathname === '/api/chat') {
|
|
202
|
+
const { prompt } = await request.json<{ prompt: string }>();
|
|
203
|
+
const response = await env.AI.run('@cf/meta/llama-3.3-70b-instruct', {
|
|
204
|
+
messages: [{ role: 'user', content: prompt }],
|
|
205
|
+
});
|
|
206
|
+
return Response.json(response);
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
// Fallback to static assets
|
|
210
|
+
return env.ASSETS ? env.ASSETS.fetch(request) : new Response('Not Found', { status: 404 });
|
|
211
|
+
},
|
|
212
|
+
|
|
213
|
+
// Background Cron Trigger handler
|
|
214
|
+
async scheduled(event: ScheduledEvent, env: Env, ctx: ExecutionContext): Promise<void> {
|
|
215
|
+
ctx.waitUntil(cleanupStaleSessions(env.DB));
|
|
216
|
+
},
|
|
217
|
+
};
|
|
218
|
+
|
|
219
|
+
async function cleanupStaleSessions(db: D1Database) {
|
|
220
|
+
await db.prepare('DELETE FROM sessions WHERE expires_at < ?').bind(Date.now()).run();
|
|
221
|
+
}
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
---
|
|
225
|
+
|
|
226
|
+
## 6. HTTP Status & Error Troubleshooting Guide
|
|
227
|
+
|
|
228
|
+
When debugging proxied sites, identify whether the issue is at the Cloudflare Edge or Origin:
|
|
229
|
+
|
|
230
|
+
| Code / Status | Meaning | Source | Actionable Fix |
|
|
231
|
+
| :--- | :--- | :--- | :--- |
|
|
232
|
+
| **`520`** | Web Server Returned Unknown Error | Origin | Origin server returned an empty, malformed, or invalid response. Check origin web server logs (Nginx/Apache/Node). |
|
|
233
|
+
| **`521`** | Web Server Is Down | Origin | Origin server refused TCP connection on port 80/443. Check if server process crashed, or firewall dropped Cloudflare IPs. |
|
|
234
|
+
| **`522`** | Connection Timed Out | Network | Cloudflare could not complete TCP handshake with origin within 15 seconds. Check firewall, routing, or overload. |
|
|
235
|
+
| **`523`** | Origin Is Unreachable | DNS/Network | Cloudflare cannot resolve origin IP or route to it. Verify DNS A/AAAA records in Cloudflare dashboard. |
|
|
236
|
+
| **`524`** | A Timeout Occurred | Origin | TCP connected, but origin did not send HTTP response within 100 seconds (Enterprise configurable). Offload to Queues. |
|
|
237
|
+
| **`525`** | SSL Handshake Failed | TLS | SSL handshake failed between Cloudflare and origin. Verify origin certificate and check SSL/TLS encryption mode (Full Strict). |
|
|
238
|
+
| **`526`** | Invalid SSL Certificate | TLS | Cloudflare SSL mode is **Full (Strict)**, but origin certificate is self-signed or expired. Renew cert or install Cloudflare Origin CA. |
|
|
239
|
+
| **`1020`** / **WAF 403** | Access Denied | Cloudflare Edge | Blocked by WAF Custom Rule, Bot Management, or IP Access Rule. Check Security Events for the Ray ID. |
|
|
240
|
+
|
|
241
|
+
---
|
|
242
|
+
|
|
243
|
+
## 7. Production Checklist & Quality Standards
|
|
244
|
+
|
|
245
|
+
- [ ] **Lock Compatibility Date**: Pin `compatibility_date` (e.g. `"2026-11-01"`) and test upgrades in preview environments.
|
|
246
|
+
- [ ] **Strict Secrets Management**: Never commit API keys, database credentials, or tokens to git. Use `npx wrangler secret put <NAME>` or Cloudflare Secrets Store.
|
|
247
|
+
- [ ] **Zero-Trust Ingress**: Use Cloudflare Tunnel (`cloudflared`) to connect private origins without opening public ingress ports.
|
|
248
|
+
- [ ] **Parameterized SQL**: Always bind D1 queries using `.bind(...)`. Never concatenate raw strings into SQL.
|
|
249
|
+
- [ ] **Smart Placement**: Enable `"smart_placement": { "enabled": true }` when Workers make multiple roundtrips to an origin backend.
|
|
250
|
+
- [ ] **Observability**: Enable Workers Logs (`wrangler tail`) and configure Workers Analytics Engine for high-cardinality telemetry.
|
|
251
|
+
- [ ] **Fail-Safe Retries**: Wrap external fetches with timeout controllers (`AbortSignal.timeout(5000)`) to prevent 524 timeouts.
|
|
252
|
+
|
|
253
|
+
---
|
|
254
|
+
|
|
255
|
+
## 8. Anti-Patterns to Avoid
|
|
256
|
+
|
|
257
|
+
| Anti-Pattern | Why It Fails | Correct Cloudflare Pattern |
|
|
258
|
+
| :--- | :--- | :--- |
|
|
259
|
+
| Using deprecated Cloudflare Pages for new projects | Missing modern Workers features & bindings | Use **Workers Static Assets** (`"assets": { "directory": "..." }`) |
|
|
260
|
+
| Hardcoding secrets in `wrangler.jsonc` | Exposes credentials in version control | Use `wrangler secret put` or Cloudflare Secrets Store |
|
|
261
|
+
| String concatenating SQL in D1 queries | SQL injection vulnerability | Always use `db.prepare('... WHERE id = ?').bind(id)` |
|
|
262
|
+
| Unbounded in-memory variables across requests | Isolate re-use is non-deterministic | Store persistent state in D1, KV, R2, or Durable Objects |
|
|
263
|
+
| Connecting directly to Postgres/MySQL from edge | Exhausts connection pool across 300+ edge nodes | Use **Hyperdrive** connection pooling |
|
|
264
|
+
| Long-running HTTP requests (> 100s) | Cloudflare proxy terminates with Error 524 | Decouple via **Queues** or **Workflows** |
|
|
265
|
+
|
|
266
|
+
---
|
|
267
|
+
|
|
268
|
+
## 9. Offline Documentation & References
|
|
269
|
+
|
|
270
|
+
- [Root Documentation Sitemap (`llms.txt`)](assets/llms.txt)
|
|
271
|
+
- [Wrangler CLI Reference](assets/cli/wrangler.md)
|
|
272
|
+
- [Workers Runtime API](assets/compute/workers.md)
|
|
273
|
+
- [Workers Static Assets](assets/compute/static-assets.md)
|
|
274
|
+
- [D1 SQL Database Reference](assets/database-storage/d1.md)
|
|
275
|
+
- [R2 Object Storage Reference](assets/database-storage/r2.md)
|
|
276
|
+
- [Durable Objects Reference](assets/database-storage/durable-objects.md)
|
|
277
|
+
- [Workers AI Reference](assets/ai/workers-ai.md)
|
|
278
|
+
- [Cloudflare Tunnel Reference](assets/networking-security/tunnels.md)
|
|
279
|
+
- [HTTP Status Codes Troubleshooting](assets/troubleshooting/http-status-codes.md)
|
|
280
|
+
- [Product Selection Matrix](references/productSelectionMatrix.md)
|
|
281
|
+
- [CLI Comparison & Migration Guide](references/cliComparison.md)
|
|
282
|
+
- [Framework Compatibility](references/frameworkCompatibility.md)
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# Cloudflare Developer Platform Offline Documentation Catalog
|
|
2
|
+
|
|
3
|
+
> High-accuracy local documentation mirrored from official Cloudflare documentation (`developers.cloudflare.com`).
|
|
4
|
+
> All documentation is official un-truncated markdown indexed by `llms.txt`.
|
|
5
|
+
|
|
6
|
+
## 📚 Navigation Sitemap
|
|
7
|
+
|
|
8
|
+
- [**`llms.txt` (Root Platform Index)**](llms.txt)
|
|
9
|
+
|
|
10
|
+
### `ai/`
|
|
11
|
+
- [`agents-sdk.md`](ai/agents-sdk.md)
|
|
12
|
+
- [`ai-gateway.md`](ai/ai-gateway.md)
|
|
13
|
+
- [`ai-search.md`](ai/ai-search.md)
|
|
14
|
+
- [`workers-ai.md`](ai/workers-ai.md)
|
|
15
|
+
|
|
16
|
+
### `cli/`
|
|
17
|
+
- [`c3.md`](cli/c3.md)
|
|
18
|
+
- [`cf-cli.md`](cli/cf-cli.md)
|
|
19
|
+
- [`wrangler.md`](cli/wrangler.md)
|
|
20
|
+
|
|
21
|
+
### `compute/`
|
|
22
|
+
- [`cron-triggers.md`](compute/cron-triggers.md)
|
|
23
|
+
- [`service-bindings.md`](compute/service-bindings.md)
|
|
24
|
+
- [`smart-placement.md`](compute/smart-placement.md)
|
|
25
|
+
- [`static-assets.md`](compute/static-assets.md)
|
|
26
|
+
- [`workers.md`](compute/workers.md)
|
|
27
|
+
|
|
28
|
+
### `database-storage/`
|
|
29
|
+
- [`d1.md`](database-storage/d1.md)
|
|
30
|
+
- [`durable-objects.md`](database-storage/durable-objects.md)
|
|
31
|
+
- [`hyperdrive.md`](database-storage/hyperdrive.md)
|
|
32
|
+
- [`kv.md`](database-storage/kv.md)
|
|
33
|
+
- [`queues.md`](database-storage/queues.md)
|
|
34
|
+
- [`r2.md`](database-storage/r2.md)
|
|
35
|
+
- [`vectorize.md`](database-storage/vectorize.md)
|
|
36
|
+
- [`workflows.md`](database-storage/workflows.md)
|
|
37
|
+
|
|
38
|
+
### `networking-security/`
|
|
39
|
+
- [`cache-cdn.md`](networking-security/cache-cdn.md)
|
|
40
|
+
- [`dns.md`](networking-security/dns.md)
|
|
41
|
+
- [`rate-limiting.md`](networking-security/rate-limiting.md)
|
|
42
|
+
- [`tunnels.md`](networking-security/tunnels.md)
|
|
43
|
+
- [`waf.md`](networking-security/waf.md)
|
|
44
|
+
|
|
45
|
+
### `troubleshooting/`
|
|
46
|
+
- [`1xxx-errors.md`](troubleshooting/1xxx-errors.md)
|
|
47
|
+
- [`5xx-errors.md`](troubleshooting/5xx-errors.md)
|
|
48
|
+
- [`http-status-codes.md`](troubleshooting/http-status-codes.md)
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Build and host AI agents on Cloudflare. Run an agent harness in a Durable Object, add capabilities such as state, WebSockets, and scheduling with the Agents SDK Lifecycle, and give the agent tools.
|
|
3
|
+
title: Build Agents on Cloudflare
|
|
4
|
+
image: https://developers.cloudflare.com/agents/og.png?v=5f3790c1b824e669
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
[Skip to content](#main-content)
|
|
8
|
+
|
|
9
|
+
> Documentation Index
|
|
10
|
+
> Fetch the complete documentation index at: https://developers.cloudflare.com/agents/llms.txt
|
|
11
|
+
> Use this file to discover all available pages before exploring further.
|
|
12
|
+
|
|
13
|
+
# Build Agents on Cloudflare
|
|
14
|
+
|
|
15
|
+
Last updated Oct 29, 2026|Copy as Markdown| [View as Markdown](https://developers.cloudflare.com/agents/index.md)| [Agent setup](https://developers.cloudflare.com/agent-setup/)
|
|
16
|
+
|
|
17
|
+
Build and host AI agents on Cloudflare. Connect chat, voice, email, Slack, and webhooks to a durable agent, and give it tools such as a workspace, a browser, web search, MCP servers, and payments.
|
|
18
|
+
|
|
19
|
+
When you host agents on Cloudflare, each agent has a durable identity, local SQL storage, real-time connections, scheduled work, and recoverable execution.
|
|
20
|
+
|
|
21
|
+
Deploy once and Cloudflare runs your agents across its global network, scaling to tens of millions of instances. No infrastructure to manage, no sessions to reconstruct, no state to externalize.
|
|
22
|
+
|
|
23
|
+
[Chat](https://developers.cloudflare.com/agents/agent-class/communication-channels/chat/) [Email](https://developers.cloudflare.com/agents/agent-class/communication-channels/email/) [Voice](https://developers.cloudflare.com/agents/agent-class/communication-channels/voice/) [Slack](https://developers.cloudflare.com/agents/agent-class/communication-channels/slack/) [Webhook](https://developers.cloudflare.com/agents/agent-class/communication-channels/webhooks/)
|
|
24
|
+
|
|
25
|
+
Runtime
|
|
26
|
+
|
|
27
|
+
The Lifecycle provides hooks for Capabilities to schedule durable work.
|
|
28
|
+
|
|
29
|
+
[Lifecycle](https://developers.cloudflare.com/agents/runtime/lifecycle/)
|
|
30
|
+
|
|
31
|
+
[State](https://developers.cloudflare.com/agents/runtime/capabilities/state/) [WebSockets](https://developers.cloudflare.com/agents/runtime/capabilities/websockets/) [Scheduler](https://developers.cloudflare.com/agents/runtime/capabilities/scheduler/) [MCP client](https://developers.cloudflare.com/agents/runtime/capabilities/mcp-client-manager/)
|
|
32
|
+
|
|
33
|
+
Harnesses
|
|
34
|
+
|
|
35
|
+
[Pi](https://developers.cloudflare.com/agents/harnesses/pi/) [OpenCode](https://developers.cloudflare.com/agents/harnesses/opencode/) [Think](https://developers.cloudflare.com/agents/harnesses/think/)
|
|
36
|
+
|
|
37
|
+
[Workspace](https://developers.cloudflare.com/agents/tools/filesystem/) [Sandbox](https://developers.cloudflare.com/agents/tools/sandbox/) [Browser](https://developers.cloudflare.com/agents/tools/browser/) [Web fetch](https://developers.cloudflare.com/agents/tools/web-fetch/) [Web search](https://developers.cloudflare.com/agents/tools/web-search/) [MCP servers](https://developers.cloudflare.com/agents/tools/mcp/) [AI Search](https://developers.cloudflare.com/agents/tools/ai-search/) [Payments](https://developers.cloudflare.com/agents/tools/payments/)
|
|
38
|
+
|
|
39
|
+
[ObservabilityLogs · metrics · traces](https://developers.cloudflare.com/agents/runtime/observability/)
|
|
40
|
+
|
|
41
|
+
Agents on Cloudflare are composed from four parts:
|
|
42
|
+
|
|
43
|
+
- **The runtime is a Durable Object, the Lifecycle, and capabilities.** Each agent is a [Durable Object](https://developers.cloudflare.com/durable-objects/), and [routing](https://developers.cloudflare.com/agents/runtime/routing/) sends each request to the right one. The Agents SDK [Lifecycle](https://developers.cloudflare.com/agents/runtime/lifecycle/) runs inside the Durable Object, handles its requests, alarms, and WebSocket events, and starts the [capabilities](https://developers.cloudflare.com/agents/runtime/capabilities/) you add to it with `.use()`. Capabilities include [`WebSockets`](https://developers.cloudflare.com/agents/runtime/capabilities/websockets/), [`State`](https://developers.cloudflare.com/agents/runtime/capabilities/state/), [`Scheduler`](https://developers.cloudflare.com/agents/runtime/capabilities/scheduler/), and [`MCPClientManager`](https://developers.cloudflare.com/agents/runtime/capabilities/mcp-client-manager/).
|
|
44
|
+
- **The harness is the capability that runs the agent loop.** A harness calls models, runs tools, handles tool results, streams responses, and decides whether to continue. It is the unit of compute for an agent, and the Agents SDK exists to make harnesses run well on Cloudflare. Use the [Pi harness](https://developers.cloudflare.com/agents/harnesses/pi/), which runs the [Pi ↗︎](https://pi.dev/) agent loop durably and keeps a run going after the object is evicted.
|
|
45
|
+
- **Tools** let the agent act. For a durable file system and code execution, give the agent a [workspace](https://developers.cloudflare.com/agents/tools/filesystem/) from Cloudflare Computer. The Agents SDK also includes [web fetch](https://developers.cloudflare.com/agents/tools/web-fetch/), [web search](https://developers.cloudflare.com/agents/tools/web-search/), [browser automation](https://developers.cloudflare.com/agents/tools/browser/), [sandboxed code execution](https://developers.cloudflare.com/agents/tools/sandbox/), [AI Search](https://developers.cloudflare.com/agents/tools/ai-search/), [MCP servers](https://developers.cloudflare.com/agents/tools/mcp/), [payments](https://developers.cloudflare.com/agents/tools/payments/), and [Code Mode](https://developers.cloudflare.com/agents/tools/codemode/).
|
|
46
|
+
- **Communication channels** define how users and systems reach your agent, such as [chat](https://developers.cloudflare.com/agents/agent-class/communication-channels/chat/), [voice](https://developers.cloudflare.com/agents/agent-class/communication-channels/voice/), [email](https://developers.cloudflare.com/agents/agent-class/communication-channels/email/), [Slack](https://developers.cloudflare.com/agents/agent-class/communication-channels/slack/), [webhooks](https://developers.cloudflare.com/agents/agent-class/communication-channels/webhooks/), and other event sources. These guides use the [`Agent` class](https://developers.cloudflare.com/agents/agent-class/), a preset Durable Object with the Lifecycle and a set of capabilities already installed.
|
|
47
|
+
|
|
48
|
+
Agents publish structured events, such as state changes, schedules, and MCP connections, that you can use for [observability](https://developers.cloudflare.com/agents/runtime/observability/).
|
|
49
|
+
|
|
50
|
+
### Get started
|
|
51
|
+
|
|
52
|
+
Build your first agent with the Pi harness. The [Pi harness](https://developers.cloudflare.com/agents/harnesses/pi/) runs the [Pi ↗︎](https://pi.dev/) agent loop durably in a Durable Object. It uses the Lifecycle's job queue to schedule future work, so a run continues after the object is evicted. No API keys are required. The examples use [Workers AI](https://developers.cloudflare.com/workers-ai/) through the `AI` binding.
|
|
53
|
+
|
|
54
|
+
npmyarnpnpmbun
|
|
55
|
+
|
|
56
|
+
```
|
|
57
|
+
npm i agents @earendil-works/pi-durable @earendil-works/pi-ai @earendil-works/pi-schema @earendil-works/chord
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
```
|
|
61
|
+
yarn add agents @earendil-works/pi-durable @earendil-works/pi-ai @earendil-works/pi-schema @earendil-works/chord
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
```
|
|
65
|
+
pnpm add agents @earendil-works/pi-durable @earendil-works/pi-ai @earendil-works/pi-schema @earendil-works/chord
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
```
|
|
69
|
+
bun add agents @earendil-works/pi-durable @earendil-works/pi-ai @earendil-works/pi-schema @earendil-works/chord
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
The Pi packages are optional peer dependencies of `agents`, at `~1.5.0`. Pi Durable is experimental and its API can change in minor releases, so each `agents` release supports one Pi minor version. Install the versions your package manager resolves for `agents`.
|
|
73
|
+
|
|
74
|
+
To start from a complete app with a browser UI, a Cloudflare Computer workspace, and code execution, deploy the Pi harness example:
|
|
75
|
+
|
|
76
|
+
[](https://deploy.workers.cloudflare.com/?url=https://github.com/cloudflare/agents/tree/main/examples/next/harnesses/pi)
|
|
77
|
+
|
|
78
|
+
To build it step by step, follow [Build your first Durable Agent](https://developers.cloudflare.com/agents/getting-started/quick-start/). To learn the Lifecycle, [`State`](https://developers.cloudflare.com/agents/runtime/capabilities/state/), and [`WebSockets`](https://developers.cloudflare.com/agents/runtime/capabilities/websockets/) without a model, refer to [Learn the runtime](https://developers.cloudflare.com/agents/getting-started/learn-the-runtime/). To add the Lifecycle to a Worker you already have, refer to [Add to an existing project](https://developers.cloudflare.com/agents/getting-started/add-to-existing-project/).
|
|
79
|
+
|
|
80
|
+
### Example agents
|
|
81
|
+
|
|
82
|
+
The Pi agent runs on the Pi harness. The other examples build on the [`Agent` class](https://developers.cloudflare.com/agents/agent-class/) preset.
|
|
83
|
+
|
|
84
|
+
[Pi agent](https://developers.cloudflare.com/agents/harnesses/pi/)
|
|
85
|
+
|
|
86
|
+
Build an agent on the Pi harness, with tools, sessions, and recovery after eviction.
|
|
87
|
+
|
|
88
|
+
[Chat agent](https://developers.cloudflare.com/agents/examples/chat-agent/)
|
|
89
|
+
|
|
90
|
+
Build a streaming AI chat agent with tools and human-in-the-loop approvals.
|
|
91
|
+
|
|
92
|
+
[Slack agent](https://developers.cloudflare.com/agents/examples/slack-agent/)
|
|
93
|
+
|
|
94
|
+
Build an agent that responds to Slack messages, mentions, and commands.
|
|
95
|
+
|
|
96
|
+
[Voice agent](https://developers.cloudflare.com/agents/examples/voice-agent/)
|
|
97
|
+
|
|
98
|
+
Build a real-time voice agent with speech-to-text and text-to-speech.
|
|
99
|
+
|
|
100
|
+
[Browser agent](https://developers.cloudflare.com/agents/examples/browser-agent/)
|
|
101
|
+
|
|
102
|
+
Build an agent that can inspect pages, capture screenshots, and use browser tools.
|
|
103
|
+
|
|
104
|
+
[Email agent](https://developers.cloudflare.com/agents/examples/email-agent/)
|
|
105
|
+
|
|
106
|
+
Build an agent that sends, receives, routes, and replies to email.
|
|
107
|
+
|
|
108
|
+
Was this helpful?
|
|
109
|
+
|
|
110
|
+
YesNo
|
|
111
|
+
|
|
112
|
+
## On this page
|
|
113
|
+
|
|
114
|
+
[Docs](https://developers.cloudflare.com/)
|
|
115
|
+
|
|
116
|
+
```json
|
|
117
|
+
{"@context":"https://schema.org","@type":"WebPage","@id":"https://developers.cloudflare.com/agents/#page","headline":"Build Agents on Cloudflare","description":"Build and host AI agents on Cloudflare. Run an agent harness in a Durable Object, add capabilities such as state, WebSockets, and scheduling with the Agents SDK Lifecycle, and give the agent tools.","url":"https://developers.cloudflare.com/agents/","inLanguage":"en","image":"https://developers.cloudflare.com/agents/og.png?v=5f3790c1b824e669","dateModified":"2026-10-29","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"},"keywords":["AI"]}
|
|
118
|
+
```
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Observe and control your AI applications with analytics, caching, rate limiting, and model fallback through AI Gateway.
|
|
3
|
+
title: Cloudflare AI Gateway
|
|
4
|
+
image: https://developers.cloudflare.com/ai-gateway/og.png?v=d9b4c0d9dbab4986
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
[Skip to content](#main-content)
|
|
8
|
+
|
|
9
|
+
> Documentation Index
|
|
10
|
+
> Fetch the complete documentation index at: https://developers.cloudflare.com/ai-gateway/llms.txt
|
|
11
|
+
> Use this file to discover all available pages before exploring further.
|
|
12
|
+
|
|
13
|
+
# Cloudflare AI Gateway
|
|
14
|
+
|
|
15
|
+
Last updated Nov 4, 2026|Copy as Markdown| [View as Markdown](https://developers.cloudflare.com/ai-gateway/index.md)| [Agent setup](https://developers.cloudflare.com/agent-setup/)
|
|
16
|
+
|
|
17
|
+
Observe and control your AI applications.
|
|
18
|
+
|
|
19
|
+
Available on all plans
|
|
20
|
+
|
|
21
|
+
Cloudflare's AI Gateway allows you to gain visibility and control over your AI apps. By connecting your apps to AI Gateway, you can gather insights on how people are using your application with analytics and logging and then control how your application scales with features such as caching, rate limiting, as well as request retries, model fallback, and more. Better yet - it only takes one line of code to get started.
|
|
22
|
+
|
|
23
|
+
Check out the [Get started guide](https://developers.cloudflare.com/ai-gateway/get-started/) to learn how to configure your applications with AI Gateway.
|
|
24
|
+
|
|
25
|
+
## Features
|
|
26
|
+
|
|
27
|
+
[Models](https://developers.cloudflare.com/ai/models/)
|
|
28
|
+
|
|
29
|
+
Explore all AI models available through AI Gateway, including OpenAI, Anthropic, Google, and more.
|
|
30
|
+
|
|
31
|
+
Browse models
|
|
32
|
+
|
|
33
|
+
[Analytics](https://developers.cloudflare.com/ai-gateway/observability/analytics/)
|
|
34
|
+
|
|
35
|
+
View metrics such as the number of requests, tokens, and the cost it takes to run your application.
|
|
36
|
+
|
|
37
|
+
View Analytics
|
|
38
|
+
|
|
39
|
+
[Logging](https://developers.cloudflare.com/ai-gateway/observability/logging/)
|
|
40
|
+
|
|
41
|
+
Gain insight on requests and errors.
|
|
42
|
+
|
|
43
|
+
View Logging
|
|
44
|
+
|
|
45
|
+
[Caching](https://developers.cloudflare.com/ai-gateway/features/caching/)
|
|
46
|
+
|
|
47
|
+
Serve requests directly from Cloudflare's cache instead of the original model provider for faster requests and cost savings.
|
|
48
|
+
|
|
49
|
+
Use Caching
|
|
50
|
+
|
|
51
|
+
[Rate limiting](https://developers.cloudflare.com/ai-gateway/features/rate-limiting/)
|
|
52
|
+
|
|
53
|
+
Control how your application scales by limiting the number of requests your application receives.
|
|
54
|
+
|
|
55
|
+
Use Rate limiting
|
|
56
|
+
|
|
57
|
+
[Routing](https://developers.cloudflare.com/ai-gateway/features/routing/)
|
|
58
|
+
|
|
59
|
+
Choose models and fallbacks with model aliases, or build conditional flows with dynamic routes.
|
|
60
|
+
|
|
61
|
+
Use Routing
|
|
62
|
+
|
|
63
|
+
[Your favorite providers](https://developers.cloudflare.com/ai-gateway/usage/providers/)
|
|
64
|
+
|
|
65
|
+
Workers AI, Anthropic, Google Gemini, OpenAI, Replicate, and more work with AI Gateway.
|
|
66
|
+
|
|
67
|
+
Use Your favorite providers
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## Related products
|
|
72
|
+
|
|
73
|
+
[Workers AI](https://developers.cloudflare.com/workers-ai/)
|
|
74
|
+
|
|
75
|
+
Run machine learning models, powered by serverless GPUs, on Cloudflare’s global network.
|
|
76
|
+
|
|
77
|
+
[Vectorize](https://developers.cloudflare.com/vectorize/)
|
|
78
|
+
|
|
79
|
+
Build full-stack AI applications with Vectorize, Cloudflare's vector database. Adding Vectorize enables you to perform tasks such as semantic search, recommendations, anomaly detection or can be used to provide context and memory to an LLM.
|
|
80
|
+
|
|
81
|
+
## More resources
|
|
82
|
+
|
|
83
|
+
### [Developer Discord](https://discord.cloudflare.com)
|
|
84
|
+
|
|
85
|
+
Connect with the Workers community on Discord to ask questions, show what you are building, and discuss the platform with other developers.
|
|
86
|
+
|
|
87
|
+
### [Use cases](https://developers.cloudflare.com/use-cases/ai/)
|
|
88
|
+
|
|
89
|
+
Learn how you can build and deploy ambitious AI applications to Cloudflare's global network.
|
|
90
|
+
|
|
91
|
+
### [@CloudflareDev](https://x.com/cloudflaredev)
|
|
92
|
+
|
|
93
|
+
Follow @CloudflareDev on Twitter to learn about product announcements, and what is new in Cloudflare Workers.
|
|
94
|
+
|
|
95
|
+
Was this helpful?
|
|
96
|
+
|
|
97
|
+
YesNo
|
|
98
|
+
|
|
99
|
+
## On this page
|
|
100
|
+
|
|
101
|
+
[Docs](https://developers.cloudflare.com/)
|
|
102
|
+
|
|
103
|
+
```json
|
|
104
|
+
{"@context":"https://schema.org","@type":"WebPage","@id":"https://developers.cloudflare.com/ai-gateway/#page","headline":"Cloudflare AI Gateway","description":"Observe and control your AI applications with analytics, caching, rate limiting, and model fallback through AI Gateway.","url":"https://developers.cloudflare.com/ai-gateway/","inLanguage":"en","image":"https://developers.cloudflare.com/ai-gateway/og.png?v=d9b4c0d9dbab4986","dateModified":"2026-11-04","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"},"keywords":["AI"]}
|
|
105
|
+
```
|