CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vibe-change

Add one bounded feature to an existing app while preserving current behavior. Do not restart the full new-project workflow.

Quality

66%

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-change/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 admirably lean and densely instructional with a clear implicit sequence and concrete reporting requirements, but its operational vocabulary (checks, checkpoints, user journeys) is never made executable, and the workflow's central verification step delegates to a nonexistent skill file. Defining those terms and fixing or inlining the verification guidance are the highest-impact improvements.

Suggestions

Resolve the dangling reference to ../vibe-verify/SKILL.md — either ship that file in the bundle, inline the verification steps, or drop the pointer.

Make key operational terms executable: specify candidate checks (test suite, typecheck, build), what a "real recovery checkpoint" is (e.g. a git commit or tag), and how to use an existing user journey.

Add a short failure-recovery clause (e.g. "If checks fail, fix and rerun before reporting") and split the three dense paragraphs into 2-3 headed sections for scanability.

DimensionReasoningScore

Conciseness

The body is entirely directive — "Inspect the affected source, applicable repository instructions, current diff, and relevant checks" — with zero concept explanations, zero padding, and no boilerplate; every sentence instructs. This matches "Lean and efficient; assumes Claude's competence; every token earns its place".

5 / 5

Actionability

Concrete deliverables exist ("Report Changed, Checked, Not checked, Next decision, Recovery") and boundaries are explicit ("Confirm only missing acceptance criteria, constraints, and scope"), but operational terms are undefined: what "checks appropriate to the change" means, what a "real recovery checkpoint" is, or how to "use an existing user journey". This fits "Some concrete guidance but incomplete; missing key details" for an instruction-only skill.

3 / 5

Workflow Clarity

The prose implies a coherent sequence (inspect → baseline → preserve work → implement → regression checks → rerun checks → verify → report) with named checkpoints, but the pivotal verification step ("Use ../vibe-verify/SKILL.md for the changed journey") points to a file that does not exist in the bundle, and there is no failure-recovery loop (what to do when checks fail). These validation gaps exceed the "minor" standard of anchor 4.

3 / 5

Progressive Disclosure

Content placement is appropriate for a 13-line skill with nothing wrongly inlined, but the body has no section headers (three unheaded paragraphs) and its single reference, ../vibe-verify/SKILL.md, is clearly signaled yet dangling — the file is absent from the bundle and its parent directory. This fits "could be better organized" with an unusable reference, below anchor 4's "minor organization gaps".

3 / 5

Total

14

/

20

Passed

Description

53%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 states a clear, third-person "what" with a useful boundary against the new-project workflow, but provides no explicit "when" trigger guidance and few natural trigger phrases. Adding a "Use when..." clause with synonyms for small, scoped changes would materially improve it.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to add, modify, or extend a single feature in an existing app without changing other behavior."

Include natural synonyms users would say — "small change", "modify", "extend the app" — alongside "bounded feature".

Briefly enumerate the concrete sub-actions (inspect baseline, implement, verify behavior preserved) to raise specificity beyond a single action.

DimensionReasoningScore

Specificity

"Add one bounded feature to an existing app" names the domain and one concrete action plus a preservation constraint, but there is no enumeration of several specific actions — the closest anchor is "Names domain and 1-2 concrete actions, but not comprehensive". It is above anchor 2 because the action is domain-relevant rather than generic, and below anchor 4 because coverage is a single action, not several.

3 / 5

Completeness

The "what" is clear (add one bounded feature while preserving current behavior), but the "when" is entirely missing — "Do not restart the full new-project workflow" only weakly implies the context by contrast. Per the judging guideline, a missing "Use when..." clause caps completeness at 3.

3 / 5

Trigger Term Quality

Terms like "add", "feature", and "existing app" are relevant keywords a user might echo, matching "Some relevant keywords but missing common variations or synonyms". It falls short of anchor 4 because there is no trigger guidance at all and common natural phrases ("modify", "small change", "extend the app") are absent, while "bounded" is authoring jargon users would not naturally say.

3 / 5

Distinctiveness Conflict Risk

The explicit contrast "Do not restart the full new-project workflow" carves out a niche distinct from scaffolding/new-project skills, and "one bounded feature" narrows scope — fitting "Mostly distinct; minor overlap risk". It is below anchor 5 because "add a feature to an app" still broadly overlaps generic implementation requests with no trigger phrases to disambiguate.

4 / 5

Total

13

/

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-change/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.