Awesome Agentic DevOps

License: MIT CI PRs Welcome

A curated, official-first catalog of MCP servers, agent skills, AI agents, frameworks, and supporting resources for DevOps, Cloud, SRE, and Platform Engineering. It includes vendor and open-source project resources alongside a clearly labeled community-driven section.

Most agent lists stop at discovery. This one is built for operators:

  • Official-first, community-inclusive — 80 entries organized into 15 catalog sections; official vendor and project resources are prioritized, while community-driven entries are separated in a dedicated community section.
  • Scored, not just listed — every entry records action capability, human-approval controls, tracing evidence, maturity, and operational risk (how entries are scored).
  • Audited by CI — GitHub repository entries are checked weekly for reachability, archived status, and stale push activity; non-GitHub documentation links are outside this automated check and require curator review.
  • Installable, not just readableone command installs hundreds of skills from cataloged Google, Microsoft, Azure, Azure DevOps, and Harness sources — plus a separate community set — into Claude Code, Cursor, Codex, VS Code, or Antigravity.
  • Runnable, not just theoretical — documented reference-agent examples cover Terraform plan review, drift detection, and policy-driven container image releases.

Safety first: some cataloged tools and agents can change infrastructure. Prefer read-only or proposal mode, require human approval before write actions, and use least-privilege credentials — full guidance in the safety model and the practical operator safety checklist.

Contents

Evaluation labels

Label Meaning
prod assessed as production-adjacent; not a readiness guarantee
prototype assessed as a useful prototype
mcp MCP/server integration
approval documents an approval or safety mechanism; enforcement varies
evidence has tracing/evidence/evals
write write-capable; review before use

Labels are shorthand for structured fields recorded on every entry in data/repos.yamlhow entries are scored explains each field and how it is verified.

Compliance evidence checklist

Production-adjacent agent runs need a reviewable evidence packet, not just a chat transcript. Use the compliance evidence checklist to capture request context, identity and data boundaries, redacted tool calls, approval records, validation output, and follow-ups for MCP servers, skills, incident copilots, Terraform reviewers, and other DevOps agents.

At minimum, record an explicit approval before any write-capable agent mutates infrastructure, source control, CI/CD, identity, secrets, incidents, or production telemetry configuration. If the approval cannot be captured, keep the agent in read-only or proposal mode.

Operator safety checklist

Before wiring any catalog entry into cloud accounts, clusters, CI/CD, identity, secrets, databases, observability, or incident-response systems, run through the operator safety checklist. It gives teams a concrete preflight for read-only-first evaluation, domain-specific credential boundaries, no-secret-in-context handling, dry-run/proposal evidence, approval gates, blast-radius limits, and audit artifacts.

Top picks by use case

