CtrlK
BlogDocsLog inGet started
Tessl Logo

prompt-generator

Generate or convert Claude Code prompt files — command orchestrators, skill files, agent role definitions, or style conversion of existing files. Follows GSD-style content separation with built-in quality gates. Triggers on "create command", "new command", "create skill", "new skill", "create agent", "new agent", "convert command", "convert skill", "convert agent", "prompt generator", "优化".

67

Quality

81%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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 is a strong skill description that clearly defines its purpose (generating and converting Claude Code prompt files), specifies the types of outputs it handles, and provides an extensive list of explicit trigger terms. It uses proper third-person voice, avoids vague language, and occupies a distinct niche that is unlikely to conflict with other skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: generate prompt files, convert prompt files, and specifies subtypes (command orchestrators, skill files, agent role definitions, style conversion). Also mentions GSD-style content separation and quality gates.

3 / 3

Completeness

Clearly answers both 'what' (generate or convert Claude Code prompt files with specific types and quality gates) and 'when' (explicit trigger phrases listed with 'Triggers on...' clause). Both dimensions are well-covered.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms explicitly listed: 'create command', 'new command', 'create skill', 'new skill', 'create agent', 'new agent', 'convert command', 'convert skill', 'convert agent', 'prompt generator', and even a Chinese term '优化'. These are phrases users would naturally say.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive — targets a very specific niche of Claude Code prompt file generation/conversion with explicit artifact types (command orchestrators, skill files, agent role definitions). The trigger terms are specific enough to avoid conflicts with general coding or document skills.

3 / 3

Total

12

/

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 is a highly actionable and well-structured skill with excellent workflow clarity, featuring explicit validation checkpoints, error recovery paths, and concrete quality gates. However, it suffers significantly from verbosity — the file is extremely long with repeated information (skill vs command distinction stated multiple times), over-detailed tables, and content that should live in the referenced spec files rather than being duplicated inline. The progressive disclosure structure is partially implemented via @-references but undermined by the monolithic inline content.

Suggestions

Move detailed quality gate checks (6b, 6b-skill, 6c) and generation rules (5a, 5a-skill, 5b) into the referenced spec files (command-design-spec.md, agent-design-spec.md) to reduce the SKILL.md to an orchestration overview — currently the specs are referenced but their content appears duplicated inline.

Eliminate repeated explanations of the skill vs command distinction (stated in purpose, step 1, step 5a-skill, and step 6b-skill) — state it once in a concise table and reference that single location.

Condense the parameter tables and path resolution logic — Claude can infer basic path construction and parameter normalization without explicit tables for every case.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~400+ lines. It over-explains concepts Claude already knows (what commands/agents/skills are, how to parse arguments, basic file operations). Many tables and sections repeat information (e.g., the skill vs command distinction is stated 4+ times). The quality gate section alone is massive with checks that could be condensed significantly. Much of this content could be in referenced spec files rather than inline.

1 / 3

Actionability

The skill provides highly concrete, executable guidance throughout: specific bash commands, exact file path patterns, detailed parameter validation rules with regex, structured Agent() call patterns, specific quality gate checks with pass/fail conditions, and concrete status banner templates. Every step has actionable specifics rather than vague directions.

3 / 3

Workflow Clarity

The 8-step process is clearly sequenced with explicit validation checkpoints: Step 6 is a mandatory quality gate with specific pass/fail/review conditions and retry logic, Step 7 includes post-write verification with fallback (Edit tool), and the convert mode has a mandatory content loss verification step (5c.5) that stops on failure. Error recovery paths are well-defined (quality gate failure → re-generate → ask user).

3 / 3

Progressive Disclosure

The skill references external spec and template files via @-references in <required_reading> (command-design-spec.md, agent-design-spec.md, conversion-spec.md, templates), which is good progressive disclosure. However, no bundle files were provided to verify these exist, and the SKILL.md itself is monolithic — much of the detailed content (quality gate checks, conversion rules, generation rules) could be split into the referenced spec files rather than duplicated inline.

2 / 3

Total

9

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

Total

10

/

11

Passed

Repository
catlog22/Claude-Code-Workflow
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.