copilot-brag-sheet

Turn vague "what did I do?" into evidence-backed impact statements — automatically, every Copilot CLI session.

🔒 Local-first · 📦 Zero dependencies · 🚫 Zero telemetry

Install in 30 seconds View on GitHub

Demo: typing 'brag' in Copilot CLI saves the current accomplishment with full session context

Install

Requires Node.js 18+ and the GitHub Copilot CLI with an active Copilot subscription.

curl Recommended

One-liner. Works on macOS, Linux, and Windows (Git Bash / WSL).

curl -fsSL https://raw.githubusercontent.com/microsoft/copilot-brag-sheet/main/install.sh | bash

npm

Global install — also gives you npm update -g copilot-brag-sheet.

npm install -g copilot-brag-sheet

Git clone

For contributors and source-tracking.

git clone https://github.com/microsoft/copilot-brag-sheet
cd copilot-brag-sheet
./install.sh

When the agent will use this

You don't need to memorize anything — just talk naturally about your work. Copilot picks up the brag-sheet tools when you say (anything close to) one of these:

brag
log work
save accomplishment
what did I ship
review my work
summarize my impact
generate work log
prep my brag sheet
promo packet
perf review
Connect prep
self-review
weekly recap
monthly summary
what did I do this quarter

All processing is local. Records live in your OS app-data directory as structured JSON with atomic writes and orphan recovery.

Why an extension, not just a SKILL.md?

If you've seen the brag-sheet skill listed elsewhere — that's the LLM guidance file. It's a prompt that tells the agent how to think about your work. This repo ships the prompt plus the extension that actually makes it happen.

	Just the SKILL.md	The full extension (this)
Trigger	LLM has to remember	Auto-captures every session
Data capture	LLM runs shell commands by hand	Direct file/PR/git tracking via Node API
Formatting	LLM formats markdown each time	Deterministic, typed, crash-safe
Storage	Markdown stored "somewhere"	Structured local JSON, atomic writes, orphan recovery
Updates	Re-curl to update	`npm update` or one-line re-install

Want just the prompt? Use SKILL.md — also published in github/awesome-copilot.
Want it to actually happen automatically? Install the extension.