Skip to content

Makkov-design/makkov-harness / skills/hyperframes

hyperframes

Verified

Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.

FileKindSize
LICENSEother10.5 KB
SKILL.mdskill md7.5 KB
assets/frame-presets/biennale-yellow/FRAME.mdmarkdown17.4 KB
assets/frame-presets/biennale-yellow/caption-skin.htmlother7.9 KB
assets/frame-presets/biennale-yellow/frame-showcase.htmlother34.1 KB
assets/frame-presets/blockframe/FRAME.mdmarkdown15.9 KB
assets/frame-presets/blockframe/caption-skin.htmlother8.1 KB
assets/frame-presets/blockframe/frame-showcase.htmlother37.9 KB
assets/frame-presets/blue-professional/FRAME.mdmarkdown16.8 KB
assets/frame-presets/blue-professional/caption-skin.htmlother8.1 KB
assets/frame-presets/blue-professional/frame-showcase.htmlother38.2 KB
assets/frame-presets/bold-poster/FRAME.mdmarkdown15.6 KB
assets/frame-presets/bold-poster/caption-skin.htmlother8.5 KB
assets/frame-presets/bold-poster/frame-showcase.htmlother31.6 KB
assets/frame-presets/broadside/FRAME.mdmarkdown15.9 KB
assets/frame-presets/broadside/caption-skin.htmlother8.2 KB
assets/frame-presets/broadside/frame-showcase.htmlother33.1 KB
assets/frame-presets/capsule/FRAME.mdmarkdown16.8 KB
assets/frame-presets/capsule/caption-skin.htmlother8.2 KB
assets/frame-presets/capsule/frame-showcase.htmlother42.0 KB
assets/frame-presets/cartesian/FRAME.mdmarkdown16.9 KB
assets/frame-presets/cartesian/caption-skin.htmlother8.1 KB
assets/frame-presets/cartesian/frame-showcase.htmlother34.5 KB
assets/frame-presets/cobalt-grid/FRAME.mdmarkdown16.9 KB
assets/frame-presets/cobalt-grid/caption-skin.htmlother8.6 KB
assets/frame-presets/cobalt-grid/frame-showcase.htmlother45.9 KB
assets/frame-presets/code-editorial/FRAME.mdmarkdown20.1 KB
assets/frame-presets/code-editorial/caption-skin.htmlother8.1 KB
assets/frame-presets/code-editorial/fonts/EBGaramond-400.woff2binary21.2 KB
assets/frame-presets/code-editorial/fonts/EBGaramond-700.woff2binary22.5 KB
assets/frame-presets/code-editorial/fonts/Inter-400.woff2binary23.1 KB
assets/frame-presets/code-editorial/fonts/Inter-700.woff2binary23.8 KB
assets/frame-presets/code-editorial/fonts/JetBrainsMono-400.woff2binary20.7 KB
assets/frame-presets/code-editorial/fonts/JetBrainsMono-700.woff2binary21.4 KB
assets/frame-presets/code-editorial/fonts/OFL-eb-garamond.txtmarkdown4.4 KB
assets/frame-presets/code-editorial/fonts/OFL-inter.txtmarkdown4.4 KB
assets/frame-presets/code-editorial/fonts/OFL-jetbrains-mono.txtmarkdown4.4 KB
assets/frame-presets/code-editorial/frame-showcase.htmlother42.7 KB
assets/frame-presets/coral/FRAME.mdmarkdown18.5 KB
assets/frame-presets/coral/caption-skin.htmlother8.1 KB
assets/frame-presets/coral/frame-showcase.htmlother35.6 KB
assets/frame-presets/creative-mode/FRAME.mdmarkdown19.1 KB
assets/frame-presets/creative-mode/caption-skin.htmlother8.2 KB
assets/frame-presets/creative-mode/frame-showcase.htmlother37.8 KB
assets/frame-presets/daisy-days/FRAME.mdmarkdown17.0 KB
assets/frame-presets/daisy-days/caption-skin.htmlother8.3 KB
assets/frame-presets/daisy-days/frame-showcase.htmlother41.3 KB
assets/frame-presets/editorial-forest/FRAME.mdmarkdown16.6 KB
assets/frame-presets/editorial-forest/caption-skin.htmlother8.2 KB
assets/frame-presets/editorial-forest/frame-showcase.htmlother36.0 KB
references/captions.mdmarkdown4.9 KB
references/film.mdmarkdown7.1 KB
references/format.mdmarkdown12.7 KB
references/look.mdmarkdown5.9 KB
references/motion.mdmarkdown11.9 KB
references/overlays.mdmarkdown2.5 KB
references/plugin-installation.mdmarkdown3.0 KB
references/review.mdmarkdown5.2 KB
references/runtimes.mdmarkdown3.9 KB
references/skill-lifecycle.mdmarkdown3.7 KB
references/sound.mdmarkdown4.4 KB
references/spec.mdmarkdown5.9 KB
references/story.mdmarkdown11.2 KB
references/storyboard-format.mdmarkdown6.5 KB
references/storyboard.mdmarkdown4.0 KB
references/types/3d.mdmarkdown1.6 KB
references/types/character.mdmarkdown1.6 KB
references/types/data.mdmarkdown1.3 KB
references/types/explainer.mdmarkdown3.0 KB
references/types/launch.mdmarkdown4.6 KB
references/types/music.mdmarkdown1.6 KB
references/types/vertical.mdmarkdown1.6 KB
scripts/bake-basemap.mjsscript17.7 KB
scripts/cli-version.jsonconfig46 B
scripts/lib/main-module.mjsscript479 B
scripts/lib/main-module.test.mjsscript2.2 KB
scripts/locate.mjsscript8.0 KB
scripts/plugin-cli.mjsscript3.7 KB
scripts/plugin-cli.test.mjsscript6.2 KB

