CtrlK
BlogDocsLog inGet started
Tessl Logo

git-workflow

Git workflow patterns including branching strategies, commit conventions, keeping history clean and readable, tidying local commits before merging, merge vs rebase, conflict resolution, and collaborative development best practices for teams of all sizes. Use when choosing a branching strategy, writing commit conventions, cleaning up history before a pull request, deciding merge versus rebase, or resolving conflicts.

60

Quality

70%

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 ./skills/git-workflow/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 reference with concrete, executable commands throughout, but it is a monolithic 710-line document that spends many tokens on knowledge Claude already has (gitignore patterns, basic aliases, quick-reference basics) and splits nothing out into reference files. Destructive/batch operations also lack validation checkpoints, capping workflow clarity.

Suggestions

Split the body into one-level-deep reference files (e.g., references/branching-strategies.md, commit-conventions.md, git-config.md) and keep SKILL.md as a concise overview with clearly signaled links, per the progressive_disclosure rubric.

Remove sections that restate knowledge Claude already has — the gitignore pattern template, basic aliases, the Semantic Versioning explainer, and the 'Quick Reference' table of elementary commands — to recover token budget.

Add explicit validation checkpoints to destructive and batch workflows: a dry-run or branch listing before the 'xargs git branch -d' cleanup pipeline, a verification step before 'git reset --hard', and a test-run command after rebasing instead of the bare 'Tests should still pass' comment.

DimensionReasoningScore

Conciseness

The 710-line body inlines substantial material Claude already knows: a gitignore template for node_modules/.DS_Store, aliases like 'co = checkout', a 'Quick Reference' table of basic commands (git add, git commit, git diff), and a Semantic Versioning explainer — plus redundant repetitions (bad commit examples appear in both 'Commit Messages' and 'Anti-Patterns'; the rebase workflow is repeated in 'Conflict Prevention'). This matches the 2 anchor ('noticeably verbose; several unnecessary explanations or padded sections') rather than 1, because the content is mostly compact commands rather than padded prose, and some sections (branching strategy comparisons, conventional-commit tables) do add genuine value.

2 / 5

Actionability

Nearly every section is copy-paste-ready: complete bash commands for merge/rebase/stash/tag/hooks, a fill-in commit message template enabled via 'git config commit.template .gitmessage', concrete good-vs-bad commit examples, a full PR description template, and runnable pre-commit/pre-push hook scripts. This matches the 5 anchor ('fully executable; copy-paste ready code or commands; specific examples cover the common cases').

5 / 5

Workflow Clarity

Multi-step workflows (Starting a New Feature, Updating a PR, Syncing a Fork, Undoing Mistakes) are numbered and clearly sequenced, which alone would merit 4. However, the rubric caps workflow clarity at 3 when destructive or batch operations lack validation steps: the batch branch-cleanup pipeline ('git branch --merged main | ... | xargs -n 1 git branch -d'), 'git reset --hard HEAD~1', and force-push guidance have no verify-before-acting checkpoints or error-recovery loops — 'Tests should still pass' after rebase is a bare comment with no verification command.

3 / 5

Progressive Disclosure

There are no bundle files (references/, scripts/, assets/ are absent) and no external references at all; the entire 710-line skill is a single monolithic file. Section headers and tables give it real structure and navigability, so it sits above the 2 anchor, but content that clearly belongs in separate reference files (branching strategies, commit conventions, git config/gitignore boilerplate, quick reference) is all inlined, matching the 3 anchor ('some structure but could be better organized; content that should be separate is inline').

3 / 5

Total

13

/

20

Passed

Description

83%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 that clearly states both capabilities and explicit 'Use when' triggers using natural user language. Main gaps are a few missing synonyms/squash-PR-related trigger terms and slight overlap risk with a commit-message-specific skill.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — 'branching strategies, commit conventions, keeping history clean and readable, tidying local commits before merging, merge vs rebase, conflict resolution' — which is specific and action-oriented. It falls short of the 5 anchor because the actions are named as topic areas rather than fully concrete operations, and body capabilities like release tagging, stash, or hooks are absent from the description.

4 / 5

Completeness

It explicitly answers both questions: 'Git workflow patterns including branching strategies, commit conventions... conflict resolution' (what) and 'Use when choosing a branching strategy... or resolving conflicts' (when) with concrete trigger phrases. This matches the 5 anchor directly; the 4 anchor applies only when the 'when' clause is less explicit or specific.

5 / 5

Trigger Term Quality

The 'Use when' clause includes natural phrases users would actually say: 'choosing a branching strategy', 'writing commit conventions', 'cleaning up history before a pull request', 'deciding merge versus rebase', 'resolving conflicts'. Coverage is good but misses common synonyms such as 'squash commits', 'git history', 'rebase conflicts', or 'PR review', which the 5 anchor expects.

4 / 5

Distinctiveness Conflict Risk

The Git-workflow niche is well delimited with distinct triggers (branching, history cleanup, merge vs rebase). Minor overlap risk exists with a dedicated commit-message-generation skill, since 'commit conventions' and 'writing commit conventions' would naturally trigger both — matching the 4 anchor ('minor overlap risk with closely related skills') rather than the 5 anchor's 'minimal conflict risk'.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (717 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

Total

14

/

16

Passed

Repository
affaan-m/ECC
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.