CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

speckit-git-feature

Create a feature branch with sequential or timestamp numbering

58

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/speckit-git-feature/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 strong, actionable procedure: executable commands for both shells, an explicit naming contract, and a concrete validation regex with abort-on-failure. Its main weaknesses are mild duplication and a stale Output section that contradicts the mandated branch-naming scheme.

Suggestions

Replace the Output section's legacy examples (`003-user-auth`, `20260319-143022-user-auth`) with examples matching the mandated scheme (e.g. `v1/feat/STAFF-0003-create-employee-cqrs-commands`), or remove the section since the naming contract is already stated.

Merge "Graceful Degradation" into "Prerequisites" — both cover the git-unavailable case — and keep one warning message.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence — it never explains git or branching basics — but "Prerequisites" and "Graceful Degradation" overlap, and the "Output" section repeats stale information. These are minor instances of over-explanation that could be trimmed, matching anchor 4 rather than the fully lean anchor 5.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance: the exact availability check (`git rev-parse --is-inside-work-tree`), concrete Bash and PowerShell invocations with a worked example value, an explicit `GIT_BRANCH_NAME` contract, and an exact validation regex. Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

Clear sequence (verify git → resolve inputs → compose name → execute → validate) with an explicit post-creation validation regex and abort-on-mismatch. Not 5 because recovery stops at 'abort and report' with no fix-and-retry guidance, and the final Output section's examples (`003-user-auth`, `20260319-143022-user-auth`) contradict the mandated naming scheme, creating sequence ambiguity.

4 / 5

Progressive Disclosure

Well-organized single-file structure with clear section headers and no nested or buried references; no bundle files exist and none are needed for this single-task skill. Not 5 because at ~105 lines it exceeds the under-50-line simple-skill zone and the contradictory trailing Output section is a minor organization gap, matching anchor 4.

4 / 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 states a clear, single concrete capability but omits any usage trigger and most natural keyword variations, leaving it at the midpoint of the rubric. It also risks misrepresenting the skill: the body explicitly disables sequential/timestamp numbering, so the description's headline behavior contradicts what the skill actually does.

Suggestions

Rewrite the description to reflect the actual behavior (explicit <version>/<type>/<PROJECTCODE>-<task-number>-<description> branch naming via GIT_BRANCH_NAME), since the body states 'Sequential/timestamp numbering... are disabled for this project'.

Add an explicit trigger clause, e.g. 'Use when creating a feature branch for a spec-kit specification or when starting work on a Trello task that needs a branch.'

Include natural keyword variants such as 'git', 'new branch', and 'branch naming' so the skill surfaces for the phrasings users actually say.

DimensionReasoningScore

Specificity

"Create a feature branch with sequential or timestamp numbering" names the git-branching domain and one concrete action plus a specific numbering mechanism, matching 'names domain and 1-2 concrete actions, but not comprehensive'. It is more concrete than the generic anchor 2 ('Processes PDF files') but lacks the several-action coverage of anchor 4.

3 / 5

Completeness

The "what" is clear (create a feature branch with a given numbering scheme) but there is no "Use when..." clause or any equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not 2 because the "what" is concrete, not vague.

3 / 5

Trigger Term Quality

Relevant terms like "feature branch" and "numbering" are present, but common variations a user would naturally say — "git", "new branch", "branch naming", "checkout" — are absent, matching 'some relevant keywords but missing common variations or synonyms'.

3 / 5

Distinctiveness Conflict Risk

"feature branch" combined with the numbering qualifier carves a mostly distinct niche with only minor overlap risk against generic git-branch-creation skills. Not 5 because "create a feature branch" alone could still plausibly trigger for ordinary branch-creation requests.

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