Use case Start with Why
AWS agentic cloud automation aws/agent-toolkit-for-aws Official AWS-supported MCP, skills, plugins, project rules, IAM-aware controls, CloudWatch metrics, and CloudTrail auditability.
Azure cloud automation microsoft/mcpmicrosoft/azure-skills Official Microsoft MCP and skills/plugin sources for Azure resource workflows.
Google Cloud automation google/mcpgoogleapis/gcloud-mcpgoogle/skills Official Google MCP and skills sources for GCP, Cloud Run, GKE, observability, and storage workflows.
Source-control DevOps github/github-mcp-serverGitLab MCP serveratlassian/atlassian-mcp-serverLinear MCP server docs Official MCP tool surfaces for repos, issues, PRs, Jira, Bitbucket, Linear roadmap/issue workflows, and related delivery workflows.
Terraform and IaC hashicorp/terraform-mcp-serverPulumi MCP Serveropentofu/opentofu-mcp-server Official IaC MCP sources for Terraform Registry/HCP Terraform, Pulumi Cloud automation, and OpenTofu Registry documentation lookup.
SRE incident response grafana/mcp-grafanadatadog-labs/mcp-serverHoneycomb MCP docsElastic Agent Builder MCP server docsPagerDuty/pagerduty-mcp-server Official observability and incident-management MCPs for metrics, logs, traces, SLOs, triggers, indexed operational data, alerts, incidents, and on-call context.
FinOps and cloud cost vantage-sh/vantage-mcp-server Official Vantage MCP server for cloud spend analysis, budgets, anomalies, reports, and provider-resource cost context across Vantage-connected providers.
Security and code quality OWASP MCP Top 10cisco-ai-defense/mcp-scannerSonarSource/sonarqube-mcp-serverokta/okta-mcp-serverSnyk Studio MCP docssnyk/studio-mcpWiz WIN MCP Server docsCrowdStrike/falcon-mcpDopplerHQ/mcp-server Official MCPs and security resources for MCP threat modeling, MCP server scanning, code quality, application security, identity-aware workflows, secrets management, agent security, cloud-security posture, and Falcon-platform SOC automation.
Data platform operations mongodb-js/mongodb-mcp-serverredis/mcp-redisgoogleapis/mcp-toolboxdbt-labs/dbt-mcpbytebase/dbhub Official database and data-platform MCP servers for MongoDB, Redis, Google MCP Toolbox for Databases, dbt, and Bytebase-maintained DBHub. Treat DBHub as independent-vendor-backed and use read-only database credentials/approval gates for SQL execution.
Kubernetes and platform operations kubernetes-sigs/mcp-lifecycle-operatorcontainers/kubernetes-mcp-serverskyhook-io/radar Official Kubernetes SIG lifecycle tooling plus community Kubernetes/OpenShift MCP operations and cluster triage with explicit RBAC/blast-radius notes.
CI/CD and GitOps jenkinsci/mcp-server-pluginargoproj-labs/mcp-for-argocdharness/mcp-server Official Jenkins, Argo Project, and Harness resources for pipeline, build, deployment, rollback, and GitOps workflows.
MCP development and governance modelcontextprotocol/python-sdkmodelcontextprotocol/typescript-sdkmodelcontextprotocol/registryDocker MCP Catalog and Toolkit Official SDKs, registry, and Docker governance surfaces for building, packaging, and controlling DevOps MCP servers.
Browser automation and debugging ChromeDevTools/chrome-devtools-mcpmicrosoft/playwright-mcp Official browser automation MCP servers for web-app QA, performance tracing, network/console inspection, and accessibility-tree-driven browser workflows.
Agent frameworks and templates google/adk-pythonGoogleCloudPlatform/agent-starter-pack Official Google agent framework and production templates with CI/CD, evaluation, and observability.

Install skills into your coding agent

Install hundreds of Agent Skills from the cataloged Google, Microsoft, Azure, Azure DevOps, and Harness sources with one command:

# Claude Code, macOS/Linux — installs every official skill into ~/.claude/skills/
curl -fsSL https://raw.githubusercontent.com/DevOpsAIguru123/awesome-agentic-devops/main/install/claude-code/install.sh | sh -s -- --official

Choose breadth with a flag: --official (361 skills), --community (26), or --all (387). Python 3 is the only requirement — there is no pip install step.

Pass --dry-run to preview first. Commands for Cursor, Codex, VS Code, Antigravity (Mac and Windows) — plus target folders and safety notes — are in the install guide. To install just one company or product, use the official skills catalog or the community skills catalog.

Recently added

New catalog entries appear below; notable non-entry changes (formatting, labels, tooling) are in the changelog.

Date Entry Category
2026-08-07 heroku/heroku-mcp-server Cloud / Heroku PaaS operations
2026-07-25 opentofu/opentofu-mcp-server IaC / OpenTofu Registry MCP
2026-07-23 containers/kubernetes-mcp-server Community / Kubernetes and OpenShift
2026-07-23 cisco-ai-defense/mcp-scanner Security / MCP server scanning
2026-07-23 Honeycomb MCP docs SRE / Honeycomb observability
2026-07-22 docker/hub-mcp DevOps / Docker Hub container workflows
2026-07-22 digitalocean-labs/mcp-digitalocean Cloud / DigitalOcean
2026-07-22 googleapis/mcp-toolbox Data platform / database toolbox
2026-07-22 dbt-labs/dbt-mcp Data platform / dbt
2026-07-22 bytebase/dbhub Data platform / independent-vendor DBHub SQL MCP
2026-07-22 aquasecurity/trivy-mcp Security / Trivy vulnerability scanning
2026-07-22 Linear MCP server docs DevOps / Linear issue and roadmap workflows
2026-07-18 DopplerHQ/mcp-server Security / Doppler secrets management
2026-07-17 CrowdStrike/falcon-mcp Security / CrowdStrike Falcon SOC automation
2026-07-14 dynatrace-oss/dynatrace-mcp SRE / Dynatrace observability
2026-07-12 harness/mcp-server CI/CD / Harness
2026-07-12 harness/harness-skills Agent skills / Harness
2026-07-09 redis/mcp-redis Data platform / Redis
2026-07-08 Elastic Agent Builder MCP server docs SRE / observability
2026-07-07 skyhook-io/radar Kubernetes / community MCP
2026-07-07 OWASP MCP Top 10 Agent security / MCP risk framework
2026-07-06 vantage-sh/vantage-mcp-server FinOps / cloud cost
2026-07-05 hashicorp/vault-mcp-server IaC / secrets management
2026-07-05 cloudflare/mcp-server-cloudflare Cloud / edge
2026-07-05 CircleCI-Public/mcp-server-circleci CI/CD
2026-07-05 mongodb-js/mongodb-mcp-server Data platform
2026-07-05 backstage/backstage (mcp-actions-backend) Platform toolkits

