git:notes

Attach metadata to Git objects via notes refs without altering SHAs.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/luicabref97/sushi-jungle-web --skill git-notes-luicabref97
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git:notes
Source: https://github.com/luicabref97/sushi-jungle-web/tree/main/.agents/skills/git-notes
Command: npx skills add https://github.com/luicabref97/sushi-jungle-web --skill git-notes-luicabref97

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Git notes provide a way to attach metadata to commits and other Git objects after they are created, enabling teams to record review status, test results, audit information, and contextual annotations without rewriting history or changing object SHAs.

Core Features & Use Cases

  • Non-invasive annotations: Add, append, edit, and remove notes without amending commits or altering commit hashes.
  • Namespaced organization: Use separate notes refs for reviews, testing, and audits to keep annotations scoped and discoverable.
  • Sharing and preservation: Push and fetch refs/notes/* to share notes across remotes and configure rewrite settings to preserve notes during rebase and amend operations.
  • Workflows: Track code review approvals, record CI test outcomes, maintain audit trails, and perform bulk operations to annotate multiple commits by author or range.

Quick Start

Add a review note to a specific commit in the reviews namespace and push the notes ref to the remote.

Frequently Asked Questions about git:notes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add metadata to a git commit without rewriting history?

Git notes provide a non-invasive way to attach metadata to commits without modifying object SHAs or altering commit hashes, enabling teams to record review status, test results, and audit information.

Can I share git notes across repositories like regular branches?

Yes, you can share git notes across repositories by pushing and fetching refs/notes/* to share annotations across remotes, using named notes refs and namespaces to keep them scoped and discoverable.

What is the best way to track code review status in git without amending commits?

The best way to track code review status without amending commits is using namespaced git notes, which allow you to record approvals and annotations in separate notes refs for reviews, testing, and audits without changing object SHAs.

Do git notes get preserved during a rebase or amend operation?

Git notes can be preserved during rebase and amend operations by configuring rewrite settings like notes.rewrite.rebase, ensuring your annotations remain attached to commits after history modifications.

What git configuration options are needed to display notes from different namespaces?

To display git notes from different namespaces, configure options like notes.displayRef for preservation and display, allowing you to view annotations across separate notes refs for reviews, testing, and audits.

Can I perform bulk operations to annotate multiple git commits at once?

Yes, you can perform bulk operations to annotate multiple git commits by author or range, attaching metadata like test results or audit information across multiple objects without rewriting history.