How do I install the Aap Lint skill?

Run npx skillmds@latest add automateyournetwork/aap-lint in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Aap Lint safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Aap Lint?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Aap Lint free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

Who published Aap Lint?

automateyournetwork (@automateyournetwork) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Aap Lint by automateyournetwork — Agent Skill

Name: Aap Lint
Rating: 4.2 (5 reviews)
Author: automateyournetwork

Aap Lint

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.

File contents

Ansible Lint Operations

MCP Server

Repository: sibilleb/AAP-Enterprise-MCP-Server
Transport: stdio (Python via uv run ansible-lint.py)
Install: git clone + uv sync (or pip install -e .)
Requires: ansible-lint installed

Available Tools (9)

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

Key Concepts

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

Workflow: Pre-Deployment Playbook Validation

Syntax check: validate_syntax — catch YAML and Ansible syntax errors
Best practices: check_best_practices — evaluate against standards
Full lint: lint_playbook with production profile — comprehensive check
Review rules: list_rules — understand which rules triggered violations
Report: Pass/fail with specific violations and remediation guidance

Workflow: Project-Wide Quality Audit

Analyze project: analyze_project — scan entire Ansible project structure
Review findings: Group violations by file, rule, and severity
Check roles: lint_role for each role directory
Report: Project quality scorecard with violation counts and trends

Integration with Other Skills

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

Important Rules

Lint before deploy — always validate playbooks before AAP job execution
Profile selection — use production profile for production deployments, basic for development
No credentials in playbooks — lint catches hardcoded secrets; use AAP credential management instead

---name: aap-lintdescription: 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.license: Apache-2.0--- # Ansible Lint Operations ## MCP Server - **Repository**: [sibilleb/AAP-Enterprise-MCP-Server](https://github.com/sibilleb/AAP-Enterprise-MCP-Server) - **Transport**: stdio (Python via `uv run ansible-lint.py`) - **Install**: `git clone` + `uv sync` (or `pip install -e .`) - **Requires**: `ansible-lint` installed ## Available Tools (9) | 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 | ## Key Concepts | 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 | ## Workflow: Pre-Deployment Playbook Validation 1. **Syntax check**: `validate_syntax` — catch YAML and Ansible syntax errors 2. **Best practices**: `check_best_practices` — evaluate against standards 3. **Full lint**: `lint_playbook` with production profile — comprehensive check 4. **Review rules**: `list_rules` — understand which rules triggered violations 5. **Report**: Pass/fail with specific violations and remediation guidance ## Workflow: Project-Wide Quality Audit 1. **Analyze project**: `analyze_project` — scan entire Ansible project structure 2. **Review findings**: Group violations by file, rule, and severity 3. **Check roles**: `lint_role` for each role directory 4. **Report**: Project quality scorecard with violation counts and trends ## Integration with Other Skills | 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 | ## Important Rules - **Lint before deploy** — always validate playbooks before AAP job execution - **Profile selection** — use `production` profile for production deployments, `basic` for development - **No credentials in playbooks** — lint catches hardcoded secrets; use AAP credential management instead

Frequently asked questions