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".

3.17x

Quality

83%

Does it follow best practices?

Impact

92%

3.17x

Average score across 3 eval scenarios

Securityby

Passed

No findings from the security scan

Quality

Content

77%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.

The body is highly actionable with a clearly sequenced, validated workflow and executable code throughout. Its main weakness is conciseness/progressive-disclosure: an inlined API reference and several redundant trailing sections inflate the token budget.

Suggestions

Move the 'Available Python Utilities' API reference into a separate REFERENCES.md (one level deep) and keep only the key entry points inline.

Merge or trim the redundant 'Tips for Quality Output', 'Success Criteria', and 'Notes' sections so guidance lives in one place.

Convert inlined data-flow rules and error-handling templates into a short reference if they grow further, keeping SKILL.md an overview.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and actionable, but the trailing 'Tips for Quality Output', 'Success Criteria', and 'Notes' sections restate workflow guidance, and the full 'Available Python Utilities' API reference is inlined, so it could be tightened.	3 / 5
Actionability	Fully executable, copy-paste-ready Python and bash snippets (search_operations, build_all_inputs, validate_jtbd.py invocations) cover the common generation cases.	5 / 5
Workflow Clarity	A clear six-step sequence (Parse -> Discover -> Analyze -> Generate -> Validate -> Save) with an explicit validation checkpoint and a regenerate-and-revalidate feedback loop.	5 / 5
Progressive Disclosure	Well-sectioned structure with a real referenced script (scripts/validate_jtbd.py), but the ~40-line 'Available Python Utilities' API reference is inlined in SKILL.md rather than split into a separate reference file.	3 / 5
	Total	16 / 20 Passed

Description

90%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.

The description is strong: it states a concrete capability and pairs it with explicit, natural-language 'Use when...' trigger guidance in third person. Its only weakness is that specificity lists a single primary action rather than multiple concrete operations.

Suggestions

Add 1-2 more concrete actions (e.g., 'discover API operations, map data flow between steps') to the 'what' clause to lift specificity.

Dimension	Reasoning	Score
Specificity	Names the domain and one concrete action ('Generate JTBD (Jobs-to-be-Done) markdown files from step descriptions') but does not list several specific actions, matching the 1-2 concrete actions anchor.	3 / 5
Completeness	Explicitly answers both what (generate JTBD markdown from step descriptions) and when ('Use when creating API workflows, building JTBD files, documenting multi-step processes, or when user says...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Comprehensive natural trigger phrases users would say, including quoted variants ('create a JTBD', 'generate workflow', 'document these API steps', 'build a job with these operations') and synonyms, matching the comprehensive-coverage anchor.	5 / 5
Distinctiveness Conflict Risk	JTBD/API-workflow generation is a clear niche with distinct triggers, so conflict with unrelated skills is minimal.	5 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: af20367

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.