CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-commit

Create a git commit following the project's established style

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 ./.agents/harness/adapters/antigravity/skills/git-commit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 a maximally lean delegation stub: one clearly signaled instruction pointing at an external shared-skill file. Conciseness is exemplary, but actionability, workflow, and structure all hinge entirely on a machine-specific path that is not part of the skill bundle and does not resolve in this environment, leaving the skill with no standalone guidance for its stated task.

Suggestions

Inline a minimal fallback workflow for creating a commit in the project's style (e.g., inspect recent git log for conventions, stage changes, write the message, commit) so the skill remains actionable when the shared skill is absent.

Replace or augment the machine-specific absolute path with a bundle-relative reference, and instruct the agent to verify the shared skill exists before deferring to it.

Add a brief inline overview of what the shared skill covers (e.g., a short summary of the commit style rules) so the SKILL.md body carries some standalone context.

DimensionReasoningScore

Conciseness

The body is two lines — "Load and follow the shared skill at `~/.agents/skills/git-commit/SKILL.md`." plus a small generator comment — with no padding, no explanation of concepts Claude already knows, and nothing that could be trimmed without losing function. This matches anchor 5 (lean and efficient; every token earns its place).

5 / 5

Actionability

"Load and follow the shared skill at `~/.agents/skills/git-commit/SKILL.md`" is a concrete instruction with an exact path, but every piece of task-specific guidance (how to inspect the project's commit style, stage, and create the commit) is deferred to an external file that is not part of the bundle and does not resolve in this environment. Anchor 3 fits (concrete but incomplete, key details missing); not 4 because the gap is the entire skill content rather than a minor one, not 2 because the single instruction is specific and executable in form.

3 / 5

Workflow Clarity

The single redirect action ("Load and follow the shared skill") is unambiguous, but no workflow for the actual task — sequencing, commit-message construction, or validation before committing — appears anywhere in the body, and the redirect target is unresolvable here so following the instruction dead-ends. Fits anchor 3 (sequence/checkpoints missing) rather than 5 under the simple-skill exception, because the single written action does not itself accomplish or scaffold the skill's stated task.

3 / 5

Progressive Disclosure

The one reference ("~/.agents/skills/git-commit/SKILL.md") is clearly signaled and one level deep, but it points outside the skill bundle via a machine-specific absolute path — no references/, scripts/, or assets/ directories exist in the skill, the comment's "scripts/agent-harnesses.py" is a dangling reference, and no inline overview is provided. Anchor 3 fits (some structure, better organization needed); not 4 because an unresolvable external pointer plus zero inline overview is more than a minor organization gap.

3 / 5

Total

14

/

20

Passed

Description

53%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 states a clear, appropriately concise "what" for a well-scoped task, but it entirely omits any "when to use it" trigger guidance and relies on a single keyword ("git commit") without natural synonyms or variations. It is serviceable but under-specified for discovery and triggering.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to commit changes, make a commit, or write a commit message."

Include natural trigger synonyms such as "commit message", "committing changes", or "save changes to git" so the skill matches how users actually phrase the request.

Briefly hint at what "established style" means (e.g., matching the project's existing git log or commit conventions) to sharpen the capability description.

DimensionReasoningScore

Specificity

"Create a git commit" names the domain and one concrete action, with "following the project's established style" as a qualifier rather than additional actions. It matches anchor 3 (1-2 concrete actions, not comprehensive) — above anchor 2 because the action is concrete rather than generic like "Processes PDF files", below anchor 4 because there is no list of several specific actions.

3 / 5

Completeness

The description clearly answers "what" ("Create a git commit following the project's established style") but contains no "Use when..." clause or any equivalent explicit trigger guidance, so completeness is capped at 3 per the judging guidelines. Not 4 because the "when" is entirely absent rather than just implicit or imprecise.

3 / 5

Trigger Term Quality

"git commit" is the core natural keyword a user would say, but common variations and synonyms — "commit message", "commit changes", "make a commit" — are absent. This fits anchor 3 (some relevant keywords, missing variations): above anchor 2 because "git commit" is specific rather than generic, below anchor 4 because only one natural term is present.

3 / 5

Distinctiveness Conflict Risk

The single-task framing ("Create a git commit") carves out a clear niche with mostly distinct triggers; the only overlap risk is with closely related commit-message-writing skills. Fits anchor 4 (mostly distinct, minor overlap) rather than 5, since the description does not include distinguishing trigger phrases that would fully separate it from those neighbors.

4 / 5

Total

13

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.agents/harness/adapters/antigravity/skills/git-commit/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.