Local reference agents

This repo keeps runnable reference agents under agents/.

Path Purpose
agents/adk/terraform-plan-reviewer Gemini ADK agent that reviews Terraform plan output and returns structured risk findings.
agents/adk/terraform-drift-detector Gemini ADK agent that reviews Terraform Cloud refresh-only plans and sends Discord-ready drift alerts.
agents/container-image-release-advisor SonarCloud and Trivy container release pipeline with deterministic policy, protected approval, three reports, and an ADK/Vertex AI or Claude/Sonnet advisory stage.

Curated catalog

The source of truth is data/repos.yaml. The catalog combines official vendor and open-source project resources with a dedicated section for community-driven tools and references. Entries include executable software as well as SDKs, documentation, security frameworks, registries, and other ecosystem resources.

Official Cloud MCP Servers and Agent Toolkits

Repo Labels Operator note
aws/agent-toolkit-for-aws prodmcpapprovalevidencewrite Official AWS-supported toolkit with managed MCP server access, current AWS docs/API knowledge tools, on-demand agent skills, Claude Code/Codex plugins, and project rules for Kiro, Claude Code, Cursor, Codex, and other MCP-compatible agents.
awslabs/mcp prodmcpapprovalwrite Official AWS Labs MCP server collection; useful legacy/source reference while AWS transitions capabilities into Agent Toolkit.
microsoft/mcp prodmcpapprovalwrite Official Microsoft MCP catalog, including Azure cloud and infrastructure MCP references.
google/mcp prodmcpapprovalwrite Official Google MCP repository listing managed and open-source MCP servers for Google and Google Cloud.
googleapis/gcloud-mcp prodmcpapprovalwrite Official Google API repository for gcloud, observability, storage, and backup/disaster-recovery MCP servers.
GoogleCloudPlatform/cloud-run-mcp prodmcpapprovalwrite Official Google Cloud Platform MCP server for deploying apps to Cloud Run.
cloudflare/mcp-server-cloudflare prodmcpapprovalwrite Official Cloudflare MCP servers for account, Workers, and edge configuration workflows.
heroku/heroku-mcp-server prototypemcpapprovalwrite Official Heroku Platform MCP Server using the Heroku CLI for app lifecycle management, deploys, dyno scaling/restarts, logs, add-ons, pipelines, teams/spaces, and Heroku Postgres operations.
vercel/vercel-mcp-overview prodmcpapprovalwrite Official public overview of Vercel's hosted MCP server for project and deployment context.
digitalocean-labs/mcp-digitalocean prototypemcpapprovalwrite DigitalOcean Labs MCP integration for self-hosted cloud operations over DigitalOcean droplets, App Platform, databases, and account resources.

Official DevOps MCP Servers

Repo Labels Operator note
microsoft/azure-devops-mcp prodmcpapprovalwrite Official Azure DevOps MCP server with remote-first onboarding and local server option.
github/github-mcp-server prodmcpapprovalwrite Official GitHub MCP server for repository, issue, pull request, code, and workflow automation.
GitLab MCP server prodmcpapprovalwrite Official GitLab MCP server is documented as a GitLab-hosted endpoint rather than a standalone GitHub repo.
atlassian/atlassian-mcp-server prodmcpapprovalwrite Official Atlassian Rovo MCP server for Jira, Confluence, Jira Service Management, Bitbucket, and Compass.
Linear MCP server docs prodmcpapprovalwrite Official Linear documentation for its centrally hosted remote MCP server with OAuth 2.1 dynamic client registration, API-key support, a read-only endpoint, and tools for issue, project, roadmap, and comment workflows.
docker/mcp-registry prodmcpapprovalevidence Official Docker MCP registry and catalog source for verified containerized MCP servers.
docker/hub-mcp prototypemcpapprovalwrite Official Docker Hub MCP server for AI-assisted image discovery, image recommendations, and Docker Hub repository workflows.
kubernetes-sigs/mcp-lifecycle-operator prototypemcpapprovalwrite Official Kubernetes SIG operator for declaratively deploying and rolling out MCP servers, not a general kubectl MCP server.

