Skip to content

paperclipai/paperclip / .agents/skills/directions-lab

directions-lab

Verified

Scaffold a directions lab that shows shipped UI (Today) beside 2-3 design directions, with surface tabs, theme and animation toggles and the V1 MVP hover motion, registered in design-proposals Storybook. Use for a directions page or lab, or to explore design directions next to production.

FileKindSize
SKILL.mdskill md15.4 KB
agents/openai.yamlconfig291 B
assets/PRECEDENTother187 B
assets/motion/v1-mvp-motion.cssother787 B
assets/templates/api-routes.ts.mjsscript531 B
assets/templates/api-stub.ts.mjsscript1.9 KB
assets/templates/build-info.ts.mjsscript220 B
assets/templates/define-lab.ts.mjsscript3.9 KB
assets/templates/direction/MotionSpecimen.tsx.mjsscript2.3 KB
assets/templates/direction/SlotBody.tsx.mjsscript521 B
assets/templates/direction/index.tsx.mjsscript445 B
assets/templates/direction/tokens.css.mjsscript1.1 KB
assets/templates/entry.html.mjsscript752 B
assets/templates/fixtures.ts.mjsscript1.2 KB
assets/templates/frames/AppShell.tsx.mjsscript5.2 KB
assets/templates/frames/Board.tsx.mjsscript4.8 KB
assets/templates/frames/LabToolbar.tsx.mjsscript4.4 KB
assets/templates/frames/Slot.tsx.mjsscript329 B
assets/templates/frames/SurfaceFrame.tsx.mjsscript1.3 KB
assets/templates/frames/SurfaceView.tsx.mjsscript540 B
assets/templates/kit.ts.mjsscript1.9 KB
assets/templates/lab-state.ts.mjsscript1.8 KB
assets/templates/lab.css.mjsscript74 B
assets/templates/launch-entries.json.mjsscript680 B
assets/templates/main.tsx.mjsscript6.2 KB
assets/templates/providers.tsx.mjsscript920 B
assets/templates/registry.ts.mjsscript1.6 KB
assets/templates/shot.cjs.mjsscript10.0 KB
assets/templates/stories/compare.stories.tsx.mjsscript3.4 KB
assets/templates/tests/api-stub.test.ts.mjsscript1.6 KB
assets/templates/tests/lab-state.test.ts.mjsscript3.1 KB
assets/templates/tests/motion-contract.test.ts.mjsscript5.7 KB
assets/templates/tests/registry.test.ts.mjsscript2.5 KB
assets/templates/tests/today.test.tsx.mjsscript2.0 KB
assets/templates/today/SlotBody.tsx.mjsscript972 B
assets/templates/today/adapters.ts.mjsscript748 B
assets/templates/today/index.tsx.mjsscript387 B
assets/templates/vite.config.mjs.mjsscript2.9 KB
evals/asks-how-many-directions/case.yamlconfig343 B
evals/asks-how-many-directions/graders/01-expected-output.mdmarkdown347 B
evals/asks-how-many-directions/prompt.mdmarkdown197 B
evals/multi-surface-three-directions/case.yamlconfig674 B
evals/multi-surface-three-directions/graders/01-expected-output.mdmarkdown672 B
evals/multi-surface-three-directions/prompt.mdmarkdown510 B
evals/single-surface-two-directions/case.yamlconfig398 B
evals/single-surface-two-directions/graders/01-expected-output.mdmarkdown397 B
evals/single-surface-two-directions/prompt.mdmarkdown284 B
references/canonical-directory.mdmarkdown15.5 KB
references/design-proposals-storybook.mdmarkdown29.2 KB
references/drawing-phases.mdmarkdown21.7 KB
references/generator.mdmarkdown25.7 KB
references/lab-anatomy.mdmarkdown28.7 KB
references/lifecycle.mdmarkdown18.9 KB
references/motion-spec.mdmarkdown21.1 KB
references/questions-and-defaults.mdmarkdown15.6 KB
references/repo-gates.mdmarkdown20.8 KB
references/today-fixtures-and-build.mdmarkdown34.9 KB
scripts/lib/args.mjsscript2.4 KB
scripts/lib/capabilities.mjsscript2.1 KB
scripts/lib/check.mjsscript10.6 KB
scripts/lib/context.mjsscript8.6 KB
scripts/lib/modes.mjsscript1001 B
scripts/lib/ports.mjsscript1.9 KB
scripts/lib/registry-edit.mjsscript5.2 KB
scripts/lib/render.mjsscript3.6 KB
scripts/lib/shared-files.mjsscript2.9 KB
scripts/lib/verify.mjsscript1.8 KB
scripts/lib/write.mjsscript2.3 KB
scripts/scaffold.mjsscript14.3 KB
scripts/scaffold.test.mjsscript33.7 KB

scripts/lib/registry-edit.mjs

View on GitHub
import { existsSync, readdirSync, readFileSync } from "node:fs";
import path from "node:path";

export class RegistryShapeError extends Error {}

