Brag document from git history
Goal: turn what you actually shipped into a draft you can edit, without inventing impact. A brag document lists work and results; this skill collects the work and marks every missing result as a gap for you to fill.
Step 1: collect the evidence
Ask for the time window (default: the last 6 months) and the repositories. Then, with the GitHub CLI signed in:
gh search prs --author @me --merged --merged-at ">=YYYY-MM-DD" --json title,url,closedAt,repository --limit 200
For code not on GitHub, use git log --author="<name or email>" --since="YYYY-MM-DD" --no-merges --pretty="%h %ad %s" --date=short in each repository. Also ask the user to paste anything git cannot show: incidents handled, mentoring, reviews done, talks, docs, on-call, design decisions, kind words from colleagues.
Do not read private repositories the user did not name. Do not guess names, teams or numbers.
Step 2: group, do not summarize yet
Group the items into themes (for example: reliability, new features, performance, tooling, mentoring, cross-team work). List each item under its theme with date and link. Merge duplicates (a feature PR plus its follow-up fixes).
Step 3: draft each theme
For every theme write:
- What I did: one or two sentences in plain verbs, using only what the titles, diffs and user notes support.
- Result: only if a number, quote or outcome was provided. Otherwise write
[GAP: what changed for users or the team? any metric before/after?]. - Evidence: links.
- Scope signal (if supported): led it, did it alone, worked across teams, was on call, reviewed others.
Step 4: finish with gaps and questions
End with a list of every [GAP], ranked by how much it would strengthen the case, and the three questions whose answers would add the most. Offer to turn the final version into a self-review, a promotion packet outline or resume bullets.
Rules
- Never invent metrics, percentages, customer names, titles or scope. A visible gap is better than a made-up number.
- Do not inflate: "contributed to" stays "contributed to". Match verbs to the evidence.
- Keep the user's credit honest: if a PR was a team effort, say what part was theirs.
- Keep private or confidential details out unless the user says the document is internal.
- Output Markdown the user can paste into their notes.