CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-notes

Use when adding metadata to commits without changing history, tracking review status, test results, code quality annotations, or supplementing commit messages post-hoc - provides git notes commands and patterns for attaching non-invasive metadata to Git objects.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./antigravity/skills/git-notes/SKILL.md

The canonical home for this skill is git-notes in NeoLabHQ/context-engineering-kit

SKILL.md
Quality
Evals
Security

Quality

Content

61%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 with concrete, executable commands throughout, but it undermines its own structure by inlining a full command reference while simultaneously pointing to a references/commands.md file that does not exist in the bundle. Batch operations lack validation checkpoints, capping workflow clarity at 3.

Suggestions

Create references/commands.md and move the entire '# Git Notes Command Reference' section (Basic Operations through Workflow Examples) into it, keeping only the Quick Reference table and Essential Patterns inline in SKILL.md — this fixes both the broken reference and the ~350 lines of inlined content.

Add validation checkpoints to the bulk operations section, e.g., verify after batch add/remove with 'git notes --ref=<name> list' or 'git log --notes=<name> --oneline', so destructive/batch workflows have a feedback loop.

Trim redundant flag permutations from the inline reference (e.g., 'add -F', 'add --allow-empty', interactive 'add'/'edit' variants) and keep only the non-obvious ones like '--stdin' bulk copy and merge strategies.

DimensionReasoningScore

Conciseness

The overview half (tables of concepts, quick reference, mistakes, best practices) is efficient, but the inlined '# Git Notes Command Reference' section (~350 lines) exhaustively enumerates flag permutations ('add -F', 'add --allow-empty', 'prune -v', interactive edit) that largely duplicate the Quick Reference table and what Claude already knows. Mostly efficient with substantial tightening possible — between anchors 2 and 3, closer to 3.

3 / 5

Actionability

Every section provides copy-paste-ready executable commands with realistic values: namespaced refs, multi-line messages, example SHAs, a sample .gitconfig, and complete bulk-operation pipelines. This matches anchor 5's fully executable, common-case-covering guidance.

5 / 5

Workflow Clarity

Concrete recipe-style patterns are present and merge-conflict resolution is properly sequenced (resolve → 'git notes merge --commit' / '--abort'), but the bulk operations (batch add via while-loop, batch remove via 'xargs git notes remove --ignore-missing') lack any validation/verification checkpoint. Per the rubric, batch operations without validation cap workflow clarity at 3.

3 / 5

Progressive Disclosure

The body signals 'For complete command reference, see references/commands.md', but no references/ directory exists in the bundle, and the entire command reference it points to is inlined in SKILL.md anyway (~350 lines of content that clearly belongs in the separate file). This matches anchor 2 (content that belongs in separate files is inlined); the missing target file makes it worse than anchor 3's 'could be in a separate file'.

2 / 5

Total

13

/

20

Passed

Description

83%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 strong description that explicitly answers both what the skill does and when to use it, with natural trigger phrases and a distinct niche. Third-person voice is maintained and there is no fluff. Minor improvements possible in synonym coverage for trigger terms.

DimensionReasoningScore

Specificity

The description lists several concrete actions ('adding metadata to commits without changing history, tracking review status, test results, code quality annotations, or supplementing commit messages post-hoc') with only minor gaps (viewing/removing notes unmentioned). It falls short of anchor 5's comprehensiveness but well above anchor 3's 1-2 actions.

4 / 5

Completeness

Both parts are explicit and concrete: an explicit 'Use when…' clause with four distinct trigger scenarios, plus a clear 'what' ('provides git notes commands and patterns for attaching non-invasive metadata to Git objects'). This matches anchor 5 rather than anchor 4, where the 'when' would only be loosely stated.

5 / 5

Trigger Term Quality

Good natural-phrase coverage: 'metadata to commits', 'review status', 'test results', 'commit messages', 'git notes', 'without changing history'. A few natural synonyms users would say are missing (e.g., 'annotate a commit', 'add a note to a commit'), keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

'git notes' is a clear niche with minimal conflict risk, but 'supplementing commit messages post-hoc' and 'tracking review status' create minor overlap with commit-message-writing and code-review skills, matching anchor 4 rather than 5.

4 / 5

Total

17

/

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

NeoLabHQ/context-engineering-kit

Path

antigravity/skills/git-notes/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.