CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vibe-workflow

Select the appropriate planning, implementation, or debugging workflow for an app project.

Quality

67%

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 ./workflow/skills/vibe-workflow/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 a lean, well-organized router with clear scenario branches and honest reporting requirements. Its main weaknesses are an undefined reference to 'the five stages' and occasionally abstract delegation language ('selectively') that leave the reader guessing at specifics.

Suggestions

Enumerate the five stages (or link to where they are defined) — currently 'The five stages are a useful route' points at content the skill never presents.

Replace 'use research, PRD, and technical design skills selectively' with a concrete rule for when each applies (e.g., quick mode vs. unresolved integrations), mirroring the precision already present in the branch descriptions.

Add lightweight section headers (Routing, Delegation, Completion and reporting) so the post-bullet guidance is as scannable as the scenario list.

DimensionReasoningScore

Conciseness

The body is dense with directives and never re-teaches concepts Claude already knows; every line carries guidance (e.g., 'An existing file does not prove that a stage is complete'). A few abstract phrases such as 'use research, PRD, and technical design skills selectively' could be tightened, matching 'Efficient; minor instances of over-explanation that could be trimmed' — not 5 due to those minor trims, not 3 because there are no full unnecessary explanations.

4 / 5

Actionability

The four scenario branches each carry concrete directives, but 'The five stages are a useful route' references stages that are never enumerated anywhere in the skill, and 'selectively' leaves which-skill choices unresolved — missing key details. This matches 'Some concrete guidance but incomplete... missing key details'; not 4 because the undefined stage list is a substantive gap, not a minor one.

3 / 5

Workflow Clarity

The routing decision is clearly structured (new product / existing product / broken behavior / instructions-only) with verification guidance ('use an available verification skill for a relevant user journey', 'distinguish actual results from unperformed checks') and closing/reporting steps. This matches 'Clear sequence with most checkpoints present; minor validation gaps' — not 5 because checkpoints are stated as principles rather than explicit validate-fix-retry loops.

4 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references (none exist in the bundle), and is well organized via an intro, a four-item scenario bullet list, and grouped delegation/reporting guidance. Per the rubric's simple-skill exception, this earns the top anchor: clear, navigable, appropriately self-contained.

5 / 5

Total

16

/

20

Passed

Description

50%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 concise and names a concrete domain and action, but it lacks any 'Use when...' trigger clause, offers thin action coverage, and structurally overlaps with the skills it routes among. It sits squarely at the midpoint of the rubric.

Suggestions

Append an explicit trigger clause, e.g., 'Use when the user asks to plan, build, change, or fix an app and the next step is unclear.'

Enumerate the concrete routing actions (choose research/PRD/design, implement a change, reproduce-and-fix a failure) so the 'what' is comprehensive rather than a single 'select' verb.

Add natural synonyms such as 'build', 'ship', 'fix a bug', or 'new feature' to widen trigger coverage and sharpen distinctiveness against the individual skills it delegates to.

DimensionReasoningScore

Specificity

The description names the domain ("app project") and one concrete action ("Select the appropriate planning, implementation, or debugging workflow"), but offers only a single action verb across three categories rather than several distinct capabilities. It matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' — not 4 because coverage is thin, not 2 because the domain and action are concrete rather than generic.

3 / 5

Completeness

The 'what' is clear (select the appropriate workflow for an app project), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

"planning", "implementation", "debugging", "workflow", and "app project" are terms users would plausibly say, but there are no synonyms or common variations (e.g., 'build', 'ship', 'fix a bug', 'PRD'). This matches 'Some relevant keywords but missing common variations or synonyms'.

3 / 5

Distinctiveness Conflict Risk

As a router for planning, implementation, and debugging, it directly overlaps with the very skills it routes to — a user asking to plan or debug could trigger this instead of the specific skill. 'Somewhat specific but could still overlap with similar skills' fits best; not 4 because the overlap is structural, not minor.

3 / 5

Total

12

/

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

allowed_tools_field

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

Warning

Total

15

/

16

Passed

Repository

KhazP/vibe-coding-prompt-template

Path

workflow/skills/vibe-workflow/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.