// Reference for scaffolding Ansible content with ansible-creator. Use ansible-creator to initialize new collections, playbook projects, and execution environments, or to add plugins and resources to existing projects. This skill is the canonical lookup table for which subcommand and flags to use.
Reference for ansible-dev-environment (ade), a pip-like installer for Ansible collections with isolated virtual environments. Use ade to set up development environments that install both Python and collection dependencies, with proper symlinks for editable collection development.
Reference for linting Ansible playbooks, roles, and collections with ansible-lint. Agents should prefer tox -e lint when available, but this skill provides the canonical reference for ansible-lint options, profiles, rule suppression, and configuration when direct invocation is needed or when understanding lint output.
Check out a PR branch, rebase it onto the base branch, push, and wait for CI to complete. Reports whether the rebase alone fixed CI or if further action is needed. Use when a PR is stale and may just need a rebase to pass CI.
Scan Ansible devtools repos for open PRs from renovate and dependabot, check their CI status, and produce a prioritized list of failing PRs. Use to get a quick overview of which bot PRs need attention.
Prepare and submit a pull request. Syncs with upstream, creates a feature branch, runs quality gates (tox -e lint, tox -e py), updates documentation as needed, commits with conventional commits, then creates the PR via gh. Use when the user asks to submit, create, or open a pull request, or says "submit PR", "open PR", "create PR", "new PR".
Use when handling pull request reviews, including automated (Copilot) and human reviewer feedback. Use when responding to PR comments, resolving review threads, or updating PRs after review.
| name | ansible-creator |
| description | Reference for scaffolding Ansible content with ansible-creator. Use ansible-creator to initialize new collections, playbook projects, and execution environments, or to add plugins and resources to existing projects. This skill is the canonical lookup table for which subcommand and flags to use. |
| argument-hint | [subcommand] |
| user-invocable | true |
| metadata | {"author":"Ansible DevTools Team","version":"1.0.0"} |
/ansible-creator # Show full subcommand reference
/ansible-creator init # How to scaffold new projects
/ansible-creator add # How to add plugins/resources
ansible-creator scaffolds Ansible content projects. Use init to create new
projects from scratch and add to extend existing ones with plugins or
resources.
namespace.name format for init collection and init playbook.-o/--overwrite — the command will fail.tox -e lint to verify the generated content passes quality gates. See the /tox skill.add plugin requires the collection root — the path must point to the directory containing galaxy.yml.| Command | What it creates | Example |
|---|---|---|
ansible-creator init collection <ns>.<name> <path> | Full collection skeleton (plugins, roles, tests, docs, galaxy.yml) | ansible-creator init collection myorg.network ~/collections/ansible_collections |
ansible-creator init playbook <ns>.<name> <path> | Playbook project structure | ansible-creator init playbook myorg.deploy ~/projects/deploy |
ansible-creator init execution_env <path> | Execution environment definition files | ansible-creator init execution_env ~/ee-project |
| Command | What it adds |
|---|---|
ansible-creator add resource devcontainer <path> | Dev container configuration |
ansible-creator add resource devfile <path> | Devfile for cloud IDEs |
ansible-creator add resource execution-environment <path> | Sample EE YAML template |
ansible-creator add resource play-argspec <path> | Playbook argument specification examples |
ansible-creator add resource role <path> | New role skeleton |
| Command | What it adds | Example |
|---|---|---|
ansible-creator add plugin action <name> <coll-path> | Action plugin | ansible-creator add plugin action my_action . |
ansible-creator add plugin filter <name> <coll-path> | Filter plugin | ansible-creator add plugin filter my_filter . |
ansible-creator add plugin lookup <name> <coll-path> | Lookup plugin | ansible-creator add plugin lookup my_lookup . |
ansible-creator add plugin module <name> <coll-path> | Module plugin | ansible-creator add plugin module my_module . |
ansible-creator add plugin test <name> <coll-path> | Test plugin | ansible-creator add plugin test my_test . |
| Flag | Purpose |
|---|---|
-o / --overwrite | Overwrite existing files |
-no / --no-overwrite | Fail if destination exists (default) |
--json | Output in JSON format |
-v | Increase verbosity (up to -vvv) |
--log-file <path> | Write log to file |
--na / --no-ansi | Disable colored output |
--ll / --log-level | Set logging level (debug, info, warning, error, critical) |
ansible-creator init collection myorg.mynetwork ~/collections/ansible_collections
cd ~/collections/ansible_collections/myorg/mynetwork
tox -e lint
cd /path/to/collection # must contain galaxy.yml
ansible-creator add plugin module my_new_module .
ansible-creator init execution_env ~/ee-project
Use --overwrite to replace existing files, or choose a clean path:
ansible-creator init collection myorg.mynetwork ~/collections/ansible_collections --overwrite
pip3 install ansible-dev-tools # recommended: includes all devtools
pip3 install ansible-creator # standalone
ansible-creator does not use a configuration file. All options are passed as
CLI flags. Scaffolded projects may include their own pyproject.toml,
galaxy.yml, and tox.ini for downstream configuration.