CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

jtbd-generator

Generate JTBD (Jobs-to-be-Done) markdown files from step descriptions. Use when creating API workflows, building JTBD files, documenting multi-step processes, or when user says "create a JTBD", "generate workflow", "document these API steps", or "build a job with these operations".

83

3.17x
Quality

81%

Does it follow best practices?

Impact

92%

3.17x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

70%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 strong, highly actionable workflow document with an explicit validated sequence and a full worked example that covers the common case. Its weaknesses are duplicated prose-guidance sections, undefined intermediate data structures in the code examples, and an inline utility API reference whose lib/ files are missing from the provided bundle.

Suggestions

Deduplicate the prose-quality guidance: keep it once (e.g., in 'Tips for Quality Output') and remove the near-verbatim repeats in Step 4's 'Quality guidelines' and 'Notes' to reclaim token budget.

Define the structure of the intermediate state used by the code examples — show the shape of a `previous_steps` entry and a `step_definitions` entry — so the snippets are fully copy-paste executable.

Move the 'Available Python Utilities' function listing into a reference file (e.g., references/utilities.md) and ensure the lib/ modules it documents are actually present alongside scripts/ in the skill bundle.

DimensionReasoningScore

Conciseness

The body is mostly lean, code-driven instruction with no explanation of concepts Claude already knows, but prose-quality guidance is repeated in three places — Step 4's "Quality guidelines" ("Be conversational and helpful", "Explain the 'why'", "Connect steps logically"), "Tips for Quality Output" ("Write conversational prose", "Explain the why", "Connect steps logically"), and "Notes" ("Be conversational and helpful"). That duplicated guidance plus the restating of the workflow order in "Notes" makes it 'mostly efficient but could be tightened' rather than minor-trim (4).

3 / 5

Actionability

Mostly executable guidance: concrete Python calls to search_operations, build_all_inputs, analyze_response_for_operation, build_complete_jtbd with realistic arguments, plus the runnable validator command `python3 .claude/skills/jtbd-generator/scripts/validate_jtbd.py /tmp/generated-job.md .`. The gap keeping it below 5 is that intermediate state like `previous_steps`, `remaining_steps`, and `step_definitions` is used in code without their structure ever being defined — the reader must infer it from the 'Store selection' bullet list.

4 / 5

Workflow Clarity

The 6-step sequence (Parse → Discover → Analyze → Generate → Validate → Save) is explicit and numbered, with a dedicated validation step and a feedback loop — "If validation fails: Explain the error in plain English, Auto-fix when possible... Regenerate and validate again" — an Error Handling section for recovery paths, and a Success Criteria checklist. This matches the anchor 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'.

5 / 5

Progressive Disclosure

Sections are well-organized and the utilities section clearly signals what lives in each lib module, but scored against the actual bundle (which contains only scripts/validate_jtbd.py), the six documented lib/ modules (api_discovery, parameter_analyzer, response_analyzer, jtbd_builder, utils, common_patterns) are absent from the bundle, and the ~40-line inline API reference for them is content that belongs in a separate reference file. This fits 'Some structure but could be better organized; content that should be separate is inline'; it is not a 4 because the referenced utility paths do not resolve within the provided bundle.

3 / 5

Total

15

/

20

Passed

Description

86%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 well-crafted description with an explicit what/when structure and rich, naturally-phrased trigger terms in third-person voice. Its only weaknesses are modest: the capability list could cover more of what the skill does, and a couple of the broader trigger phrases create minor overlap risk with generic documentation skills.

DimensionReasoningScore

Specificity

The description names the domain and a single concrete action — "Generate JTBD (Jobs-to-be-Done) markdown files from step descriptions" — but does not enumerate the other capabilities the skill actually performs (operation discovery, data-flow mapping, validation). It matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; a 4 would require several specific actions listed.

3 / 5

Completeness

It explicitly answers both questions: the first sentence states what the skill does, and "Use when creating API workflows, building JTBD files... or when user says 'create a JTBD'..." gives concrete trigger phrases. This mirrors the anchor-5 example structure exactly; a 4 would mean the 'when' clause was present but less explicit.

5 / 5

Trigger Term Quality

It quotes natural phrases users would actually say — "create a JTBD", "generate workflow", "document these API steps", "build a job with these operations" — plus broader conditions ("creating API workflows", "building JTBD files", "documenting multi-step processes"), covering create/generate/build/document synonym variations. This matches the comprehensive-synonyms anchor; there is no meaningful file extension for the JTBD domain that is missing.

5 / 5

Distinctiveness Conflict Risk

The JTBD/Anypoint niche and quoted triggers like "create a JTBD" are clearly distinct, but "generate workflow" and "documenting multi-step processes" are generic enough to overlap with general workflow-documentation skills. This fits 'Mostly distinct; minor overlap risk with closely related skills'; a 5 would require all triggers to be as specific as the JTBD ones.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (510 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

mulesoft/mulesoft-dx

Path

.claude/skills/jtbd-generator/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.