Skip to content
Back to search

claude-wrapped

SkillWorks with Claude CodeGitHub

Your year with Claude Code as a 16-slide story with its own generated soundtrack. A Claude Code skill. Unofficial.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fox-d-e-n--claude-wrapped/badge.svg)](/listings/fox-d-e-n--claude-wrapped)

HTML

<a href="/listings/fox-d-e-n--claude-wrapped"><img src="/api/listings/fox-d-e-n--claude-wrapped/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

It is a [Claude Code skill](https://docs.claude.com/en/docs/claude-code/skills). Copy the folder into your skills directory:

git clone https://github.com/fox-d-e-n/claude-wrapped
cp -r claude-wrapped/skills/claude-wrapped ~/.claude/skills/

On Windows the folder is `C:\Users\<you>\.claude\skills\claude-wrapped`. Then open Claude Code and say **"make my Claude Wrapped"**. Claude counts your stats, asks what you built this year, writes a few lines of story and hands you the page.

Needs Python 3.10 or newer. No packages to install.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 69 lines
  1. # Claude Wrapped
  2. Your year with Claude Code, as a 16-slide story you can tap through, with its own soundtrack.
  3. It reads the transcripts Claude Code already keeps on your machine and shows your busiest day, longest
  4. streak, peak hour, top tools and models, biggest projects, a few spotlights (your most-typed word, your
  5. latest night, your longest session) and a receipt at the end. Each slide has its own track, generated in
  6. the browser with the Web Audio API: no audio files, nothing to license.
  7. **[See the demo](https://fox-d-e-n.github.io/claude-wrapped/)** (made-up numbers; tap for sound).
  8. <p>
  9. <img src="docs/preview-months.png" width="200" alt="Monthly token chart slide">
  10. <img src="docs/preview-busiest.png" width="200" alt="Busiest day slide">
  11. <img src="docs/preview-clock.png" width="200" alt="Peak hour slide">
  12. <img src="docs/preview-receipt.png" width="200" alt="Receipt slide">
  13. </p>
  14. ## Install
  15. It is a [Claude Code skill](https://docs.claude.com/en/docs/claude-code/skills). Copy the folder into your
  16. skills directory:
  17. ```bash
  18. git clone https://github.com/fox-d-e-n/claude-wrapped
  19. cp -r claude-wrapped/skills/claude-wrapped ~/.claude/skills/
  20. ```
  21. On Windows the folder is `C:\Users\<you>\.claude\skills\claude-wrapped`. Then open Claude Code and say
  22. **"make my Claude Wrapped"**. Claude counts your stats, asks what you built this year, writes a few lines
  23. of story and hands you the page.
  24. Needs Python 3.10 or newer. No packages to install.
  25. ## Run it by hand
  26. ```bash
  27. cd skills/claude-wrapped/scripts
  28. python wrapped_stats.py --out stats.json # counts, from ~/.claude/projects
  29. python render.py stats.json story.json -o wrapped.html
  30. ```
  31. `story.json` is optional (your name, notes per month, "what you built" cards); `SKILL.md` lists every
  32. key and `examples/demo-story.json` shows one filled in. Useful flags on `wrapped_stats.py`: `--since`,
  33. `--until`, `--root` (another projects folder) and `--ignore-prompt REGEX` (leave hook-generated text out
  34. of the word count).
  35. ## Privacy
  36. Everything runs on your machine and nothing is uploaded. The page it builds can show your session
  37. titles, project folder names and most-typed words, so read it before you post it anywhere.
  38. Claude Code deletes transcripts older than its `cleanupPeriodDays` setting, so the recap covers what is
  39. still on disk; the receipt says which dates it counted.
  40. ## Change it
  41. - Soundtrack: the `T` table in `skills/claude-wrapped/assets/music.js` sets each slide's track name,
  42. tempo, key, chords and intensity.
  43. - Slides: `assets/slides.js` builds them from the stats; a slide with no data is left out.
  44. - Look: colours and type are CSS variables at the top of `assets/template.html`.
  45. Checks: `python wrapped_stats.py --selftest` and `python render.py --selftest`.
  46. ## License
  47. MIT. Use it, fork it, change it.
  48. Unofficial fan project. Not affiliated with or endorsed by Anthropic or Spotify. "Claude" is a trademark
  49. of Anthropic; "Spotify Wrapped" is a trademark of Spotify.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.