convez.ai
Skill
anmolnagpal

devops-skills

anmolnagpal/devops-skills

Ver no GitHub
BomPluginScore · de 0 a 100

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-skills

1 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

Estrelas
8
Forks
2
Acompanhando
0
Saúde
85%
Último commit
há 3 semanas
Versão
v1.5.0
Issues abertas
3
Contribuidores
2

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.

test License: MIT Claude Code Cursor Codex

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 clouddrove plugin — 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 .mdc rules and Codex AGENTS.md so 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:

FlagWhat it installs
--claudeclouddrove 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>)
--codexAGENTS.md into ~/.codex/AGENTS.md (or --project <path>)
--allAll 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:

SourceClaude slashCursor ruleAuto-trigger
skills/tf/SKILL.md/clouddrove:tftf.mdc**/*.tf, **/*.tfvars
skills/k8s/SKILL.md/clouddrove:k8sk8s.mdc**/values*.yaml, **/Chart.yaml, **/templates/*.yaml
skills/ci/SKILL.md/clouddrove:cici.mdc**/.gitlab-ci.yml
skills/github-actions/SKILL.md/clouddrove:github-actionsgithub-actions.mdc**/.github/workflows/*.yml
skills/github/SKILL.md/clouddrove:githubgithub.mdc**/CODEOWNERS, **/.github/dependabot.yml, PR/issue templates
skills/docker/SKILL.md/clouddrove:dockerdocker.mdc**/Dockerfile, **/docker-compose*.yml
skills/finops/SKILL.md/clouddrove:finopsfinops.mdcmanual
skills/owasp/SKILL.md/clouddrove:owaspowasp.mdcmanual
skills/clouddrove:wrapper-tf/SKILL.md/clouddrove:wrapper-tfwrapper-tf.mdc_modules/**/*.tf, environments/**/*.tf, .github/workflows/terraform.yml
skills/deploy/SKILL.md/clouddrove:deploydeploy.mdcmanual
skills/adr/SKILL.md/clouddrove:adradr.mdc**/docs/adr/*.md
skills/skill-creator/SKILL.md/clouddrove:skill-creatorskill-creator.mdcmanual

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

SkillPurpose
/tfTerraform (generic / terraform-aws-modules ecosystem): pre-MR review, AWS resource scaffolding, provider upgrade guidance
/k8sKubernetes/Helm: pre-deploy review, production-ready values scaffolding
/ciGitLab CI/CD: pipeline review, Terraform/Helm pipeline scaffolds
/github-actionsGitHub Actions: workflow review, security hardening (OIDC, pinning), scaffolds
/githubGitHub repo hygiene: settings audit, CODEOWNERS, branch protection, releases
/dockerDockerfile review, image optimization, Compose, registry workflows
/finopsAWS cost: waste detection, right-sizing, Savings Plans/RIs, EKS cost
/owasp-securitySecurity review against OWASP Top 10:2025, ASVS 5.0, Agentic AI risks
/clouddrove:wrapper-tfTeam 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.
/deployDeployment strategy (rolling/blue-green/canary), production-readiness gate (reuses existing rule IDs), and rollback playbook for AWS/EKS
/adrCapture architectural decisions as structured ADRs under docs/adr/
/skill-creatorBuild, 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.

PluginSourceWhat it adds
terraform-code-generationhashicorpTerraform style guide, registry search, import, tests
terraform-module-generationhashicorpModule refactoring and Terraform Stacks
claude-memthedotmackPersistent cross-session memory — Claude remembers past decisions and context
engineering-workflow-skillsmhattingpeteGit operations, code review, feature planning workflows
superpowersobra/superpowersTDD, systematic debugging, brainstorming/planning, and subagent dev workflows
cavemanJuliusBrussee/cavemanUltra-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 installs
  • hub:github-org/repo — for plugins installed via npx 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.

ServerWhat it gives Claude
kubernetes-mcp-serverLive read access to EKS clusters — pods, logs, events, Helm releases
eks-mcp-serverAWS-native EKS ops — cluster diagnostics, CloudWatch, IAM/OIDC, resource management
billing-mcp-serverCost Explorer, budget tracking, savings plan analysis, Compute Optimizer
mcp-atlassianJira + Confluence — JQL search, create/update issues, add comments, transition tickets
outlineOutline 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

  1. Create skills/<name>.md following the format above
  2. Run bash scripts/generate.sh to refresh Cursor (.cursor/rules/<name>.mdc) + Codex (AGENTS.md) adapters
  3. Commit skills/<name>.md, the new .cursor/rules/<name>.mdc, and updated AGENTS.md
  4. Teammates run git pull && ./scripts/install.sh --all to 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

  1. Add a new block to scripts/mcp.sh following 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)
  2. If the server uses AWS credentials, add it to the AWS_MCP_SERVERS list in scripts/set-aws-profile.sh
  3. Commit and push — teammates pick it up on next ./scripts/install.sh
Ver o original no GitHub

Bom para

Relacionados