CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

jtbd-validator

Validate JTBD (Jobs-to-be-Done) markdown files for correctness and completeness. Use when user says "validate JTBD", "check JTBD", "verify workflow", or "lint JTBD".

85

1.08x
Quality

84%

Does it follow best practices?

Impact

89%

1.08x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

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

A tight, highly actionable skill body: real copy-paste commands, a clear sequenced workflow with error reporting, and validation logic properly externalized to an existing script. The only trims worth making are the duplicated command listings between "How to Use" and "Workflow" and the mock interaction dialogue.

DimensionReasoningScore

Conciseness

The body is lean — bullet lists, commands, and error/fix pairs with no explanation of concepts Claude already knows — but it duplicates the same validate_jtbd.py invocations in both "How to Use" and "Workflow", and the mock "Example Interactions" dialogue is padding, fitting anchor 4's minor-trimmable-instances rather than anchor 5's every-token-earns-its-place. It is well above anchor 3 since no unnecessary conceptual explanation exists.

4 / 5

Actionability

Commands are copy-paste ready and verified real ("python3 .claude/skills/jtbd-validator/scripts/validate_jtbd.py path/to/job.md ." points to an existing script), the batch loop and find command are executable as written, and common errors are shown with concrete error strings and fixes, matching anchor 5's fully-executable comprehensive coverage.

5 / 5

Workflow Clarity

The "When User Requests Validation" section gives a clear 4-step sequence (identify files → run validator → report results → explain fixes) with an error-handling branch, fitting anchor 4. It falls short of anchor 5 because there is no explicit re-validate-after-fix feedback loop for the batch (validate-all) path, and above anchor 3 because checkpoints (validator pass/fail with exit codes 0/1) are explicit rather than implicit.

4 / 5

Progressive Disclosure

Sections are well organized and the heavy logic correctly lives one level deep in a real, clearly-signaled script (scripts/validate_jtbd.py, verified present) with nothing inlined that belongs elsewhere, fitting anchor 4. Not anchor 5 because the body has no clearly-signaled reference/navigation structure beyond the script — the "Common Errors & Fixes" section and mock interactions are reasonable inline, but the ~95-line body offers only the single script reference rather than a well-signaled reference set.

4 / 5

Total

17

/

20

Passed

Description

78%Weight 40%Scale 1-5

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

A strong description with an explicit what-and-when structure and natural, quotable trigger phrases. Its main weakness is specificity — it says "validate for correctness and completeness" without naming the concrete checks the body actually documents.

Suggestions

List the concrete checks in the description (e.g., "Validates frontmatter, step sequencing, API URNs, operationIds, and step dependencies") to raise specificity from one generic action to several concrete ones.

Add missing natural trigger variations such as "check workflow" or "validate job file" to broaden keyword coverage.

Reconsider the generic trigger "verify workflow" — it risks firing for non-JTBD workflow verification requests; scoping it (e.g., "verify JTBD workflow") would reduce conflict risk.

DimensionReasoningScore

Specificity

"Validate JTBD (Jobs-to-be-Done) markdown files for correctness and completeness" names the domain and a single action ("validate"), but does not enumerate the concrete checks performed (frontmatter, step dependencies, API URNs, operationIds), matching the anchor for 1-2 concrete actions without comprehensive coverage. It falls short of anchor 4, which expects several specific actions listed, and above anchor 2 because the domain is clearly named with a real action.

3 / 5

Completeness

It clearly answers both questions: the first sentence states what it does ("Validate JTBD... markdown files for correctness and completeness") and the second gives an explicit "Use when..." clause with concrete quoted trigger phrases, exactly matching anchor 5.

5 / 5

Trigger Term Quality

The explicit triggers "validate JTBD", "check JTBD", "verify workflow", and "lint JTBD" give good natural keyword coverage including a synonym ("lint"), but common variations like "check workflow" or file-extension terms are missing, fitting anchor 4 rather than the comprehensive synonym-plus-extension coverage of anchor 5. Above anchor 3 because multiple natural phrases users would actually say are present.

4 / 5

Distinctiveness Conflict Risk

JTBD validation is a clear niche with distinct triggers, but the trigger "verify workflow" is generic and could plausibly fire for unrelated workflow-verification requests, giving minor overlap risk per anchor 4. Not anchor 5 because of that generic trigger; not anchor 3 because the JTBD-specific terms are highly distinctive.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

mulesoft/mulesoft-dx

Path

.claude/skills/jtbd-validator/SKILL.md

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.