CtrlK
BlogDocsLog inGet started
Tessl Logo

speckit-git-validate

Validate current branch follows feature branch naming conventions

60

Quality

70%

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/speckit-git-validate/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 tight, executable, well-structured validation procedure that assumes Claude's intelligence and wastes no tokens; its only weakness is that the spec-directory lookup step is described narratively rather than as a runnable command.

Suggestions

Provide a concrete command or snippet for the spec-directory existence check (e.g. a `ls specs/ | grep` or `test -d` invocation per branch type) so the whole workflow is copy-paste ready.

Add an explicit recovery action when the spec directory is missing (e.g. 'warn and continue' vs. 'stop') to close the workflow-clarity gap toward a feedback loop.

DimensionReasoningScore

Conciseness

The ~46-line body is lean and efficient, with only concrete commands, complete regex patterns, and example branch names; it assumes Claude's competence and explains no background concepts, matching the score-5 anchor 'every token earns its place'.

5 / 5

Actionability

Executable commands (`git rev-parse --is-inside-work-tree`, `git rev-parse --abbrev-ref HEAD`) and complete regex patterns with examples are provided, but the spec-directory existence check and ticket-segment extraction are described in prose rather than as a copy-paste runnable command, a minor gap that holds it below 5.

4 / 5

Workflow Clarity

The Prerequisites → Validation Rules → Execution → Graceful Degradation sequence is clear with explicit checkpoints (git-availability gate, ✓/⚠/✗ output signals, spec-directory existence check), matching score 4; it stays below 5 because the spec-directory check is asserted without a concrete filesystem command and there is no explicit retry loop on a missing spec dir.

4 / 5

Progressive Disclosure

This is a simple single-purpose skill under 50 lines with well-organized sections and no need for external references; no bundle files exist in references/scripts/assets to verify, so the simple-skill guideline allows a 5 for well-organized sections alone.

5 / 5

Total

18

/

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 is concise and names a clear, specific purpose, but it omits any 'Use when' trigger guidance, which caps both completeness and trigger-term quality at the midpoint.

Suggestions

Add an explicit 'when' clause, e.g. 'Use when the user asks to check or enforce feature-branch naming conventions before working on a spec-kit project.'

Broaden trigger terms with natural synonyms users might say (e.g. 'branch name', 'check branch', 'naming pattern').

Optionally list the concrete validation actions (e.g. 'checks the branch name against Trello, sequential, and timestamp patterns') to lift specificity.

DimensionReasoningScore

Specificity

The phrase 'Validate current branch follows feature branch naming conventions' names the domain (branch naming conventions) plus one concrete action ('validate'), matching the score-3 anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; it falls short of 4 because only a single action is named rather than several specific ones.

3 / 5

Completeness

The description gives a clear 'what' (validate branch naming) but no explicit 'when'/trigger clause, which the rubric guideline caps at 3; it is above 2 because the 'what' is concrete rather than vague.

3 / 5

Trigger Term Quality

Natural terms a user would say ('current branch', 'feature branch', 'naming conventions') are present, but common variations or synonyms are missing and there is no explicit 'Use when' trigger phrase, matching the score-3 anchor; it does not reach 4 because keyword coverage is not broad enough.

3 / 5

Distinctiveness Conflict Risk

'feature branch naming conventions' targets a fairly specific niche with only minor overlap risk against general git skills, matching the score-4 anchor 'Mostly distinct; minor overlap risk'; it is below 5 because no explicit distinct trigger phrase is given.

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
g14wx/staffSync
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.