claude-ansible-skills

claude-ansible-skills

A collection of Claude Code skills for Ansible automation development following Red Hat Communities of Practice (CoP) good practices.

Skills

ansible-cop-review

Review Ansible code against all Red Hat CoP automation good practices.

• Severity classification: ERROR, WARNING, INFO
• Diff-aware mode — review only changed files
• Category filtering — focus on specific rule categories
• ansible-lint integration with CoP rule cross-referencing
• Parallel review with subagents for large projects
• Auto-fix offer after reporting

ansible-scaffold-role

Scaffold a new Ansible role fully compliant with CoP rules.

• Interactive variable builder — asks what the role manages (packages, services, configs, users, firewall, storage) and generates realistic defaults, tasks, handlers, and templates
• Task componentization — splits complex roles into install.yml, configure.yml, service.yml with sub-task name prefixes
• Smart handler generation — creates real handlers (restart, reload, validate) based on role purpose
• Collection-aware — uses ansible-creator inside collections, manual creation otherwise
• Falls back to manual creation when ansible-creator is not installed

ansible-scaffold-collection

Scaffold a new Ansible content collection using ansible-creator, then customize for full CoP compliance.

• Plugin scaffolding — generates modules, filters, lookup, and action plugin skeletons with proper docstrings and FQCN examples
• Delegates role creation to the full ansible-scaffold-role skill process
• CI/CD pipeline generation for GitHub Actions or GitLab CI (lint, test, build, publish)
• Changelog setup with antsibull-changelog
• Generates collection-level CLAUDE.md for future Claude Code sessions
• Falls back to manual creation when ansible-creator is not installed

ansible-scaffold-ee

Scaffold a new Ansible execution environment project using ansible-creator.

• Dependency introspection — auto-detects collections, roles, Python, and system deps from existing project files
• External dependency files — generates requirements.yml, requirements.txt, and bindep.txt for non-trivial EEs
• CI/CD pipeline generation for GitHub Actions or GitLab CI (build, test, push to registry)
• Falls back to manual creation when ansible-creator is not installed

ansible-zen

Display the Zen of Ansible and review code against its 20 principles.

• Display mode — prints the full Zen and explains a random principle with a practical example
• Review mode — evaluates Ansible code for simplicity, readability, and clarity
• Zen Score (1-10) rating with justification
• Principle-grouped findings with before/after code improvements
• Complements ansible-cop-review with philosophical guidance

Project Structure

Each top-level ansible-* directory is a standalone Claude Code plugin with:

ansible-cop-review/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata (name, version, description)
└── skills/
    └── ansible-cop-review/
        └── SKILL.md          # Skill prompt definition

The root .claude-plugin/marketplace.json indexes all plugins for marketplace discovery.

Installation

Plugin install (recommended)

Register the marketplace and install skills as plugins:

/plugin marketplace add https://github.com/leogallego/claude-ansible-skills
/plugin install ansible-cop-review
/plugin install ansible-scaffold-role
/plugin install ansible-scaffold-collection
/plugin install ansible-scaffold-ee
/plugin install ansible-zen

Manual install (symlinks)

Alternatively, clone and symlink individual skill directories. Each skill lives inside <plugin>/skills/<skill-name>/.

Project-level (single project):

git clone https://github.com/leogallego/claude-ansible-skills.git
cd ~/my-ansible-project
mkdir -p .claude/skills
ln -s ~/claude-ansible-skills/ansible-cop-review/skills/ansible-cop-review .claude/skills/ansible-cop-review

Profile-level (all projects):

mkdir -p ~/.claude/skills
ln -s ~/claude-ansible-skills/ansible-scaffold-role/skills/ansible-scaffold-role ~/.claude/skills/ansible-scaffold-role

All skills at once at profile level:

mkdir -p ~/.claude/skills
for plugin in ~/claude-ansible-skills/ansible-*/; do
  skill=$(basename "$plugin")
  ln -s "$plugin/skills/$skill" ~/.claude/skills/"$skill"
done

Usage

Once installed, invoke skills in Claude Code with their slash command:

/ansible-cop-review
/ansible-scaffold-role
/ansible-scaffold-collection
/ansible-scaffold-ee
/ansible-zen

Dependencies