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 developmenttools
Federate your NetClaw with other NetClaw operators over the BGP mesh — exchange capability inventories and ask your claw what a peer can do. (US1; remote invocation and chat land in later phases.)
tools
3D network topology visualization and interactive digital twin in Unreal Engine 5.8 via the built-in UE5 MCP server.
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
IPv4 and IPv6 subnet calculator - CIDR breakdown, usable hosts, previous/next subnets, address classification, VLSM planning, and dual-stack analysis. Use when calculating subnets, figuring out how many hosts fit in a prefix, planning IP addressing, getting wildcard masks for ACLs, or checking if two IPs are in the same subnet.