convez.ai
SkillDevOps & InfraestruturaIntermediário
justynroberts

Rundeck Job Builder

justynroberts/runbook-automation-skill

Autor YAML de jobs Rundeck production-ready com validação offline

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude que gera definições de jobs Rundeck em YAML prontas para produção e importação direta. Encapsula regras de estrutura, tipos de steps, sintaxe de variáveis, fluxo de controle e validação, treinado em corpus de milhares de exports reais de Rundeck.

Instalação

$npx convez-ai justynroberts/runbook-automation-skill

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
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar workflows de automação de infraestrutura em Rundeck via conversação natural
  • Validar e revisar YAML de jobs Rundeck antes de importação
  • Gerar jobs com integrações (PagerDuty, ServiceNow, Kubernetes, Ansible, cloud)

Veredito

Skill especializada e bem documentada para quem usa Rundeck em produção. Reduz ciclos de validação manual e incorpora padrões reais extraídos de jobs em uso. Melhor aproveitada por equipes DevOps com Rundeck estabelecido.

README

A tradução para o português deste README ainda está na fila.

Rundeck Job Builder — Claude skill

A Claude skill that authors production-ready, importable Rundeck job definitions as YAML. It encodes the structure, step-type selection, variable syntax, data passing, control flow, security, and validation rules needed to produce jobs that import into Rundeck without hand-editing.

The rules and plugin formats here were mined and validated against a corpus of thousands of real Rundeck job exports, so the step types, config field names, and conventions reflect what actually works in production rather than just the docs.

Install

Copy the skill/ directory into your Claude skills folder as rundeck-job-builder:

git clone https://github.com/justynroberts/runbook-automation-skill.git
cp -R runbook-automation-skill/skill ~/.claude/skills/rundeck-job-builder

Restart Claude Code (or your Claude client) once and the skill is live.

To uninstall: rm -rf ~/.claude/skills/rundeck-job-builder

The bundled validator (skill/scripts/validate_rundeck_job.py) needs python3 with PyYAML (python3 -m pip install pyyaml) if you want to use it; the skill itself is just Markdown and YAML.

Using the skill

Once installed, just ask Claude things like:

  • "Write a Rundeck job that restarts the nginx service on a node group, with a Slack notification on failure."
  • "Create a Rundeck workflow that runs a SQL Runner step and captures the row count into a data variable."
  • "Review this Rundeck YAML and tell me what won't import cleanly."

Claude picks up the skill automatically on any Rundeck-job intent — you don't need to say "use the skill".

What it covers

  • Core rules (skill/SKILL.md): top-level structure, the step-selection decision guide, node vs workflow steps, the @...@ / ${...} variable convention (including the * multiline form, ${export.*}, ${globals.*}), data passing via LogFilters, conditional steps as the preferred branching mechanism, options, security, validation, and a pre-delivery checklist.
  • Plugin catalog (skill/references/plugin-catalog.md): validated config for every generic step — script/exec, sleep, wait-for, job reference, both HTTP plugins, SQL Runner, all Kubernetes steps, Ansible, export-var, log-data, stub-data, progress-badge, RSS, and all LogFilter types.
  • Integrations (skill/references/integrations.md): the PagerDuty family, ServiceNow, and cloud (AWS / GCP / Azure) steps.
  • Workflow & flow (skill/references/workflow-and-flow.md): execution strategies, error handlers, notifications, runner/SaaS selection, and how to recognize (and replace) the legacy ruleset strategy.
  • Windows / PowerShell (skill/references/windows-powershell.md): authoring PowerShell node steps.
  • Examples (skill/examples/): clean, validated Rundeck jobs you can use as reference.

Validator

python3 skill/scripts/validate_rundeck_job.py path/to/job.yaml [more.yaml ...]

Purely local — never connects to, imports into, or modifies any Rundeck server. Exit code is non-zero if any file has errors. Errors are hard problems (bad conditional format, id:/uuid: present, variables in enum-literal fields, broken LogFilter regex). Warnings are smells worth a look. Calibrated against the real-job corpus to flag errors on ~0.1% of genuinely-importable jobs.

Ver o original no GitHub

Bom para

Relacionados