CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prompt-builder

Build effective prompts for Claude Code skills. Creates clear, specific, actionable prompts using engineering principles, templates, and validation. Use when creating skill instructions, workflow steps, task operations, or any Claude prompt.

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/prompt-builder/SKILL.md

The canonical home for this skill is prompt-builder in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

62%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 skill has a genuinely clear, well-signposted 5-step workflow with strong validation checkpoints and concrete templates, but it badly overspends its token budget by duplicating its own reference material inline and explaining prompt-writing fundamentals Claude already knows. Reference signaling is generic, leaving progressive disclosure underexploited despite a proper bundle being present.

Suggestions

Cut the 'Best Practices', 'Common Mistakes', and 'Quick Reference' sections (they restate the workflow steps almost verbatim) and move the detailed principles, good/bad example pairs, and pattern library into the existing references files, keeping SKILL.md to the 5-step workflow plus navigation.

Replace the generic closing pointer 'see the references/ directory' with explicit per-file links, e.g. 'Templates: see [prompt-templates.md](references/prompt-templates.md); worked examples: [prompt-examples.md](references/prompt-examples.md); automated checks: python scripts/validate-prompt.py <file>'.

Fix the malformed nested code fence in the Step 3 'Examples' section (the inner triple backticks close the outer markdown block early) and add one fully worked example prompt built end-to-end through the 5 steps so the templates are demonstrated, not just sketched.

DimensionReasoningScore

Conciseness

The ~875-line body repeatedly explains concepts Claude already knows ("Use active voice", "Exact numbers, not ranges", defining what makes a task clear) and restates its core content three times across the workflow steps, the Best Practices/Common Mistakes sections, and the Quick Reference. Concrete templates do earn some value, but the padding and duplication are extensive, fitting the 'noticeably verbose; several unnecessary explanations or padded sections' anchor rather than the 'severely verbose' anchor 1.

2 / 5

Actionability

For an instruction-only skill, the guidance is largely executable: a fill-in task definition template, a six-part prompt structure, four scenario templates (workflow step, task operation, analysis, creation), good/bad example pairs, and a real validation script (scripts/validate-prompt.py exists). Minor gaps keep it below anchor 5 — the nested code fence in the 'Examples' template section is malformed (the inner triple backticks prematurely close the block), and the templates remain unfilled skeletons without one complete worked prompt.

4 / 5

Workflow Clarity

The 5-step workflow is clearly sequenced with explicit '→ Output' and '→ Next' transitions at every step, culminating in a dedicated Refine & Validate step with a numeric quality target (all dimensions ≥4), checklists, testing strategies including iteration, and an issue→fix recovery table — matching the anchor's clear sequence, explicit validation, feedback loops, and checklists. No destructive or batch operations apply, so no cap is triggered.

5 / 5

Progressive Disclosure

The bundle structure is real and one level deep (references/prompt-engineering-principles.md, prompt-templates.md, prompt-examples.md, scripts/validate-prompt.py all exist), but the body signals them only generically ("see the references/ directory") without per-topic links, and roughly 600 lines of principles, patterns, and examples that duplicate the reference files are inlined in SKILL.md. This matches the anchor for 'references present but not clearly signaled; content that should be separate is inline'.

3 / 5

Total

14

/

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 well-formed description that clearly states both capability and explicit use conditions with natural trigger phrases in third-person voice. Its main weaknesses are generic action verbs in the 'what' clause and a broad 'any Claude prompt' tail that raises mild conflict risk with other prompt-related skills.

DimensionReasoningScore

Specificity

The description names the domain ("Build effective prompts for Claude Code skills") and its methods ("using engineering principles, templates, and validation"), but the actions are generic build/create verbs rather than a list of several distinct concrete capabilities, matching the 'names domain and 1-2 concrete actions' anchor. It falls below anchor 4 because it does not enumerate multiple specific actions with only minor gaps.

3 / 5

Completeness

It explicitly answers both questions: the 'what' is concrete ("Creates clear, specific, actionable prompts using engineering principles, templates, and validation") and the 'when' is an explicit trigger clause with concrete phrases ("Use when creating skill instructions, workflow steps, task operations, or any Claude prompt"), mirroring the anchor-5 example structure. Voice is third-person/ imperative throughout, so no penalty applies.

5 / 5

Trigger Term Quality

It covers good natural trigger terms — "skill instructions", "workflow steps", "task operations", "any Claude prompt" — that users would plausibly say. It stays below anchor 5 because common variations like "improve prompts", "rewrite prompts", or "prompt engineering" are absent (the body's When-to-Use list even includes 'Improving existing prompts', which the description omits).

4 / 5

Distinctiveness Conflict Risk

The prompt-building niche is mostly distinct with a clear purpose, but the tail clause "or any Claude prompt" broadens the trigger surface to overlap with any general prompt-writing or prompt-improvement skill. Minor overlap risk with closely related skills fits anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

allowed_tools_field

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

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/prompt-builder/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.