CtrlK
BlogDocsLog inGet started
Tessl Logo

git-workflow-and-versioning

Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams.

53

Quality

58%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/git-workflow-and-versioning/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

35%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill is well-structured with clear headers and contains useful concrete examples (commit formats, branch naming, pre-commit commands), but it is far too verbose for a skill targeting Claude. It spends significant tokens explaining concepts Claude already knows (what git is, why commits matter, DORA research findings) and includes motivational content (Common Rationalizations table, Red Flags) that doesn't add actionable value. The content would benefit from aggressive trimming to focus on the specific conventions and patterns the user wants Claude to follow.

Suggestions

Remove the Overview paragraph, Common Rationalizations table, and explanatory text about why git practices matter — Claude already understands these concepts. Focus on the specific conventions to follow.

Extract the git debugging section, worktrees section, and pre-commit hygiene into separate reference files, keeping SKILL.md as a concise overview with links.

Trim principle explanations to just the convention/rule and example — e.g., for 'Atomic Commits', show the good/bad log examples without the surrounding explanation.

Add explicit error recovery steps to the verification checklist (e.g., 'If secrets found: git reset HEAD <file>, add to .gitignore, re-stage').

DimensionReasoningScore

Conciseness

Significantly verbose for its target audience (Claude). Explains well-known concepts like what trunk-based development is, what DORA research shows, what git bisect does, and includes a 'Common Rationalizations' table that teaches motivation rather than providing actionable instructions. The 'Overview' paragraph explains what git is conceptually. Much of this content is knowledge Claude already possesses.

1 / 3

Actionability

Contains concrete commands and examples (git log, git bisect, pre-commit checks, commit message formats), but much of the content is philosophical guidance and principles rather than executable instructions. The commit message format and pre-commit hygiene sections are actionable, but sections like 'Core Principles' and 'Common Rationalizations' are descriptive rather than instructive.

2 / 3

Workflow Clarity

The 'Save Point Pattern' provides a clear workflow with a decision tree, and the pre-commit hygiene section has a numbered sequence. However, the overall document reads more as a reference guide than a workflow. The verification checklist at the end is good but lacks explicit error recovery steps (e.g., what to do if secrets are found in the diff).

2 / 3

Progressive Disclosure

The document is a monolithic wall of text at ~200+ lines with no references to supporting files (except one mention of 'code-review-and-quality' for splitting strategies). Content like git debugging commands, the rationalizations table, and the worktrees section could be split into separate reference files. The sections are well-organized with headers, but everything is inline.

2 / 3

Total

7

/

12

Passed

Description

82%

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 has good completeness with explicit 'Use when' clauses and decent trigger terms for git-related workflows. However, the overly broad trigger 'Use when making any code change' creates significant conflict risk with other skills, and the 'what' portion is somewhat vague—it could benefit from listing more concrete actions beyond just 'structures git workflow practices'.

Suggestions

Replace 'Use when making any code change' with a more targeted trigger to reduce conflict with other coding skills, e.g., 'Use when following git best practices for commits and branches'.

Add more specific concrete actions to the 'what' portion, e.g., 'Creates feature branches with naming conventions, writes structured commit messages, manages merge conflict resolution, organizes parallel development streams'.

DimensionReasoningScore

Specificity

Names the domain (git workflow) and some actions (committing, branching, resolving conflicts), but 'structures git workflow practices' is vague and doesn't list concrete specific actions like 'create feature branches with naming conventions' or 'write commit messages following conventional commits'.

2 / 3

Completeness

Clearly answers both what ('Structures git workflow practices') and when ('Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams') with explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes strong natural trigger terms users would say: 'committing', 'branching', 'resolving conflicts', 'code change', 'parallel streams'. These cover common git workflow scenarios well.

3 / 3

Distinctiveness Conflict Risk

'Use when making any code change' is overly broad and would likely conflict with many other skills (e.g., coding skills, linting skills, testing skills). The git-specific triggers help, but the blanket 'any code change' clause creates significant overlap risk.

2 / 3

Total

10

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
addyosmani/agent-skills
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.