Official Security and Code-Quality MCP Servers

Repo Labels Operator note
SonarSource/sonarqube-mcp-server prodmcpapproval Official SonarQube MCP server for code quality and security insights in AI agents.
okta/okta-mcp-server prodmcpapprovalwrite Official Okta self-hosted MCP server for connecting agents to Okta identity workflows.
OWASP MCP Top 10 prodmcpapprovalevidence Official OWASP MCP Top 10 documentation for assessing Model Context Protocol security risks across agentic DevOps integrations.
Snyk Studio MCP docs prodmcpapprovalevidence Official Snyk documentation for Snyk Studio agentic security workflows and Snyk MCP Server usage.
snyk/studio-mcp prodmcpapprovalevidence Official Snyk MCP server (Go) providing snyk_sca_scan, snyk_code_scan, snyk_iac_scan, snyk_container_scan, snyk_sbom_scan, snyk_secret_scan, and snyk_aibom tools via the snyk mcp CLI command.
snyk/agent-scan prodapprovalevidence Official Snyk security scanner for AI agents, MCP servers, and agent skills.
Wiz WIN MCP Server docs prodmcpapprovalevidence Official Wiz documentation for the WIN MCP server, adding CNAPP and cloud-security coverage.
CrowdStrike/falcon-mcp prototypemcpapprovalwrite Official CrowdStrike MCP server (Python, public preview) for threat detection, incident investigation, threat intelligence, endpoint inventory, identity protection, NG-SIEM, and cloud security (CSPM/CSVM). Use least-privilege API scopes; write-capable modules can change endpoint policy and detection rules.
DopplerHQ/mcp-server prototypemcpapprovalwrite Official Doppler MCP server (TypeScript, Apache-2.0) providing AI assistants access to the Doppler secrets API. Experimental; use service tokens scoped per config. Write-capable — can create/delete secrets.
cisco-ai-defense/mcp-scanner prodmcpapprovalevidence Cisco AI Defense MCP Scanner for scanning MCP servers and tools with YARA rules, LLM-as-judge, Cisco AI Defense Inspect API, dependency checks, readiness checks, and optional VirusTotal analysis.
aquasecurity/trivy-mcp prototypemcpapprovalevidence Official Aqua Security Trivy MCP plugin exposing vulnerability, misconfiguration, secret, filesystem, container image, and repository scanning to MCP clients.

Official CI/CD and GitOps MCP Servers

Repo Labels Operator note
jenkinsci/mcp-server-plugin prodmcpapprovalwrite Official Jenkins plugin that enables Jenkins to act as an MCP server for LLM-powered clients.
argoproj-labs/mcp-for-argocd prototypemcpapprovalwrite Argo Project Labs MCP server implementation for Argo CD, filling the GitOps/CD gap in the catalog.
controlplaneio-fluxcd/flux-operator (MCP) prodmcpapprovalevidencewrite Official Flux Operator MCP server from CNCF Flux core maintainers; Go single-binary with read-only mode, kubeconfig scoping, and Kubernetes impersonation. Covers Kustomizations, HelmReleases, drift detection, root cause analysis, and multi-cluster comparison.
CircleCI-Public/mcp-server-circleci prodmcpapprovalevidence Official CircleCI MCP server for build failure logs, pipeline status, flaky test detection, and usage analysis.
harness/mcp-server prodmcpapprovalwrite Official Harness MCP server (Go) for CI/CD pipelines, deployments, connectors, feature flags, and infrastructure operations; risk-tiered model blocks destructive ops without confirmation.

Official MCP SDKs, Reference Implementations, Registries, and Governance Platforms

