CtrlK
BlogDocsLog inGet started
Tessl Logo

git-workflow

Provides expert guidance on Git operations including branch management, commit best practices, merge conflicts, and version control workflows. Use when the user needs help with Git commands, workflows, or resolving repository issues.

76

Quality

75%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./claude/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 capabilities, includes natural trigger terms users would actually say, 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: 'branch management, commit best practices, merge conflicts, and version control workflows' - these are distinct, actionable capabilities.

3 / 3

Completeness

Clearly answers both what ('expert guidance on Git operations including branch management, commit best practices, merge conflicts, and version control workflows') AND when ('Use when the user needs help with Git commands, workflows, or resolving repository issues').

3 / 3

Trigger Term Quality

Includes natural keywords users would say: 'Git', 'branch', 'commit', 'merge conflicts', 'Git commands', 'workflows', 'repository issues' - good coverage of common terms.

3 / 3

Distinctiveness Conflict Risk

Clear niche focused specifically on Git version control with distinct triggers like 'Git commands', 'merge conflicts', 'repository issues' - unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

50%

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

This skill provides a reasonable overview of Git operations with some useful code snippets, but reads more like a reference card than actionable guidance. It explains concepts Claude already knows (commit types, branch purposes) while lacking the concrete, workflow-integrated examples that would make it truly useful. The safety principles are good but not integrated into the actual command workflows.

Suggestions

Remove the 'Core Responsibilities' descriptive lists and replace with concrete command examples for each operation type

Integrate safety checks directly into workflows (e.g., 'Before rebase: 1. git status (verify clean), 2. git branch backup-$(date +%Y%m%d), 3. git rebase -i HEAD~3')

Add explicit validation/recovery steps to destructive operations like rebase and force push

Consider splitting advanced topics (bisect, cherry-pick, complex merge strategies) into separate reference files

DimensionReasoningScore

Conciseness

The content is reasonably efficient but includes some unnecessary explanation of concepts Claude already knows (e.g., listing commit types, explaining what branches are for). The 'Core Responsibilities' section reads more like a job description than actionable guidance.

2 / 3

Actionability

Provides some concrete code examples (feature branch, commit, rebase, sync), but many sections are descriptive lists rather than executable guidance. The conflict resolution steps are good, but most 'Core Responsibilities' items lack concrete commands.

2 / 3

Workflow Clarity

The conflict resolution section has clear steps, but other multi-step workflows lack explicit validation checkpoints. Safety principles mention verification but don't integrate into workflows with feedback loops (e.g., no 'verify -> fix -> retry' pattern for rebase operations).

2 / 3

Progressive Disclosure

Content is organized with headers but is somewhat monolithic. No references to external files for detailed topics like git-flow patterns, advanced rebasing, or bisect usage. All content is inline when some could be split into focused reference documents.

2 / 3

Total

8

/

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
einverne/dotfiles
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.