By 3A2DEV
AI-assisted Ansible authoring toolkit for Claude Code. Scaffolds, reviews, and updates playbooks, roles, collections, and ansible.cfg files following production best practices.
AI-assisted Ansible authoring toolkit for Claude Code. Scaffolds, reviews, and updates playbooks, roles, collections, and ansible.cfg files following production best practices. Sub-commands: new-playbook, review-playbook, update-playbook, new-role, review-role, update-role, new-collection, review-collection, update-collection, new-conf, review-conf, update-conf. Runs discovery (CLAUDE.md to ansible.cfg to README to filesystem) at the start of every command.
Scaffold a new Ansible collection. Triggered by /new-collection. Collects collection_path, namespace, and collection name, then generates galaxy.yml, README.md, CHANGELOG.md, LICENSE, meta/runtime.yml, plugin skeletons (module, filter, lookup), roles directory, playbooks directory, and docs structure. Shows summary before writing.
Generate an annotated ansible.cfg for a specific environment. Triggered by /new-conf. Asks for target environment (dev, CI, or AWX) and generates a fully annotated ansible.cfg covering all official sections including defaults, privilege escalation, SSH connection, vault config, callback plugins, and fact caching. Shows summary before writing.
Create a new Ansible playbook. Triggered by /new-playbook. Runs discovery to find existing roles and collections, then collects path, filename, target hosts/groups, and roles to include. Generates a complete playbook with header, vars block, pre/post tasks, roles section, error handling, and tags. Shows summary before writing. Never overwrites existing files without confirmation.
Scaffold a complete Ansible role. Triggered by /new-role. Resolves role location from FQCN or path, asks whether multi-OS support is needed (RHEL, Solaris, Windows/WinRM), and generates a full role directory structure with realistic starter tasks, handlers, defaults, meta/main.yml, and OS-specific var files if requested. Shows summary before writing.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
▐▛███▜▌ Claude Code
▝▜█████▛▘ Sonnet 4.6 · Claude
▘▘ ▝▝ ansible-designer/
⎿ SessionStart:startup says: [ansible-designer 0.1.7]
──────────────────────────────────────────────────────────
█████╗ ███╗ ██╗███████╗██╗██████╗ ██╗ ███████╗
██╔══██╗████╗ ██║██╔════╝██║██╔══██╗██║ ██╔════╝
███████║██╔██╗ ██║███████╗██║██████╔╝██║ █████╗
██╔══██║██║╚██╗██║╚════██║██║██╔══██╗██║ ██╔══╝
██║ ██║██║ ╚████║███████║██║██████╔╝███████╗███████╗
╚═╝ ╚═╝╚═╝ ╚═══╝╚══════╝╚═╝╚═════╝ ╚══════╝╚══════╝
██████╗ ███████╗███████╗██╗ ██████╗ ███╗ ██╗███████╗██████╗
██╔══██╗██╔════╝██╔════╝██║██╔════╝ ████╗ ██║██╔════╝██╔══██╗
██║ ██║█████╗ ███████╗██║██║ ███╗██╔██╗ ██║█████╗ ██████╔╝
██║ ██║██╔══╝ ╚════██║██║██║ ██║██║╚██╗██║██╔══╝ ██╔══██╗
██████╔╝███████╗███████║██║╚██████╔╝██║ ╚████║███████╗██║ ██║
╚═════╝ ╚══════╝╚══════╝╚═╝ ╚═════╝ ╚═╝ ╚═══╝╚══════╝╚═╝ ╚═╝
───────────────────────────────────────────────────────────────
❯ /ansible-designer
───────────────────────────────────────────────────────────────
AI-assisted Ansible authoring toolkit for Claude Code. Scaffolds, reviews, and updates playbooks, roles, collections, and ansible.cfg files following ansible-core 2.15+ conventions and production best practices.
Using Claude Code:
/plugin marketplace add 3A2DEV/ansible-designer
/plugin install ansible-designer
npx skills add 3A2DEV/ansible-designer --skill '*'
Both options register each skill as a top-level command (e.g. /new-playbook, /review-role).
Requirements:
| Command | Description |
|---|---|
/ansible-designer | Show this overview and available commands |
| Playbooks | |
/new-playbook | Create a new playbook (site, component, or AWX-ready) |
/review-playbook | Review a playbook — severity report, no file modification |
/update-playbook | Update a playbook — diff + confirm before writing |
| Roles | |
/new-role | Scaffold a complete role (asks about multi-OS support) |
/review-role | Review a role — severity report, no file modification |
/update-role | Update a role — diff + confirm before writing |
| Collections | |
/new-collection | Scaffold a new collection with galaxy.yml, plugins, roles |
/review-collection | Review a collection — severity report, no file modification |
/update-collection | Update a collection — diff + confirm before writing |
| ansible.cfg | |
/new-conf | Generate annotated ansible.cfg for dev, CI, or AWX |
/review-conf | Review ansible.cfg — severity report, no file modification |
/update-conf | Update ansible.cfg — diff + confirm before writing |
Every command begins by scanning the project for context:
CLAUDE.md → ansible.cfg → README.md → filesystem scan
Discovery extracts:
roles_path — where roles livecollections_paths — where collections liveThis context is used to suggest smart defaults, resolve FQCNs, and skip questions the user doesn't need to answer.
Every command enforces these rules:
ansible.builtin.copy, never copyinstall, configure, service, validate)npx claudepluginhub 3a2dev/ansible-designer --plugin ansible-designerEnd-to-end Ansible workflow automation: design, create, validate, and review playbooks and roles with orchestrated multi-agent pipelines
Create Ansible playbooks for configuration management
Ansible automation skills for Claude Code: playbook development, debugging, shell conversion, and interactive workflows
Ansible playbook validation and configuration management best practices
Infrastructure management discipline: Ansible automation, container orchestration, Proxmox virtualization, Unraid NAS, and network architecture
Infrastructure as Code and DevOps tools. Includes 0 agents and 15 skills for OpenTofu, Ansible, Hetzner, DigitalOcean, Cloudflare, 1Password CLI, cloud-init, and devops-plan.