Skip to content

JaimeJunr/claude-code-frontend-skills / plugins/hyperframes/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
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.mdmarkdown13.4 KB
references/look.mdmarkdown5.9 KB
references/motion.mdmarkdown12.2 KB
references/overlays.mdmarkdown2.6 KB
references/path-tracing.mdmarkdown5.6 KB
references/plugin-installation.mdmarkdown4.1 KB
references/review.mdmarkdown5.2 KB
references/runtimes.mdmarkdown4.1 KB
references/skill-lifecycle.mdmarkdown4.8 KB
references/sound.mdmarkdown3.6 KB
references/spec.mdmarkdown5.9 KB
references/story.mdmarkdown11.2 KB
references/storyboard-format.mdmarkdown6.5 KB
references/storyboard.mdmarkdown4.4 KB
references/types/3d.mdmarkdown1.8 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.8 KB
scripts/lib/main-module.mjsscript479 B
scripts/lib/main-module.test.mjsscript1.9 KB
scripts/lib/windows-exe-search.mjsscript640 B
scripts/lib/windows-exe-search.test.mjsscript5.6 KB
scripts/locate.mjsscript8.1 KB
scripts/plugin-cli.mjsscript5.5 KB
scripts/plugin-cli.test.mjsscript12.3 KB

scripts/plugin-cli.mjs

View on GitHub
#!/usr/bin/env node
// Every skill starts the CLI through this file, from the user's project. A plugin install pins the
// release in its manifest; a standalone skill install takes the newest release from npm.
import "./lib/windows-exe-search.mjs";
import { spawnSync } from "node:child_process";
import { existsSync, readFileSync, realpathSync } from "node:fs";
import { homedir } from "node:os";
import { basename, isAbsolute, join, relative, resolve, sep, win32 } from "node:path";
import { fileURLToPath } from "node:url";
import { isMainModule } from "./lib/main-module.mjs";

const root = fileURLToPath(new URL("../../../", import.meta.url));
const manifests = [
  "plugin.json",
  ".claude-plugin/plugin.json",
  ".codex-plugin/plugin.json",
  ".cursor-plugin/plugin.json",
  "gemini-extension.json",
];

// The first release whose bin moves into HYPERFRAMES_PLUGIN_CWD. An older one would run the
// command in the home folder.
const CLI_FLOOR = "0.9.34";
export const STANDALONE_CLI = `hyperframes@>=${CLI_FLOOR}`;

const realOrResolved = (path) => {
  try {
    return realpathSync.native(path);
  } catch {
    return resolve(path);
  }
};

const isOutside = (from, to) => {
  const path = relative(from, to);
  return path === ".." || path.startsWith(`..${sep}`) || isAbsolute(path);
};

// Plugin managers keep bundles in their own folders, such as ~/.claude/plugins or ~/.gemini/extensions.
// Skills in a dot folder (.agents, .claude) or in the working folder's own tree are project content.
function isPluginBundle(pluginRoot, workDir) {
  const bundle = realOrResolved(pluginRoot);
  const work = realOrResolved(workDir);
  if (basename(bundle).startsWith(".") || !isOutside(bundle, work)) return false;
  if (isOutside(work, bundle)) return true;
  return relative(work, bundle)
    .split(sep)
    .some((segment) => segment.startsWith("."));
}

function isBelowFloor(version) {
  const parts = (text) => text.split("-")[0].split(".").map(Number);
  const [have, floor] = [parts(version), parts(CLI_FLOOR)];
  const at = have.findIndex((part, index) => part !== floor[index]);
  return at === -1 ? version.includes("-") : have[at] < floor[at];
}

export function pluginVersion(pluginRoot = root, workDir = process.cwd()) {
  if (!isPluginBundle(pluginRoot, workDir)) return undefined;
  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}`);
    }
    if (isBelowFloor(manifest.version))
      throw new Error(
        `${file} pins HyperFrames ${manifest.version}; this launcher runs ${CLI_FLOOR} or newer.`,
      );
    return manifest.version;
  }
  return undefined;
}

// npm takes the package, bin links and .npmrc from the folder it starts in, so npx starts
// in the home folder and the CLI moves into the project before it runs a command. A shared
// folder such as the temp folder is no substitute, so there is no fallback.
export function npmFolder(home = homedir(), pathExists = existsSync) {
  if (home && pathExists(home)) return home;
  throw new Error("Cannot find your home folder. Set HOME (USERPROFILE on Windows) and retry.");
}

export function invocation(
  args,
  {
    cwd = process.cwd(),
    version = pluginVersion(root, cwd),
    env = process.env,
    platform = process.platform,
    node = process.execPath,
    pathExists = existsSync,
    npmCwd,
    launcher = fileURLToPath(import.meta.url),
  } = {},
) {
  if (version && args[0] === "skills")
    throw new Error(
      "Bundled skills are release-managed; the person updates HyperFrames through their agent's plugin manager.",
    );
  const childEnv = version
    ? {
        ...env,
        HYPERFRAMES_SKIP_SKILLS: "1",
        HYPERFRAMES_SKILL_PKG_VERSION: version,
        HYPERFRAMES_PLUGIN_VERSION: version,
        HYPERFRAMES_NO_UPDATE_CHECK: "1",
      }
    : { ...env };
  if (args[0] === "--script") {
    if (!args[1]) throw new Error("--script requires a Node script path.");
    // Helpers that call the CLI run it through this launcher, never a `hyperframes` from the project.
    const env = { ...childEnv, HYPERFRAMES_CLI_ENTRY: launcher };
    return { command: node, args: args.slice(1), env, cwd };
  }
  const cliArgs = ["--yes", version ? `hyperframes@${version}` : STANDALONE_CLI, ...args];
  const cliEnv = { ...childEnv, HYPERFRAMES_PLUGIN_CWD: cwd };
  const npxCwd = npmCwd ?? npmFolder();
  if (platform !== "win32") return { command: "npx", args: cliArgs, env: cliEnv, cwd: npxCwd };
  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: cliEnv, cwd: npxCwd };
}

if (isMainModule(import.meta.url)) {
  try {
    const command = invocation(process.argv.slice(2));
    const result = spawnSync(command.command, command.args, {
      cwd: command.cwd,
      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;
  }
}
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