CtrlK
BlogDocsLog inGet started
Tessl Logo

creating-ansible-playbooks

Execute use when you need to work with Ansible automation. This skill provides Ansible playbook creation with comprehensive guidance and automation. Trigger with phrases like "create Ansible playbook", "automate with Ansible", or "configure with Ansible".

63

Quality

76%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/devops/ansible-playbook-creator/skills/creating-ansible-playbooks/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description adequately identifies the domain (Ansible) and provides explicit trigger guidance, making it functional for skill selection. However, it lacks specificity in concrete actions beyond 'playbook creation' — terms like 'comprehensive guidance and automation' are vague padding. The opening phrase 'Execute use when' is awkward and the description uses imperative voice rather than third person.

Suggestions

Replace vague phrases like 'comprehensive guidance and automation' with specific actions such as 'define roles, manage inventories, configure handlers, write tasks and templates'.

Rewrite in third person voice (e.g., 'Creates Ansible playbooks, manages roles and inventories') instead of the awkward imperative 'Execute use when...'.

DimensionReasoningScore

Specificity

It names the domain (Ansible automation) and mentions 'playbook creation' as an action, but lacks specific concrete actions beyond that. 'Comprehensive guidance and automation' is vague filler rather than listing specific capabilities like 'manage inventories, define roles, configure handlers'.

2 / 3

Completeness

It explicitly answers both 'what' (Ansible playbook creation with guidance and automation) and 'when' (trigger phrases like 'create Ansible playbook', 'automate with Ansible'). The 'Use when' equivalent is present via 'Execute use when you need to work with Ansible automation' and explicit trigger phrases.

3 / 3

Trigger Term Quality

Includes natural trigger phrases users would say: 'create Ansible playbook', 'automate with Ansible', 'configure with Ansible'. These are realistic phrases a user would type when needing Ansible help, and 'Ansible' itself is a strong distinguishing keyword.

3 / 3

Distinctiveness Conflict Risk

Ansible is a very specific tool, and the description clearly scopes to Ansible playbooks and automation. This is unlikely to conflict with other skills unless there are multiple Ansible-related skills, as the trigger terms are domain-specific.

3 / 3

Total

11

/

12

Passed

Implementation

62%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill provides a well-structured workflow for Ansible playbook creation with good validation steps and a useful error handling table. However, it critically lacks executable code examples—no sample playbook YAML, no template snippets, no concrete role structure—which significantly limits actionability for a code-generation skill. The content could also be tightened by removing explanations of concepts Claude already understands about Ansible.

Suggestions

Add at least one complete, executable example playbook YAML (e.g., a minimal Nginx provisioning playbook) and a sample role directory structure with actual file contents.

Remove explanatory text Claude already knows (e.g., 'SSH-based agentless automation', basic prerequisites like Python version) to improve conciseness.

Replace the natural language Examples section with concrete input/output pairs showing a prompt and the expected generated playbook YAML.

Consider extracting the error handling table and resources into a separate reference file to improve progressive disclosure.

DimensionReasoningScore

Conciseness

The content is reasonably structured but includes some unnecessary verbosity. The Overview explains what Ansible does (SSH-based agentless automation) which Claude already knows. The Prerequisites section lists basics like Python version requirements and SSH access that are standard knowledge. The Examples section lists natural language prompts rather than concrete input/output pairs, adding tokens without much value.

2 / 3

Actionability

The instructions provide a clear sequence of steps and mention specific commands like `ansible-lint` and `ansible-playbook --check --diff`, but there are no executable code examples—no sample playbook YAML, no role directory creation commands, no Jinja2 template snippets. For a skill about creating Ansible playbooks, the absence of any concrete playbook code is a significant gap.

2 / 3

Workflow Clarity

The workflow is clearly sequenced from scanning existing files through creation, validation, and idempotency testing. It includes explicit validation checkpoints (step 8 with ansible-lint and dry run, step 9 with idempotency verification). The error handling table provides a feedback loop for common failure modes with specific solutions.

3 / 3

Progressive Disclosure

The content is organized into clear sections (Overview, Prerequisites, Instructions, Output, Error Handling, Examples, Resources) which is good structure. However, with no bundle files, all content is inline in a single file. The detailed error handling table and extensive output specification could potentially be split into reference files, and the Resources section links to external docs but there are no internal references to supplementary files.

2 / 3

Total

9

/

12

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed

Repository
jeremylongshore/claude-code-plugins-plus-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.