From 30e0786b97b9e0f0044d9fdf2599846037edb24e Mon Sep 17 00:00:00 2001 From: Vids Bhatia Date: Thu, 16 Apr 2026 23:27:03 -0700 Subject: [PATCH 1/4] =?UTF-8?q?Add=20brag-sheet=20skill=20=E2=80=94=20work?= =?UTF-8?q?=20impact=20writer=20for=20performance=20reviews?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- skills/brag-sheet/SKILL.md | 108 +++++++++++++++++++++++++++++++++++++ 1 file changed, 108 insertions(+) create mode 100644 skills/brag-sheet/SKILL.md diff --git a/skills/brag-sheet/SKILL.md b/skills/brag-sheet/SKILL.md new file mode 100644 index 000000000..e3f680f11 --- /dev/null +++ b/skills/brag-sheet/SKILL.md @@ -0,0 +1,108 @@ +--- +name: brag-sheet +description: > + Write impact-first work entries for performance reviews. Backfill from git history, + Copilot session logs, and PRs. Categories: pr, bugfix, infrastructure, investigation, + collaboration, tooling, oncall, design, documentation. +--- + +# Brag Sheet — Work Impact Writer + +Help users write, organize, and backfill work accomplishments for performance reviews. + +USE FOR: "brag", "log work", "what did I do", "backfill my work history", "prep for performance review", "write impact statement", "Connect prep" +DO NOT USE FOR: project management, sprint planning, time tracking, ticket creation + +## Entry Format + +Every entry uses impact-first framing: + +``` +Did X for Y → Result Z → Evidence +``` + +Transform vague descriptions into impact statements: + +| ❌ Vague | ✅ Impact-first | +|---------|----------------| +| "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" | +| "Did code review" | "Reviewed and unblocked 8 PRs across 3 repos → team shipped migration on schedule" | + +## 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 | + +## Writing Entries + +Guide users through 3 questions: + +1. **What did you do?** — the specific change or deliverable +2. **Why does it matter?** — who benefits, what problem it solves +3. **What's the evidence?** — PR link, metrics, before/after + +Output as markdown: + +```markdown +### 🏗️ Infrastructure +- **Built latency dashboard in Grafana** → on-call detects P95 spikes in <2min → deployed to prod +``` + +## Backfill from Sources + +When the user asks "what did I do last week" or "backfill my history": + +### Git commits +```bash +git log --oneline --after="2 weeks ago" --author="$(git config user.name)" --no-merges +``` +Group related commits into single entries. Bug fixes → `bugfix`, infra → `infrastructure`. + +### Copilot CLI session history +Scan `~/.copilot/session-state/` for recent sessions: +```bash +find ~/.copilot/session-state/ -name "workspace.yaml" -mtime -14 -type f 2>/dev/null +``` +Read each `workspace.yaml` for `summary`, `cwd`, `repository`, `branch` fields. Compose entries from significant sessions. + +### PR history +```bash +gh pr list --state merged --author @me --limit 20 +``` + +### Workflow +1. **Scan** sources above +2. **Group** related work into entries +3. **Draft** impact-first summaries +4. **Present** to user for review +5. **Output** as formatted markdown + +## Performance Review Prep + +When prepping for a review, organize entries by impact theme (not chronologically): +- Reliability / operational excellence +- Feature delivery / velocity +- Collaboration / mentoring +- Technical leadership + +For narrative sections, use STAR format: Situation → Task → Action → Result. + +## Full Automatic Tracking + +For automatic session tracking (files edited, PRs created, git actions captured in the background), install the [copilot-brag-sheet](https://github.com/microsoft/copilot-brag-sheet) extension: + +```bash +curl -sL https://raw.githubusercontent.com/microsoft/copilot-brag-sheet/main/install.sh | bash +``` + +The extension adds `save_to_brag_sheet`, `review_brag_sheet`, and `generate_work_log` tools to every session. From 7a781664d37bd0736aec9d9bf7e6d13494f07dc7 Mon Sep 17 00:00:00 2001 From: Vids Bhatia Date: Sat, 18 Apr 2026 11:55:48 -0700 Subject: [PATCH 2/4] polish: improve skill with frontmatter, fallbacks, cross-platform guidance --- skills/brag-sheet/SKILL.md | 113 ++++++++++++++++++++++++------------- 1 file changed, 74 insertions(+), 39 deletions(-) diff --git a/skills/brag-sheet/SKILL.md b/skills/brag-sheet/SKILL.md index e3f680f11..7f0ac98ff 100644 --- a/skills/brag-sheet/SKILL.md +++ b/skills/brag-sheet/SKILL.md @@ -2,26 +2,32 @@ name: brag-sheet description: > Write impact-first work entries for performance reviews. Backfill from git history, - Copilot session logs, and PRs. Categories: pr, bugfix, infrastructure, investigation, - collaboration, tooling, oncall, design, documentation. + Copilot session logs, and PRs. Works standalone or with the copilot-brag-sheet extension. +license: MIT +compatibility: 'Cross-platform (Windows, macOS, Linux). Works with any GitHub Copilot CLI session.' +metadata: + version: "1.0" +argument-hint: 'Optional: time range ("last 2 weeks"), category ("infrastructure"), or "backfill"' --- # Brag Sheet — Work Impact Writer Help users write, organize, and backfill work accomplishments for performance reviews. -USE FOR: "brag", "log work", "what did I do", "backfill my work history", "prep for performance review", "write impact statement", "Connect prep" +USE FOR: "brag", "log work", "what did I do", "backfill my work history", "prep for performance review", "write impact statement", "review prep" DO NOT USE FOR: project management, sprint planning, time tracking, ticket creation ## Entry Format -Every entry uses impact-first framing: +Every entry uses impact-first framing with three required parts: ``` -Did X for Y → Result Z → Evidence +Did [action] → [result/impact] → [evidence] ``` -Transform vague descriptions into impact statements: +**Do not output an entry unless it includes all three parts.** If evidence is missing, ask for it or mark as "(evidence needed)". + +### Examples | ❌ Vague | ✅ Impact-first | |---------|----------------| @@ -43,13 +49,29 @@ Transform vague descriptions into impact statements: | `design` | 📐 | Design docs, architecture decisions | | `documentation` | 📝 | Docs, runbooks, guides | +## How to Help the User + +Follow this decision tree: + +1. **If `save_to_brag_sheet` tool 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. + +2. **If git or gh CLI is available** → backfill from commits and PRs (see Backfill section below) + +3. **Otherwise** → run a guided interview: + - "What did you work on recently?" + - "Who benefited and how?" + - "What's the evidence? (PR number, metric, link)" + - Draft entries from answers + +In all cases, output formatted markdown the user can save. + ## Writing Entries Guide users through 3 questions: 1. **What did you do?** — the specific change or deliverable 2. **Why does it matter?** — who benefits, what problem it solves -3. **What's the evidence?** — PR link, metrics, before/after +3. **What's the evidence?** — PR link, metrics, before/after comparison Output as markdown: @@ -58,51 +80,64 @@ Output as markdown: - **Built latency dashboard in Grafana** → on-call detects P95 spikes in <2min → deployed to prod ``` -## Backfill from Sources +## Backfill Workflow When the user asks "what did I do last week" or "backfill my history": -### Git commits -```bash -git log --oneline --after="2 weeks ago" --author="$(git config user.name)" --no-merges -``` -Group related commits into single entries. Bug fixes → `bugfix`, infra → `infrastructure`. +**Follow these steps in order. Do not draft entries until scanning is complete.** -### Copilot CLI session history -Scan `~/.copilot/session-state/` for recent sessions: -```bash -find ~/.copilot/session-state/ -name "workspace.yaml" -mtime -14 -type f 2>/dev/null -``` -Read each `workspace.yaml` for `summary`, `cwd`, `repository`, `branch` fields. Compose entries from significant sessions. +### Step 1: Scan available sources -### PR history -```bash -gh pr list --state merged --author @me --limit 20 -``` +**Git commits** — Look at recent commit history in the current repo: +- Use `git log` to find recent commits by the user +- Group related commits by theme (same files, related messages) + +**PR history** — Check for merged PRs: +- Use `gh pr list` if available, or ask the user for PR links + +**Copilot session history** — If `~/.copilot/session-state/` exists, scan for recent sessions: +- Each subdirectory is a session with a `workspace.yaml` containing `summary`, `cwd`, `repository`, `branch` +- Skip sessions without summaries +- 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 commits/PRs/sessions into logical entries. Multiple small commits on the same feature → one entry. -### Workflow -1. **Scan** sources above -2. **Group** related work into entries -3. **Draft** impact-first summaries -4. **Present** to user for review -5. **Output** as formatted markdown +### 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: + +```markdown +## 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 prepping for a review, organize entries by impact theme (not chronologically): +When the user is preparing for a review, organize entries by impact theme (not chronologically): - Reliability / operational excellence - Feature delivery / velocity - Collaboration / mentoring - Technical leadership -For narrative sections, use STAR format: Situation → Task → Action → Result. +For narrative sections, use STAR format: **S**ituation → **T**ask → **A**ction → **R**esult. -## Full Automatic Tracking - -For automatic session tracking (files edited, PRs created, git actions captured in the background), install the [copilot-brag-sheet](https://github.com/microsoft/copilot-brag-sheet) extension: - -```bash -curl -sL https://raw.githubusercontent.com/microsoft/copilot-brag-sheet/main/install.sh | bash -``` +## Automatic Session Tracking (Optional) -The extension adds `save_to_brag_sheet`, `review_brag_sheet`, and `generate_work_log` tools to every session. +For automatic background tracking of every Copilot CLI session (files edited, PRs created, git actions), install the [copilot-brag-sheet](https://github.com/microsoft/copilot-brag-sheet) extension. It adds `save_to_brag_sheet`, `review_brag_sheet`, and `generate_work_log` tools to every session. From abcd089adaedd3b62ff6db32d70706c9432188b3 Mon Sep 17 00:00:00 2001 From: Vids Bhatia Date: Mon, 20 Apr 2026 11:24:41 -0700 Subject: [PATCH 3/4] improve skill with routing table, anti-patterns, evidence ladder, gotchas --- skills/brag-sheet/SKILL.md | 182 ++++++++++++++++++++++++++++++++----- 1 file changed, 160 insertions(+), 22 deletions(-) diff --git a/skills/brag-sheet/SKILL.md b/skills/brag-sheet/SKILL.md index 7f0ac98ff..99e5dd2be 100644 --- a/skills/brag-sheet/SKILL.md +++ b/skills/brag-sheet/SKILL.md @@ -1,22 +1,52 @@ --- name: brag-sheet description: > - Write impact-first work entries for performance reviews. Backfill from git history, - Copilot session logs, and PRs. Works standalone or with the copilot-brag-sheet extension. + Turn vague "what did I do?" into evidence-backed impact statements for performance + reviews, self-reviews, promotion packets, and weekly updates. Uniquely mines Copilot + CLI session logs to reconstruct forgotten work, plus git commits and GitHub PRs. + Enforces a 3-part impact contract (action → result → evidence). Works standalone + with zero dependencies. Trigger for: "brag", "log work", "what did I do", + "backfill my work history", "performance review", "self-review", "self assessment", + "write impact statement", "review prep", "promo packet", "promotion case", + "weekly update", "status report", "accomplishments", "what did I ship", + "I forgot to log my work", "summarize my work", "track my wins", + "what should I highlight", "end of half", "career growth", "work journal", + or any request to document, summarize, or organize work accomplishments. license: MIT -compatibility: 'Cross-platform (Windows, macOS, Linux). Works with any GitHub Copilot CLI session.' +compatibility: 'Cross-platform (Windows, macOS, Linux). Works with any GitHub Copilot CLI session. Optional: git, gh CLI.' metadata: - version: "1.0" -argument-hint: 'Optional: time range ("last 2 weeks"), category ("infrastructure"), or "backfill"' + version: "1.1" +argument-hint: 'Optional: time range ("last 2 weeks", "this half"), category ("infrastructure"), "backfill", or "review prep"' --- # Brag Sheet — Work Impact Writer -Help users write, organize, and backfill work accomplishments for performance reviews. +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 my work history", "prep for performance review", "write impact statement", "review prep" +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 + +1. **DO** confirm the time range and scope before scanning sources. Don't assume "last week" — ask. +2. **DO** check which tools are available (`save_to_brag_sheet`, `git`, `gh`) before choosing a workflow. +3. **DO** always include all three parts: action → result → evidence. If evidence is missing, write `(evidence needed)` — never silently omit. +4. **DO** show drafted entries to the user before saving. Never auto-save without confirmation. +5. **DO** group related commits into a single entry. Ten commits on the same feature = one entry. +6. **DO** preserve the user's voice. Reframe for impact, but don't invent accomplishments or inflate scope. +7. **DO NOT** fabricate metrics, team sizes, or impact numbers. If the user doesn't provide a number, don't invent one. +8. **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?" +9. **DO NOT** skip the backfill scan steps or draft entries before scanning is complete. +10. **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: @@ -35,6 +65,33 @@ Did [action] → [result/impact] → [evidence] | "Worked on dashboards" | "Built latency dashboard in Grafana → on-call detects P95 spikes in <2min → deployed to prod" | | "Did code review" | "Reviewed and unblocked 8 PRs across 3 repos → team shipped migration on schedule" | +## Anti-Patterns + +| ❌ Don't | ✅ Do instead | +|---------|--------------| +| "Fixed a bug" | "Fixed token refresh race condition → eliminated 401 errors affecting 12% of API calls → PR #247" | +| Invent a metric: "saved 40% of eng time" | Ask the user: "Do you have a rough estimate, or should I keep this qualitative?" | +| One entry per commit | Group related commits into a single logical entry with the highest-impact framing | +| Use passive voice: "The pipeline was improved" | Use active voice: "Built CI matrix testing 3 OSes × 3 Node versions → caught Windows-only bug before release" | +| List technologies: "Used Terraform, Helm, ArgoCD" | State the outcome: "Migrated 4 services to IaC → deployment time dropped from 45 min to 8 min" | +| Write a wall of text for review prep | Organize by impact theme with 2–3 bullets each; use STAR format for narratives | +| Silently drop entries with weak evidence | Mark `(evidence needed)` and present for the user to fill in | +| Pad weak weeks with trivial entries | Honest gap > inflated list. Focus on fewer, stronger entries | + +## 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 | @@ -88,23 +145,41 @@ When the user asks "what did I do last week" or "backfill my history": ### Step 1: Scan available sources -**Git commits** — Look at recent commit history in the current repo: -- Use `git log` to find recent commits by the user -- Group related commits by theme (same files, related messages) +**Do not draft entries until ALL available sources are scanned.** + +Check what's available: +```bash +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: +```bash +git log --author="$(git config user.email)" --since="2 weeks ago" \ + --pretty=format:'%h|%ad|%s' --date=short --no-merges +``` -**PR history** — Check for merged PRs: -- Use `gh pr list` if available, or ask the user for PR links +**PR history** — merged PRs across repos: +```bash +gh pr list --author @me --state merged --limit 20 \ + --json number,title,repository,mergedAt +``` -**Copilot session history** — If `~/.copilot/session-state/` exists, scan for recent sessions: -- Each subdirectory is a session with a `workspace.yaml` containing `summary`, `cwd`, `repository`, `branch` -- Skip sessions without summaries +**Copilot session history** (unique to this skill): +- Path: `~/.copilot/session-state//workspace.yaml` +- Read fields: `summary`, `cwd`, `repository`, `branch` +- Skip sessions without a `summary` field - 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 commits/PRs/sessions into logical entries. Multiple small commits on the same feature → one entry. +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 @@ -130,13 +205,76 @@ Format as markdown grouped by week: ## Performance Review Prep -When the user is preparing for a review, organize entries by impact theme (not chronologically): -- Reliability / operational excellence -- Feature delivery / velocity -- Collaboration / mentoring -- Technical leadership +When the user is preparing for a performance review (Connect, annual review, etc.): + +### Structure + +1. **Gather** — collect entries from the work log (or backfill using the workflow above) +2. **Select** — pick the top 3–5 highest-impact items +3. **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 +4. **Organize** by impact theme (not chronologically): + - Delivering results / operational excellence + - Customer / team impact + - Collaboration / mentoring / leadership + - Growth / learning +5. **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: **S**ituation → **T**ask → **A**ction → **R**esult. + +For Microsoft employees using the Connect preset, frame entries around Core Priorities: delivering results, customer obsession, teamwork, and growth mindset. + +## Output Contract + +Every skill invocation must satisfy ALL of the following before finishing: + +1. **Every entry uses impact-first format**: action → result → evidence. No exceptions. +2. **No fabricated data**. Every metric must come from the user or scanned sources. If unverified, mark `(evidence needed)`. +3. **Entries are presented to the user before saving**. Never auto-save or finalize without confirmation. +4. **Backfill scans complete before drafting**. If the user asked to backfill, all available sources must be scanned first. +5. **Time range is explicit**. Every backfill or review output states the date range it covers. +6. **Output is valid markdown** that can be pasted directly into a review doc or shared with a manager. +7. **Every entry has a category** from the valid set. + +## Gotchas + +### No recent commits in the current repo +The user may work across multiple repos. Before concluding there's nothing to backfill: +1. Ask if they want to scan a different repo or branch +2. Check `gh pr list --author @me --state merged` for cross-repo PRs +3. 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: +```bash +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. -For narrative sections, use STAR format: **S**ituation → **T**ask → **A**ction → **R**esult. +### 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) From 1755fae6ae7760442922acb331fd5db6094232f3 Mon Sep 17 00:00:00 2001 From: Vids Bhatia Date: Mon, 20 Apr 2026 12:16:56 -0700 Subject: [PATCH 4/4] trim skill to reduce token count, run npm start to update docs --- docs/README.skills.md | 1 + skills/brag-sheet/SKILL.md | 67 ++++++++++---------------------------- 2 files changed, 18 insertions(+), 50 deletions(-) diff --git a/docs/README.skills.md b/docs/README.skills.md index 2aa6ba0eb..501c58a17 100644 --- a/docs/README.skills.md +++ b/docs/README.skills.md @@ -67,6 +67,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-skills) for guidelines on how to | [batch-files](../skills/batch-files/SKILL.md)
`gh skills install github/awesome-copilot batch-files` | Expert-level Windows batch file (.bat/.cmd) skill for writing, debugging, and maintaining CMD scripts. Use when asked to "create a batch file", "write a .bat script", "automate a Windows task", "CMD scripting", "batch automation", "scheduled task script", "Windows shell script", or when working with .bat/.cmd files in the workspace. Covers cmd.exe syntax, environment variables, control flow, string processing, error handling, and integration with system tools. | `assets/executable.txt`
`assets/library.txt`
`assets/task.txt`
`references/batch-files-and-functions.md`
`references/cygwin.md`
`references/msys2.md`
`references/tools-and-resources.md`
`references/windows-commands.md`
`references/windows-subsystem-on-linux.md` | | [bigquery-pipeline-audit](../skills/bigquery-pipeline-audit/SKILL.md)
`gh skills install github/awesome-copilot bigquery-pipeline-audit` | Audits Python + BigQuery pipelines for cost safety, idempotency, and production readiness. Returns a structured report with exact patch locations. | None | | [boost-prompt](../skills/boost-prompt/SKILL.md)
`gh skills install github/awesome-copilot boost-prompt` | Interactive prompt refinement workflow: interrogates scope, deliverables, constraints; copies final markdown to clipboard; never writes code. Requires the Joyride extension. | None | +| [brag-sheet](../skills/brag-sheet/SKILL.md)
`gh skills install github/awesome-copilot brag-sheet` | Turn vague "what did I do?" into evidence-backed impact statements for performance reviews, self-reviews, promotion packets, and weekly updates. Uniquely mines Copilot CLI session logs to reconstruct forgotten work, plus git commits and GitHub PRs. Enforces a 3-part impact contract (action → result → evidence). Works standalone with zero dependencies. Trigger for: "brag", "log work", "what did I do", "backfill my work history", "performance review", "self-review", "self assessment", "write impact statement", "review prep", "promo packet", "promotion case", "weekly update", "status report", "accomplishments", "what did I ship", "I forgot to log my work", "summarize my work", "track my wins", "what should I highlight", "end of half", "career growth", "work journal", or any request to document, summarize, or organize work accomplishments. | None | | [breakdown-epic-arch](../skills/breakdown-epic-arch/SKILL.md)
`gh skills install github/awesome-copilot breakdown-epic-arch` | Prompt for creating the high-level technical architecture for an Epic, based on a Product Requirements Document. | None | | [breakdown-epic-pm](../skills/breakdown-epic-pm/SKILL.md)
`gh skills install github/awesome-copilot breakdown-epic-pm` | Prompt for creating an Epic Product Requirements Document (PRD) for a new epic. This PRD will be used as input for generating a technical architecture specification. | None | | [breakdown-feature-implementation](../skills/breakdown-feature-implementation/SKILL.md)
`gh skills install github/awesome-copilot breakdown-feature-implementation` | Prompt for creating detailed feature implementation plans, following Epoch monorepo structure. | None | diff --git a/skills/brag-sheet/SKILL.md b/skills/brag-sheet/SKILL.md index 99e5dd2be..250f4ac8a 100644 --- a/skills/brag-sheet/SKILL.md +++ b/skills/brag-sheet/SKILL.md @@ -57,26 +57,17 @@ 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)". -### Examples - -| ❌ Vague | ✅ Impact-first | -|---------|----------------| -| "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" | -| "Did code review" | "Reviewed and unblocked 8 PRs across 3 repos → team shipped migration on schedule" | - -## Anti-Patterns +### Anti-Patterns | ❌ Don't | ✅ Do instead | |---------|--------------| -| "Fixed a bug" | "Fixed token refresh race condition → eliminated 401 errors affecting 12% of API calls → PR #247" | -| Invent a metric: "saved 40% of eng time" | Ask the user: "Do you have a rough estimate, or should I keep this qualitative?" | -| One entry per commit | Group related commits into a single logical entry with the highest-impact framing | -| Use passive voice: "The pipeline was improved" | Use active voice: "Built CI matrix testing 3 OSes × 3 Node versions → caught Windows-only bug before release" | -| List technologies: "Used Terraform, Helm, ArgoCD" | State the outcome: "Migrated 4 services to IaC → deployment time dropped from 45 min to 8 min" | -| Write a wall of text for review prep | Organize by impact theme with 2–3 bullets each; use STAR format for narratives | -| Silently drop entries with weak evidence | Mark `(evidence needed)` and present for the user to fill in | -| Pad weak weeks with trivial entries | Honest gap > inflated list. Focus on fewer, stronger entries | +| "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 @@ -114,28 +105,9 @@ Follow this decision tree: 2. **If git or gh CLI is available** → backfill from commits and PRs (see Backfill section below) -3. **Otherwise** → run a guided interview: - - "What did you work on recently?" - - "Who benefited and how?" - - "What's the evidence? (PR number, metric, link)" - - Draft entries from answers - -In all cases, output formatted markdown the user can save. - -## Writing Entries +3. **Otherwise** → guided interview: "What did you work on?", "Who benefited?", "What's the evidence?" -Guide users through 3 questions: - -1. **What did you do?** — the specific change or deliverable -2. **Why does it matter?** — who benefits, what problem it solves -3. **What's the evidence?** — PR link, metrics, before/after comparison - -Output as markdown: - -```markdown -### 🏗️ Infrastructure -- **Built latency dashboard in Grafana** → on-call detects P95 spikes in <2min → deployed to prod -``` +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 @@ -145,9 +117,7 @@ When the user asks "what did I do last week" or "backfill my history": ### Step 1: Scan available sources -**Do not draft entries until ALL available sources are scanned.** - -Check what's available: +Check what's available, then mine each source: ```bash git --version 2>/dev/null # for commit mining gh --version 2>/dev/null # for PR mining @@ -239,15 +209,12 @@ For Microsoft employees using the Connect preset, frame entries around Core Prio ## Output Contract -Every skill invocation must satisfy ALL of the following before finishing: - -1. **Every entry uses impact-first format**: action → result → evidence. No exceptions. -2. **No fabricated data**. Every metric must come from the user or scanned sources. If unverified, mark `(evidence needed)`. -3. **Entries are presented to the user before saving**. Never auto-save or finalize without confirmation. -4. **Backfill scans complete before drafting**. If the user asked to backfill, all available sources must be scanned first. -5. **Time range is explicit**. Every backfill or review output states the date range it covers. -6. **Output is valid markdown** that can be pasted directly into a review doc or shared with a manager. -7. **Every entry has a category** from the valid set. +Before finishing, ensure: +1. Every entry has action → result → evidence (mark `(evidence needed)` if missing) +2. No fabricated metrics — only user-provided or source-verified data +3. Entries shown to user before saving +4. Time range explicitly stated +5. Output is pasteable markdown with categories assigned ## Gotchas