Guide · Agent skill
How to use the Brag Sheet Work Impact Writer agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The brag-sheet skill teaches an AI agent to help you write up your engineering work for performance reviews, self-assessments, promotion packets and weekly status updates. Instead of relying on memory, the agent can scan your git history, GitHub pull requests and Copilot CLI session logs to reconstruct what you did. This guide explains what an agent skill is, how to install this one, how to ask for help in plain language, and what to check before you use it.
Brag Sheet Work Impact Writergithub/awesome-copilot · MIT Download the skill Quick start
- 1Download the ZIP. Download the brag-sheet ZIP from this page and unzip it. You should find SKILL.md.
- 2Place the skill folder. Put the brag-sheet folder in ~/.claude/skills/ for all projects, or in your project's .claude/skills/ folder for one project.
- 3Or upload in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the skill.
- 4Confirm your sources. Check whether git, gh and ~/.copilot/session-state/ are available on your machine. None are required.
- 5Ask for a backfill. Request a backfill with a time range, for example the last two weeks, and answer the agent's scope question.
- 6Review the drafts. Read each drafted entry, add PR links or outcomes, and approve only what is accurate before anything is saved.
What is an agent skill and what does brag-sheet make the agent do?
An agent skill is a folder containing a SKILL.md file that gives an AI agent instructions for a specific kind of task. When a request matches the skill's trigger phrases, the agent follows the instructions in that file.
The brag-sheet skill is built around one format. Every entry is written as action, then result, then evidence. The agent asks you to confirm the time range, reconstructs work from your sources, groups related commits into one entry, and shows drafts before anything is saved. It is meant for performance reviews, self-reviews, promotion packets and weekly updates. It is not meant for project management, sprint planning, time tracking or ticket creation.
- Capture: log one accomplishment as a single impact-first entry
- Backfill: rebuild a week or range of work from git, PRs and session logs, grouped by week
- Review Pack: group entries by impact theme with STAR-style narratives for review prep
Install the brag-sheet skill from a ZIP file
Download the ZIP for this skill from this page and unzip it. The download contains SKILL.md. To make it available across your projects, unzip it into ~/.claude/skills/ so the skill folder sits at ~/.claude/skills/brag-sheet/. To make it available only inside one project, unzip it into that project's .claude/skills/ folder.
If you use the Claude apps instead of Claude Code, you can upload the skill under Settings → Capabilities → Skills.
- Personal install: ~/.claude/skills/brag-sheet/
- Project install: <your-project>/.claude/skills/brag-sheet/
- Claude apps: Settings → Capabilities → Skills, then upload
Trigger the skill with natural requests
You do not need a special command. Ask in plain language and include a time range or category if you have one. The skill's argument hint suggests time ranges such as "last 2 weeks" or "this half", categories such as "infrastructure", and the words "backfill" or "review prep".
The skill also recognises phrases such as "brag", "log work", "what did I do", "self-review", "promo packet", "weekly update" and "I forgot to log my work". The agent will ask you to confirm the time range before it scans anything.
- "What did I do last two weeks? Backfill my work history."
- "Help me write my self-review for this half, focus on infrastructure."
- "I forgot to log my work for the last sprint. Can you help me reconstruct it?"
- "Prep my review pack for my promo packet."
Understand what the agent reads and what it needs
The skill works with no extra dependencies, using the guided interview if no other source is available. When they are present, the agent can use three sources. Git is optional and is used to read commits by your author email in the current repo. The GitHub CLI gh is optional and is used to list your merged PRs. Copilot CLI session logs are optional and are read from ~/.copilot/session-state/ if that folder exists.
An optional save_to_brag_sheet extension tool is mentioned by the skill, but it is not included in this file. The skill only uses it if it is confirmed available.
- git: optional, for commit mining
- gh (GitHub CLI): optional, for PR mining
- ~/.copilot/session-state/: optional, Copilot CLI session logs
- save_to_brag_sheet: optional extension tool, not included in this download
git log --author="$(git config user.email)" --since="2 weeks ago" --pretty=format:'%h|%ad|%s' --date=short --no-merges
gh pr list --author @me --state merged --limit 20 --json number,title,repository,mergedAtReview the safety notes before you run a backfill
This skill runs scripts and uses the network. The scan commands check whether git, gh and the session folder exist, then read commit messages, PR titles and session summaries. Session logs record the working directory, repository and branch for each session. Commit messages, PR titles and local session logs can contain sensitive material, so do not use the skill if you do not want an agent to read them.
The skill is designed to avoid inventing numbers, and it asks you to confirm before saving. You should still read every draft, because the agent can overstate impact when the evidence you supply is weak.
- Scripts run: yes. The scan commands run in your shell.
- Network use: yes. The gh command queries GitHub for your merged PRs.
- Review every draft; entries with weak evidence are marked (evidence needed) rather than polished.
Get better drafts from the skill
The skill's rules are strict about evidence. Give it PR numbers, links to design docs, or observable outcomes such as an incident that was resolved or a team that was unblocked. If you have a real measurement, include it. If you do not, the agent will ask whether you have a rough estimate or keep the entry qualitative.
Group work by feature rather than by commit when you review drafts. The skill merges several commits on the same feature into one entry and avoids padding weak periods with trivial items.
- Answer "Did this ship? Is there a PR or doc I can reference?" with a link where you can.
- Use the categories pr, bugfix, infrastructure, investigation, collaboration, tooling, oncall, design and documentation to organise entries.
- Accept an honest gap rather than asking for filler entries.
What people use it for
- Preparing a self-assessment by rebuilding a half's merged PRs and commits
- Writing a weekly status update from recent commits in one repo
- Building a promotion packet with entries grouped by impact theme
- Reconstructing forgotten work from Copilot CLI session summaries
- Rewording existing accomplishments into action, result and evidence form
Frequently asked questions
How do I install the brag-sheet agent skill?
Download the ZIP from this page and unzip it. Place the brag-sheet folder in ~/.claude/skills/ for all projects, or in a project's .claude/skills/ folder for one project. In the Claude apps, you can instead upload it under Settings → Capabilities → Skills.
Is the brag-sheet skill free to use?
The skill is published under the MIT licence, as stated on this page. Check the licence file in the source repository for the full terms.
What do I need to run brag-sheet?
Nothing beyond an agent that can load skills. git and the GitHub CLI gh are optional and add commit and PR mining. Copilot CLI session logs are optional and read from ~/.copilot/session-state/ if it exists.
Does brag-sheet read my code or commit messages?
It reads commit subjects, PR titles and Copilot session summaries when you ask for a backfill and the sources are available. If you do not want an agent to read those, do not use the skill.
Does brag-sheet save entries automatically?
No. The skill says to show drafted entries before saving and never to auto-save without confirmation. The save_to_brag_sheet tool it mentions is not included in this file.
Can brag-sheet make up impact numbers for me?
The skill's rules forbid inventing metrics, team sizes or impact numbers. If you do not supply a figure, entries stay qualitative or are marked (evidence needed).
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use brag-sheet if you are an engineer preparing a review or promotion case, or want weekly summaries drawn from your real commits and PRs, and you are comfortable with an agent reading those sources. Pick something else if you need sprint planning, ticket creation or time tracking, which the skill explicitly does not cover, or if you cannot share commit and session data with an agent.
Download the skill