CtrlK
BlogDocsLog inGet started
Tessl Logo

git-workflow

Manage Git workflows including commits, branches, merges, and collaboration. Use when working with Git repositories, creating commits, managing branches, or resolving conflicts.

78

1.05x
Quality

71%

Does it follow best practices?

Impact

90%

1.05x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

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

Quality

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.

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
supercent-io/skills-template
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.