devops-skills
anmolnagpal/devops-skills
Multi-tool DevOps skills for Claude Code, Cursor, and Codex — Terraform, Kubernetes, Docker, GitHub Actions, GitLab CI, AWS FinOps, OWASP security.
Instalação
npx convez-ai anmolnagpal/devops-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
devops-skills
One source of DevOps expertise, three AI coding tools. Reusable skills for Claude Code, Cursor, and Codex that review and scaffold Terraform, Kubernetes/Helm, Docker, CI/CD (GitHub Actions + GitLab), AWS FinOps, GitHub repo hygiene, and OWASP security — without you copy-pasting the same prompt into every project.
What you get
- 10 skills that auto-trigger on file globs and answer with structured review output
(
/clouddrove:tf,/clouddrove:k8s,/clouddrove:ci,/clouddrove:github-actions,/clouddrove:github,/clouddrove:docker,/clouddrove:finops,/clouddrove:owasp,/clouddrove:wrapper-tf,/clouddrove:deploy,/clouddrove:adr,/clouddrove:skill-creator) - Packaged as the
clouddroveplugin — installed from this repo's own marketplace, so skills are namespaced(clouddrove)in Claude Code natively - Single source in
skills/<name>/SKILL.md— a generator emits Cursor.mdcrules and CodexAGENTS.mdso every tool stays in sync - One installer with flags —
--claude/--cursor/--codex/--all, global or per-project scope - Curated Claude plugin set — Terraform code/module generation (HashiCorp), claude-mem, superpowers, caveman, engineering-workflow-skills
- MCP servers wired in: Kubernetes live access, EKS ops, AWS Cost Explorer, Atlassian (Jira + Confluence), Outline docs/wiki
New here? Skip to CHEATSHEET.md for one-line prompts per skill.
Quick Start
Multi-tool: works with Claude Code, Cursor, and Codex (same skills, different injection per tool).
Claude Code — install as a plugin (no clone needed):
/plugin marketplace add anmolnagpal/devops-skills
/plugin install clouddrove@devops-skills
Skills then appear as /clouddrove:tf, /clouddrove:deploy, … with a native (clouddrove) label. The install script below does the same automatically (plus Cursor/Codex and MCP).
# Claude Code only
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/anmolnagpal/devops-skills/main/scripts/bootstrap.sh)" -- --claude
# All three tools
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/anmolnagpal/devops-skills/main/scripts/bootstrap.sh)" -- --all
# Interactive (no flags) — prompts for which tools
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/anmolnagpal/devops-skills/main/scripts/bootstrap.sh)"
What each flag does:
| Flag | What it installs |
|---|---|
--claude | clouddrove skills plugin (from this repo's marketplace), team plugins from config/plugins.txt, MCP servers |
--cursor | .cursor/rules/*.mdc into ~/.cursor/rules/ (or --project <path>) |
--codex | AGENTS.md into ~/.codex/AGENTS.md (or --project <path>) |
--all | All three |
Per-tool flags:
./scripts/install.sh --claude --no-mcp --no-plugins # skills only
./scripts/install.sh --cursor --project ~/work/repo # per-project install
./scripts/install.sh --codex --project ~/work/repo
GitLab authentication: If you get a 403, make sure you have access to the repo. You may need to use SSH clone instead — see Manual install below.
Updating
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/anmolnagpal/devops-skills/main/scripts/bootstrap.sh)"
Same command. If the repo is already installed it pulls the latest and re-runs the installer.
Manual install
If you prefer SSH or need to use a different install directory:
git clone git@github.com:anmolnagpal/devops-skills.git ~/devops-skills
~/devops-skills/scripts/install.sh
Skills
Single source: skills/<name>/SKILL.md. The clouddrove plugin bundles them all; the generator emits per-tool adapters via scripts/generate.sh:
| Source | Claude slash | Cursor rule | Auto-trigger |
|---|---|---|---|
skills/tf/SKILL.md | /clouddrove:tf | tf.mdc | **/*.tf, **/*.tfvars |
skills/k8s/SKILL.md | /clouddrove:k8s | k8s.mdc | **/values*.yaml, **/Chart.yaml, **/templates/*.yaml |
skills/ci/SKILL.md | /clouddrove:ci | ci.mdc | **/.gitlab-ci.yml |
skills/github-actions/SKILL.md | /clouddrove:github-actions | github-actions.mdc | **/.github/workflows/*.yml |
skills/github/SKILL.md | /clouddrove:github | github.mdc | **/CODEOWNERS, **/.github/dependabot.yml, PR/issue templates |
skills/docker/SKILL.md | /clouddrove:docker | docker.mdc | **/Dockerfile, **/docker-compose*.yml |
skills/finops/SKILL.md | /clouddrove:finops | finops.mdc | manual |
skills/owasp/SKILL.md | /clouddrove:owasp | owasp.mdc | manual |
skills/clouddrove:wrapper-tf/SKILL.md | /clouddrove:wrapper-tf | wrapper-tf.mdc | _modules/**/*.tf, environments/**/*.tf, .github/workflows/terraform.yml |
skills/deploy/SKILL.md | /clouddrove:deploy | deploy.mdc | manual |
skills/adr/SKILL.md | /clouddrove:adr | adr.mdc | **/docs/adr/*.md |
skills/skill-creator/SKILL.md | /clouddrove:skill-creator | skill-creator.mdc | manual |
All 12 are also injected into AGENTS.md for Codex.
Backlog specs (drafts, not active): skills/specs/ — aws-cost, aws-security, azure-cost, azure-security, gcp-cost, gcp-security, kubernetes-cost, kubernetes-security. Promote to active by adding frontmatter under skills/<name>/SKILL.md.
Edit skills/<name>/SKILL.md, run bash scripts/generate.sh, commit. Re-run ./scripts/install.sh --all to push to local installs.
In Claude Code: invoke with /clouddrove:<skill> (namespaced by the plugin). In Cursor: rules auto-attach via globs:. In Codex: AGENTS.md loaded by default.
What each skill does
| Skill | Purpose |
|---|---|
/tf | Terraform (generic / terraform-aws-modules ecosystem): pre-MR review, AWS resource scaffolding, provider upgrade guidance |
/k8s | Kubernetes/Helm: pre-deploy review, production-ready values scaffolding |
/ci | GitLab CI/CD: pipeline review, Terraform/Helm pipeline scaffolds |
/github-actions | GitHub Actions: workflow review, security hardening (OIDC, pinning), scaffolds |
/github | GitHub repo hygiene: settings audit, CODEOWNERS, branch protection, releases |
/docker | Dockerfile review, image optimization, Compose, registry workflows |
/finops | AWS cost: waste detection, right-sizing, Savings Plans/RIs, EKS cost |
/owasp-security | Security review against OWASP Top 10:2025, ASVS 5.0, Agentic AI risks |
/clouddrove:wrapper-tf | Team standard for AWS Terraform repos on the CloudDrove wrapper pattern: scaffold _modules/<name>/, generate Terraform GitHub Actions CI, review against the wrapper pattern, map to SOC2/GDPR controls. Supersedes /tf on these repos. |
/deploy | Deployment strategy (rolling/blue-green/canary), production-readiness gate (reuses existing rule IDs), and rollback playbook for AWS/EKS |
/adr | Capture architectural decisions as structured ADRs under docs/adr/ |
/skill-creator | Build, test, and iterate new skills |
Plugins
Declared in plugins.txt and installed automatically by install.sh. Skips any already installed.
All plugins live in config/plugins.txt and are installed automatically by install.sh.
| Plugin | Source | What it adds |
|---|---|---|
terraform-code-generation | hashicorp | Terraform style guide, registry search, import, tests |
terraform-module-generation | hashicorp | Module refactoring and Terraform Stacks |
claude-mem | thedotmack | Persistent cross-session memory — Claude remembers past decisions and context |
engineering-workflow-skills | mhattingpete | Git operations, code review, feature planning workflows |
superpowers | obra/superpowers | TDD, systematic debugging, brainstorming/planning, and subagent dev workflows |
caveman | JuliusBrussee/caveman | Ultra-compressed communication mode — cuts ~75% tokens while preserving technical accuracy |
Adding a plugin
Add a line to config/plugins.txt:
name@marketplace— for official Claude plugin marketplace installshub:github-org/repo— for plugins installed vianpx claudepluginhub
If it's from a new marketplace, also add it to config/marketplaces.txt. Then commit and push — teammates pick it up on next ./scripts/install.sh.
MCP Servers
Configured interactively during install.sh. Each server prompts you to install or skip. Already-installed servers are skipped automatically.
| Server | What it gives Claude |
|---|---|
kubernetes-mcp-server | Live read access to EKS clusters — pods, logs, events, Helm releases |
eks-mcp-server | AWS-native EKS ops — cluster diagnostics, CloudWatch, IAM/OIDC, resource management |
billing-mcp-server | Cost Explorer, budget tracking, savings plan analysis, Compute Optimizer |
mcp-atlassian | Jira + Confluence — JQL search, create/update issues, add comments, transition tickets |
outline | Outline docs/wiki — search, read, create/update documents (remote HTTP, browser OAuth) |
Switching AWS profile
If you need to switch the AWS profile used by the AWS MCP servers:
# Interactive
~/devops-skills/scripts/set-aws-profile.sh
# Or directly
~/devops-skills/scripts/set-aws-profile.sh prod
Restart Claude Code after switching.
Repository Structure
devops-skills/
skills/ ← Canonical skill sources (edit here)
tf.md k8s.md ci.md owasp.md docker.md finops.md skill-creator.md
owasp/ ← Reference docs loaded on-demand by /owasp-security
docker/ ← Reference docs + scripts for /docker
finops/ ← Reference docs + scripts for /finops
specs/ ← Backlog spec docs (not active skills)
.cursor/rules/ ← Generated Cursor rules (.mdc) — from scripts/generate.sh
AGENTS.md ← Generated Codex skill doc — from scripts/generate.sh
agents/ ← Reserved for Claude Code agents
hooks/ ← Shipped with the plugin (registered via hooks.json)
hooks.json ← Plugin hook config (uses ${CLAUDE_PLUGIN_ROOT})
session-banner.sh ← SessionStart: prints repo/branch/AWS/kube context
bash-guard.sh ← PreToolUse(Bash): blocks destructive patterns
templates/
CLAUDE.md ← Copy into project repos for always-on team context
settings.json ← Global ~/.claude/settings.json defaults (perm allow/deny)
scripts/
bootstrap.sh ← One-liner installer
install.sh ← Flag dispatcher (--claude / --cursor / --codex / --all)
install-claude.sh ← Claude adapter: skills, plugins, MCP
install-cursor.sh ← Cursor adapter: links .cursor/rules
install-codex.sh ← Codex adapter: links AGENTS.md
generate.sh ← Build Cursor + Codex adapters from skills/*.md
mcp.sh ← Interactive MCP server install (Claude only)
set-aws-profile.sh ← Switch AWS profile for AWS MCP servers
config/
plugins.txt ← Claude plugins to install
marketplaces.txt ← Claude plugin marketplaces
_docs/
CHEATSHEET.md ← Example prompts per skill and MCP server
README.md
Global settings.json
install.sh --claude seeds ~/.claude/settings.json from templates/settings.json on first run. On subsequent runs it merges missing permission entries only — never clobbers existing keys (enabledPlugins, mcpServers, hooks, etc.).
Template ships with a safe DevOps allow-list (read-only kubectl/terraform/aws/git) and deny-list (kubectl delete, terraform apply, terraform destroy, rm -rf, aws s3 rm, aws ec2 terminate-instances). Edit templates/settings.json to change team defaults, commit, teammates re-run ./scripts/install.sh --claude.
Project CLAUDE.md Template
Copy templates/CLAUDE.md into the root of any project repo and fill in the placeholders. Claude Code auto-loads it every session, giving Claude permanent context about your AWS setup, Terraform backend, EKS clusters, and team conventions — without needing to invoke a skill.
cp ~/devops-skills/templates/CLAUDE.md /path/to/your/repo/CLAUDE.md
cp -r ~/devops-skills/templates/.claude /path/to/your/repo/.claude
# Fill in the CLAUDE.md placeholders, then commit both
Adding a New Team Skill
Skills follow a standard format. Use the /skill-creator skill to build and test new ones.
Skill file format
---
name: skill-name
description: "Concise description — include when to use and key trigger keywords"
metadata:
version: 1.0.0
author: Anmol Nagpal
category: devops
updated: YYYY-MM-DD
---
# Skill Title
One-line summary.
## Keywords
keyword1, keyword2, keyword3
## Output Artifacts
| Request | Output |
|---------|--------|
| "do X" | Produces Y |
---
## SECTION — ...
Steps to add
- Create
skills/<name>.mdfollowing the format above - Run
bash scripts/generate.shto refresh Cursor (.cursor/rules/<name>.mdc) + Codex (AGENTS.md) adapters - Commit
skills/<name>.md, the new.cursor/rules/<name>.mdc, and updatedAGENTS.md - Teammates run
git pull && ./scripts/install.sh --allto pick it up
Testing
The installer is tested in Docker on every push to main and every pull request via GitHub Actions (.github/workflows/test.yml). The workflow also fails if generated adapters (.cursor/rules/, AGENTS.md) drift from skills/*.md — run bash scripts/generate.sh and commit.
To run the test locally (requires Docker):
bash _test/test.sh
The test builds _test/Dockerfile, which runs install.sh in a clean container with a stubbed claude CLI and CI=true to skip interactive MCP prompts. It verifies all skills are symlinked and all plugins install without error.
Adding a New MCP Server
- Add a new block to
scripts/mcp.shfollowing the existing pattern (check if installed → prompt → register the server):- Local/stdio servers —
claude mcp add-json <name> '{"command":...,"args":...}' -s user - Remote/HTTP servers (e.g.
outline) —claude mcp add <name> <url> --transport http -s user(auth via browser OAuth on first use)
- Local/stdio servers —
- If the server uses AWS credentials, add it to the
AWS_MCP_SERVERSlist inscripts/set-aws-profile.sh - Commit and push — teammates pick it up on next
./scripts/install.sh