const DIRECTION_LINE = /^ {4}\{ id: "([^"]+)", key: "(\d)", name: "([^"]+)", tagline: "((?:[^"\\]|\\.)*)"(, baseline: true)?, stage: "([a-z]+)" \},$/;
const SURFACE_LINE = /^ {4}\{ id: "([^"]+)", label: "((?:[^"\\]|\\.)*)", width: (\d+), nav: "([a-z]+)" \},$/;

function field(text, name, pattern, file) {
  const match = new RegExp(`^  ${name}: ${pattern},$`, "m").exec(text);
  if (!match) throw new RegistryShapeError(`${file}: cannot find the generator-owned line "  ${name}: ..."; the registry was hand-edited past what the generator recognises`);
  return match[1];
}

function block(text, name, file) {
  const start = text.indexOf(`  ${name}: [\n`);
  if (start === -1) throw new RegistryShapeError(`${file}: cannot find the generator-owned "  ${name}: [" array`);
  const end = text.indexOf("\n  ],\n", start);
  if (end === -1) throw new RegistryShapeError(`${file}: the "${name}" array has no "  ]," close on its own line`);
  const inner = text.slice(start + `  ${name}: [\n`.length, end);
  return { start, end: end + "\n  ],\n".length, lines: inner.split("\n") };
}

export function readRegistry(text, file = "registry.ts") {
  const slug = field(text, "slug", '"([^"]+)"', file);
  const title = field(text, "title", '"((?:[^"\\\\]|\\\\.)*)"', file);
  const storyId = field(text, "storyId", '"([^"]+)"', file);
  const group = field(text, "group", '"([^"]+)"', file);
  const landingRaw = field(text, "landing", '\\{ direction: "([^"]+)", view: "[^"]+" \\}', file);
  const landingView = /^  landing: \{ direction: "[^"]+", view: "([^"]+)" \},$/m.exec(text)[1];
  const directions = block(text, "directions", file).lines.map((line) => {
    const match = DIRECTION_LINE.exec(line);
    if (!match) throw new RegistryShapeError(`${file}: direction line not in generator form:\n${line}`);
    const [, id, key, name, tagline, baseline, stage] = match;
    return { id, key, name, tagline, baseline: Boolean(baseline), stage };
  });
  const surfaces = block(text, "surfaces", file).lines.map((line) => {
    const match = SURFACE_LINE.exec(line);
    if (!match) throw new RegistryShapeError(`${file}: surface line not in generator form:\n${line}`);
    const [, id, label, width, nav] = match;
    return { id, label, width: Number(width), nav };
  });
  const allowMatch = /^  allow: \[(.*)\],$/m.exec(text);
  const allow = allowMatch ? allowMatch[1].split(",").map((item) => item.trim().replace(/^"|"$/g, "")).filter(Boolean) : [];
  return { slug, title, storyId, group, landing: { direction: landingRaw, view: landingView }, directions, surfaces, allow, allowMore: /^  allowMore: true,$/m.test(text) };
}

export function directionLine(direction) {
  return `    { id: "${direction.id}", key: "${direction.key}", name: "${direction.name}", tagline: "${direction.tagline}", stage: "${direction.stage}" },`;
}

export function insertDirection(text, direction, { file = "registry.ts", allowMore = false } = {}) {
  const { lines, start, end } = block(text, "directions", file);
  const todayIndex = lines.findIndex((line) => DIRECTION_LINE.exec(line)?.[5]);
  if (todayIndex === -1) {
    throw new RegistryShapeError(`${file}: no baseline line in the directions array. Add this line by hand before the today entry:\n${directionLine(direction)}`);
  }
  const next = [...lines.slice(0, todayIndex), directionLine(direction), ...lines.slice(todayIndex)];
  let result = `${text.slice(0, start)}  directions: [\n${next.join("\n")}\n  ],\n${text.slice(end)}`;
  if (allowMore && !/^  allowMore: true,$/m.test(result)) {
    const allowLine = /^  allow: \[.*\],$/m.exec(result);
    if (!allowLine) throw new RegistryShapeError(`${file}: cannot find "  allow: [...]," to place allowMore before`);
    result = `${result.slice(0, allowLine.index)}  allowMore: true,\n${result.slice(allowLine.index)}`;
  }
  return result;
}

export const STORY_ANCHOR = "export const TodayProductionPalette: Story = {";

export const directionStoryLine = (direction) => `export const D${direction.key}: Story = { name: ${JSON.stringify(direction.name)}, args: { direction: ${JSON.stringify(direction.id)} } };`;

export function insertDirectionStory(text, direction, file = "stories.tsx") {
  const line = directionStoryLine(direction);
  if (text.includes(`export const D${direction.key}: Story`)) throw new RegistryShapeError(`${file}: export D${direction.key} already exists`);
  const anchor = text.indexOf(STORY_ANCHOR);
  if (anchor === -1) throw new RegistryShapeError(`${file}: cannot find "${STORY_ANCHOR}" to insert before. Add this line by hand after the last D<N> export:\n${line}`);
  return `${text.slice(0, anchor)}${line}\n${text.slice(anchor)}`;
}

export function findLabs(root) {
  const dir = path.join(root, "ui/src");
  if (!existsSync(dir)) return [];
  return readdirSync(dir, { withFileTypes: true })
    .filter((entry) => entry.isDirectory() && entry.name.endsWith("-directions") && existsSync(path.join(dir, entry.name, "registry.ts")))
    .map((entry) => {
      const file = path.join(dir, entry.name, "registry.ts");
      return { dir: `ui/src/${entry.name}`, file, registry: readRegistry(readFileSync(file, "utf8"), `ui/src/${entry.name}/registry.ts`) };
    });
}
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall