CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-workflow

Follow this team's Git conventions for branching, commit messages, and pull requests.

Quality

80%

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 ./samples/SkillsServer/Skills/git-workflow/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%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 an exemplary lean instruction-only skill: concrete rules, no filler, sensible offloading of commit-style details to a real one-level reference, and a clear section flow. Its one real defect is the dangling reference to `templates/PULL_REQUEST.md`, which does not exist in the bundle and slightly weakens both actionability and progressive disclosure.

Suggestions

Fix the broken reference: `templates/PULL_REQUEST.md` does not exist in the bundle (only `references/COMMIT_STYLE.md` is present) — either add the template file or inline the required PR template structure so the "Fill in the template" step is executable.

Audit all referenced bundle paths at authoring time; the commit-style reference resolves correctly, but a missing template path breaks navigation for the pull request workflow.

DimensionReasoningScore

Conciseness

The body is 26 lines of pure rules — "Branch from `main`", "subject line of at most 72 characters", "Request review from at least one code owner" — with zero explanation of concepts Claude already knows and no padding. This matches anchor 5 ("Lean and efficient; assumes Claude's competence; every token earns its place"); the slight overlap between the commit rules and `references/COMMIT_STYLE.md` serves as a summary pointer, not over-explanation, so it does not drop to 4.

5 / 5

Actionability

Guidance is largely concrete and executable: "Name branches `<type>/<short-description>`, where `<type>` is one of `feat`, `fix`, `docs`, or `chore`" and "Open pull requests against `main`" are precise, unambiguous instructions. It falls short of anchor 5 because "Fill in the template in `templates/PULL_REQUEST.md`" points to a file that does not exist in the bundle, leaving the PR step not fully executable as written.

4 / 5

Workflow Clarity

This is a simple, under-50-line skill whose three sections (Branches → Commits → Pull requests) follow the natural task order, and each instruction is unambiguous with no missing detail — matching the simple-skill exception where a clearly organized single-purpose skill can score 5. No validation checkpoints are required because the operations are not destructive or batch operations, so the cap does not apply; anchor 4's "minor validation gaps" would only fit a multi-step process needing checkpoints.

5 / 5

Progressive Disclosure

The structure is good: an overview ("Use this skill whenever you create branches, commits, or pull requests"), clearly headed sections, and a well-signaled one-level-deep reference ("See `references/COMMIT_STYLE.md` for the full style guide and examples") that exists in the bundle. It is not a 5 because the body also references `templates/PULL_REQUEST.md`, which is absent from the bundle — a broken navigation path that constitutes the "minor organization gaps" of anchor 4.

4 / 5

Total

18

/

20

Passed

Description

61%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.

The description is concise and names its three coverage areas with natural trigger keywords, and it stays in an acceptable imperative style consistent with the good examples. Its main weakness is the missing 'Use when...' trigger clause, which caps completeness, and the generic "Follow this team's Git conventions" action verb, which limits specificity.

Suggestions

Add an explicit trigger clause, e.g. "Use when creating branches, writing commit messages, or opening pull requests in this repository" — the missing 'Use when...' guidance caps completeness at 3.

Replace the generic verb "Follow this team's Git conventions" with concrete actions, e.g. "Name branches, format commit messages, and fill pull request templates to this team's conventions" to raise specificity.

Add common trigger synonyms such as "commits" and "PRs" to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

The phrase "Follow this team's Git conventions for branching, commit messages, and pull requests" names the domain and enumerates three scope areas, but the single action verb "Follow ... conventions" is generic — it never states what is actually done (e.g. how branches are named or how messages are formatted). This matches anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive") better than anchor 4, which expects several distinct specific actions like "Extracts text from PDF files, fills forms, converts pages to images".

3 / 5

Completeness

The 'what' is reasonably clear ("Follow this team's Git conventions for branching, commit messages, and pull requests") but the 'when' is entirely absent — there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the 'what' is not vague: it names three concrete areas of convention.

3 / 5

Trigger Term Quality

"branching, commit messages, and pull requests" are exactly the natural phrases users would say when needing this skill, giving good keyword coverage. It falls short of anchor 5 because common variations and synonyms such as "commits", "PR", "PRs", or "merge" are absent — matching anchor 4 ("Good keyword coverage; a few natural terms missing").

4 / 5

Distinctiveness Conflict Risk

"Follow this team's Git conventions" carves a clear niche around team-specific Git process with distinct triggers (branching, commit messages, pull requests), so it is mostly distinct. It is not a 5 because a closely related skill (e.g., a generic commit-message generator) could overlap for the commit-message trigger; it is clearly above anchor 3 since the team-conventions framing is far more specific than "Works with document files".

4 / 5

Total

14

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

modelcontextprotocol/csharp-sdk

Path

samples/SkillsServer/Skills/git-workflow/SKILL.md

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.