Skip to content
Skills Library
Marketing & content · Building & coding

code-islands

/code-islands

This skill should be used when someone asks for a video, animation, timelapse, year in review or "wrapped" of their commits, contributions or agentic coding history, across one or many repos. Renders each repo as a separate floating island that grows with their work, with a stats HUD and AI release timeline, plus a share cut that blurs private repo names.

Licence
MIT
Last repository change
06.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
5
Scripts
1
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 06.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: examples/music-elevenlabs.py

What it does and when to use it

This skill should be used when someone asks for a video, animation, timelapse, year in review or "wrapped" of their commits, contributions or agentic coding history, across one or many repos. Renders each repo as a separate floating island that grows with their work, with a stats HUD and AI release timeline, plus a share cut that blurs private repo names.

Triggers from the description

wrapped
Original author description

This skill should be used when someone asks for a video, animation, timelapse, year in review or "wrapped" of their commits, contributions or agentic coding history, across one or many repos. Renders each repo as a separate floating island that grows with their work, with a stats HUD and AI release timeline, plus a share cut that blurs private repo names.

How it works

  1. 1. Set up
  2. 2. Choose repos
  3. 3. Gather
  4. 4. AI releases
  5. 5. Preview
  6. 6. Render
  7. Before anyone shares a cut
  8. Additional resources
Original SKILL.md headings · 93 lines, 688 words
SKILL.md preview
---
name: code-islands
description: This skill should be used when someone asks for a video, animation, timelapse, year in review or "wrapped" of their commits, contributions or agentic coding history, across one or many repos. Renders each repo as a separate floating island that grows with their work, with a stats HUD and AI release timeline, plus a share cut that blurs private repo names.
---

# Code Islands

Turn one person's commits across all their repos into a 1080p video. Works on macOS and Linux.

Scripts live in `${CLAUDE_PLUGIN_ROOT}/scripts`. Run every command from the workspace folder, written below as `cd <workspace> && ...`, because each script reads `config.json` and `build/` from the current directory.

## 1. Set up

Run `sh "${CLAUDE_PLUGIN_ROOT}/scripts/doctor.sh"` and fix what it reports. Run `gh auth setup-git` so private repos can be cloned.

Ask for anything that cannot be worked out:

- **Workspace folder.** Default `~/code-islands`. It holds full clones, so it can take gigabytes.
- **Start date.** Suggest a round date. Offer the first AI co-authored commit once `collect.py` has reported it.
- **Timezone.** Sets the hour-of-day chart and day boundaries.
- **Length in seconds.** Default 90. Pacing follows from the length.
- **Sound.** An audio file, or silent. See `references/music.md`.

Write `config.json` in the workspace, following `examples/config.json`. Only `since` and `authors` are required.

`authors` are case-insensitive regexes matched against `name|email` of each commit. Start from `gh api user` (login, name) and `git config user.email`, and wrap names in `\b` so `dan` does not match `daniel`. Ask for old names and emails, since they split history.

Save a square avatar of at least 128px as `avatar.png`:

```sh
cd <workspace> && curl -sL "https://github.com/<login>.png?size=200" -o avatar.png
```

## 2. Choose repos

List repos without cloning anything:

```sh
cd <workspace> && python3 "${CLAUDE_PLUGIN_ROOT}/scripts/discover.py"
```

Show the list. Ask which employer, client or other sensitive repos to leave out, and add those to `exclude_repos` as `owner/name`. Add repos that are not on GitHub to `local_repos`. Those always count as private.

## 3. Gather

```sh
cd <workspace> && python3 "${CLAUDE_PLUGIN_ROOT}/scripts/discover.py" clone && python3 "${CLAUDE_PLUGIN_ROOT}/scripts/prs.py" && python3 "${CLAUDE_PLUGIN_ROOT}/scripts/collect.py"
```

`prs.py` waits between requests because GitHub search is rate limited, so run long ranges in the background and let the chain finish before step 5.

