CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-workflows

Always invoke this skill for any git-related request (commit messages, staging review, history, PR descriptions, etc.) so git workflows are handled consistently.

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-engineered skill body: script usage, environment knobs, and error recovery are all concrete and verified against the actual bundle, with the detailed operation workflows correctly pushed into real, one-level-deep reference files. The only deductions are minor verbosity in the prose rationale paragraphs and validation checkpoints living in references rather than the main workflow view.

DimensionReasoningScore

Conciseness

The 70-line body is dense with skill-specific information Claude cannot know (script signatures, repo-root validation, exclude pathspec magic, GIT_SKILL_DEBUG, non-interactive flags) and avoids teaching general git concepts. A few passages run longer than needed — the multi-sentence rationale for passing the repo root explicitly, and the bold-heavy excludes/debug paragraph — so anchor 4 (efficient, minor trimming possible) fits better than anchor 5.

4 / 5

Actionability

Every script is given as a copy-paste-ready invocation with argument signatures, a concrete example call ("scripts/git-diff.sh /path/to/repo main"), an anti-pattern note, a debug command ("GIT_SKILL_DEBUG=1 scripts/git-cached-diff.sh /path/to/repo"), and executable error-handling commands ("git -C <repo-root> rev-parse --git-dir", "chmod +x scripts/*.sh"). This matches anchor 5: fully executable commands covering the common cases; verified against the actual scripts (common.sh does provide parse_repo_root, build_exclude_args, GIT_SKILL_DEBUG, GIT_TERMINAL_PROMPT handling).

5 / 5

Workflow Clarity

The five operations are numbered and sequenced, each with a required reference file to read before starting, and an Error Handling section provides a diagnostic feedback loop. Validation checkpoints for the batch auto-commit operation exist but live in the delegated reference (auto_commit_workflow.md's confirm-staged and abort steps) rather than the main body, and the body's own per-operation checkpoints are implicit ('read the reference file first'), so anchor 4 (clear sequence, most checkpoints present, minor gaps) fits better than anchor 5.

4 / 5

Progressive Disclosure

The body is a lean overview and the bulk of the content (729 lines across 8 reference files) is split into one-level-deep, well-signaled references — every referenced path exists in the bundle, each operation names its reference file(s) explicitly, and paths are declared relative to the skill directory. Cross-links between references (e.g., op_review → guidelines, auto_commit → partial_staging) are supplementary; all files remain directly discoverable from SKILL.md, matching anchor 5's clear overview with easy navigation.

5 / 5

Total

18

/

20

Passed

Description

66%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 has an excellent explicit trigger ('when') and natural git vocabulary, but it never states what the skill actually does — the parenthetical list names request types, not capabilities — and the 'always, any git-related request' framing creates conflict risk with narrower git skills. It is a solid, usable trigger description with an under-specified capability statement.

Suggestions

Replace the implied capability with explicit actions, e.g., "Generates commit messages, reviews staged/unstaged and cross-commit diffs, composes PR descriptions, and auto-commits grouped unstaged changes", followed by the existing 'when' clause.

Add natural trigger synonyms users actually say — "diff", "pull request", "changelog", "stage changes" — to round out keyword coverage.

Scope the 'Always invoke ... for any git-related request' claim to the operations the skill covers (commit messages, diff review, PR descriptions, auto-committing), reducing the chance it hijacks requests better served by adjacent skills.

DimensionReasoningScore

Specificity

The description names the domain ("git-related request") and enumerates several task areas ("commit messages, staging review, history, PR descriptions"), but these read as request categories rather than the concrete actions the skill performs (e.g., generating commit messages, composing PR bodies, auto-committing grouped changes). It matches anchor 3 (domain plus some concrete items, not comprehensive) better than anchor 4, which expects explicit specific actions.

3 / 5

Completeness

The 'when' is explicit and strong ("Always invoke this skill for any git-related request"), and a 'what' is present but only implied via the parenthetical list and the vague purpose clause "so git workflows are handled consistently". This fits anchor 4 (both what and when present, one could be more explicit) rather than anchor 5, which requires a concrete action statement alongside the trigger.

4 / 5

Trigger Term Quality

Natural phrases users would say are present — "commit messages", "PR descriptions", "git", "staging review", "history" — giving good keyword coverage. A few common variations are missing (e.g., "diff", "pull request" spelled out, "changelog"), so it falls just short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The git-workflow domain itself is reasonably distinct, but the absolute trigger ("Always invoke this skill for any git-related request ... etc.") maximizes overlap with adjacent single-purpose skills (commit-message generators, code-review, PR-creation skills). Somewhat specific yet with real overlap risk matches anchor 3; it is not anchor 2's fully generic case, but broader than anchor 4's minor-overlap profile.

3 / 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

ceshine/ceshine-agent-skills

Path

git-workflows/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.