Repo Labels Operator note
Docker MCP Catalog and Toolkit docs prodmcpapprovalwrite Official Docker documentation for MCP Toolkit, MCP Catalog, profiles, CLI, and MCP Gateway.
Docker MCP Gateway docs prodmcpapprovalwrite Official Docker MCP Gateway documentation for secure, centralized orchestration of containerized MCP tools.
modelcontextprotocol/servers prodmcpapproval Official MCP reference server implementations and ecosystem pointers.
modelcontextprotocol/python-sdk prodmcpapproval Official Python SDK for building MCP servers and clients.
modelcontextprotocol/typescript-sdk prodmcpapproval Official TypeScript SDK for Model Context Protocol servers and clients.
modelcontextprotocol/registry prodmcpapprovalevidence Official community-driven registry service for Model Context Protocol servers.

Official CloudOps Agent Samples

Repo Labels Operator note
aws-samples/sample-cloudops-multi-agent-platform prototypeapprovalevidencewrite AWS Samples reference for a hierarchical multi-agent CloudOps platform using Bedrock AgentCore and Strands Agents SDK.

Official IaC MCP Servers

Repo Labels Operator note
hashicorp/terraform-mcp-server prodmcpapprovalevidencewrite Official HashiCorp Terraform MCP server with registry, HCP Terraform, Terraform Enterprise, and OTel support.
Pulumi MCP Server prodmcpapprovalwrite Official Pulumi hosted MCP server for Pulumi Cloud resources, registry lookup, policies, and Pulumi Neo workflows.
hashicorp/vault-mcp-server prototypemcpapprovalwrite Official HashiCorp Vault MCP server for secrets and mount management, complementing the Terraform MCP server for IaC workflows.
opentofu/opentofu-mcp-server prototypemcpapproval Official OpenTofu MCP server for searching the OpenTofu Registry, retrieving provider/module details, resource and data-source docs, and configuration examples via hosted or local MCP deployment.

Official SRE MCP Servers

Repo Labels Operator note
grafana/mcp-grafana prodmcpapprovalevidencewrite Official Grafana MCP server for Grafana and surrounding observability ecosystem access.
getsentry/sentry-mcp prodmcpapprovalevidencewrite Official Sentry MCP service focused on human-in-the-loop coding agents and debugging workflows.
datadog-labs/mcp-server prodmcpapprovalevidence Official Datadog MCP server documentation and examples for connecting AI agents to Datadog observability.
Honeycomb MCP docs prodmcpapprovalevidencewrite Official Honeycomb hosted MCP documentation for querying traces, metrics, logs, SLOs, triggers, and AI-optimized observability workflows through OAuth 2.1 or scoped API keys.
Datadog MCP Server setup docs prodmcpapprovalevidence Official Datadog MCP setup documentation, including the ChatGPT setup path.
Splunk MCP Server prodmcpapprovalevidence Splunkbase listing for the Splunk-supported MCP Server for Splunk Platform, Enterprise, and Cloud customers.
PagerDuty/pagerduty-mcp-server prodmcpapprovalwrite Official PagerDuty MCP server for incidents, services, schedules, event orchestrations, and embedded incident UIs.
newrelic/mcp-server prodmcpapprovalevidence Official New Relic MCP server for APM, dashboard, and NRQL-based observability context.
dynatrace-oss/dynatrace-mcp prodmcpapprovalevidencewrite Official Dynatrace open-source MCP server for DQL querying, anomaly/incident/Kubernetes investigation, Davis Copilot AI chat, and deployment automation.
Elastic Agent Builder MCP server docs prodmcpapprovalevidence Official Elastic documentation for exposing Agent Builder tools through MCP with Kibana URL and API-key authentication.

Official Agent Skills and Frameworks

Repo Labels Operator note
microsoft/azure-devops-skills prodwrite Official Microsoft Azure DevOps skill examples; approval gates should be verified per skill.
microsoft/skills prodmcpapproval Official Microsoft skills, MCP configurations, custom agents, and AGENTS.md guidance for coding agents.
microsoft/azure-skills prodmcpapprovalwrite Official Azure skills plugin with Azure skills, Azure MCP tools, and Foundry MCP coverage.
google/skills prodapproval Official Google Agent Skills repository for Google products and technologies.
google/adk-python prodapprovalevidence Official Google Agent Development Kit for building, evaluating, and deploying agents.
GoogleCloudPlatform/agent-starter-pack prodapprovalevidence Official Google Cloud starter pack for shipping agents with CI/CD, evaluation, observability, and security.
harness/harness-skills prodapprovalwrite Official Harness agent skills for Claude Code, Cursor, and GitHub Copilot enabling natural-language CI/CD automation via harness/mcp-server.

