CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-workflow

Squad branching model: dev-first workflow with insiders preview channel

Quality

71%

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 ./.squad-templates/skills/git-workflow/SKILL.md

The canonical home for this skill is git-workflow in microsoft/waza

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, executable operational guide: project-specific conventions are captured concisely with copy-paste-ready commands, decision tables, and gated cleanup steps for every common scenario. The only soft spots are the absence of error-recovery loops and the entirely prose hotfix/promotion pipeline.

DimensionReasoningScore

Conciseness

The body is dense with project-specific conventions Claude could not know (branch naming, insiders channel, .squad union-merge rules) and avoids explaining git basics. Minor trimmable padding exists ("No filesystem collisions, no branch-switching overhead", the explanatory framing around the .squad section), so it sits at 'Efficient; minor instances of over-explanation' rather than the 'every token earns its place' level of 5.

4 / 5

Actionability

Every common case — single-issue workflow, parallel worktrees, multi-repo coordination, cleanup — has complete, copy-paste-ready command sequences with real example values (squad/195-fix-version-stamp-bug, gh pr create --base dev --draft, git worktree add ../squad-195 -b ... origin/dev). This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The issue workflow is a clear 6-step numbered sequence, worktree setup/cleanup is explicitly gated on PR merge, and there are real checkpoints (inspect staged diff before committing, verify cross-repo changes via npm link before pushing). It falls short of 5 because there are no error-recovery feedback loops (e.g., what to do on a failed union merge or red build) and the hotfix path ('cherry-pick to main if urgent') is stated without steps.

4 / 5

Progressive Disclosure

No bundle files exist, so all content is inline in a single well-organized ~200-line file with clear section headers, decision tables (branch model, worktree-vs-sequential), and an anti-patterns summary — matching 'Good structure; most content is appropriately placed'. Not 5 because at this length the multi-repo scenarios (~50 lines) could plausibly live in a separate reference, and the under-50-line simple-skill exception does not apply.

4 / 5

Total

17

/

20

Passed

Description

48%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 identifies its subject precisely but reads as a domain label rather than a capability statement: it lacks action verbs, natural trigger phrases, and any 'use when' guidance. It is distinctive but not informative enough to trigger reliably.

Suggestions

Add an explicit trigger clause, e.g., 'Use when creating branches, opening PRs, publishing preview builds, or routing parallel issues in Squad repos.'

State concrete actions in the description: 'Create squad/{issue}-{slug} branches from dev, open draft PRs targeting dev, publish preview/insiders npm tags, and manage git worktrees for parallel issues.'

Include natural keywords users would actually say — 'git', 'branch', 'PR', 'pull request', 'merge', 'hotfix', 'worktree' — so the skill triggers on ordinary phrasing, not just project jargon.

DimensionReasoningScore

Specificity

The description names the domain ("Squad branching model", "dev-first workflow with insiders preview channel") but contains no action verbs or concrete capabilities — it states what the model is, not what the skill does (e.g., no 'create branches', 'open PRs', 'publish tags'). This matches the anchor 'Names the domain but actions are minimal or generic'; it is above 1 because the domain is specific, and below 3 because no concrete actions are listed.

2 / 5

Completeness

The 'what' is reasonably clear (defines Squad's branching model: dev-first with an insiders channel), but 'when to use it' is entirely absent — there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not 2 because the 'what' is concrete and unambiguous; not 4+ because the 'when' is not even weakly implied.

3 / 5

Trigger Term Quality

Some relevant keywords are present ("branching model", "dev-first", "workflow", "insiders preview channel") that a Squad contributor might echo, but common natural variations users would actually say are missing ("git", "branch", "PR", "pull request", "merge", "hotfix", "publish"). Matches 'Some relevant keywords but missing common variations or synonyms'; below 4 because coverage is thin, above 2 because the keywords present are domain-relevant rather than generic.

3 / 5

Distinctiveness Conflict Risk

The project-specific terms "Squad", "dev-first", and "insiders preview channel" give it a clear niche with minimal overlap risk against generic git skills. Not 5 because a generic branching-workflow skill could still contend for related queries given no distinct trigger phrases; not 3 because it is far more specific than 'Works with document files'-level descriptions.

4 / 5

Total

12

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

bradygaster/squad

Path

.squad-templates/skills/git-workflow/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.