workspace/skills/aap-lint/SKILL.md
ansible-lint playbook and role validation — syntax checking, best practice enforcement, project-wide analysis, rule filtering. Use when validating Ansible playbooks, checking code quality, or enforcing automation best practices before deployment.
npx skillsauth add automateyournetwork/netclaw aap-lintInstall 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-lint.py)git clone + uv sync (or pip install -e .)ansible-lint installed| Tool | What It Does |
|------|-------------|
| lint_playbook | Lint playbook content with configurable profiles and output formats |
| lint_file | Lint a specific Ansible file at a given path |
| lint_role | Comprehensive linting of an Ansible role directory |
| list_rules | Display available ansible-lint rules with optional tag filtering |
| list_tags | Show all tags for categorizing lint rules |
| validate_syntax | Quick syntax validation using syntax-specific rules |
| check_best_practices | Evaluate content against best practices with severity categorization |
| analyze_project | Comprehensive report on an entire Ansible project structure |
| get_ansible_lint_version | Return installed ansible-lint version |
| Concept | What It Means |
|---------|---------------|
| Profile | Lint strictness level (min, basic, moderate, safety, shared, production) |
| Rule | Individual lint check (e.g., yaml[truthy], no-changed-when, fqcn) |
| Tag | Rule category for filtering (e.g., command-shell, formatting, idiom) |
| FQCN | Fully Qualified Collection Name — required in production profiles |
validate_syntax — catch YAML and Ansible syntax errorscheck_best_practices — evaluate against standardslint_playbook with production profile — comprehensive checklist_rules — understand which rules triggered violationsanalyze_project — scan entire Ansible project structurelint_role for each role directory| Skill | How They Work Together |
|-------|----------------------|
| aap-automation | Validate playbooks before running them through AAP job templates |
| aap-eda | Lint rulebook playbook actions before EDA activation |
| github-ops | CI/CD lint checks on PR playbook changes |
| gait-session-tracking | Audit trail for lint results and quality gate decisions |
production profile for production deployments, basic for developmenttesting
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.