Official Platform Agent Toolkits

Repo Labels Operator note
databricks-solutions/ai-dev-kit prodmcpapprovalevidencewrite Databricks field-engineering AI Dev Kit with Databricks MCP server, Databricks skills, tools core, and builder app support.
kubeflow/mcp-server prodmcpapprovalwrite Official Kubeflow MCP server for AI-assisted development with Kubeflow tools.
backstage/backstage (mcp-actions-backend) prodmcpapprovalwrite Official CNCF Backstage plugin that exposes Internal Developer Portal actions as MCP tools for AI agents.

Official Diagramming and Architecture MCP Tools

Repo Labels Operator note
jgraph/drawio-mcp prodmcpapproval draw.io MCP server and Claude Code plugin for generating, opening, and exporting draw.io diagrams with shape search.

Official Browser Automation and Debugging MCP Servers

Repo Labels Operator note
ChromeDevTools/chrome-devtools-mcp prodmcpapprovalevidencewrite Official Chrome DevTools MCP server for browser debugging, performance tracing, network inspection, and DOM automation in coding agents.
microsoft/playwright-mcp prodmcpapprovalwrite Official Microsoft Playwright MCP server exposing accessibility-tree browser automation for web QA, scraping, debugging, and exploratory agent loops.

Official Data Platform MCP Servers

Repo Labels Operator note
mongodb-js/mongodb-mcp-server prodmcpapprovalwrite Official MongoDB MCP server (public preview) connecting agents to MongoDB Community, Enterprise, and Atlas deployments.
redis/mcp-redis prodmcpapprovalwrite Official Redis MCP Server for natural-language Redis data management, cache/session workflows, vector search, streams, pub/sub, and Redis documentation lookup.
googleapis/mcp-toolbox prodmcpapprovalevidencewrite Official Google APIs MCP Toolbox for Databases with self-hosted database tools, SDKs, integrated auth, and OpenTelemetry support.
dbt-labs/dbt-mcp prodmcpapprovalwrite Official dbt Labs MCP server for dbt Core, dbt Fusion, and dbt Platform context, including Discovery API, Semantic Layer, project search, and dbt CLI tools.
bytebase/dbhub prodmcpapprovalwrite Bytebase-maintained DBHub MCP server from an independent database DevSecOps vendor for Postgres, MySQL, MariaDB, SQL Server, and SQLite; supports execute_sql plus read-only mode, row limits, and timeouts, so use least-privilege DB credentials and approval gates.

Official FinOps and Cloud-Cost MCP Servers

Repo Labels Operator note
vantage-sh/vantage-mcp-server prodmcpapprovalevidencewrite Official Vantage MCP server for natural-language FinOps workflows over Vantage cloud spend, budgets, anomalies, reports, and provider resources.

Community Discovery and Skills

Repo Labels Operator note
rohitg00/awesome-devops-mcp-servers mcpprototype Community discovery source for MCP ecosystem mapping and candidate integrations.
antonbabenko/terraform-skill prototypeapproval Community Terraform-specific prompt and workflow reference.
addyosmani/agent-skills prodapproval Community engineering skill reference; useful style and structure input for DevOps-specific skills.
Agents365-ai/drawio-skill prototypeapproval Community draw.io skill for natural-language diagram generation, visual self-checking, and exports.
containers/kubernetes-mcp-server prodmcpapprovalevidencewrite Community-maintained Containers org MCP server for Kubernetes and OpenShift with direct Kubernetes API access, multi-cluster support, read-only mode, and a read-only production setup guide.
skyhook-io/radar prodmcpapprovalevidencewrite Community open-source Kubernetes UI with a built-in MCP server: read-only cluster/topology/event queries plus RBAC-scoped write and GitOps/Helm tools for AI-assisted operations.

How to contribute

Start with CONTRIBUTING.md. New entries should update data/repos.yaml, include a real operational use case, classify action level, and explain safety or approval behavior.

Run validation before opening a PR:

python scripts/validate_repos_yaml.py
python scripts/sync_readme_counts.py   # refreshes the intro's entry/category counts
pytest -q
python scripts/run_mock_eval_scenarios.py
python scripts/audit_github_repos.py --workers 12 --fail-on-unreachable