SkillPedia Skills Encyclopedia
中文 EN

技能 2026-09-24 18:25 UTC

hyperframes-community-skillsv2.3.2

版本【2.3.2】由提交人 jmoran-heygen 提交,主要更新类型为:功能特性新增与扩展。提交说明:Add day-in-my-life community skill (#13)。为项目引入了新的能力与模块支持。

jmoran-heygen ba7a0bb heygen-com/hyperframes-community-skills

Commit提交信息原文

Add day-in-my-life community skill (#13)

## What it does

Makes a 60 to 75 second hand-drawn ink film of one ordinary session
between an agent and its user: "a day in my life as <name>'s agent".

- The agent reads its own local Claude Code history and works out the
user's routine from its tool calls: reading, editing, tests, commits,
renders, whatever the history shows.
- It tells one session in time order, using the user's own words: the
opener, go-aheads, check-ins, corrections, praise, and memory titles.
- A coder gets a coding day (a terminal going red, then green, then a
merged PR). A video maker gets a video day.
- The look is two-tone p5.brush ink that boils at 8 fps, with a
hand-lettered title.
- The score is strings composed note for note on the film's clock. The
typed `claude` is the theme, and every knock, test result and lamp-out
is a note at the same timestamp as its drawing.

## Why it belongs here

It is one personal workflow built on one engine (a p5.brush canvas
painter driven through the `hf-seek` bridge), too specialized for the
curated skill set.

## Contents

- `SKILL.md`: workflow, requirements, rules, verification.
- `references/`:
  - `story.md`: routine → timeline → lines → privacy gate.
  - `look.md`: the ink kit and how to add a chapter type.
  - `score.md`: the arrangement and one recipe per chapter type.
- `scripts/`:
  - `harvest.py`: local receipts and the routine.
  - `new-film.mjs`: scaffolds a film and validates `story.json`.
  - `shoot.mjs`: stills and design-pass sheets.
- `score.py`: composes, synthesizes and masters the score, and writes
MIDI.
  - `qc.py`: render checks.
- `setup.sh`, `package.json`, `package-lock.json`, `requirements.txt`:
pinned dependencies.
- `assets/kit/`: `brush-ink.js`, `props.js`, `film.js`, `hf-bridge.js`.
- `assets/template/`: `index.html`, `scenes.js` (16 chapter types),
`archetypes.json` (the shared clock), `story.example.json` (a fictional
user).

## Commands, network, credentials, cost

- `sh scripts/setup.sh`, run manually once: `npm ci` from the lockfile.
It installs p5 2.3.2, p5.brush 2.2.1 and puppeteer 25.9.0; puppeteer
fetches its pinned Chrome for Testing from Google.
- `python3 -m pip install -r scripts/requirements.txt`: numpy 2.0.2,
scipy 1.13.1.
- `npx --yes hyperframes@0.8.70` for check and render, from
registry.npmjs.org. Needs Node 22+.
- `ffmpeg`, run locally for mastering, QC and render.
- At preview and render time the page loads the Gochi Hand font from
Google Fonts.
- No credentials, no paid calls, nothing uploaded.

## Side effects and privacy

- **Reads, locally:**
- `~/.claude/projects/*/*.jsonl`: the user's messages and the agent's
own tool calls.
  - `~/.claude/projects/*/memory/*.md`.
  - The `CLAUDE.md` of the projects those transcripts point at.
- It skips transcripts modified in the last 30 minutes (the session
making the film) unless `--keep-current` is passed.
- **Writes** only inside the film folder: `receipts.json`, `story.json`,
`story.js`, `music/`, `renders/`. These hold the user's words, and
SKILL.md says never to commit or share them.
- **The user approves every on-screen line, with its source, before
anything renders** (`story.approved`).
- `new-film.mjs --sync` refuses credentials, email addresses and file
paths, and warns on URLs.
- `harvest.py` flags secrets, emails, paths, URL domains and capitalised
names. It also attaches each line's session opener so the agent can
judge context.

## Tests

- `bash .github/scripts/validate-skills.sh`: Validated 6 skill(s).
- Smoke test with the fictional example (a coding day): scaffold, then
`score.py` (372 notes, -17.1 LUFS), then `hyperframes check` (0 errors),
then render (66.25 s, 1590 frames, 57 s on an M3 Pro GPU), then `qc.py`,
which passes all 18 checks:
- 8 drawings a second, every change on the 3-frame grid, no hold longer
than 3 frames
  - a fully inked frame at every cut
  - picture black and audio silent within one frame at the lamp-out
  - -17.2 LUFS, -2.5 dBTP
- Regression against the film the skill was built from (a real user's
history, not included): the composer reproduces its 424 notes exactly,
and stills match within 0.6% of pixels.
- Failure paths:
- A story with a trailing-period caption, an email, a credential-like
string and a misplaced `kept` chapter is refused with four errors.
  - Scaffolding into a folder holding other files is refused.
- A fresh agent given only the skill:
- harvested a real history, built a 13-chapter story, and produced the
design-pass sheet
- reported 13 unclear instructions and layout bugs, all fixed in this
version: candidate order, pasted-text filtering, session context, sticky
fit, labels showing through the new book, per-chapter check times, the
receipts format

## Dependencies and licenses

- p5 2.3.2 (LGPL-2.1), p5.brush 2.2.1 (MIT), puppeteer 25.9.0
(Apache-2.0). Pinned by `package-lock.json` and copied into each film's
`vendor/` at scaffold time. Nothing vendored in this repo.
- numpy 2.0.2 and scipy 1.13.1 (BSD-3-Clause).
- Gochi Hand (SIL OFL 1.1), via Google Fonts.

## Residual risk

- The film shows the user's real words. The privacy gate relies on the
agent following it and the user reading the approval table. The
heuristics miss lowercase names and can't know which repos are private.
- The strings are synthesized (additive bowed tones, Karplus-Strong
pizzicato), so they sound hand-made, not orchestral. `music/strings.mid`
can be re-voiced with a sampled library; `score.py --master-only` then
re-masters it.
- The page paints with WebGL, so renders run locally with
`--browser-gpu`.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Miguel Ángel <miguel.sierra@heygen.com>