{"id":38271990,"url":"https://github.com/akin-ozer/cc-devops-skills","last_synced_at":"2026-03-03T21:08:46.805Z","repository":{"id":327739522,"uuid":"1110572485","full_name":"akin-ozer/cc-devops-skills","owner":"akin-ozer","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-10T13:16:16.000Z","size":1212,"stargazers_count":60,"open_issues_count":0,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-10T18:08:25.419Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/akin-ozer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-05T11:52:50.000Z","updated_at":"2026-02-10T13:16:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/akin-ozer/cc-devops-skills","commit_stats":null,"previous_names":["akin-ozer/cc-devops-skills"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/akin-ozer/cc-devops-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akin-ozer%2Fcc-devops-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akin-ozer%2Fcc-devops-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akin-ozer%2Fcc-devops-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akin-ozer%2Fcc-devops-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akin-ozer","download_url":"https://codeload.github.com/akin-ozer/cc-devops-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akin-ozer%2Fcc-devops-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30061006,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T18:21:05.932Z","status":"ssl_error","status_checked_at":"2026-03-03T18:20:59.341Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-17T01:50:35.503Z","updated_at":"2026-03-03T21:08:46.800Z","avatar_url":"https://github.com/akin-ozer.png","language":"HCL","funding_links":[],"categories":["Agent Skills 🤖","Code \u0026 Developer Tools","Browse The Shelves","Agent Skills"],"sub_categories":["General","Agent skill packs"],"readme":"# DevOps skills for Claude Code and Codex\n\n[![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/hesreallyhim/awesome-claude-code)\n\nA practical skill pack for DevOps work in Claude Code and Codex desktop.\n\nThis repository ships **31 skills**:\n- **16 generators** for scaffolding production-ready configs\n- **14 validators** for linting, security checks, and dry-run validation\n- **1 debugger** (`k8s-debug`) for cluster troubleshooting\n\nThe goal is simple: make infra and pipeline work faster without skipping correctness checks.\n\n## Quick Install\n\n### Claude Code Plugin Marketplace\n\n```bash\n/plugin marketplace add akin-ozer/cc-devops-skills\n/plugin install devops-skills@akin-ozer\n```\n\n### Codex Desktop\n\n```bash\n$skill-installer install https://github.com/akin-ozer/cc-devops-skills/tree/main/devops-skills-plugin/skills\n```\n\n### Team Rollout\n\nAdd this to project-level `.claude/settings.json`:\n\n```json\n{\n  \"extraKnownMarketplaces\": {\n    \"devops-skills\": {\n      \"source\": {\n        \"source\": \"github\",\n        \"repo\": \"akin-ozer/cc-devops-skills\"\n      }\n    }\n  }\n}\n```\n\n## Drop-In GitHub Action Wrapper\n\nThis repository also publishes a **drop-in wrapper** around `anthropics/claude-code-action@v1`.\n\nReplace:\n\n```yaml\nuses: anthropics/claude-code-action@v1\n```\n\nWith:\n\n```yaml\nuses: akin-ozer/cc-devops-skills@v1\n```\n\nBehavior stays compatible with upstream `v1`, and DevOps skills are injected by default through:\n\n- Marketplace: `https://github.com/akin-ozer/cc-devops-skills.git`\n- Plugin: `devops-skills@akin-ozer`\n\nTag policy:\n\n- `akin-ozer/cc-devops-skills@v1` tracks this wrapper's latest `v1.x.y` release.\n- The wrapper internally calls `anthropics/claude-code-action@v1` (tag), not a pinned SHA.\n\nTo run as pure passthrough (no auto-injection):\n\n```yaml\nuses: akin-ozer/cc-devops-skills@v1\nwith:\n  inject_devops_skills: \"false\"\n```\n\nDocs and examples:\n\n- Wrapper details: [`docs/drop-in-wrapper.md`](docs/drop-in-wrapper.md)\n- IaC PR review workflow: [`examples/github-actions/iac-pr-review.yml`](examples/github-actions/iac-pr-review.yml)\n- Compatibility drift check: [`scripts/check_upstream_action_surface.sh`](scripts/check_upstream_action_surface.sh)\n\n## How people use this repo\n\nMost workflows are generator + validator loops.\n\n```mermaid\nflowchart LR\n  A[\"Ask for generator skill\"] --\u003e B[\"Create artifact\"]\n  B --\u003e C[\"Run matching validator\"]\n  C --\u003e D{\"Passes checks?\"}\n  D -- \"No\" --\u003e E[\"Patch + re-run checks\"]\n  D -- \"Yes\" --\u003e F[\"Ship to PR/CI\"]\n```\n\nTypical prompts:\n\n```text\nUse terraform-generator to scaffold a reusable AWS VPC module with outputs and examples.\nValidate ./infra/vpc with terraform-validator and list only high-severity findings.\nUse k8s-debug to diagnose pods stuck in Pending in namespace payments.\n```\n\n## What makes these skills useful\n\n- **Local-first validation pipelines**: many validator skills run shell/Python checks directly from their `scripts/` folders.\n- **Tool-aware workflows**: validators integrate with real tools like `terraform`, `tflint`, `checkov`, `helm`, `kubeconform`, `actionlint`, and `act`.\n- **CRD/provider documentation lookup**: Kubernetes/Helm/Terraform/Terragrunt/Ansible flows include explicit doc lookup paths for custom resources.\n- **Fallback behavior is defined**: when a tool is missing, many skills degrade gracefully and tell you exactly what was skipped.\n\n## Skill catalog (31)\n\n### Infrastructure as code (6)\n\n| Skill | Primary use |\n|---|---|\n| `ansible-generator` | Scaffold playbooks, roles, inventories, and vars |\n| `ansible-validator` | Validate/lint/security-check playbooks, roles, and inventories |\n| `terraform-generator` | Generate Terraform modules/resources/variables/outputs |\n| `terraform-validator` | Run Terraform validation, linting, security audit, and planning |\n| `terragrunt-generator` | Scaffold Terragrunt root/child/stack layouts |\n| `terragrunt-validator` | Validate Terragrunt HCL, stacks, and module wiring |\n\n### CI/CD pipelines (8)\n\n| Skill | Primary use |\n|---|---|\n| `azure-pipelines-generator` | Generate `azure-pipelines.yml` and reusable templates |\n| `azure-pipelines-validator` | Validate syntax/security/best-practice rules for Azure Pipelines |\n| `github-actions-generator` | Scaffold workflows and `action.yml` actions |\n| `github-actions-validator` | Validate and test workflows under `.github/workflows` |\n| `gitlab-ci-generator` | Generate `.gitlab-ci.yml` pipelines and job stages |\n| `gitlab-ci-validator` | Validate and secure GitLab CI configs |\n| `jenkinsfile-generator` | Generate declarative/scripted Jenkinsfiles |\n| `jenkinsfile-validator` | Validate Jenkinsfiles and shared-library pipeline code |\n\n### Containers and Kubernetes (7)\n\n| Skill | Primary use |\n|---|---|\n| `dockerfile-generator` | Create production-friendly Dockerfiles |\n| `dockerfile-validator` | Lint and security-check Dockerfiles |\n| `helm-generator` | Scaffold Helm charts, values, and templates |\n| `helm-validator` | Validate chart structure, templates, schemas, and CRD usage |\n| `k8s-yaml-generator` | Generate Kubernetes manifests (including CRDs) |\n| `k8s-yaml-validator` | Validate/lint/dry-run Kubernetes YAML |\n| `k8s-debug` | Troubleshoot runtime cluster failures |\n\n### Observability and Logging (6)\n\n| Skill | Primary use |\n|---|---|\n| `fluentbit-generator` | Generate Fluent Bit pipelines (`INPUT`/`FILTER`/`OUTPUT`) |\n| `fluentbit-validator` | Validate Fluent Bit config quality and safety |\n| `logql-generator` | Build LogQL queries and alert expressions |\n| `loki-config-generator` | Generate Loki server configs for common deployment modes |\n| `promql-generator` | Generate PromQL queries, recording rules, and alerts |\n| `promql-validator` | Validate and optimize PromQL queries/alerts |\n\n### Scripting and Build (4)\n\n| Skill | Primary use |\n|---|---|\n| `bash-script-generator` | Create shell scripts and CLI helpers |\n| `bash-script-validator` | Validate shell scripts with ShellCheck-oriented checks |\n| `makefile-generator` | Generate Makefiles with reusable targets |\n| `makefile-validator` | Validate Makefile correctness and anti-patterns |\n\n## Validator Internals (examples)\n\nThese are real execution patterns inside the skill instructions and scripts:\n\n| Skill | Validation pattern |\n|---|---|\n| `terraform-validator` | `terraform fmt` -\u003e `tflint` -\u003e `terraform validate` -\u003e Checkov -\u003e optional `terraform plan` |\n| `k8s-yaml-validator` | CRD detection -\u003e `kubeconform` schema checks -\u003e `kubectl --dry-run` flow |\n| `helm-validator` | `helm lint` -\u003e `helm template` -\u003e `kubeconform` -\u003e optional cluster dry-run |\n| `github-actions-validator` | `actionlint` static checks + `act` runtime workflow tests |\n| `gitlab-ci-validator` | syntax + best-practice + security checks with strict/test-only modes |\n| `ansible-validator` | syntax/lint/check-mode + role tests + security checks |\n| `dockerfile-validator` | scripted lint/security path with fallback scanning modes |\n\n## Requirements\n\nYou do not need every tool for every skill. Install the tools for the domains you use.\n\n### Baseline\n\n- `bash`\n- `python3` (3.8+ recommended; 3.9+ for some security tooling)\n\n### Common Toolchain by Domain\n\n| Domain | Common tools |\n|---|---|\n| Terraform/Terragrunt | `terraform`, `tflint`, `terragrunt`, `checkov` |\n| Kubernetes/Helm | `kubectl`, `kubeconform`, `helm`, `yamllint` |\n| Docker | `hadolint` |\n| GitHub Actions | `actionlint`, `act` |\n| Shell scripting | `shellcheck` |\n| Prometheus | `promtool` |\n\n### Quick Install (macOS example)\n\n```bash\nbrew install terraform tflint terragrunt helm kubeconform kubectl hadolint\nbrew install actionlint act shellcheck prometheus yq fluent-bit\npipx install ansible ansible-lint checkov yamllint molecule\nhelm plugin install https://github.com/databus23/helm-diff\n```\n\n## Repo Layout\n\n```text\ncc-devops-skills/\n├── action.yml\n├── README.md\n├── LICENSE\n├── docs/\n│   └── drop-in-wrapper.md\n├── examples/\n│   └── github-actions/\n│       └── iac-pr-review.yml\n├── scripts/\n│   └── check_upstream_action_surface.sh\n├── .github/workflows/\n│   └── compat-check.yml\n└── devops-skills-plugin/\n    ├── .claude-plugin/plugin.json\n    └── skills/\n        └── \u003cskill-name\u003e/\n            ├── SKILL.md\n            ├── scripts/\n            ├── references/\n            ├── assets/\n            ├── examples/\n            └── tests/ (or test/)\n```\n\n## Contributing\n\nContributions are welcome for:\n- new skills in adjacent DevOps domains\n- better validator coverage and safer defaults\n- test fixtures and regression tests\n- improved docs/examples for real production scenarios\n\n## License\n\nApache-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakin-ozer%2Fcc-devops-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakin-ozer%2Fcc-devops-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakin-ozer%2Fcc-devops-skills/lists"}