Add brag-sheet skill — turn forgotten work into review bullets

[vidhartbhatia]

Pull Request Checklist

• I have read and followed the CONTRIBUTING.md guidelines.
• I have read and followed the Guidance for submissions involving paid services.
• My contribution adds a new skill file in the correct directory.
• The file follows the required naming convention.
• The content is clearly structured and follows the example format.
• I have tested the skill with GitHub Copilot CLI.
• I have run npm start and verified that docs/README.skills.md is up to date.
• I am targeting the staged branch for this pull request.

---

Description

Quick context: I previously tried submitting this as an external plugin (#1420, #1425). #1420 was rejected because the repo was in my personal account — I've since moved it to microsoft/copilot-brag-sheet. #1425 I closed myself after discovering that copilot plugin install doesn't actually load joinSession() extensions. So I'm submitting the core value as a standalone skill instead — no install required, works out of the box.

---

I built this because I kept forgetting what I shipped by the time review season came around.

This skill helps turn half-remembered work into solid review notes — impact-first bullets you can drop straight into a review doc. It can pull context from git history, PRs, and Copilot CLI session logs, then group things by category (PRs, bug fixes, infra, oncall, docs, etc.).

The session log angle is the part I cared about most. I use Copilot CLI a lot, and that history is usually the missing piece when I'm trying to reconstruct a week I forgot to write down.

There's also a companion extension (copilot-brag-sheet) for automatic tracking, but the skill works fine on its own.

Trigger phrases

• "log my work" / "save to brag sheet"
• "what did I do this week"
• "backfill my work history"
• "help me prep for my review"

---

Type of Contribution

• New skill file.

---

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

[github-actions]

🔍 Skill Validator Results

⚠️ Warnings or advisories found

Scope	Checked
Skills	1
Agents	1
Total	2
Severity	Count
---	---:
❌ Errors	0
⚠️ Warnings	1
ℹ️ Advisories	0

Summary

Level	Finding
ℹ️	Found 1 skill(s)
ℹ️	[brag-sheet] 📊 brag-sheet: 2,922 BPE tokens [chars/4: 2,959] (standard ~), 30 sections, 6 code blocks
ℹ️	[brag-sheet] ⚠ Skill is 2,922 BPE tokens (chars/4 estimate: 2,959) — approaching "comprehensive" range where gains diminish.
ℹ️	✅ All checks passed (1 skill(s))

Full validator output

```text Found 1 skill(s) [brag-sheet] 📊 brag-sheet: 2,922 BPE tokens [chars/4: 2,959] (standard ~), 30 sections, 6 code blocks [brag-sheet] ⚠ Skill is 2,922 BPE tokens (chars/4 estimate: 2,959) — approaching "comprehensive" range where gains diminish. ✅ All checks passed (1 skill(s)) ```

[Copilot]

Pull request overview

Adds a new brag-sheet skill to the skills/ catalog, aimed at helping developers produce impact-first accomplishment entries and backfill work history for performance reviews.

Changes:

• Introduces a new skills/brag-sheet/ skill with guidance for writing “impact-first” entries.
• Adds backfill workflows leveraging git history, Copilot CLI session-state, and GitHub PR history.
• Documents an optional integration with the external copilot-brag-sheet extension for automatic tracking.

[aaronpowell]

I closed myself after discovering that copilot plugin install doesn't actually load joinSession() extensions

Is that just in the session that you install in, or does it never load? Regardless, it sounds like something that should be raised as a bug on https://github.com/github/copilot-cli (if it's not already there).

It's good to merge as it is, but do you want to review if the plugin workflow does work on a terminal restart?

[vidhartbhatia]

Good call — I tested after terminal restart too and it still doesn't load the extension from \installed-plugins/. The CLI only discovers extensions from ~/.copilot/extensions//extension.mjs\ and .github/extensions//extension.mjs, not from the plugin install path. I'll file a bug on github/copilot-cli.

For now the manual install (\install.sh\ / \install.ps1) works fine and the skill is standalone useful without it. Thanks for the review!

[vidhartbhatia]

Hey @aaronpowell — I rebased onto latest staged to fix a merge conflict in the generated docs/README.skills.md. No changes to the skill itself. Could you re-approve when you get a chance? The force push dismissed the previous approval. Thanks!

[vidhartbhatia]

@all-contributors add @vidhartbhatia for skill

[allcontributors]

@vidhartbhatia

I couldn't determine any contributions to add, did you specify any contributions?
Please make sure to use valid contribution names.

[vidhartbhatia]

@all-contributors add @vidhartbhatia for content

[allcontributors]

@vidhartbhatia

I've put up a pull request to add @vidhartbhatia! 🎉