scripts/plugin-cli.test.mjs

View on GitHub
// Changed by makkov-harness (see NOTICE at the repository root); the original is HeyGen's, Apache-2.0.
import assert from "node:assert/strict";
import { spawnSync } from "node:child_process";
import {
  copyFileSync,
  mkdirSync,
  mkdtempSync,
  readFileSync,
  realpathSync,
  rmSync,
  writeFileSync,
} from "node:fs";
import { join } from "node:path";
import { tmpdir } from "node:os";
import { test } from "node:test";
import { invocation, pluginVersion } from "./plugin-cli.mjs";

function fixture(t, manifest = "plugin.json", version = "1.2.3") {
  const root = mkdtempSync(join(tmpdir(), "hf-plugin-"));
  t.after(() => rmSync(root, { recursive: true, force: true }));
  mkdirSync(join(root, "skills/hyperframes/scripts/lib"), { recursive: true });
  mkdirSync(join(root, manifest, ".."), { recursive: true });
  writeFileSync(join(root, manifest), JSON.stringify({ name: "hyperframes", version }));
  const launcher = join(root, "skills/hyperframes/scripts/plugin-cli.mjs");
  copyFileSync(new URL("./plugin-cli.mjs", import.meta.url), launcher);
  copyFileSync(
    new URL("./lib/main-module.mjs", import.meta.url),
    join(root, "skills/hyperframes/scripts/lib/main-module.mjs"),
  );
  return { root, launcher };
}

for (const manifest of [
  "plugin.json",
  ".claude-plugin/plugin.json",
  ".codex-plugin/plugin.json",
  ".cursor-plugin/plugin.json",
  "gemini-extension.json",
]) {
  test(`locates ${manifest} without repository packages`, (t) => {
    const { root } = fixture(t, manifest);
    assert.equal(pluginVersion(root), "1.2.3");
  });
}

test("rejects missing and floating plugin versions", (t) => {
  const { root } = fixture(t, "plugin.json", "latest");
  assert.throws(() => pluginVersion(root), /Invalid HyperFrames plugin release/);
  rmSync(join(root, "plugin.json"));
  assert.throws(() => pluginVersion(root), /No HyperFrames plugin manifest/);
});

test("pins CLI, suppresses standalone refresh, preserves unrelated environment", () => {
  const result = invocation(["init", "project with spaces", "--non-interactive"], {
    version: "1.2.3",
    platform: "darwin",
    env: { PATH: "/bin", HYPERFRAMES_SKIP_SKILLS: "0" },
  });
  assert.equal(result.command, "npx");
  assert.deepEqual(result.args, [
    "--yes",
    "hyperframes@1.2.3",
    "init",
    "project with spaces",
    "--non-interactive",
  ]);
  assert.deepEqual(result.env, {
    PATH: "/bin",
    HYPERFRAMES_SKIP_SKILLS: "1",
    HYPERFRAMES_SKILL_PKG_VERSION: "1.2.3",
    HYPERFRAMES_PLUGIN_VERSION: "1.2.3",
    HYPERFRAMES_NO_UPDATE_CHECK: "1",
    HYPERFRAMES_NO_TELEMETRY: "1",
    npm_config_ignore_scripts: "true",
  });
  assert.throws(() => invocation(["skills", "update"], { version: "1.2.3" }), /plugin manager/);
});

