Manage Git workflows including commits, branches, merges, and collaboration. Use when working with Git repositories, creating commits, managing branches, or resolving conflicts.
78
71%
Does it follow best practices?
Impact
90%
1.05xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.agent-skills/git-workflow/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description that follows best practices. It uses third person voice, lists specific concrete actions, includes natural trigger terms developers would use, and explicitly states both what the skill does and when to use it. The description is concise yet comprehensive.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'commits, branches, merges, and collaboration' along with 'creating commits, managing branches, or resolving conflicts'. These are concrete, actionable Git operations. | 3 / 3 |
Completeness | Clearly answers both what ('Manage Git workflows including commits, branches, merges, and collaboration') AND when ('Use when working with Git repositories, creating commits, managing branches, or resolving conflicts') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'Git', 'commits', 'branches', 'merges', 'repositories', 'conflicts'. These are common terms developers naturally use when discussing version control. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on Git version control operations. The specific mention of Git, repositories, commits, branches, and merges creates distinct triggers unlikely to conflict with other skills like general file management or code editing. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is a comprehensive Git reference but fails as a SKILL.md by being excessively verbose and teaching Claude things it already knows. While the commands are actionable and executable, the document wastes significant token budget on basic Git operations. The content would benefit from aggressive trimming to focus only on project-specific conventions or non-obvious patterns.
Suggestions
Reduce content by 80%+ by removing standard Git commands Claude already knows; focus only on project-specific conventions (e.g., required commit message format, branch naming rules)
Split into multiple files: keep SKILL.md as a brief overview with links to GIT_TROUBLESHOOTING.md, GIT_WORKFLOWS.md, etc.
Add validation checkpoints to workflows, e.g., 'After rebase, verify with git log --oneline that history looks correct before force pushing'
Remove explanatory content like 'Commit types' definitions unless they differ from conventional commits standard
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~400 lines covering basic Git commands Claude already knows. Explains fundamental concepts like 'git add', 'git status', and commit message formats that don't need teaching. Most content is standard Git documentation that adds no unique value. | 1 / 3 |
Actionability | All commands are fully executable with concrete examples. Code blocks are copy-paste ready with real command syntax and practical examples like the feature development workflow. | 3 / 3 |
Workflow Clarity | Steps are clearly numbered and sequenced in the examples section, but validation checkpoints are largely missing. No explicit verification steps after merges or rebases to confirm success before proceeding. | 2 / 3 |
Progressive Disclosure | Monolithic wall of text with everything inline. No references to external files for advanced topics. Content that could be split (troubleshooting, configuration, advanced workflows) is all in one massive document. | 1 / 3 |
Total | 7 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (525 lines); consider splitting into references/ and linking | Warning |
metadata_version | 'metadata.version' is missing | Warning |
Total | 9 / 11 Passed | |
c033769
Table of Contents
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.