Show the totals and top repos. Look for missed name variants, and for wrong people caught by a loose regex.

Rerun `collect.py` after any `config.json` change. After moving `since` earlier, rerun all three commands.

## 4. AI releases

`${CLAUDE_PLUGIN_ROOT}/data/ai_releases.json` drives the left panel and the heatmap ticks. Search the web for releases newer than its last entry, then write the full list to `ai_releases.json` in the workspace, which takes priority. Entries are `{"date", "name", "vendor"}`. `anthropic` draws orange, `openai` blue, and any other vendor purple. Check dates against the vendors' own announcements.

## 5. Preview

Check a real frame before the full render. Use a time late in the video:

```sh
cd <workspace> && python3 "${CLAUDE_PLUGIN_ROOT}/scripts/islands.py" test 60 && python3 "${CLAUDE_PLUGIN_ROOT}/scripts/hud.py" test 60 build/isl_60.png
```

This writes `build/hud_60.png`. View it. `R0` and `EXP` at the top of `islands.py` set island size. `SAFE` is the area the HUD leaves free.

## 6. Render

Run as one background job, because both cuts share `build/islands.mp4`:

```sh
cd <workspace> && sh "${CLAUDE_PLUGIN_ROOT}/scripts/render.sh" && VARIANT=share sh "${CLAUDE_PLUGIN_ROOT}/scripts/render.sh" && sh "${CLAUDE_PLUGIN_ROOT}/scripts/scan.sh"
```

Files land in `out/` at 1080p and 720p. `DUR=10 OUT=/tmp/try` in front of `render.sh` makes a short test.

`scan.sh` needs `tesseract` and both cuts. It reads one frame per second with OCR, using the full cut as its control. It fails if a private name shows in the share cut, or if it cannot read names at all. Skip the share cut and the scan if the video stays private.

## Before anyone shares a cut

Tell the user plainly:

- The share cut blurs a random fake name, so de-blurring reveals nothing. Public repos keep their real names.
- Totals, activity patterns and the size of each island stay visible. Someone who knows the user may guess a large project.
- `scan.sh` samples frames and skips names under four characters, so it is a check and not a proof. View the video too.
- Nothing in `repos/` or `build/` should be published. Those folders hold private history.

## Additional resources

- `references/metrics.md`: what each number counts. Consult when a total looks wrong or the user asks.
- `references/music.md`: where to get a track, plus a prompt for AI music tools.
- `examples/config.json`: every config option.
- `examples/music-elevenlabs.py`: generating a track through one API.
Files in this package (5)
  • SKILL.md 5 KB
  • examples/config.json 1 KB
  • examples/music-elevenlabs.py 1 KB
  • references/metrics.md 1 KB
  • references/music.md 1 KB

Versions

The database has no other skills named code-islands.

Database snapshot: 13.11.2026 · package version 736ac3f0207e (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100code-wrapped
    Turn someone's git history into a "Wrapped"-style year-in-review story, a set of bold vertical cards (commits, lines written and deleted, coding hours heatmap, latest-night commit, longest streak, busiest day, top languages, most-touched file, biggest commit, commit-message…
  • 100repo-timelapse
    Turn a git repo's history into a video of the project growing. Files appear as a living treemap coloured by language that grows with the code, glows when touched and fades on delete, with a date, a lines-of-code counter, commit messages typing in as captions and an activity…
  • 85islands-and-plan
    Floating islands, the user's Goals, Scheduled and Settled lists, and scheduled wakes. Use when showing work at a glance, when they ask to change their plan or be reminded at a time, and when an island notice arrives.
  • 100github-year-in-review
    Turn someone's GitHub year into a short, postable year-in-review video (4:5, about 45 s, made for LinkedIn) using HyperFrames. Use when someone says "/github-year-in-review", "/year-in-review", "make my GitHub wrapped", "my year in code", "GitHub recap video", or wants to share…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.