skillfullstack 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.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,231 @@
|
|
|
1
|
+
# Managing remote repositories
|
|
2
|
+
|
|
3
|
+
Learn to work with your local repositories on your computer and remote repositories hosted on GitHub.
|
|
4
|
+
|
|
5
|
+
## Adding a remote repository
|
|
6
|
+
|
|
7
|
+
To add a new remote, use the `git remote add` command on the terminal, in the directory your repository is stored at.
|
|
8
|
+
|
|
9
|
+
The `git remote add` command takes two arguments:
|
|
10
|
+
|
|
11
|
+
* A remote name, for example, `origin`
|
|
12
|
+
* A remote URL, for example, `https://github.com/OWNER/REPOSITORY.git`
|
|
13
|
+
|
|
14
|
+
For example:
|
|
15
|
+
|
|
16
|
+
```shell
|
|
17
|
+
$ git remote add origin https://github.com/OWNER/REPOSITORY.git
|
|
18
|
+
# Set a new remote
|
|
19
|
+
|
|
20
|
+
$ git remote -v
|
|
21
|
+
# Verify new remote
|
|
22
|
+
> origin https://github.com/OWNER/REPOSITORY.git (fetch)
|
|
23
|
+
> origin https://github.com/OWNER/REPOSITORY.git (push)
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
For more information on which URL to use, see [About remote repositories](/en/get-started/git-basics/about-remote-repositories).
|
|
27
|
+
|
|
28
|
+
### Troubleshooting: Remote origin already exists
|
|
29
|
+
|
|
30
|
+
This error means you've tried to add a remote with a name that already exists in your local repository.
|
|
31
|
+
|
|
32
|
+
```shell
|
|
33
|
+
$ git remote add origin https://github.com/octocat/Spoon-Knife.git
|
|
34
|
+
> fatal: remote origin already exists.
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
To fix this, you can:
|
|
38
|
+
|
|
39
|
+
* Use a different name for the new remote.
|
|
40
|
+
* Rename the existing remote repository before you add the new remote. For more information, see [Renaming a remote repository](#renaming-a-remote-repository) below.
|
|
41
|
+
* Delete the existing remote repository before you add the new remote. For more information, see [Removing a remote repository](#removing-a-remote-repository) below.
|
|
42
|
+
|
|
43
|
+
## Changing a remote repository's URL
|
|
44
|
+
|
|
45
|
+
The `git remote set-url` command changes an existing remote repository URL.
|
|
46
|
+
|
|
47
|
+
> [!TIP]
|
|
48
|
+
> For information on the difference between HTTPS and SSH URLs, see [About remote repositories](/en/get-started/git-basics/about-remote-repositories).
|
|
49
|
+
|
|
50
|
+
The `git remote set-url` command takes two arguments:
|
|
51
|
+
|
|
52
|
+
* An existing remote name. For example, `origin` or `upstream` are two common choices.
|
|
53
|
+
* A new URL for the remote. For example:
|
|
54
|
+
|
|
55
|
+
* If you're updating to use HTTPS, your URL might look like:
|
|
56
|
+
|
|
57
|
+
```shell
|
|
58
|
+
https://github.com/OWNER/REPOSITORY.git
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
* If you're updating to use SSH, your URL might look like:
|
|
62
|
+
|
|
63
|
+
```shell
|
|
64
|
+
git@github.com:OWNER/REPOSITORY.git
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### Switching remote URLs from SSH to HTTPS
|
|
68
|
+
|
|
69
|
+
1. Open <span class="platform-mac">Terminal</span><span class="platform-linux">Terminal</span><span class="platform-windows">Git Bash</span>.
|
|
70
|
+
|
|
71
|
+
2. Change the current working directory to your local project.
|
|
72
|
+
|
|
73
|
+
3. List your existing remotes in order to get the name of the remote you want to change.
|
|
74
|
+
|
|
75
|
+
```shell
|
|
76
|
+
$ git remote -v
|
|
77
|
+
> origin git@github.com:OWNER/REPOSITORY.git (fetch)
|
|
78
|
+
> origin git@github.com:OWNER/REPOSITORY.git (push)
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
4. Change your remote's URL from SSH to HTTPS with the `git remote set-url` command.
|
|
82
|
+
|
|
83
|
+
```shell
|
|
84
|
+
git remote set-url origin https://github.com/OWNER/REPOSITORY.git
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
5. Verify that the remote URL has changed.
|
|
88
|
+
|
|
89
|
+
```shell
|
|
90
|
+
$ git remote -v
|
|
91
|
+
# Verify new remote URL
|
|
92
|
+
> origin https://github.com/OWNER/REPOSITORY.git (fetch)
|
|
93
|
+
> origin https://github.com/OWNER/REPOSITORY.git (push)
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
The next time you `git fetch`, `git pull`, or `git push` to the remote repository, you'll be asked for your GitHub username and password. When Git prompts you for your password, enter your personal access token. Alternatively, you can use a credential helper like [Git Credential Manager](https://github.com/GitCredentialManager/git-credential-manager/blob/main/README.md). Password-based authentication for Git has been removed in favor of more secure authentication methods. For more information, see [Managing your personal access tokens](/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).
|
|
97
|
+
|
|
98
|
+
You can [use a credential helper](/en/get-started/git-basics/caching-your-github-credentials-in-git) so Git will remember your GitHub username and personal access token every time it talks to GitHub.
|
|
99
|
+
|
|
100
|
+
### Switching remote URLs from HTTPS to SSH
|
|
101
|
+
|
|
102
|
+
1. Open <span class="platform-mac">Terminal</span><span class="platform-linux">Terminal</span><span class="platform-windows">Git Bash</span>.
|
|
103
|
+
|
|
104
|
+
2. Change the current working directory to your local project.
|
|
105
|
+
|
|
106
|
+
3. List your existing remotes in order to get the name of the remote you want to change.
|
|
107
|
+
|
|
108
|
+
```shell
|
|
109
|
+
$ git remote -v
|
|
110
|
+
> origin https://github.com/OWNER/REPOSITORY.git (fetch)
|
|
111
|
+
> origin https://github.com/OWNER/REPOSITORY.git (push)
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
4. Change your remote's URL from HTTPS to SSH with the `git remote set-url` command.
|
|
115
|
+
|
|
116
|
+
```shell
|
|
117
|
+
git remote set-url origin git@github.com:OWNER/REPOSITORY.git
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
5. Verify that the remote URL has changed.
|
|
121
|
+
|
|
122
|
+
```shell
|
|
123
|
+
$ git remote -v
|
|
124
|
+
# Verify new remote URL
|
|
125
|
+
> origin git@github.com:OWNER/REPOSITORY.git (fetch)
|
|
126
|
+
> origin git@github.com:OWNER/REPOSITORY.git (push)
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
### Troubleshooting: No such remote '\[name]'
|
|
130
|
+
|
|
131
|
+
This error means that the remote you tried to change doesn't exist:
|
|
132
|
+
|
|
133
|
+
```shell
|
|
134
|
+
$ git remote set-url sofake https://github.com/octocat/Spoon-Knife
|
|
135
|
+
> fatal: No such remote 'sofake'
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
Check that you've correctly typed the remote name.
|
|
139
|
+
|
|
140
|
+
## Renaming a remote repository
|
|
141
|
+
|
|
142
|
+
Use the `git remote rename` command to rename an existing remote.
|
|
143
|
+
|
|
144
|
+
The `git remote rename` command takes two arguments:
|
|
145
|
+
|
|
146
|
+
* An existing remote name, for example, `origin`
|
|
147
|
+
* A new name for the remote, for example, `destination`
|
|
148
|
+
|
|
149
|
+
### Example of renaming a remote repository
|
|
150
|
+
|
|
151
|
+
These examples assume you're [cloning using HTTPS](/en/get-started/git-basics/about-remote-repositories#cloning-with-https-urls), which is recommended.
|
|
152
|
+
|
|
153
|
+
```shell
|
|
154
|
+
$ git remote -v
|
|
155
|
+
# View existing remotes
|
|
156
|
+
> origin https://github.com/OWNER/REPOSITORY.git (fetch)
|
|
157
|
+
> origin https://github.com/OWNER/REPOSITORY.git (push)
|
|
158
|
+
|
|
159
|
+
$ git remote rename origin destination
|
|
160
|
+
# Change remote name from 'origin' to 'destination'
|
|
161
|
+
|
|
162
|
+
$ git remote -v
|
|
163
|
+
# Verify remote's new name
|
|
164
|
+
> destination https://github.com/OWNER/REPOSITORY.git (fetch)
|
|
165
|
+
> destination https://github.com/OWNER/REPOSITORY.git (push)
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
### Troubleshooting: Could not rename config section 'remote.\[old name]' to 'remote.\[new name]'
|
|
169
|
+
|
|
170
|
+
This error means that the old remote name you typed doesn't exist.
|
|
171
|
+
|
|
172
|
+
You can check which remotes currently exist with the `git remote -v` command:
|
|
173
|
+
|
|
174
|
+
```shell
|
|
175
|
+
$ git remote -v
|
|
176
|
+
# View existing remotes
|
|
177
|
+
> origin https://github.com/OWNER/REPOSITORY.git (fetch)
|
|
178
|
+
> origin https://github.com/OWNER/REPOSITORY.git (push)
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
### Troubleshooting: Remote \[new name] already exists
|
|
182
|
+
|
|
183
|
+
This error means that the remote name you want to use already exists. To solve this, either use a different remote name, or rename the original remote.
|
|
184
|
+
|
|
185
|
+
## Removing a remote repository
|
|
186
|
+
|
|
187
|
+
Use the `git remote rm` command to remove a remote URL from your repository.
|
|
188
|
+
|
|
189
|
+
The `git remote rm` command takes one argument:
|
|
190
|
+
|
|
191
|
+
* A remote name, for example, `destination`
|
|
192
|
+
|
|
193
|
+
Removing the remote URL from your repository only unlinks the local and remote repositories. It does not delete the remote repository.
|
|
194
|
+
|
|
195
|
+
### Example of removing a remote repository
|
|
196
|
+
|
|
197
|
+
These examples assume you're [cloning using HTTPS](/en/get-started/git-basics/about-remote-repositories#cloning-with-https-urls), which is recommended.
|
|
198
|
+
|
|
199
|
+
```shell
|
|
200
|
+
$ git remote -v
|
|
201
|
+
# View current remotes
|
|
202
|
+
> origin https://github.com/OWNER/REPOSITORY.git (fetch)
|
|
203
|
+
> origin https://github.com/OWNER/REPOSITORY.git (push)
|
|
204
|
+
> destination https://github.com/FORKER/REPOSITORY.git (fetch)
|
|
205
|
+
> destination https://github.com/FORKER/REPOSITORY.git (push)
|
|
206
|
+
|
|
207
|
+
$ git remote rm destination
|
|
208
|
+
# Remove remote
|
|
209
|
+
$ git remote -v
|
|
210
|
+
# Verify it's gone
|
|
211
|
+
> origin https://github.com/OWNER/REPOSITORY.git (fetch)
|
|
212
|
+
> origin https://github.com/OWNER/REPOSITORY.git (push)
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
> [!NOTE]
|
|
216
|
+
> `git remote rm` does not delete the remote repository from the server. It simply removes the remote and its references from your local repository.
|
|
217
|
+
|
|
218
|
+
### Troubleshooting: Could not remove config section 'remote.\[name]'
|
|
219
|
+
|
|
220
|
+
This error means that the remote you tried to delete doesn't exist:
|
|
221
|
+
|
|
222
|
+
```shell
|
|
223
|
+
$ git remote rm sofake
|
|
224
|
+
> error: Could not remove config section 'remote.sofake'
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
Check that you've correctly typed the remote name.
|
|
228
|
+
|
|
229
|
+
## Further reading
|
|
230
|
+
|
|
231
|
+
* ["Working with Remotes" from the *Pro Git* book](https://git-scm.com/book/en/v2/Git-Basics-Working-with-Remotes)
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
# Pushing commits to a remote repository
|
|
2
|
+
|
|
3
|
+
Use git push to push commits made on your local branch to a remote repository.
|
|
4
|
+
|
|
5
|
+
## About `git push`
|
|
6
|
+
|
|
7
|
+
The `git push` command takes two arguments:
|
|
8
|
+
|
|
9
|
+
* A remote name, for example, `origin`
|
|
10
|
+
* A branch name, for example, `main`
|
|
11
|
+
|
|
12
|
+
For example:
|
|
13
|
+
|
|
14
|
+
```shell
|
|
15
|
+
git push REMOTE-NAME BRANCH-NAME
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
As an example, you usually run `git push origin main` to push your local changes
|
|
19
|
+
to your online repository.
|
|
20
|
+
|
|
21
|
+
## Renaming branches
|
|
22
|
+
|
|
23
|
+
To rename a branch, you'd use the same `git push` command, but you would add
|
|
24
|
+
one more argument: the name of the new branch. For example:
|
|
25
|
+
|
|
26
|
+
```shell
|
|
27
|
+
git push REMOTE-NAME LOCAL-BRANCH-NAME:REMOTE-BRANCH-NAME
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
This pushes the `LOCAL-BRANCH-NAME` to your `REMOTE-NAME`, but it is renamed to `REMOTE-BRANCH-NAME`.
|
|
31
|
+
|
|
32
|
+
## Dealing with "non-fast-forward" errors
|
|
33
|
+
|
|
34
|
+
If your local copy of a repository is out of sync with, or "behind," the upstream
|
|
35
|
+
repository you're pushing to, you'll get a message saying `non-fast-forward updates were rejected`.
|
|
36
|
+
This means that you must retrieve, or "fetch," the upstream changes, before
|
|
37
|
+
you are able to push your local changes.
|
|
38
|
+
|
|
39
|
+
For more information on this error, see [Dealing with non-fast-forward errors](/en/get-started/using-git/dealing-with-non-fast-forward-errors).
|
|
40
|
+
|
|
41
|
+
## Resolving blocked commits
|
|
42
|
+
|
|
43
|
+
To maintain the security of the repository you're pushing to, GitHub's push protection automatically protects you from accidentally committing secrets to public repositories on GitHub.com. Exposed secrets can pose serious security risks to your repository and your supply chain.
|
|
44
|
+
If GitHub detects that the commit you're attempting to push contains a supported secret, it blocks the push. In order to resolve the block, you should either:
|
|
45
|
+
|
|
46
|
+
* **Remove the secret** from your commit(s). For more information, see [Resolving a blocked push](/en/code-security/how-tos/secure-your-secrets/work-with-leak-prevention/push-protection-on-the-command-line#resolving-a-blocked-push).
|
|
47
|
+
* **Follow the provided URL** to see options to allow the push. For more information, see [Bypassing push protection](/en/code-security/how-tos/secure-your-secrets/work-with-leak-prevention/push-protection-on-the-command-line#bypassing-push-protection).
|
|
48
|
+
|
|
49
|
+
To learn more about push protection, see [Managing push protection for users](/en/code-security/how-tos/secure-your-secrets/prevent-future-leaks/manage-user-push-protection).
|
|
50
|
+
|
|
51
|
+
## Pushing tags
|
|
52
|
+
|
|
53
|
+
By default, and without additional parameters, `git push` sends all matching branches
|
|
54
|
+
that have the same names as remote branches.
|
|
55
|
+
|
|
56
|
+
To push a single tag, you can issue the same command as pushing a branch:
|
|
57
|
+
|
|
58
|
+
```shell
|
|
59
|
+
git push REMOTE-NAME TAG-NAME
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
To push all your tags, you can type the command:
|
|
63
|
+
|
|
64
|
+
```shell
|
|
65
|
+
git push REMOTE-NAME --tags
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Deleting a remote branch or tag
|
|
69
|
+
|
|
70
|
+
The syntax to delete a branch is a bit arcane at first glance:
|
|
71
|
+
|
|
72
|
+
```shell
|
|
73
|
+
git push REMOTE-NAME :BRANCH-NAME
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
Note that there is a space before the colon. The command resembles the same steps
|
|
77
|
+
you'd take to rename a branch. However, here, you're telling Git to push *nothing*
|
|
78
|
+
into `BRANCH-NAME` on `REMOTE-NAME`. Because of this, `git push` deletes the branch
|
|
79
|
+
on the remote repository.
|
|
80
|
+
|
|
81
|
+
## Remotes and forks
|
|
82
|
+
|
|
83
|
+
You might already know that [you can "fork" repositories](https://guides.github.com/overviews/forking/) on GitHub.
|
|
84
|
+
|
|
85
|
+
When you clone a repository you own, you provide it with a remote URL that tells
|
|
86
|
+
Git where to fetch and push updates. If you want to collaborate with the original
|
|
87
|
+
repository, you'd add a new remote URL, typically called `upstream`, to
|
|
88
|
+
your local Git clone:
|
|
89
|
+
|
|
90
|
+
```shell
|
|
91
|
+
git remote add upstream THEIR_REMOTE_URL
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Now, you can fetch updates and branches from *their* fork:
|
|
95
|
+
|
|
96
|
+
```shell
|
|
97
|
+
git fetch upstream
|
|
98
|
+
# Grab the upstream remote's branches
|
|
99
|
+
> remote: Counting objects: 75, done.
|
|
100
|
+
> remote: Compressing objects: 100% (53/53), done.
|
|
101
|
+
> remote: Total 62 (delta 27), reused 44 (delta 9)
|
|
102
|
+
> Unpacking objects: 100% (62/62), done.
|
|
103
|
+
> From https://github.com/OCTOCAT/REPO
|
|
104
|
+
> * [new branch] main -> upstream/main
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
When you're done making local changes, you can push your local branch to GitHub
|
|
108
|
+
and [initiate a pull request](/en/pull-requests/reference/pull-requests).
|
|
109
|
+
|
|
110
|
+
For more information on working with forks, see [Syncing a fork](/en/pull-requests/how-tos/work-with-forks/syncing-a-fork).
|
|
111
|
+
|
|
112
|
+
## Further reading
|
|
113
|
+
|
|
114
|
+
* [The "Remotes" chapter from the "Pro Git" book](https://git-scm.com/book/en/v2/Git-Basics-Working-with-Remotes)
|
|
115
|
+
* [`git remote` main page](https://git-scm.com/docs/git-remote.html)
|
|
116
|
+
* [Git cheatsheet](/en/get-started/git-basics/git-cheatsheet)
|
|
117
|
+
* [Git workflows](/en/get-started/git-basics/git-workflows)
|
|
118
|
+
* [Git Handbook](https://guides.github.com/introduction/git-handbook/)
|
|
119
|
+
* [Troubleshooting the 2 GiB push limit](/en/get-started/using-git/troubleshooting-the-2-gb-push-limit)
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
evalGitWorkflow.py
|
|
4
|
+
Validates the diagnostic script and ensures that gitWorkflow executes cleanly.
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
import subprocess
|
|
8
|
+
import json
|
|
9
|
+
import os
|
|
10
|
+
import sys
|
|
11
|
+
|
|
12
|
+
def test_diagnose_script():
|
|
13
|
+
script_path = os.path.join(os.path.dirname(__file__), "..", "scripts", "diagnoseGitGraph.py")
|
|
14
|
+
res = subprocess.run([sys.executable, script_path], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
|
|
15
|
+
assert res.returncode == 0, f"Script failed: {res.stderr}"
|
|
16
|
+
data = json.loads(res.stdout)
|
|
17
|
+
assert "recommendation" in data
|
|
18
|
+
print(" test_diagnose_script default workspace check passed")
|
|
19
|
+
|
|
20
|
+
def test_diagnose_script_in_repo():
|
|
21
|
+
import tempfile
|
|
22
|
+
script_path = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "scripts", "diagnoseGitGraph.py"))
|
|
23
|
+
with tempfile.TemporaryDirectory() as tmpdir:
|
|
24
|
+
subprocess.run(["git", "init"], cwd=tmpdir, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, check=True)
|
|
25
|
+
subprocess.run(["git", "config", "user.name", "Test"], cwd=tmpdir, check=True)
|
|
26
|
+
subprocess.run(["git", "config", "user.email", "test@example.com"], cwd=tmpdir, check=True)
|
|
27
|
+
test_file = os.path.join(tmpdir, "test.txt")
|
|
28
|
+
with open(test_file, "w") as f:
|
|
29
|
+
f.write("hello")
|
|
30
|
+
subprocess.run(["git", "add", "."], cwd=tmpdir, check=True)
|
|
31
|
+
subprocess.run(["git", "commit", "-m", "init"], cwd=tmpdir, check=True)
|
|
32
|
+
|
|
33
|
+
res = subprocess.run([sys.executable, script_path], cwd=tmpdir, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
|
|
34
|
+
assert res.returncode == 0, f"Failed in git repo: {res.stderr}"
|
|
35
|
+
data = json.loads(res.stdout)
|
|
36
|
+
assert data.get("isClean") is True
|
|
37
|
+
assert data.get("branch") in ["main", "master"]
|
|
38
|
+
print(" test_diagnose_script_in_repo passed")
|
|
39
|
+
|
|
40
|
+
if __name__ == "__main__":
|
|
41
|
+
test_diagnose_script()
|
|
42
|
+
test_diagnose_script_in_repo()
|
|
43
|
+
print("All gitWorkflow evals passed.")
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Modern Git Branching Models & DAG Strategy Reference
|
|
2
|
+
|
|
3
|
+
## 1. Trunk-Based Development vs GitFlow
|
|
4
|
+
|
|
5
|
+
### Trunk-Based Development (Recommended for Modern CI/CD)
|
|
6
|
+
- Developers work in short-lived feature branches (< 1-2 days) branched from `main`.
|
|
7
|
+
- Continuous integration requires daily integration into `main`.
|
|
8
|
+
- High test coverage and fast automated CI prevent trunk breakage.
|
|
9
|
+
- Feature flags decouple deployment from release.
|
|
10
|
+
|
|
11
|
+
### GitFlow (Legacy / Heavy Release Cycles)
|
|
12
|
+
- Branches: `main`, `develop`, `feature/*`, `release/*`, `hotfix/*`.
|
|
13
|
+
- High merge overhead and long-lived branches risk painful "merge hell".
|
|
14
|
+
- Best reserved for scheduled binary packaging (e.g. embedded firmware, mobile app stores).
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## 2. The Directed Acyclic Graph (DAG) Internals
|
|
19
|
+
|
|
20
|
+
- **Blobs**: Store file contents (compressed zlib, identified by SHA-1/SHA-256).
|
|
21
|
+
- **Trees**: Directories mapping filenames and permissions to Blobs and sub-Trees.
|
|
22
|
+
- **Commits**: Pointer to a Tree, parent commit SHAs, author, committer, and message.
|
|
23
|
+
- **Fast-Forward**: Occurs when target branch commit is an ancestor of the branch being merged. No merge commit created.
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## 3. Conflict Resolution Protocol
|
|
28
|
+
|
|
29
|
+
1. Run `git checkout --conflict=diff3 <file>` to view the 3-way diff (Ancestor, Ours, Theirs).
|
|
30
|
+
2. Prefer structural resolution: Keep both non-conflicting imports/routes, isolate the real functional divergence.
|
|
31
|
+
3. Validate with unit tests before staging: `pytest` or `npm test`.
|
|
32
|
+
4. Stage: `git add <file>` and run `git rebase --continue`.
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
diagnoseGitGraph.py
|
|
4
|
+
Audits the current Git repository state, working tree hygiene, divergence from upstream,
|
|
5
|
+
and uncommitted changes. Outputs structured JSON.
|
|
6
|
+
"""
|
|
7
|
+
|
|
8
|
+
import subprocess
|
|
9
|
+
import json
|
|
10
|
+
import sys
|
|
11
|
+
|
|
12
|
+
def run_git(cmd):
|
|
13
|
+
try:
|
|
14
|
+
res = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, check=True)
|
|
15
|
+
return res.stdout.strip()
|
|
16
|
+
except subprocess.CalledProcessError as e:
|
|
17
|
+
return None
|
|
18
|
+
|
|
19
|
+
def main():
|
|
20
|
+
inside_tree = run_git(["git", "rev-parse", "--is-inside-work-tree"])
|
|
21
|
+
if inside_tree != "true":
|
|
22
|
+
result = {
|
|
23
|
+
"isGitRepo": False,
|
|
24
|
+
"error": "Not inside a valid Git repository",
|
|
25
|
+
"recommendation": "Run 'git init' to initialize repository or navigate to a Git-tracked workspace."
|
|
26
|
+
}
|
|
27
|
+
print(json.dumps(result, indent=2))
|
|
28
|
+
sys.exit(0)
|
|
29
|
+
|
|
30
|
+
branch = run_git(["git", "branch", "--show-current"]) or "DETACHED"
|
|
31
|
+
head_sha = run_git(["git", "rev-parse", "--short", "HEAD"])
|
|
32
|
+
status_raw = run_git(["git", "status", "--porcelain"]) or ""
|
|
33
|
+
|
|
34
|
+
modified = []
|
|
35
|
+
untracked = []
|
|
36
|
+
for line in status_raw.splitlines():
|
|
37
|
+
if line.startswith("??"):
|
|
38
|
+
untracked.append(line[3:])
|
|
39
|
+
else:
|
|
40
|
+
modified.append(line)
|
|
41
|
+
|
|
42
|
+
upstream = run_git(["git", "rev-parse", "--abbrev-ref", "@{upstream}"])
|
|
43
|
+
ahead, behind = 0, 0
|
|
44
|
+
if upstream:
|
|
45
|
+
counts = run_git(["git", "rev-list", "--left-right", "--count", f"HEAD...{upstream}"])
|
|
46
|
+
if counts:
|
|
47
|
+
parts = counts.split()
|
|
48
|
+
ahead = int(parts[0])
|
|
49
|
+
behind = int(parts[1])
|
|
50
|
+
|
|
51
|
+
result = {
|
|
52
|
+
"branch": branch,
|
|
53
|
+
"headSha": head_sha,
|
|
54
|
+
"upstream": upstream or "none",
|
|
55
|
+
"ahead": ahead,
|
|
56
|
+
"behind": behind,
|
|
57
|
+
"isClean": len(status_raw) == 0,
|
|
58
|
+
"modifiedFilesCount": len(modified),
|
|
59
|
+
"untrackedFilesCount": len(untracked),
|
|
60
|
+
"recommendation": (
|
|
61
|
+
"Ready for rebase/merge" if len(status_raw) == 0 else "Working tree dirty: stash or commit before rebasing"
|
|
62
|
+
)
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
print(json.dumps(result, indent=2))
|
|
66
|
+
|
|
67
|
+
if __name__ == "__main__":
|
|
68
|
+
main()
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# GitHub Documentation Assets, REST API & CLI Reference
|
|
2
|
+
|
|
3
|
+
Official offline documentation specifications from GitHub Docs (`https://docs.github.com/en/rest`), GitHub Docs API, and the GitHub CLI (`gh`).
|
|
4
|
+
|
|
5
|
+
## Directory Structure
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
skills/github/assets/
|
|
9
|
+
├── rest-api/ # Core GitHub REST API Reference Specifications
|
|
10
|
+
│ ├── overview.md # REST API Architecture & Root Endpoint
|
|
11
|
+
│ ├── quickstart.md # Quickstart for GitHub REST API
|
|
12
|
+
│ ├── authenticating.md # Authentication, OAuth, and Personal Access Tokens
|
|
13
|
+
│ ├── using-the-rest-api.md # Headers, pagination, media types, rate limits
|
|
14
|
+
│ ├── repos.md # Repositories API (create, edit, delete, transfer)
|
|
15
|
+
│ ├── branches.md # Branches & Branch Protection Rules API
|
|
16
|
+
│ ├── rules.md # Modern Rulesets API
|
|
17
|
+
│ ├── pulls.md # Pull Requests API
|
|
18
|
+
│ ├── pull-reviews.md # Pull Request Reviews & Comments API
|
|
19
|
+
│ ├── actions-workflows.md # Actions Workflows API
|
|
20
|
+
│ ├── actions-workflow-runs.md # Workflow Runs & Triggering API
|
|
21
|
+
│ ├── actions-secrets.md # Actions Secrets & Variables API
|
|
22
|
+
│ ├── code-scanning.md # CodeQL & SARIF Uploads API
|
|
23
|
+
│ ├── secret-scanning.md # Secret Scanning Alerts API
|
|
24
|
+
│ ├── dependabot-alerts.md # Dependabot Security & Version Alerts API
|
|
25
|
+
│ ├── teams.md # Teams & Permissions API
|
|
26
|
+
│ ├── orgs.md # Organizations & Members API
|
|
27
|
+
│ ├── collaborators.md # Repository Collaborators API
|
|
28
|
+
│ ├── commits.md # Git Commits & Status API
|
|
29
|
+
│ ├── checks-runs.md # Checks & Check Suites API
|
|
30
|
+
│ └── releases.md # GitHub Releases & Assets API
|
|
31
|
+
│
|
|
32
|
+
├── cli/ # Official GitHub CLI (gh) Reference Manual
|
|
33
|
+
│ ├── gh-reference.md # Complete reference manual (all gh commands & flags)
|
|
34
|
+
│ ├── gh-environment.md # GH_TOKEN, GH_HOST, GH_DEBUG environment variables
|
|
35
|
+
│ └── gh-formatting.md # JSON templating and jq output options
|
|
36
|
+
│
|
|
37
|
+
└── docs-api/ # GitHub Docs Programmatic API
|
|
38
|
+
└── github-docs-api.md # /api/article/body, /api/pagelist, and /llms.txt
|
|
39
|
+
```
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
`GH_TOKEN`, `GITHUB_TOKEN` (in order of precedence): an authentication token that will be used when
|
|
2
|
+
a command targets either `github.com` or a subdomain of `ghe.com`. Setting this avoids being prompted to
|
|
3
|
+
authenticate and takes precedence over previously stored credentials.
|
|
4
|
+
|
|
5
|
+
`GH_ENTERPRISE_TOKEN`, `GITHUB_ENTERPRISE_TOKEN` (in order of precedence): an authentication
|
|
6
|
+
token that will be used when a command targets a GitHub Enterprise Server host.
|
|
7
|
+
|
|
8
|
+
`GH_HOST`: specify the GitHub hostname for commands where a hostname has not been provided, or
|
|
9
|
+
cannot be inferred from the context of a local Git repository. If this host was previously
|
|
10
|
+
authenticated with, the stored credentials will be used. Otherwise, setting `GH_TOKEN` or
|
|
11
|
+
`GH_ENTERPRISE_TOKEN` is required, depending on the targeted host.
|
|
12
|
+
|
|
13
|
+
`GH_REPO`: specify the GitHub repository in the `[HOST/]OWNER/REPO` format for commands
|
|
14
|
+
that otherwise operate on a local repository.
|
|
15
|
+
|
|
16
|
+
`GH_EDITOR`, `GIT_EDITOR`, `VISUAL`, `EDITOR` (in order of precedence): the editor tool to use
|
|
17
|
+
for authoring text.
|
|
18
|
+
|
|
19
|
+
`GH_BROWSER`, `BROWSER` (in order of precedence): the web browser to use for opening links.
|
|
20
|
+
|
|
21
|
+
`GH_DEBUG`: set to a truthy value to enable verbose output on standard error. Set to `api`
|
|
22
|
+
to additionally log details of HTTP traffic.
|
|
23
|
+
|
|
24
|
+
`DEBUG` (deprecated): set to `1`, `true`, or `yes` to enable verbose output on standard
|
|
25
|
+
error.
|
|
26
|
+
|
|
27
|
+
`GH_PAGER`, `PAGER` (in order of precedence): a terminal paging program to send standard output
|
|
28
|
+
to, e.g. `less`.
|
|
29
|
+
|
|
30
|
+
`GLAMOUR_STYLE`: the style to use for rendering Markdown. See
|
|
31
|
+
<https://github.com/charmbracelet/glamour#styles>
|
|
32
|
+
|
|
33
|
+
`NO_COLOR`: set to any value to avoid printing ANSI escape sequences for color output.
|
|
34
|
+
|
|
35
|
+
`CLICOLOR`: set to `0` to disable printing ANSI colors in output.
|
|
36
|
+
|
|
37
|
+
`CLICOLOR_FORCE`: set to a value other than `0` to keep ANSI colors in output
|
|
38
|
+
even when the output is piped.
|
|
39
|
+
|
|
40
|
+
`GH_COLOR_LABELS`: set to any value to display labels using their RGB hex color codes in terminals that
|
|
41
|
+
support truecolor.
|
|
42
|
+
|
|
43
|
+
`GH_ACCESSIBLE_COLORS` (preview): set to a truthy value to use customizable, 4-bit accessible colors.
|
|
44
|
+
|
|
45
|
+
`GH_FORCE_TTY`: set to any value to force terminal-style output even when the output is
|
|
46
|
+
redirected. When the value is a number, it is interpreted as the number of columns
|
|
47
|
+
available in the viewport. When the value is a percentage, it will be applied against
|
|
48
|
+
the number of columns available in the current viewport.
|
|
49
|
+
|
|
50
|
+
`GH_NO_UPDATE_NOTIFIER`: set to any value to disable GitHub CLI update notifications.
|
|
51
|
+
When any command is executed, gh checks for new versions once every 24 hours.
|
|
52
|
+
If a newer version was found, an upgrade notice is displayed on standard error.
|
|
53
|
+
|
|
54
|
+
`GH_NO_EXTENSION_UPDATE_NOTIFIER`: set to any value to disable GitHub CLI extension update notifications.
|
|
55
|
+
When an extension is executed, gh checks for new versions for the executed extension once every 24 hours.
|
|
56
|
+
If a newer version was found, an upgrade notice is displayed on standard error.
|
|
57
|
+
|
|
58
|
+
`GH_EXTENSION`: set to `1` by gh when it invokes an extension, allowing an extension to
|
|
59
|
+
tell whether it was run as `gh <extension>` or directly as a standalone program.
|
|
60
|
+
|
|
61
|
+
`GH_CONFIG_DIR`: the directory where gh will store configuration files. If not specified,
|
|
62
|
+
the default value will be one of the following paths (in order of precedence):
|
|
63
|
+
- `$XDG_CONFIG_HOME/gh` (if `$XDG_CONFIG_HOME` is set),
|
|
64
|
+
- `$AppData/GitHub CLI` (on Windows if `$AppData` is set), or
|
|
65
|
+
- `$HOME/.config/gh`.
|
|
66
|
+
|
|
67
|
+
`GH_PROMPT_DISABLED`: set to any value to disable interactive prompting in the terminal.
|
|
68
|
+
|
|
69
|
+
`GH_PATH`: set the path to the gh executable, useful for when gh can not properly determine
|
|
70
|
+
its own path such as in the cygwin terminal. gh also sets this when invoking extensions so they
|
|
71
|
+
can call back into the same gh executable.
|
|
72
|
+
|
|
73
|
+
`GH_MDWIDTH`: default maximum width for markdown render wrapping. The max width of lines
|
|
74
|
+
wrapped on the terminal will be taken as the lesser of the terminal width, this value, or 120 if
|
|
75
|
+
not specified. This value is used, for example, with `pr view` subcommand.
|
|
76
|
+
|
|
77
|
+
`GH_ACCESSIBLE_PROMPTER` (preview): set to a truthy value to enable prompts that are
|
|
78
|
+
more compatible with speech synthesis and braille screen readers.
|
|
79
|
+
|
|
80
|
+
`GH_TELEMETRY`: set to `log` to print telemetry data to standard error instead of sending it.
|
|
81
|
+
Set to `false` or `0` to disable telemetry. Takes precedence over `DO_NOT_TRACK`.
|
|
82
|
+
|
|
83
|
+
`DO_NOT_TRACK`: set to `true` or `1` to disable telemetry. Ignored when
|
|
84
|
+
`GH_TELEMETRY` is set, which takes precedence.
|
|
85
|
+
|
|
86
|
+
`GH_SPINNER_DISABLED`: set to a truthy value to replace the spinner animation with
|
|
87
|
+
a textual progress indicator.
|