New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Session Story Film

by heygen-com in heygen-com/hyperframes-community-skills

Turns one typical session between you and your agent into a short animated film built from your real messages, with a composed score, after you approve every line.

Apache-2.0Auto-check passedMedia & Creative

Install Session Story Film

skills CLI
$ npx skills add heygen-com/hyperframes-community-skills --skill session-story -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install heygen-com/hyperframes-community-skills session-story --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/heygen-com/hyperframes-community-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/session-story .claude/skills/session-story && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
session-story
GitHub stars
183
Token cost
~1.8k tokens
SKILL.md length
896 words
Files
39 (incl. scripts, references, assets)
Skills in repo
8
Repo updated
First seen
Licence
Apache-2.0

At a glance

Turns one typical session between you and your agent into a short animated film built from your real messages, with a composed score, after you approve every line.

  • Works in 11 steps: Setup: sh scripts/setup.sh (once). → Ask first. Tell the user you'll read… → Harvest: python3 scripts/harvest.py… → …
  • Making an animated film about what working with your agent is like
  • SKILL.md covers When to use / when not, Requirements and side effects…, Workflow and Verify success, plus 1 more section
  • Runs JavaScript scripts from its folder; calls npx, sh and node; needs GEMINI_API_KEY

What it does

The agent reads its own history with you, such as local Claude Code or Codex transcripts or messages you paste, and finds your routine. It then builds a film of 40 to 70 seconds in which your verbatim words arrive as objects, the agent's replies go back, the room is decorated from what the agent knows about you, and the agent composes a score matched to the timeline. Nothing on screen is invented: every line is a quote, and you approve each one before a frame is rendered.

You write story.json and the bundled engine handles the choreography, with p5.brush watercolour rendered through HyperFrames. Reads happen locally and only after you say yes, outputs hold your words and should never be committed or shared, and build time uses no network as long as snapshots run with describing turned off, since a Gemini key would otherwise send frames. It is not for someone else's history, a team's shared logs or marketing with made-up quotes. Setup runs once by hand with npm ci from a lockfile.

When your agent uses it

  • Making an animated film about what working with your agent is like
  • Turning a real session transcript into a short story with a score
  • Reviewing and approving every quoted line before rendering

Example prompts

  • “Make a film of a typical session between us, using my real messages.”
  • “Animate a session with me, and show me every line to approve before you render.”
  • “Show what working with me is like, using only local transcripts from this project.”

Requirements

  • Node 22 or later and Python 3.9 or later
  • ffmpeg on PATH
  • The HyperFrames CLI, downloaded from npm on first use
  • swift on macOS, or fluidsynth with a General MIDI soundfont, for the score

Workflow steps

