Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add heygen-com/hyperframes-community-skills --skill session-storygit clone --depth 1 https://github.com/heygen-com/hyperframes-community-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/heygen-com/hyperframes-community-skills/session-story)<a href="https://agentmods.dev/skills/heygen-com/hyperframes-community-skills/session-story"><img src="https://agentmods.dev/badge/skills/heygen-com/hyperframes-community-skills/session-story/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/heygen-com/hyperframes-community-skills/session-story"><img src="https://agentmods.dev/badge/skills/heygen-com/hyperframes-community-skills/session-story.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00219 | $0.01848 |
| Opus 5.5 | $0.00088 | $0.00739 |
| Sonnet 5.5 | $0.00044 | $0.00370 |
| Haiku 4.5 | $0.00022 | $0.00185 |
Grade A, and why
session-story scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 21d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 101 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Session story
The agent reads its own history with its user, finds their routine, and turns one typical session into a 40 to 70 s film, in the order it happened:
- Story: the user's verbatim words arriving as objects, and the agent's own replies going back. The window and the wall clock follow the session's real time.
- Room: decorated from what the agent knows about its user.
- Score: composed by the agent against the film's own timeline.
Write story.json and the engine does the choreography. Nothing on screen is invented: every line is a quote, and
the user approves every line before a frame is rendered.
When to use / when not
- Use when a user asks their agent for a film of their work together, and the agent has real history with that user: local transcripts, or messages the user pastes in.
- Do not use for someone else's history, a team's shared logs, marketing with made-up quotes, or anything the user won't review. With no history at all, ask the user for a session's messages. Never invent quotes.
Requirements and side effects (complete list)
- Tools: Node 22+, Python 3.9+ (standard library only),
ffmpegon PATH, and the HyperFrames CLI pinned tonpx --yes [email protected](downloaded from the npm registry on first use). - Setup (once, manually):
sh scripts/setup.shrunsnpm cifrom the committed lockfile: p5 2.3.3 (LGPL-2.1), p5.brush 2.2.3 (MIT), @fontsource/permanent-marker 5.3.0 (Apache-2.0). Read-only downloads from npm. - Score renderer: on macOS,
swift(Xcode Command Line Tools) plays the score through Apple's built-in General MIDI bank. Elsewhere,fluidsynthwith a General MIDI soundfont you set asSOUNDFONT. Neither downloads anything. - Reads (local only, after the user says yes): the agent's own transcripts,
~/.claude/projects/<project>/*.jsonl(Claude Code) and~/.codex/sessions(Codex), for the current project unless the user allows--all-projects. Also the agent's memory and instruction files for the room. Nothing is uploaded. - Writes:
session-story-candidates.json(harvest) and everything inside the project folder you create. Both hold the user's words: never commit or share them. - Network at build time: none. Pass
--describe falseto everysnapshot, as shown below: withGEMINI_API_KEYset,snapshototherwise sends frames (the user's words) to Gemini. Render locally: the page paints with WebGL. - No credentials, no paid calls.
What ships with it
34 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- assets/engine/index.html 2.4 KB
- assets/engine/kit/clawd.js 51 KB runs code
- assets/engine/kit/config.js 149 B runs code
- assets/engine/kit/core.js 21 KB runs code
- assets/engine/kit/hf-bridge.js 2.1 KB runs code
- assets/engine/kit/timeline.js 2.9 KB runs code
- assets/engine/LICENSE-ClaudeAnimationBase 1.0 KB
- assets/engine/NOTICE.md 1.2 KB
- assets/engine/scenes/cast-custom.js 333 B runs code
- assets/engine/scenes/compile.js 20 KB runs code
- assets/engine/scenes/desk.js 25 KB runs code
- assets/engine/scenes/director.js 28 KB runs code
- assets/engine/scenes/paper.js 16 KB runs code
- assets/engine/scenes/props-custom.js 599 B runs code
- assets/engine/scenes/props.js 22 KB runs code
- assets/engine/story.js 189 B runs code
- assets/example/score.py 619 B runs code
- assets/example/story.json 2.1 KB
- references/cast.md 1.9 KB
- references/motion.md 2.8 KB
- references/room.md 4.4 KB
- references/score.md 6.7 KB
- references/sources.md 4.7 KB
- references/story.md 6.4 KB
- scripts/harvest.py 15 KB runs code
- scripts/new-project.mjs 5.0 KB runs code
- scripts/package-lock.json 8.8 KB
- scripts/package.json 311 B
- scripts/schedule.mjs 5.6 KB runs code
- scripts/score/build.sh 1.7 KB runs code
- scripts/score/orchestra.py 24 KB runs code
- scripts/score/qc.py 1.6 KB runs code
- scripts/score/render.swift 3.6 KB
- scripts/setup.sh 398 B runs code
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 21d ago First seen · 101 lines · 219 tokens per session scan A 6f5189263899
session-story is a skill published in the GitHub repository heygen-com/hyperframes-community-skills (208 stars, last pushed 2d ago), licensed Apache-2.0. It adds 219 tokens to every session and 1,848 once invoked, about $0.0009 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-25.
Other skills, from other repositories
paperclip-capsules
Generate, implement, or review Paperclip capsule visuals. Use for capsule art, agent capsules, heartbeat status capsules, identicons, capsule banks, or brand-usage validation.
video-hyperframes
Hyperframes / Remotion-compatible continuous frame animation with autoplay support.
brag
Turn the current project website into a short, polished, shareable launch video using Hyperframes. Use when someone says "/brag", "let's brag about this", "make a launch video", "turn this into a video", or wants to share what they built. Reads the project code directly — no live URL or screenshots needed.
brag-slim
Turn a project directory or a website URL into a short, shareable launch video with music, motion, and share copy. One file, no bundled assets — built entirely by the model with the tools already on the machine. Use when someone says "/brag-slim", "let's /brag about this", "brag about a website", "make a launch…
video-hyperframes
A web-based sequence of video frames designed for Hyperframes or Remotion, with each frame presenting one visual idea.
broll-director
Turn a complete original SRT and design into immutable shot truth, revisable creative proposals, semantic chapters, a shared visual world, a compact motion map, and three representative-scene choices.