CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-generator

Meta-skill for creating new Claude Code skills with configurable execution modes. Supports sequential (fixed order) and autonomous (stateless) phase patterns. Use for skill scaffolding, skill creation, or building new workflows. Triggers on "create skill", "new skill", "skill generator".

55

Quality

62%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/skill-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

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 solid description that clearly identifies its niche as a meta-skill for skill creation, includes explicit trigger terms, and answers both what and when. Its main weakness is that the specificity of concrete actions could be improved—it mentions 'configurable execution modes' and phase patterns but doesn't detail the concrete outputs or steps involved in skill creation.

Suggestions

Add more concrete actions describing what the skill produces, e.g., 'Generates SKILL.md files with YAML frontmatter, phase definitions, and instruction content' to improve specificity.

DimensionReasoningScore

Specificity

Names the domain (skill creation) and mentions some actions like 'skill scaffolding' and 'building new workflows', and references specific concepts like 'sequential' and 'autonomous' phase patterns. However, it doesn't list multiple concrete actions in detail—what exactly does it produce, what files, what structure?

2 / 3

Completeness

Clearly answers both 'what' (meta-skill for creating new Claude Code skills with configurable execution modes supporting sequential and autonomous patterns) and 'when' (explicit triggers: 'Use for skill scaffolding, skill creation, or building new workflows. Triggers on "create skill", "new skill", "skill generator"').

3 / 3

Trigger Term Quality

Includes natural trigger terms users would say: 'create skill', 'new skill', 'skill generator', 'skill scaffolding', 'skill creation', 'building new workflows'. These are terms a user would naturally use when wanting to create a new skill.

3 / 3

Distinctiveness Conflict Risk

This is a very specific meta-skill about creating other skills, which is a clear niche. The trigger terms like 'create skill', 'skill generator', and 'skill scaffolding' are highly distinctive and unlikely to conflict with other skills.

3 / 3

Total

11

/

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 has a well-thought-out architecture with clear phase separation and comprehensive reference documentation, but suffers significantly from verbosity and duplication — the Reference Documents section is copy-pasted twice in full. The execution guidance sits in an awkward middle ground between abstract description and executable code, providing pseudocode that illustrates intent but isn't actionable. The skill would benefit greatly from aggressive trimming, deduplication, and moving detailed content into the referenced phase files.

Suggestions

Remove the duplicated 'Reference Documents by Phase' section — it appears twice in full, wasting significant tokens

Choose either the prose execution flow OR the pseudocode execution protocol, not both — they convey the same information redundantly

Move the detailed phase descriptions and execution protocol into the referenced phase files (phases/01-05), keeping only a concise summary in SKILL.md

Add intermediate validation checkpoints between phases 2-4 (e.g., validate directory structure before generating phase files, validate phase files before generating specs)

DimensionReasoningScore

Conciseness

The content is extremely verbose at ~300+ lines with massive duplication — the entire 'Reference Documents by Phase' section is repeated verbatim twice. The ASCII architecture diagrams, while informative, are bulky. The execution flow is described three times: once as a diagram, once as prose, and once as pseudocode. Much of the conceptual explanation (what sequential vs autonomous means) is something Claude already understands.

1 / 3

Actionability

The execution protocol provides pseudocode-style JavaScript that illustrates the flow but isn't truly executable — functions like `generateConfig()`, `generateSkillEntry()`, `generateOrchestrator()` are undefined placeholders. The phase descriptions give concrete tool names (Bash, Write, AskUserQuestion) and specific commands like `mkdir -p`, which adds some actionability, but the core generation logic remains abstract.

2 / 3

Workflow Clarity

The 6-phase pipeline (Phase 0-5) is clearly sequenced with inputs/outputs specified for each phase, and Phase 0 has a mandatory gate ('MUST complete before Phase 1'). However, validation is only present in Phase 5 as a final check rather than having feedback loops between phases. For a skill that generates file structures (a somewhat destructive/batch operation), the lack of intermediate validation checkpoints between phases 2-4 is a gap.

2 / 3

Progressive Disclosure

The skill has excellent reference organization with well-signaled links to specs, templates, and phase guides organized by phase. However, the entire 'Reference Documents by Phase' section is duplicated verbatim, and the main SKILL.md contains too much inline content (full execution protocol pseudocode, detailed phase descriptions) that could be in referenced files. The structure is good in principle but poorly executed due to duplication and excessive inline detail.

2 / 3

Total

7

/

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.