11 steps, taken from the first numbered list in SKILL.md.

  1. Setup: sh scripts/setup.sh (once).
  2. Ask first. Tell the user you'll read your local history with them to find the session, and wait for a yes.
  3. Harvest: python3 scripts/harvest.py --project --out /candidates.json prints
  4. Scaffold: node scripts/new-project.mjs . Everything you write from here lives in .
  5. Story: take a typical session and write /story.json beat by beat, in the order it happened, with each
  6. Room: fill the slots from what you know about the user, per references/room.md. Draw a
  7. Privacy gate: show the user one table of every on-screen line (hook, nameplate, each quote, each reply, each
  8. Design pass: run the snapshot command schedule.mjs prints. Look at every frame: quotes legible, props where
  9. Score: write /score/score.py with your own theme, key and palette, per
  10. Render: from : npx --yes hyperframes@0.8.71 check`, then
  11. Check the render: its length must match schedule.mjs. Pull a frame at each key moment

What it can do on your machine

Read from SKILL.md and the folder at commit ba7a0bb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (JavaScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • npx
    • sh
    • node
    • npm
    • python3
    • ffmpeg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx and npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GEMINI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Session Story Film loads about 1.8k tokens when it runs, and up to ~8.7k if it reads all its reference files. Until then it costs about 238 tokens; SKILL.md has 896 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~238
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from heygen-com/hyperframes-community-skills at commit ba7a0bb, republished under its Apache-2.0 licence (© heygen-com). 896 words, ~1,801 tokens.

Download SKILL.mdSave it as .claude/skills/session-story/SKILL.md (or your agent's skills folder). This skill also uses 38 other files; get the full folder from GitHub.
name
session-story
description
An agent makes an animated film of an average session with its own user, beginning to end, told with that user's real messages: whatever their routine is (code, writing, data, design, video). The agent sits at a desk in a room decorated from what it knows about the user, and the monitor shows their kind of work. Requests glide in as paper planes and unfold. Corrections are a 3D cartoon mallet that bonks, then turns to show the words on its face. Praise is a butterfly towing the words on a ribbon. The agent types each reply onto a sheet, folds it and throws it back. The film opens with the agent asleep until the monitor boots: "Initiating session with <name>". The agent composes its own orchestral score, cued to every action. p5.brush watercolour, rendered in HyperFrames. Trigger on: "a video of our session", "animate a session with me", "session story", "show what working with me is like", "make a film about me and my agent".

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), ffmpeg on PATH, and the HyperFrames CLI pinned to npx --yes hyperframes@0.8.71 (downloaded from the npm registry on first use).
  • Setup (once, manually): sh scripts/setup.sh runs npm ci from 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, fluidsynth with a General MIDI soundfont you set as SOUNDFONT. 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 false to every snapshot, as shown below: with GEMINI_API_KEY set, snapshot otherwise sends frames (the user's words) to Gemini. Render locally: the page paints with WebGL.
  • No credentials, no paid calls.

Workflow

  1. Setup: sh scripts/setup.sh (once).
  2. Ask first. Tell the user you'll read your local history with them to find the session, and wait for a yes.
  3. Harvest: python3 scripts/harvest.py --project <their project folder> --out <scratch>/candidates.json prints the routine and lists sessions, most typical first. --session <id> (with the same --project) prints one in order, with local times and your replies. Per references/sources.md.
  4. Scaffold: node scripts/new-project.mjs <dir>. Everything you write from here lives in <dir>.
  5. Story: take a typical session and write <dir>/story.json beat by beat, in the order it happened, with each beat's real time, per references/story.md. The user's lines are verbatim spans; your replies are your own words from that session. Set screen to what their work looks like, and pick the ending their sessions have. node scripts/schedule.mjs <dir> checks it: run it after every edit.
  6. Room: fill the slots from what you know about the user, per references/room.md. Draw a custom prop in <dir>/scenes/props-custom.js when the library has nothing true to them. If you are not Claude, draw yourself: references/cast.md.
  7. Privacy gate: show the user one table of every on-screen line (hook, nameplate, each quote, each reply, each prop and why), each with its source. Take their edits, get an explicit yes, then set "approved": true. Until then every frame carries a DRAFT stamp.
  8. Design pass: run the snapshot command schedule.mjs prints. Look at every frame: quotes legible, props where they belong, nothing covering a message. Show the user the contact sheet.
  9. Score: write <dir>/score/score.py with your own theme, key and palette, per references/score.md. Then sh <dir>/score/build.sh. It fails on dead air.
  10. Render: from <dir>: npx --yes hyperframes@0.8.71 check, then npx --yes hyperframes@0.8.71 render --fps 24 --crf 12 -o renders/session-story.mp4.
  11. Check the render: its length must match schedule.mjs. Pull a frame at each key moment (ffmpeg -ss <t> -i renders/session-story.mp4 -frames:v 1 renders/check-<t>.png) and look at them. Then hand it to the user to watch with sound.
Show full SKILL.md (198 more words)Show less

The example (node scripts/new-project.mjs <dir> --example, then schedule.mjs <dir> --example) is the reference film: a real session between Claude and the skill's author, who makes videos. It shows the format, not the shape of your film. schedule.mjs refuses it without --example, so it can't stand in for your user's story.

Verify success

  • schedule.mjs exits 0 and prints no warnings. hyperframes check passes. p5.brush logs WebGL uniform warnings, which are harmless.
  • The design-pass frames show every quote legible, and match the beat table.
  • score/build.sh ends with ok: no dead air, and the score's length matches the film's.
  • The render is the length schedule.mjs printed, has an audio track, and its frames at the key moments match the design pass.
  • Failure path to test: a story that opens on a reply, or has a quote over the limit, makes schedule.mjs exit 1 and name the beat.

What the engine owns

The motion is physical and already tuned: glide paths, the fold, the throw, the swing, the bonk and the wingbeats. Change the story, the room, the cast and the score. Leave the choreography in scenes/director.js and scenes/compile.js alone unless you are fixing a bug. The motion rules are in references/motion.md.

© heygen-com, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 38 other files (scripts, references, assets) in skills/session-story of heygen-com/hyperframes-community-skills.

  • SKILL.md
  • assets/engine/LICENSE-ClaudeAnimationBase
  • assets/engine/NOTICE.md
  • assets/engine/index.html
  • assets/engine/kit/clawd.js
  • assets/engine/kit/config.js
  • assets/engine/kit/core.js
  • assets/engine/kit/hf-bridge.js
  • assets/engine/kit/timeline.js
  • assets/engine/scenes/cast-custom.js
  • assets/engine/scenes/compile.js
  • assets/engine/scenes/desk.js
  • assets/engine/scenes/director.js
  • assets/engine/scenes/paper.js
  • assets/engine/scenes/props-custom.js
  • assets/engine/scenes/props.js
  • assets/engine/story.js
  • … and 22 more

Open the folder on GitHubat commit ba7a0bb

Compare with similar skills

Session Story Film next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Session Story Film compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Session Story Film this skillheygen-com/hyperframes-community-skills183—~1.8kAutomated safety check: PassApache-2.0
KinocutKyaniteLabs/kinocut197—~5.7kAutomated safety check: PassApache-2.0
Render Myth Vs Factgooseworks-ai/goose-skills1.2k—~2.2kAutomated safety check: PassMIT
Manim Video Productionbrowser-use/video-use28k6 repos~3kAutomated safety check: PassMIT
Embedded Video Captionsheygen-com/hyperframes59k3 repos~8.6kAutomated safety check: PassApache-2.0
HyperFrames Video Entry Pointheygen-com/hyperframes59k3 repos~5.2kAutomated safety check: PassApache-2.0

Similar skills

  • Kinocut

    KyaniteLabs/kinocut

    Use Kinocut for guarded video editing, source-backed planning, FFmpeg operations, media analysis, subtitles, audio workflows, Hyperframes or Revideo rendering, repurposing packages, and release…

    197 GitHub stars~5.7k tokensUpdated today
    Media & CreativeAuto-check passed

  • Render Myth Vs Fact

    gooseworks-ai/goose-skills

    Assemble a myth-vs-fact kinetic-typography explainer video ad (≈29.5s, 9:16) from N myth/fact pairs + hook / turn / punch copy + palette + a brand end-card PNG + a VO track — a hook, 3 red-strike…

    1.2k GitHub stars~2.2k tokensUpdated today
    Media & CreativeAuto-check passed

  • Manim Video Production

    browser-use/video-use

    Produces math and technical explainer videos with Manim Community Edition: concept animations, equation derivations, algorithm walkthroughs and data stories.

    28k GitHub starsUsed in 6 repos~3k tokens
    Media & CreativeAuto-check passed

  • Embedded Video Captions

    heygen-com/hyperframes

    Adds captions to a single-subject talking-head video without editing the footage, from plain subtitles to cinematic text placed behind the speaker.

    59k GitHub starsUsed in 3 repos~8.6k tokens
    Media & CreativeAuto-check passed

  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    59k GitHub starsUsed in 3 repos~5.2k tokens
    Media & CreativeAuto-check passed

  • Black White Text Opener

    Pluviobyte/video-production-skills

    Create reusable black-background white-text opening animations for new videos.

    667 GitHub stars~1k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed

More from heygen-com/hyperframes-community-skills

All 8 skills in this repo

  • Day in My Life Agent Film

    heygen-com/hyperframes-community-skills

    Turns your local Claude Code session history into a 60 to 75 second hand-drawn ink film about a day with your agent, with a string score and your approval of every line.

    183 GitHub stars~1.7k tokensUpdated 10 days ago
    Auto-check passed

  • Duo Foldable Phone Comparison

    heygen-com/hyperframes-community-skills

    Builds side-by-side comparison and meme videos on a fixed photo of hands holding an open foldable phone, with your own HTML playing in each screen.

    183 GitHub stars~2k tokensUpdated 10 days ago
    Auto-check passed

  • p5 Paint Animation

    heygen-com/hyperframes-community-skills

    Turns a text prompt, photo or short video into hand-made looking p5.js animation: self-writing handwriting, brushstroke repaints and living paintings rendered offline.

    183 GitHub stars~1.8k tokensUpdated 10 days ago
    Auto-check passed

  • X Posting License Video

    heygen-com/hyperframes-community-skills

    Builds a short animated posting-license card video from an X profile's name, handle, counters and avatar, using a fixed template that the agent only fills in and renders.

    183 GitHub stars~1.2k tokensUpdated 10 days ago
    Auto-check passed

  • 3D Camera Captions for HyperFrames

    heygen-com/hyperframes-community-skills

    Builds captions that move in 3D space around a talking head: a virtual camera flies past words at different depths, hero words hide behind the speaker, and text steps at 15 fps with motion blur.

    183 GitHub stars~2.3k tokensUpdated 10 days ago
    Auto-check passed

  • Strudel Live-Coding Video Producer

    heygen-com/hyperframes-community-skills

    Turns a Strudel live-coding music track into a 1080x1080 HyperFrames video where the code itself is the picture and each line highlights on the note it plays.

    183 GitHub stars~1.3k tokensUpdated 10 days ago
    Auto-check passed

Works with

Categories

Questions about Session Story Film

What does Session Story Film do?

Turns one typical session between you and your agent into a short animated film built from your real messages, with a composed score, after you approve every line. The agent reads its own history with you, such as local Claude Code or Codex transcripts or messages you paste, and finds your routine. It then builds a film of 40 to 70 seconds in which your verbatim words arrive as objects, the agent's replies go back, the room is decorated from what the agent knows about you, and the agent composes a score matched to the timeline.

When should I use Session Story Film?

Session Story Film fits situations like: making an animated film about what working with your agent is like; turning a real session transcript into a short story with a score; reviewing and approving every quoted line before rendering.

How do I install Session Story Film in Claude Code?

Run `npx skills add heygen-com/hyperframes-community-skills --skill session-story -a claude-code`. Or copy the skill folder (skills/session-story in heygen-com/hyperframes-community-skills) into .claude/skills/session-story in your project. Claude Code loads it when a task matches its description.

How do I install Session Story Film in Codex?

Run `npx skills add heygen-com/hyperframes-community-skills --skill session-story -a codex`. Or copy the skill folder (skills/session-story in heygen-com/hyperframes-community-skills) into .agents/skills/session-story in your project. Codex loads it when a task matches its description.

Can I use Session Story Film in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add heygen-com/hyperframes-community-skills --skill session-story -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/session-story, .gemini/skills/session-story, .github/skills/session-story and .opencode/skills/session-story in your project.

What does Session Story Film need to run?

Going by SKILL.md and its folder, Session Story Film needs JavaScript for the scripts in its folder, the command-line tools its instructions call (npx, sh, node, npm, python3 and ffmpeg) and credentials named GEMINI_API_KEY. Our summary lists: Node 22 or later and Python 3.9 or later; ffmpeg on PATH; The HyperFrames CLI, downloaded from npm on first use; swift on macOS, or fluidsynth with a General MIDI soundfont, for the score.

Does Session Story Film access the network?

SKILL.md contains no URLs. Its commands use npx and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Session Story Film safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Session Story Film use?

Session Story Film is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Session Story Film use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 6.9k tokens, read only when the agent opens those files.

What are the alternatives to Session Story Film?

Skills that share tags, products or a category with Session Story Film: Kinocut (KyaniteLabs/kinocut, 197 stars), Render Myth Vs Fact (gooseworks-ai/goose-skills, 1.2k stars), Manim Video Production (browser-use/video-use, 28k stars) and Embedded Video Captions (heygen-com/hyperframes, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Story Film?

heygen-com (a GitHub organization) maintains it in heygen-com/hyperframes-community-skills, which has 183 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on September 29, 2026.

Source: heygen-com/hyperframes-community-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.