Agent skill · neolabhq
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.
What it needs
About 6k tokens when loaded.
What this skill does
Git Notes Overview Git notes attach metadata to commits (or any Git object) without modifying the objects themselves. Notes are stored separately and displayed alongside commit messages. Core principle: Add information to commits after creation without rewriting history. Core Concepts Concept Description --------- ------------- Notes ref Storage location, default refs/notes/commits Non-invasive Notes never modify SHA of original object Namespaces Use --ref for different note categories Display Notes appear in git log and git show output Quick Reference Task Command ------ --------- Add note git notes add -m "message" <sha> View note git notes show <sha> Append git notes append -m "message" <sha> Edit git notes edit <sha> Remove git notes remove <sha> Use namespace git notes --ref=<name> <command> Push notes git push origin refs/notes/<name> Fetch notes git fetch origin refs/notes/<name>:refs/notes/<name> Show in log git log --notes=<name> For complete command reference, see references/commands.md. Essential Patterns Code Review Tracking Sharing Notes Preserving Through Rebase Common Mistakes Mistake Fix --------- ----- Notes not showing in log Specify ref: git log --notes=reviews or configure notes.displayRef Notes lost after rebase Enable: git config notes.rewrite.rebase true Notes not on remote Push explicitly: git push origin refs/notes/commits "Note already exists" error Use -f to overwrite or append to add Best Practices Practice Rationale ---------- ----------- Use namespaces Separate notes by purpose (reviews, testing, audit) Be explicit about refs Always specify --ref for non-default notes Push notes explicitly Document sharing procedures in team guidelines Use append over add -f Preserve note history when accumulating Configure rewrite preservation Run git config notes.rewrite.rebase true before rebasing Git Notes Command Reference Complete reference for all git notes commands and options. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills neolabhq/git-notes--c065c5