CtrlK
BlogDocsLog inGet started
Tessl Logo

git-workflow

This skill should be used when the user asks to "create git commit", "manage branches", "follow git workflow", "use Conventional Commits", "handle merge conflicts", or asks about git branching strategies, version control best practices, pull request workflows. Provides comprehensive Git workflow guidance for team collaboration.

57

Quality

66%

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.

The body is highly actionable — every workflow is concrete, copy-paste-ready bash — but it is bloated: it re-explains standard Git knowledge Claude already has and summarizes its own content twice. Workflows involving destructive operations (branch deletion, push to master, reset --hard) lack validation checkpoints, and two referenced example files do not exist in the bundle.

Suggestions

Cut the generic Git tutorial material (Conventional Commits type table, common .gitignore patterns, merge-vs-rebase basics, and the amend/stash/blame 'Common Issues' section) — Claude already knows Git; keep only the project-specific conventions and move any needed detail into the existing reference files.

Remove one of the two recap sections ('Best Practices Summary' and 'Summary') — they restate the detailed sections almost verbatim and roughly double the token cost of the conclusion.

Add validation checkpoints before destructive steps: verify CI/tests pass before merging to master or develop, and confirm the target commit (e.g., git log inspection or a backup branch) before git reset --hard or branch deletion.

Fix or remove the references to examples/commit-messages.txt and examples/workflow-commands.sh — the examples/ directory does not exist in the bundle, so these are dead pointers.

DimensionReasoningScore

Conciseness

Large portions re-teach Git knowledge Claude already has — a Conventional Commits type table, a generic .gitignore patterns list, a merge-vs-rebase comparison, and a 'Common Issues' section covering amend/stash/blame basics. It is also padded with triple redundancy: the detailed sections, a 'Best Practices Summary' that restates them, and a final 'Summary' that restates them again (~470 lines where the project-specific conventions would fit in far fewer). This fits anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') better than anchor 3, since the padding is repeated across sections rather than incidental.

2 / 5

Actionability

The three workflows (daily development, hotfix, release) are fully executable, copy-paste-ready bash with concrete branch names, commit messages, and tags; conflict resolution, tag operations, and common-issue fixes are all given as exact commands. Specific examples cover the common cases, matching anchor 5. The few comment-only steps (e.g., '# 2. Update version numbers and documentation') are inherently task-specific, not gaps.

5 / 5

Workflow Clarity

The multi-step workflows are clearly numbered and sequenced, but they involve destructive and batch operations with no validation checkpoints — the hotfix/release flows push to master and delete branches without any verify step, and the rollback guidance offers 'git reset --hard abc123' with no safety check (e.g., confirm target with git log or create a backup branch). Per the judging guidelines, missing validation in destructive/batch workflows caps this at 3. It is not a 4 because the gaps are systematic across every workflow, not minor.

3 / 5

Progressive Disclosure

References are one level deep and clearly signaled (each section links a matching references/*.md, with a consolidated list at the end), which is good — but scored against the actual bundle, the body cites 'examples/commit-messages.txt' and 'examples/workflow-commands.sh' in an examples/ directory that does not exist. Additionally, substantial content that mirrors existing reference files is fully inlined (.gitignore standards despite references/gitignore-guide.md, tag management, common issues). Broken references plus inlined content that should live in the reference files place this at anchor 3 rather than 4.

3 / 5

Total

13

/

20

Passed

Description

75%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 solid description with explicit, natural trigger phrases covering the main task areas, written in acceptable third-person voice. Its main weakness is a generic capability statement ("comprehensive Git workflow guidance") where specific actions would be stronger, and a few missing common trigger synonyms.

DimensionReasoningScore

Specificity

The description enumerates several concrete task areas ("create git commit", "manage branches", "handle merge conflicts", "pull request workflows"), though the capability statement itself is one generic phrase ("Provides comprehensive Git workflow guidance"). It sits between anchor 3 (1-2 concrete actions) and anchor 5 (comprehensive concrete actions) — several specific areas with minor gaps (no mention of tags, releases, or rebase), matching anchor 4.

4 / 5

Completeness

Both 'what' ("Provides comprehensive Git workflow guidance for team collaboration") and 'when' ("This skill should be used when the user asks to...") are explicitly present, and the 'when' clause includes concrete trigger phrases — so the anchor-3 cap for missing trigger guidance does not apply. It is not anchor 5 because the 'what' is generic guidance-speak rather than enumerated concrete capabilities.

4 / 5

Trigger Term Quality

Natural phrases users would actually say are well covered ("create git commit", "manage branches", "handle merge conflicts", "follow git workflow", "use Conventional Commits") plus topical variants ("git branching strategies", "version control best practices", "pull request workflows"). It falls short of anchor 5 because common variations like "rebase", "write commit message", "undo/revert a commit", or "create a PR" are missing.

4 / 5

Distinctiveness Conflict Risk

Git-workflow governance is a clear niche with distinct, git-specific triggers (Conventional Commits, branch management, merge conflicts), giving minimal conflict risk with unrelated skills. Minor overlap remains with narrower skills (e.g., a dedicated commit-message generator or code-review skill), keeping it at anchor 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
Galaxy-Dawn/claude-scholar
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.