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/render.mjs

View on GitHub
import path from "node:path";
import { fileURLToPath, pathToFileURL } from "node:url";

export const TEMPLATE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../assets/templates");

async function template(name) {
  return import(pathToFileURL(path.join(TEMPLATE_ROOT, name)).href);
}

const LAB_FILES = [
  ["main.tsx", "main.tsx.mjs"],
  ["providers.tsx", "providers.tsx.mjs"],
  ["lab.css", "lab.css.mjs"],
  ["build-info.ts", "build-info.ts.mjs"],
  ["define-lab.ts", "define-lab.ts.mjs"],
  ["registry.ts", "registry.ts.mjs"],
  ["kit.ts", "kit.ts.mjs"],
  ["lab-state.ts", "lab-state.ts.mjs"],
  ["api-stub.ts", "api-stub.ts.mjs"],
  ["api-routes.ts", "api-routes.ts.mjs"],
  ["fixtures.ts", "fixtures.ts.mjs"],
  ["shot.cjs", "shot.cjs.mjs"],
  ["frames/Slot.tsx", "frames/Slot.tsx.mjs"],
  ["frames/LabToolbar.tsx", "frames/LabToolbar.tsx.mjs"],
  ["frames/Board.tsx", "frames/Board.tsx.mjs"],
  ["frames/AppShell.tsx", "frames/AppShell.tsx.mjs"],
  ["frames/SurfaceView.tsx", "frames/SurfaceView.tsx.mjs"],
  ["directions/today/index.tsx", "today/index.tsx.mjs"],
  ["directions/today/adapters.ts", "today/adapters.ts.mjs"],
  ["registry.test.ts", "tests/registry.test.ts.mjs"],
  ["lab-state.test.ts", "tests/lab-state.test.ts.mjs"],
  ["motion-contract.test.ts", "tests/motion-contract.test.ts.mjs"],
  ["today.test.tsx", "tests/today.test.tsx.mjs"],
  ["api-stub.test.ts", "tests/api-stub.test.ts.mjs"],
];

export async function renderDirection(ctx, direction) {
  const files = new Map();
  const dir = `${ctx.labDir}/directions/${direction.id}`;
  const index = await template("direction/index.tsx.mjs");
  const tokens = await template("direction/tokens.css.mjs");
  const specimen = await template("direction/MotionSpecimen.tsx.mjs");
  const body = await template("direction/SlotBody.tsx.mjs");
  files.set(`${dir}/index.tsx`, index.default(ctx, direction));
  files.set(`${dir}/tokens.css`, tokens.default(ctx, direction));
  files.set(`${dir}/MotionSpecimen.tsx`, specimen.default(ctx, direction));
  for (const surface of ctx.surfaces) files.set(`${dir}/${surface.body}.tsx`, body.default(ctx, direction, surface));
  return files;
}

export async function renderLab(ctx) {
  const files = new Map();
  const entry = await template("entry.html.mjs");
  const config = await template("vite.config.mjs.mjs");
  const story = await template("stories/compare.stories.tsx.mjs");
  const buildInfo = await template("build-info.ts.mjs");
  files.set(`ui/${ctx.entry}`, entry.default(ctx));
  files.set(`ui/${ctx.configFile}`, config.default(ctx));
  files.set(ctx.storyFile, story.default(ctx));
  files.set(`${ctx.labDir}/lab-env.d.ts`, buildInfo.envDts(ctx));
  for (const [target, name] of LAB_FILES) {
    const module = await template(name);
    files.set(`${ctx.labDir}/${target}`, module.default(ctx));
  }
  const frame = await template("frames/SurfaceFrame.tsx.mjs");
  const todayBody = await template("today/SlotBody.tsx.mjs");
  for (const surface of ctx.surfaces) {
    files.set(`${ctx.labDir}/frames/${surface.frame}.tsx`, frame.default(ctx, surface));
    files.set(`${ctx.labDir}/directions/today/${surface.body}.tsx`, todayBody.default(ctx, surface));
  }
  for (const direction of ctx.directions) for (const [target, content] of await renderDirection(ctx, direction)) files.set(target, content);
  return files;
}

export async function launchEntries(ctx) {
  const module = await template("launch-entries.json.mjs");
  return { entries: module.default(ctx), names: module.launchNames(ctx) };
}

export async function motionBlockFor(direction) {
  const module = await template("direction/tokens.css.mjs");
  return module.motionBlock(direction);
}
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