Makkov-design/makkov-harness / skills/hyperframes
hyperframes
VerifiedRead 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.
scripts/plugin-cli.mjs
View on GitHub#!/usr/bin/env node
// Changed by makkov-harness (see NOTICE at the repository root); the original is HeyGen's, Apache-2.0.
// Run from the user's project; locate the release from this installed file.
import { spawnSync } from "node:child_process";
import { existsSync, readFileSync } from "node:fs";
import { join, win32 } from "node:path";
import { fileURLToPath } from "node:url";
import { isMainModule } from "./lib/main-module.mjs";
const root = fileURLToPath(new URL("../../../", import.meta.url));
// makkov-harness bundles these skills inside its own plugin, so its manifest names the harness
// and its version, not HyperFrames. This file pins the HyperFrames CLI release the harness
// reviewed (see SECURITY.md); it is read before any plugin manifest.
const manifests = [
"skills/hyperframes/scripts/cli-version.json",
"plugin.json",
".claude-plugin/plugin.json",
".codex-plugin/plugin.json",
".cursor-plugin/plugin.json",
"gemini-extension.json",
];
export function pluginVersion(pluginRoot = root) {
for (const path of manifests) {
const file = join(pluginRoot, path);
if (!existsSync(file)) continue;
const manifest = JSON.parse(readFileSync(file, "utf8"));
if (
manifest.name !== "hyperframes" ||
!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(manifest.version ?? "")
) {
throw new Error(`Invalid HyperFrames plugin release: ${file}`);
}
return manifest.version;
}
throw new Error(
"No HyperFrames plugin manifest found. Use the standalone skills installation instructions.",
);
}
export function invocation(
args,
{
version = pluginVersion(),
env = process.env,
platform = process.platform,
node = process.execPath,
pathExists = existsSync,
} = {},
) {
if (args[0] === "skills")
throw new Error(
"Update HyperFrames through your agent's plugin manager; bundled skills are release-managed.",
);
const childEnv = {
...env,
HYPERFRAMES_SKIP_SKILLS: "1",
HYPERFRAMES_SKILL_PKG_VERSION: version,
HYPERFRAMES_PLUGIN_VERSION: version,
HYPERFRAMES_NO_UPDATE_CHECK: "1",
};
// makkov-harness: the CLI's own usage telemetry stays off unless the user opted in with
// MEDIA_USE_TELEMETRY=1 or set HYPERFRAMES_NO_TELEMETRY themselves.
if (env.MEDIA_USE_TELEMETRY !== "1" && env.HYPERFRAMES_NO_TELEMETRY === undefined)
childEnv.HYPERFRAMES_NO_TELEMETRY = "1";
// makkov-harness: npm runs no install scripts of the CLI's packages (the CLI itself needs none).
if (env.npm_config_ignore_scripts === undefined) childEnv.npm_config_ignore_scripts = "true";
if (args[0] === "--script") {
if (!args[1]) throw new Error("--script requires a Node script path.");
return { command: node, args: args.slice(1), env: childEnv };
}
const cliArgs = ["--yes", `hyperframes@${version}`, ...args];
if (platform !== "win32") return { command: "npx", args: cliArgs, env: childEnv };
const candidates = [
env.npm_execpath && win32.join(win32.dirname(env.npm_execpath), "npx-cli.js"),
win32.join(win32.dirname(node), "node_modules", "npm", "bin", "npx-cli.js"),
].filter(Boolean);
const npx = candidates.find(pathExists);
if (!npx)
throw new Error(
"Cannot find npx-cli.js. Install Node.js with npm or run from an npm environment.",
);
return { command: node, args: [npx, ...cliArgs], env: childEnv };
}
if (isMainModule(import.meta.url)) {
try {
const command = invocation(process.argv.slice(2));
const result = spawnSync(command.command, command.args, {
env: command.env,
stdio: "inherit",
windowsHide: true,
});
if (result.error) throw result.error;
process.exitCode = result.status ?? 1;
} catch (error) {
console.error(error.message);
process.exitCode = 1;
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |