CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

speckit-git-validate

Validate current branch follows feature branch naming conventions

57

Quality

72%

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

78%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 content is a tight, actionable validation procedure with exact patterns, commands, and outputs — exactly the kind of non-derivable detail a skill should carry. Its main weaknesses are the mildly duplicated Git-unavailable handling across two sections and the absence of a concrete command for the spec-directory lookup.

Suggestions

Consolidate the Git-unavailable case into one place: either Prerequisites points to the SPECIFY_FEATURE fallback in Graceful Degradation, or merge the two sections so the skip-vs-fallback behavior is unambiguous.

Provide an executable form of the spec-directory check, e.g. 'ls -d specs/<prefix>-*' or a glob example like 'specs/STAFF-0003-*', so the lookup is copy-paste ready like the other commands.

Clarify which pattern takes precedence when a branch matches multiple conventions (e.g. a sequential branch that also carries a ticket segment).

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: exact regex patterns, concrete commands, and prescribed output strings with no filler or explanations of known concepts. It falls short of 5 due to mild duplication between 'Prerequisites' (skip validation when Git is unavailable) and 'Graceful Degradation' (fallback to SPECIFY_FEATURE), which could be merged into one section.

4 / 5

Actionability

Concrete, copy-paste-ready commands ('git rev-parse --abbrev-ref HEAD'), exact regexes, and example branch names make the guidance mostly executable. It is not 5 because the spec-directory check ('look for specs/<prefix>-*') is described rather than given as an executable command or glob example.

4 / 5

Workflow Clarity

The sequence (check Git -> get branch name -> match patterns -> verify spec directory -> report) is clearly ordered with explicit pass/fail outputs for each branch of the workflow. A minor gap: the Prerequisites section says to skip validation when Git is unavailable, while Graceful Degradation says to fall back to SPECIFY_FEATURE, leaving the exact behavior slightly ambiguous.

4 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and needs no external references; the well-organized sections (Prerequisites, Validation Rules, Execution, Graceful Degradation) satisfy the simple-skill exception for a top score. All content is appropriately inlined with nothing that belongs in a separate file.

5 / 5

Total

17

/

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, distinct capability, but it omits any "when to use" trigger guidance and under-specifies what the validation covers (which conventions, what happens on failure). It reads more like a title than a trigger-ready description.

Suggestions

Add an explicit trigger clause, e.g. 'Use when working on spec-kit feature branches, before committing, or when the user mentions branch naming conventions.'

Mention the concrete outcomes and natural terms users would say: which naming patterns are checked (Trello-style v1/feat/TICKET-1234, sequential, timestamp) and that invalid branches are flagged.

Include domain synonyms such as 'git', 'branch name', and 'spec-kit' so the skill triggers on naturally phrased requests.

DimensionReasoningScore

Specificity

The description names the domain (git branch) and one concrete action ("Validate current branch follows feature branch naming conventions"), but enumerates no further actions or outcomes. It matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' and falls short of level 4, which requires several specific actions listed.

3 / 5

Completeness

The "what" is clear (validate branch naming), but there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not level 4 because the "when" is entirely absent rather than merely weak.

3 / 5

Trigger Term Quality

Relevant keywords like "branch", "feature branch", and "naming conventions" are present, but common variations users would naturally say ("git", "branch name", "spec-kit", "ticket") are missing. It sits at 'Some relevant keywords but missing common variations or synonyms' rather than level 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

Branch-naming validation is a narrow niche with few competing skills, so overlap risk is minor. It does not reach 5 because the description lacks distinct trigger phrases that would fully separate it from generic git-workflow skills.

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

g14wx/staffSync

Path

.claude/skills/speckit-git-validate/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.