workspace/skills/aap-automation/SKILL.md
Red Hat Ansible Automation Platform — inventory management, job template execution, project SCM sync, ad-hoc commands, host management, Galaxy content discovery. Use when automating infrastructure with Ansible, running playbooks, managing inventories, or searching for Ansible collections and roles.
npx skillsauth add automateyournetwork/netclaw aap-automationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
uv run ansible.py)git clone + uv sync (or pip install -e .)AAP_URL, AAP_TOKEN| Tool | What It Does |
|------|-------------|
| list_inventories | Retrieve all inventories from AAP |
| get_inventory | Fetch details for a specific inventory by ID |
| create_inventory | Create a new inventory with organization and configuration |
| delete_inventory | Remove an inventory from the platform |
| list_hosts | List all hosts within a specific inventory |
| get_host_details | Get comprehensive information about a host |
| get_host_facts | Obtain gathered facts for a host |
| add_host_to_inventory | Add a new host with optional variables |
| update_host | Modify host properties including variables and status |
| delete_host | Remove a host from inventory |
| get_failed_hosts | List hosts with active failures |
| Tool | What It Does |
|------|-------------|
| list_groups | Show all groups in an inventory |
| get_group_details | Retrieve group information |
| create_group | Create a new group within an inventory |
| add_host_to_group | Associate a host with a group |
| remove_host_from_group | Disassociate a host from a group |
| get_host_groups | List all groups containing a host |
| Tool | What It Does |
|------|-------------|
| list_job_templates | List all available job templates |
| get_job_template | Get details for a specific job template |
| create_job_template | Create a new job template with playbook configuration |
| run_job | Execute a job template with optional extra variables |
| list_jobs | Show all jobs in the platform |
| list_recent_jobs | Filter jobs by timeframe |
| job_status | Check current status of a job |
| job_logs | Retrieve execution logs for a job |
| Tool | What It Does |
|------|-------------|
| list_projects | List all projects |
| get_project | Get project details |
| create_project | Create a project with SCM configuration |
| update_project | Trigger an SCM sync |
| list_project_updates | Show all project update jobs |
| get_project_update | Get status of an update job |
| get_project_update_logs | Retrieve logs from an SCM sync |
| Tool | What It Does |
|------|-------------|
| list_inventory_sources | Show all dynamic inventory sources |
| get_inventory_source | Get details for a specific source |
| create_inventory_source | Create a dynamic inventory source |
| update_inventory_source | Modify an existing source |
| delete_inventory_source | Remove an inventory source |
| sync_inventory_source | Trigger a manual sync |
| Tool | What It Does |
|------|-------------|
| run_adhoc_command | Execute Ansible commands directly against hosts |
| get_adhoc_command_status | Check execution status |
| get_adhoc_command_output | Retrieve command output |
| Tool | What It Does |
|------|-------------|
| search_galaxy_collections | Search Ansible Galaxy for collections |
| search_galaxy_roles | Search Galaxy for roles |
| get_collection_details | Get comprehensive collection info |
| get_role_details | Get detailed role info |
| Concept | What It Means | |---------|---------------| | AAP | Ansible Automation Platform — Red Hat's enterprise automation controller | | Inventory | Collection of managed hosts organized by groups | | Job Template | Reusable playbook execution definition with parameters | | Project | SCM-backed collection of Ansible playbooks | | Ad-Hoc Command | One-off Ansible module execution against hosts | | Inventory Source | Dynamic inventory pulled from cloud/CMDB/external systems |
list_inventories — find the target inventorylist_hosts — verify target hosts are presentlist_job_templates — locate the playbook to runrun_job — launch the job template with extra vars if neededjob_status — poll until completionjob_logs — check execution outputlist_inventories — enumerate all inventorieslist_hosts — count and list hostsget_failed_hosts — identify hosts with active failuresget_host_facts — verify host data is currentlist_projects — find the projectupdate_project — trigger SCM pullget_project_update — check sync statusget_project_update_logs — verify no errors| Skill | How They Work Together |
|-------|----------------------|
| aap-eda | AAP job execution + EDA event-driven triggers |
| aap-lint | Validate playbooks before running them through AAP |
| netbox-reconcile | Cross-reference AAP inventories with NetBox DCIM |
| nautobot-sot | AAP inventory validation against Nautobot IPAM |
| servicenow-change-workflow | ServiceNow CR gating before AAP job execution |
| github-ops | Commit playbooks and inventory changes to Git |
| pyats-health-check | Device health verification before/after AAP automation |
| gait-session-tracking | Audit trail for all AAP operations |
AAP_URL — AAP Controller API endpoint (e.g., https://aap.example.com/api/controller/v2)AAP_TOKEN — AAP API token (Write scope)testing
Human-in-the-loop escalation via HumanRail — route low-confidence agent decisions, pre-destructive operation approvals, and ambiguous incident tickets to real human engineers. Human answers are verified and returned as structured output. Workers are paid via Lightning Network. Use when the agent is uncertain, when a destructive change needs explicit human sign-off beyond a ServiceNow CR, or when an ambiguous ticket requires human triage before automated handling.
testing
Manage EVE-NG node lifecycle. Use when listing nodes, checking runtime state, creating or deleting nodes, starting or stopping nodes or whole labs, verifying node details, or wiping node NVRAM back to factory defaults.
development
Manage EVE-NG labs and platform inventory. Use when listing labs, checking lab metadata, creating or deleting labs, importing or exporting lab archives, checking EVE-NG health or auth, or verifying available node images before build work.
tools
Execute live CLI commands on running EVE-NG nodes over telnet console. Use when running show commands, making live config changes, verifying protocol state, testing connectivity, checking console readiness, or interacting with IOS, Junos, VPCS, EOS, or NX-OS nodes.