CtrlK
BlogDocsLog inGet started
Tessl Logo

speckit-git-validate

Validate current branch follows feature branch naming conventions

61

Quality

73%

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

The canonical home for this skill is speckit-git-validate in g14wx/staffSync

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 validation procedure with concrete commands, regex patterns, and exact outputs, plus a thoughtful degradation path. It is well-organized and appropriately scoped, with only trivial conciseness trim possible.

DimensionReasoningScore

Conciseness

The body is lean and command/pattern/output-driven with no padding about what Git is; the only minor trim is the opening restatement of the title, so it sits just below the 'every token earns its place' level 5.

4 / 5

Actionability

Fully executable guidance: concrete git commands (`git rev-parse --abbrev-ref HEAD`), exact regex patterns with worked examples for both branch types, literal output strings, and an env-var fallback path — copy-paste ready and covering the common cases.

5 / 5

Workflow Clarity

A clear, well-sequenced single-purpose validation workflow (Prerequisites -> Validation Rules -> Execution -> Graceful Degradation) with an explicit git-availability checkpoint and a documented fallback; as a simple, non-destructive skill this meets the clear-sequence anchor.

5 / 5

Progressive Disclosure

Under 50 lines with no need for external bundle files (none exist), organized into well-labeled sections (Prerequisites, Validation Rules, Execution, Graceful Degradation); per the simple-skills note this qualifies for the top anchor.

5 / 5

Total

19

/

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, concrete purpose but omits any explicit 'Use when...' trigger guidance, which limits its completeness and trigger-term coverage. It is reasonably specific and distinct, landing at the midpoint of the scale.

Suggestions

Add an explicit 'Use when...' clause naming the trigger scenarios, e.g. 'Use when verifying a spec-kit feature branch name before committing or running spec workflows.'

Broaden trigger terms with natural variations users say, such as 'branch name', 'feature branch', 'naming convention', and 'spec-kit branch'.

Consider naming the concrete actions it performs (e.g. 'checks branch name against sequential and timestamp patterns and locates the matching spec directory') to lift specificity.

DimensionReasoningScore

Specificity

Names the domain (feature branch naming) and one concrete action ("Validate current branch follows..."), matching the 'names domain and 1-2 concrete actions' anchor; it does not list several specific actions, so it is not a 4.

3 / 5

Completeness

Provides a clear 'what' (validate branch naming) but lacks any 'Use when...' or equivalent explicit trigger guidance; per the judging guidelines a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Contains relevant natural keywords like "branch", "feature branch", and "naming conventions", but offers few synonyms or variations a user might also say, fitting the 'some relevant keywords but missing common variations' anchor rather than the comprehensive 4.

3 / 5

Distinctiveness Conflict Risk

Tied to a specific spec-kit branch-naming convention, making it mostly distinct with only minor overlap risk against other general git skills; not a 5 because 'feature branch' is a broadly shared term.

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
mixpanel/mixpanel-headless
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.