ansible-zen

claude-ansible-skills

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

Skills

ansible-good-practices

Review Ansible code against Red Hat CoP automation good practices loaded from per-section AsciiDoc references.

• Section-selective loading — loads only the reference sections relevant to the files being reviewed
• 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-new-role

Create 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-new-collection

Create 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-new-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-new-ee

Create 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-docs

Answer Ansible questions and review code against official Ansible ecosystem documentation.

• Covers 6 doc sources: ansible-core, ansible-lint, ansible-navigator, ansible-builder, ansible-creator, molecule
• Q&A mode — search docs, answer grounded in official documentation with URL citations
• Code review mode — identify directives/modules in code, review against official docs
• Requires the ansible-know MCP server (v0.7.0+) — install with uvx ansible-know-mcp
• Complements ansible-good-practices (official docs vs CoP rules)

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-good-practices with philosophical guidance

Project Structure

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

ansible-good-practices/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata (name, version, description)
└── skills/
    └── ansible-good-practices/
        └── 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-good-practices
/plugin install ansible-new-role
/plugin install ansible-new-collection
/plugin install ansible-new-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-good-practices/skills/ansible-good-practices .claude/skills/ansible-good-practices

Profile-level (all projects):

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