Converts engineering activities into evidence-backed impact statements for performance reviews by mining git history, PRs, and Copilot CLI logs.
- GitHub stars
- 41,038
- Files
- 1
- Last commit
- Nov 11, 2026
- License
- MIT
- Allowed tools
- —
What does the brag-sheet skill do?
brag-sheet converts engineering activities into evidence-backed impact statements for performance reviews by mining git history, PRs, and Copilot CLI logs.
Summary generated from the skill's SKILL.md.
About the brag-sheet skill
Engineering professionals can transform their daily technical activities into structured impact statements for performance reviews and promotion packets. This tool automates the documentation of accomplishments by mining git history, GitHub pull requests, and Copilot CLI session logs to reconstruct work that might otherwise be forgotten. It is designed to help developers move away from vague task lists toward a formal three-part contract consisting of action, result, and evidence.
When an agent loads this skill, it can perform backfill scans across specific time ranges to group related commits and pull requests into cohesive entries. It relies on the availability of git and the GitHub CLI to gather data, and it can uniquely access Copilot session state files to find context for completed tasks. The output is provided as categorized markdown, ensuring every entry includes a verifiable link, metric, or observable outcome without fabricating any data.
What an agent can do with it
- 1Backfill recent work historyAn engineer can ask the agent to summarize everything they accomplished over the last two weeks using their git and PR history.
- 2Prepare for promotion cyclesA developer can generate a structured review pack that organizes accomplishments into impact themes and STAR narratives.
- 3Document specific accomplishmentsUsers can capture a single achievement immediately to ensure it is recorded with proper evidence.
- 4Reconstruct forgotten tasksThe tool can use Copilot CLI logs to find details about work that does not appear in standard git logs.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the brag-sheet skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the brag-sheet skill in Claude Code
~/.claude/skills/brag-sheet/SKILL.md
$ npx degit github/awesome-copilot/skills/brag-sheet ~/.claude/skills/brag-sheetInstall the brag-sheet skill in Claude Code (project)
.claude/skills/brag-sheet/SKILL.md
$ npx degit github/awesome-copilot/skills/brag-sheet .claude/skills/brag-sheetInstall the brag-sheet skill in Codex
~/.agents/skills/brag-sheet/SKILL.md
$ npx degit github/awesome-copilot/skills/brag-sheet ~/.agents/skills/brag-sheetInstall the brag-sheet skill in Gemini CLI
~/.gemini/skills/brag-sheet/SKILL.md
$ npx degit github/awesome-copilot/skills/brag-sheet ~/.gemini/skills/brag-sheetInstall the brag-sheet skill in Claude.ai
npx degit github/awesome-copilot/skills/brag-sheet brag-sheet && zip -r brag-sheet.zip brag-sheet # claude.ai → Customize → Skills → + → Create skill → Upload a skill → brag-sheet.zip
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work · What to fix for more points
- Source repository linked and reachablegithub/awesome-copilot/skills/brag-sheet is public and reachablegithub.com/github/awesome-copilot/tree/HEAD/skills/brag-shee ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit 2026-11-11github.com/github/awesome-copilot/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/github/awesome-copilot/blob/HEAD/skills/brag-shee ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/github/awesome-copilot/blob/HEAD/skills/brag-shee ↗Pass
- SKILL.md follows the Agent Skills formatthe description does not say when to use the skillgithub.com/github/awesome-copilot/blob/HEAD/skills/brag-shee ↗Finding
SKILL.md
View on GitHubBrag Sheet — Work Impact Writer
Turn engineering work into evidence-backed impact statements for performance reviews, self-reviews, promotion packets, and weekly updates. Uniquely mines Copilot CLI session logs, git history, and PRs to reconstruct forgotten work.
USE FOR: "brag", "log work", "what did I do", "backfill", "performance review", "self-review", "promo packet", "weekly update", "status report", "write impact statement", "what did I ship", "I forgot to log my work", "review prep", "accomplishments" DO NOT USE FOR: project management, sprint planning, time tracking, ticket creation
Quick Start
| User wants... | Mode | Output |
|---|---|---|
| Log one accomplishment | Capture | 1 impact-first entry |
| "What did I do last week?" | Backfill | Entries grouped by week, mined from git/PRs/sessions |
| Prep for review or promo | Review Pack | Entries grouped by impact theme + STAR narratives |
Agent Behavior Rules
- DO confirm the time range and scope before scanning sources. Don't assume "last week" — ask.
- DO check which tools are available (
save_to_brag_sheet,git,gh) before choosing a workflow. - DO always include all three parts: action → result → evidence. If evidence is missing, write
(evidence needed)— never silently omit. - DO show drafted entries to the user before saving. Never auto-save without confirmation.
- DO group related commits into a single entry. Ten commits on the same feature = one entry.
- DO preserve the user's voice. Reframe for impact, but don't invent accomplishments or inflate scope.
- DO NOT fabricate metrics, team sizes, or impact numbers. If the user doesn't provide a number, don't invent one.
- DO NOT write entries for work the user only described verbally without verifying. Ask: "Did this ship? Is there a PR or doc I can reference?"
- DO NOT skip the backfill scan steps or draft entries before scanning is complete.
- DO NOT pad weak periods with trivial entries. An honest gap is better than inflated fluff.
Entry Format
Every entry uses impact-first framing with three required parts:
Did [action] → [result/impact] → [evidence]
Do not output an entry unless it includes all three parts. If evidence is missing, ask for it or mark as "(evidence needed)".
Anti-Patterns
| ❌ Don't | ✅ Do instead |
|---|---|
| "Fixed a bug in auth" | "Fixed token refresh race condition → eliminated 401s affecting 12% of API calls → PR #247" |
| "Worked on dashboards" | "Built latency dashboard in Grafana → on-call detects P95 spikes in <2min → deployed to prod" |
| Invent a metric: "saved 40% of eng time" | Ask: "Do you have a rough estimate, or should I keep this qualitative?" |
| One entry per commit | Group related commits into one entry with highest-impact framing |
| Passive voice: "The pipeline was improved" | Active voice: "Built CI matrix → caught Windows-only bug before release" |
| List technologies used | State the outcome: "Migrated 4 services to IaC → deploy time 45min → 8min" |
| Silently drop weak entries | Mark (evidence needed) and present for user to fill in |
Evidence Ladder
Not every entry needs a metric. Use the strongest evidence available:
| Strength | Evidence type | Example |
|---|---|---|
| 🥇 Best | Quantified metric | "Reduced P95 latency from 800ms to 120ms" |
| 🥈 Strong | PR, commit, or doc link | "PR #312, design doc in wiki" |
| 🥉 Good | Observable outcome | "Unblocked Team X", "Resolved Sev2 incident Y" |
| ✅ Acceptable | Qualitative + context | "Reduced toil for on-call rotation — see updated runbook" |
| ⚠️ Weak | Activity only | "Worked on auth" — reframe or mark (evidence needed) |
Never invent a metric to fill the gap. Qualitative evidence with context beats fabricated numbers.
Categories
| ID | Emoji | Use for |
|---|---|---|
pr |
🚀 | Merged PRs, shipped features |
bugfix |
🐛 | Bug fixes, incident patches |
infrastructure |
🏗️ | Infra, deployments, migrations |
investigation |
🔍 | Root cause analysis, debugging |
collaboration |
🤝 | Reviews, mentoring, design discussions |
tooling |
🔧 | Dev tools, scripts, automation |
oncall |
🚨 | Incident response, on-call wins |
design |
📐 | Design docs, architecture decisions |
documentation |
📝 | Docs, runbooks, guides |
How to Help the User
Follow this decision tree:
-
If
save_to_brag_sheettool is available → use extension tools directly (save_to_brag_sheet,review_brag_sheet,generate_work_log). Do not reference or attempt to call these tools unless they are confirmed available. -
If git or gh CLI is available → backfill from commits and PRs (see Backfill section below)
-
Otherwise → guided interview: "What did you work on?", "Who benefited?", "What's the evidence?"
For each entry, walk through: What (the deliverable) → Why (who benefits) → Evidence (PR, metric, link). Output formatted markdown the user can paste into a review doc.
Backfill Workflow
When the user asks "what did I do last week" or "backfill my history":
Follow these steps in order. Do not draft entries until scanning is complete.
Step 1: Scan available sources
Check what's available, then mine each source:
git --version 2>/dev/null # for commit mining
gh --version 2>/dev/null # for PR mining
ls ~/.copilot/session-state/ 2>/dev/null # Copilot session logs
Git commits — recent commits by the user in the current repo:
git log --author="$(git config user.email)" --since="2 weeks ago" \
--pretty=format:'%h|%ad|%s' --date=short --no-merges
PR history — merged PRs across repos:
gh pr list --author @me --state merged --limit 20 \
--json number,title,repository,mergedAt
Copilot session history (unique to this skill):
- Path:
~/.copilot/session-state/<session-id>/workspace.yaml - Read fields:
summary,cwd,repository,branch - Skip sessions without a
summaryfield - Note: this directory may not exist on all machines
If none of these sources are available, fall back to the guided interview.
Step 2: Group related work
Cluster related signals into one entry:
- Same PR + its commits → 1 entry
- Multiple commits on the same file/feature within 3 days → 1 entry
- Copilot sessions referencing the same repo + branch → merge into PR entry if one exists
Step 3: Draft entries
Write impact-first entries for each group. Assign categories.
Step 4: Present and refine
Show all drafted entries to the user. Adjust based on feedback.
Step 5: Output
Format as markdown grouped by week:
## Week of 2025-04-14
### 🚀 PRs & Features
- **Migrated auth service to managed identity** → eliminated 3 secret rotation incidents/quarter → PR #312
### 🏗️ Infrastructure
- **Built CI pipeline for copilot-brag-sheet** → 107 tests across 3 OSes × 3 Node versions → shipped v1.0.0
Performance Review Prep
When the user is preparing for a performance review (Connect, annual review, etc.):
Structure
- Gather — collect entries from the work log (or backfill using the workflow above)
- Select — pick the top 3–5 highest-impact items
- Rewrite each item with three parts:
- What I did — the specific action
- Why it mattered — who benefited, what changed
- Proof — PR number, metric delta, dashboard link, customer outcome
- Organize by impact theme (not chronologically):
- Delivering results / operational excellence
- Customer / team impact
- Collaboration / mentoring / leadership
- Growth / learning
- Ask for gaps — if evidence is missing, prompt the user: "What metric changed?", "Who was unblocked?", "What's the PR or incident ID?"
Strong vs weak entries
| ✅ Strong | ❌ Weak |
|---|---|
| Outcome-first, quantified | Activity list ("worked on X") |
| Tied to customer/team impact | No beneficiary mentioned |
| Includes evidence (PR, metric) | No measurable result |
| Shows ownership or leadership | Pure task completion |
Narrative format
For longer narrative sections, use STAR: Situation → Task → Action → Result.
For Microsoft employees using the Connect preset, frame entries around Core Priorities: delivering results, customer obsession, teamwork, and growth mindset.
Output Contract
Before finishing, ensure:
- Every entry has action → result → evidence (mark
(evidence needed)if missing) - No fabricated metrics — only user-provided or source-verified data
- Entries shown to user before saving
- Time range explicitly stated
- Output is pasteable markdown with categories assigned
Gotchas
No recent commits in the current repo
The user may work across multiple repos. Before concluding there's nothing to backfill:
- Ask if they want to scan a different repo or branch
- Check
gh pr list --author @me --state mergedfor cross-repo PRs - Fall back to the guided interview — not all impactful work leaves git traces (design docs, incident response, mentoring)
Review period doesn't match git history
Performance reviews often cover 6–12 months. Explicitly set the date range:
git log --author="$(git config user.name)" --since="2024-07-01" --until="2025-01-01" --oneline
PR history (gh pr list --state merged) is more reliable for long time ranges than commit logs.
User can't quantify impact
Not every entry needs a number. See the Evidence Ladder above. Acceptable evidence includes PR links, "unblocked Team X", or qualitative outcomes with context. Never invent a metric to fill the gap.
Copilot session directory doesn't exist
~/.copilot/session-state/ only exists if the user has run Copilot CLI sessions. Don't error — silently skip and note: "No Copilot session history found; scanning git and PRs only."
"brag" might mean something else
The user might say "brag about this feature to my team" (a launch announcement, not a work entry). Confirm intent if ambiguous.
Pair programming or co-authored commits
If multiple authors appear on the same commits, ask: "Should I credit this as your work, shared work, or skip it?"
Automatic Session Tracking (Optional)
For automatic background tracking of every Copilot CLI session (files edited, PRs created, git actions), install the copilot-brag-sheet extension. It adds save_to_brag_sheet, review_brag_sheet, and generate_work_log tools to every session.
Files in this skill
1brag-sheet skill questions
How do I install the brag-sheet skill in Claude Code?
Run npx degit github/awesome-copilot/skills/brag-sheet ~/.claude/skills/brag-sheet. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the brag-sheet skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
What sources does the tool use to reconstruct my work?
It mines Copilot CLI session logs, git commits, and GitHub PRs to find evidence of your accomplishments.
How are impact statements formatted?
Every entry follows a three-part contract: action, result/impact, and evidence.
Can the tool invent metrics if I don't provide them?
No, the tool is strictly prohibited from fabricating metrics, team sizes, or impact numbers.