CtrlK
BlogDocsLog inGet started
Tessl Logo

yaml-master

Execute proactive YAML intelligence: automatically activates when working with YAML files. Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.

32

Quality

17%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/productivity/002-jeremy-yaml-master-agent/skills/yaml-master/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

0%

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

This description is extremely weak across all dimensions. It reads like a template with placeholder text rather than an actual skill description—phrases like 'trigger with relevant phrases based on skill purpose' and 'use when appropriate context detected' are self-referential and provide no useful information. The description fails to communicate what the skill does, when it should be used, or how it differs from other skills.

Suggestions

Replace 'proactive YAML intelligence' with specific concrete actions the skill performs, e.g., 'Validates YAML syntax, converts between YAML and JSON, generates YAML configuration files, and fixes formatting issues.'

Replace the placeholder 'Use when appropriate context detected' with explicit trigger guidance, e.g., 'Use when the user asks about YAML files, .yml/.yaml configuration, YAML syntax errors, or converting data to/from YAML format.'

Remove meta-language like 'Trigger with relevant phrases based on skill purpose' and instead list the actual trigger terms and scenarios that should activate this skill.

DimensionReasoningScore

Specificity

The description uses entirely vague language like 'proactive YAML intelligence' and 'automatically activates' without listing any concrete actions. There are no specific capabilities described—no mention of what it actually does with YAML files (validate, lint, convert, generate, etc.).

1 / 3

Completeness

The 'what' is essentially missing—'YAML intelligence' is not a description of capability. The 'when' clause ('Use when appropriate context detected') is a tautological placeholder that provides zero guidance on when to select this skill.

1 / 3

Trigger Term Quality

The only natural keyword is 'YAML files,' but the rest is filled with meaningless phrases like 'appropriate context detected' and 'relevant phrases based on skill purpose,' which are meta-descriptions rather than actual trigger terms a user would say.

1 / 3

Distinctiveness Conflict Risk

The description is so vague that it could conflict with any skill that touches YAML, configuration files, or data serialization. There are no distinct triggers or specific use cases to differentiate it from other file-processing skills.

1 / 3

Total

4

/

12

Passed

Implementation

35%

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 reasonable high-level framework for YAML validation and formatting but lacks the concrete, actionable guidance that would make it truly useful. The absence of actual YAML examples (before/after), executable code snippets, and specific tool invocations means Claude would need to rely entirely on its own knowledge rather than skill-specific instructions. The skill reads more like a task description than an operational guide.

Suggestions

Add concrete before/after YAML examples showing actual syntax errors and their fixes (e.g., a mis-indented GitHub Actions workflow with the corrected version).

Include executable validation commands or code snippets for each target system (e.g., `yamllint -d relaxed file.yml`, `kubectl apply --dry-run=client -f file.yml`, `docker compose config`).

Replace abstract instructions like 'Parse and validate YAML syntax' with specific techniques or tool invocations Claude should use.

Provide the referenced `SKILL.full.md` bundle file, or inline the essential detailed guidance if the reference cannot be provided.

DimensionReasoningScore

Conciseness

The skill is reasonably concise but includes some unnecessary framing (e.g., 'Proactive YAML intelligence' repeated in overview, the Prerequisites section states obvious things like 'Permission to edit the file(s)'). The instructions describe what to do at a high level rather than providing dense, token-efficient guidance.

2 / 3

Actionability

The skill provides no executable code, no concrete commands (beyond a brief mention of `kubectl apply --dry-run=client`), and no copy-paste-ready examples. The examples section describes inputs/outputs in prose rather than showing actual YAML before/after. Instructions are abstract directives like 'Parse and validate YAML syntax' without specifying how.

1 / 3

Workflow Clarity

Steps are listed in a logical sequence (parse → normalize → validate → identify risks → output), and there's some error handling guidance. However, there are no explicit validation checkpoints or feedback loops (e.g., re-validate after fixes), and the steps lack specificity about what tools or methods to use at each stage.

2 / 3

Progressive Disclosure

The skill references a full detailed guide at `${CLAUDE_SKILL_DIR}/references/SKILL.full.md` and external resources, which is good structure. However, no bundle files were provided, so the referenced file doesn't exist, and the main content itself is thin enough that the reference feels like it's hiding essential content rather than supplementing a complete overview.

2 / 3

Total

7

/

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.