test("CLI telemetry is off unless the user opted in or chose it", () => {
  const run = (env) => invocation(["render"], { version: "1.2.3", platform: "darwin", env }).env;
  assert.equal(run({}).HYPERFRAMES_NO_TELEMETRY, "1");
  assert.equal(run({ MEDIA_USE_TELEMETRY: "1" }).HYPERFRAMES_NO_TELEMETRY, undefined);
  assert.equal(run({ HYPERFRAMES_NO_TELEMETRY: "0" }).HYPERFRAMES_NO_TELEMETRY, "0");
});

test("npm runs no install scripts unless the user chose otherwise", () => {
  const run = (env) => invocation(["render"], { version: "1.2.3", platform: "darwin", env }).env;
  assert.equal(run({}).npm_config_ignore_scripts, "true");
  assert.equal(run({ npm_config_ignore_scripts: "false" }).npm_config_ignore_scripts, "false");
});

test("Windows launches npx through Node without shell argument interpretation", () => {
  const result = invocation(["render", "a & b"], {
    version: "1.2.3",
    platform: "win32",
    node: String.raw`C:\Program Files\nodejs\node.exe`,
    env: { npm_execpath: String.raw`C:\Program Files\nodejs\node_modules\npm\bin\npm-cli.js` },
    pathExists: (p) => p === String.raw`C:\Program Files\nodejs\node_modules\npm\bin\npx-cli.js`,
  });
  assert.equal(result.command, String.raw`C:\Program Files\nodejs\node.exe`);
  assert.deepEqual(result.args, [
    String.raw`C:\Program Files\nodejs\node_modules\npm\bin\npx-cli.js`,
    "--yes",
    "hyperframes@1.2.3",
    "render",
    "a & b",
  ]);
  assert.throws(
    () => invocation([], { version: "1.2.3", platform: "win32", env: {}, pathExists: () => false }),
    /Cannot find npx/,
  );
});

test("installed helper keeps cwd, arguments, release environment and exit code", (t) => {
  const { root, launcher } = fixture(t);
  const project = join(root, "user project");
  mkdirSync(project);
  const helper = join(root, "helper.mjs");
  writeFileSync(
    helper,
    "console.log(JSON.stringify({ cwd: process.cwd(), args: process.argv.slice(2), skip: process.env.HYPERFRAMES_SKIP_SKILLS, version: process.env.HYPERFRAMES_SKILL_PKG_VERSION })); process.exit(7);",
  );
  const before = readFileSync(join(root, "plugin.json"), "utf8");
  const result = spawnSync(
    process.execPath,
    [launcher, "--script", helper, "literal $value & spaces"],
    { cwd: project, encoding: "utf8" },
  );
  assert.equal(result.status, 7, result.stderr);
  assert.deepEqual(JSON.parse(result.stdout), {
    cwd: realpathSync(project),
    args: ["literal $value & spaces"],
    skip: "1",
    version: "1.2.3",
  });
  assert.equal(readFileSync(join(root, "plugin.json"), "utf8"), before);
});

test("a bundling plugin pins the CLI with cli-version.json, not its own manifest", (t) => {
  const root = mkdtempSync(join(tmpdir(), "hf-bundled-"));
  t.after(() => rmSync(root, { recursive: true, force: true }));
  mkdirSync(join(root, ".claude-plugin"), { recursive: true });
  mkdirSync(join(root, "skills/hyperframes/scripts"), { recursive: true });
  writeFileSync(
    join(root, ".claude-plugin/plugin.json"),
    JSON.stringify({ name: "makkov-harness", version: "0.3.1" }),
  );
  assert.throws(() => pluginVersion(root), /Invalid HyperFrames plugin release/);
  writeFileSync(
    join(root, "skills/hyperframes/scripts/cli-version.json"),
    JSON.stringify({ name: "hyperframes", version: "0.9.9" }),
  );
  assert.equal(pluginVersion(root), "0.9.9");
});

test("the CLI version this repository pins is an exact release", () => {
  const pinned = JSON.parse(readFileSync(new URL("./cli-version.json", import.meta.url), "utf8"));
  assert.equal(pinned.name, "hyperframes");
  assert.match(pinned.version, /^\d+\.\d+\.\d+$/);
});
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall