github-wrapped
Installation
SKILL.md
GitHub Wrapped (Single-file HTML, Verifiable Data)
This skill generates a GitHub “Year in Review / Wrapped” as a single self-contained HTML file with a Bilibili-style narrative (scroll/page scenes, cinematic transitions, share card). The non-negotiable requirement is verifiability: every number must be traceable to saved gh api raw responses committed alongside the report.
Non-negotiables
- No fabricated data: if GitHub APIs cannot provide a metric, show
—and explain the limitation in-page. - Save raw API responses: the report is invalid without a
raw/folder containing the original JSON (and the GraphQL queries used). - Ship one
.html: no runtimeghcalls; embed a dataset into the HTML. - External CDNs are optional (fonts/icons/screenshot libs/music) but must never break core navigation/rendering if they fail to load.
- Build step-by-step: start with a tiny scaffold (≤ ~400 LOC) and iterate towards a 5k–10k LOC finished report; never try to ship the full “final” file in one pass.
What to ask the user first
YEAR(default: current year)USER(default:gh api user --jq .login)- Output language for the page copy (Chinese is usually preferred for CN users; this doc stays English)
- Timezone (default:
Asia/Shanghaifor CN users) - Whether to enable a music widget (autoplay may be blocked; must have a user-gesture fallback)