CtrlK
BlogDocsLog inGet started
Tessl Logo

managing-git

Manages Git workflows including branching, commits, and pull requests. Use when working with Git, creating commits, opening PRs, managing branches, resolving conflicts, or when asked about version control best practices.

67

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

73%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.

Highly actionable and well-sequenced, with genuine validation checkpoints and error-recovery loops around commits and PRs. The main weakness is token efficiency: a large share of the body restates standard Git knowledge Claude already has, and the 224-line single-file layout leaves the command reference and PR template un-externalized.

Suggestions

Cut sections that restate Claude's built-in knowledge — the conventional-commits types table, 'Common Git Commands', and the GitHub Flow / Git Flow diagrams — keeping only what is project-specific (branch naming pattern, the three checklists, PR template, validation gates); this alone would address the lowest-scoring dimension.

Move the command reference and PR template into a references/ file (e.g. commands.md, pr-template.md) and keep SKILL.md as a concise overview with one-level-deep pointers, bringing the body closer to a true progressive-disclosure structure.

If a command reference is intentionally kept, trim it to the non-obvious variants Claude is less likely to recall verbatim (--autosquash with GIT_SEQUENCE_EDITOR, --force-with-lease, bisect sequences) and drop the everyday commands.

DimensionReasoningScore

Conciseness

Large portions re-teach knowledge Claude already has: the conventional-commits types table, the 'Common Git Commands' section covering standard checkout/add/commit/push/stash/bisect operations, and the GitHub Flow / Git Flow explanations are all built-in knowledge. Only the project-specific pieces (branch naming pattern, the three checklists, PR template, validation gates) add information Claude could not derive. It sits between anchors 1 and 2: the redundancy is extensive, but the material is organized reference tables rather than heavily padded prose, so 2 fits better than 1.

2 / 5

Actionability

Everything shown is executable and copy-paste ready: 'git push -u origin HEAD', 'GIT_SEQUENCE_EDITOR=: git rebase -i --autosquash HEAD~3', the full bisect sequence, two complete example commit messages, concrete branch names, and a fill-in PR template. The common cases are covered, matching anchor 5 rather than 4, which would require gaps in the runnable guidance.

5 / 5

Workflow Clarity

The feature workflow is a clear six-step sequenced checklist, gated by an explicit validation step ('Before pushing, validate commits') with a feedback loop ('If validation fails, use git rebase -i to clean up commit history... before pushing') plus a PR checklist before merge. Destructive commands carry inline caveats ('also discards uncommitted changes', '--force-with-lease'), so the destructive-operations validation cap does not apply; the explicit validation + error recovery + checklists pattern matches anchor 5.

5 / 5

Progressive Disclosure

Well-organized single file: a 'When to Load' section, consistent headers, and cleanly scoped sections make navigation easy — matching anchor 4 (good structure, most content appropriately placed). It is not 5 because that requires well-signaled one-level-deep references, which don't exist here (no references/ files at all), and the under-50-line exception doesn't apply to a 224-line body; it is not 3 because the content is clearly sectioned rather than a misplaced inline dump.

4 / 5

Total

16

/

20

Passed

Description

87%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.

A strong description: third-person, explicitly answers both 'what' and 'when' with concrete trigger phrases spanning branching, commits, PRs, conflicts, and version control. Remaining weaknesses are minor — a few missing synonyms ('merge', 'pull request' spelled out, 'rebase') and a capability list that trails the body's actual scope.

DimensionReasoningScore

Specificity

Names the domain ('Git workflows') and lists several concrete actions — 'branching, commits, and pull requests' — but the 'what' stops short of the body's full scope: conflict resolution, rebasing, history cleanup, and stash/bisect operations are never named as capabilities. This matches anchor 4 (several specific actions, minor gaps) rather than 5 (comprehensive coverage), since the capability list is visibly narrower than what the skill actually covers.

4 / 5

Completeness

Explicitly answers both questions in the anchor-5 pattern: what ('Manages Git workflows including branching, commits, and pull requests') and when ('Use when working with Git, creating commits, opening PRs, managing branches, resolving conflicts, or when asked about version control best practices'). A 'Use when...' clause is present, so no cap applies, and the structure mirrors the anchor-5 example almost exactly.

5 / 5

Trigger Term Quality

Good natural-language coverage: 'working with Git, creating commits, opening PRs, managing branches, resolving conflicts, or when asked about version control best practices' — phrases users would actually say. It falls short of anchor 5's comprehensiveness because a few common synonyms are missing: 'pull request' spelled out, 'merge'/'merge conflicts', 'rebase', and 'repository'/'repo'.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Git workflow management) with distinct, domain-specific triggers — 'Git', 'PRs', 'branches', 'resolving conflicts', 'version control' — that would not naturally fire for non-Git skills. It does not fall to anchor 4 because there is no stated overlap with a neighboring skill's trigger space.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
CloudAI-X/claude-workflow-v2
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.