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

assets/templates/main.tsx.mjs

View on GitHub
export default (ctx) => `import { Component, StrictMode, useCallback, useEffect, useLayoutEffect, useRef, useState, type ReactNode } from "react";
import { createRoot } from "react-dom/client";
import { AvatarInitialProvider } from "@/components/ui/avatar-initials";
import { useTheme } from "@/context/ThemeContext";
import "../index.css";
import "./lab.css";
import { installApiStub } from "./api-stub";
import "./api-routes";
import { LAB_BUILD } from "./build-info";
import { DIRECTION_IDS, KIT_KEYS, KIT_META, SURFACE_IDS, loadKit, type DirectionId, type DirectionKit } from "./kit";
import { kitIdOf, labSearch, readLabState, type LabState, type LabTheme } from "./lab-state";
import { createLabQueryClient, LabProviders } from "./providers";
import { registry } from "./registry";
import { Board } from "./frames/Board";
import { LabToolbar } from "./frames/LabToolbar";
import { SurfaceView } from "./frames/SurfaceView";

installApiStub();

const initial = readLabState(window.location.search);

function applyTheme(theme: LabTheme) {
  document.documentElement.classList.toggle("dark", theme === "dark");
  document.documentElement.style.colorScheme = theme;
}
applyTheme(initial.theme);

function applyAnim(anim: boolean) {
  if (anim) document.documentElement.dataset.labAnim = "1";
  else delete document.documentElement.dataset.labAnim;
}
applyAnim(initial.anim);

(window as unknown as { __LAB__: unknown }).__LAB__ = {
  slug: registry.slug,
  directions: DIRECTION_IDS,
  surfaces: SURFACE_IDS,
  keys: KIT_KEYS,
  names: Object.fromEntries(DIRECTION_IDS.map((id) => [id, KIT_META[id].name])),
  labels: Object.fromEntries(registry.surfaces.map((surface) => [surface.id, surface.label])),
  storyId: registry.storyId,
  build: LAB_BUILD,
};

function ThemeSync({ theme }: { theme: LabTheme }) {
  const { theme: current, setTheme } = useTheme();
  useEffect(() => {
    if (current !== theme) setTheme(theme);
  }, [current, setTheme, theme]);
  return null;
}

function isTyping(target: EventTarget | null): boolean {
  return target instanceof HTMLElement && (target.isContentEditable || /^(INPUT|TEXTAREA|SELECT)$/.test(target.tagName));
}

function KitProblem({ id, error }: { id: DirectionId; error: unknown }) {
  return (
    <div role="alert" data-kit-error={id} className="m-6 rounded-md bg-destructive/10 p-4 font-mono text-xs text-destructive">
      {KIT_META[id].name} failed: {error instanceof Error ? error.message : String(error)}
    </div>
  );
}

class KitBoundary extends Component<{ id: DirectionId; children: ReactNode }, { error: unknown }> {
  state: { error: unknown } = { error: null };
  static getDerivedStateFromError(error: unknown) {
    return { error };
  }
  render() {
    return this.state.error ? <KitProblem id={this.props.id} error={this.state.error} /> : this.props.children;
  }
}

type KitState = { id: DirectionId; kit?: DirectionKit; error?: unknown };

function useKit(id: DirectionId): KitState {
  const [state, setState] = useState<KitState>({ id });
  useEffect(() => {
    let live = true;
    loadKit(id).then(
      (kit) => live && setState({ id, kit }),
      (error: unknown) => {
        console.error(error);
        if (live) setState({ id, error });
      },
    );
    return () => {
      live = false;
    };
  }, [id]);
  return state.id === id || !state.kit ? state : { id: state.id, kit: state.kit };
}

function useScrollKeeper(deps: unknown[]) {
  const pending = useRef<number | null>(null);
  const keep = useCallback(() => {
    pending.current = window.scrollY;
  }, []);
  useLayoutEffect(() => {
    const top = pending.current;
    if (top === null) return;
    const restore = () => window.scrollTo({ top, left: window.scrollX, behavior: "instant" });
    restore();
    const frame = window.requestAnimationFrame(restore);
    const late = window.setTimeout(() => {
      restore();
      if (pending.current === top) pending.current = null;
    }, 200);
    return () => {
      window.cancelAnimationFrame(frame);
      window.clearTimeout(late);
    };
  }, deps);
  return keep;
}

function Lab() {
  const [state, setState] = useState<LabState>(initial);
  const kitId = kitIdOf(state);
  const { id: shownKitId, kit, error } = useKit(kitId);
  const keepScroll = useScrollKeeper([state, shownKitId]);

  const change = useCallback(
    (patch: Partial<LabState>) => {
      keepScroll();
      setState((current) => {
        const next = { ...current, ...patch };
        window.history.replaceState(null, "", labSearch(next));
        return next;
      });
    },
    [keepScroll],
  );

  useEffect(() => applyTheme(state.theme), [state.theme]);
  useEffect(() => applyAnim(state.anim), [state.anim]);

  useEffect(() => {
    const onKey = (event: KeyboardEvent) => {
      if (event.metaKey || event.ctrlKey || event.altKey || isTyping(event.target)) return;
      if (event.key === "t") change({ theme: state.theme === "dark" ? "light" : "dark" });
      if (event.key === "a") change({ anim: !state.anim });
      const direction = DIRECTION_IDS.find((id) => KIT_KEYS[id] === event.key);
      if (direction) change({ direction });
    };
    window.addEventListener("keydown", onKey);
    return () => window.removeEventListener("keydown", onKey);
  }, [change, state.theme, state.anim]);

  const surface = state.view === "board" ? null : state.view;
  const page = (
    <>
      <ThemeSync theme={state.theme} />
      {state.chrome ? <LabToolbar state={state} onChange={change} /> : null}
      {surface === null || state.direction === "all" ? (
        <Board direction={state.direction} view={state.view} theme={state.theme} anim={state.anim} proposal={state.proposal} />
      ) : error ? (
        <KitProblem id={kitId} error={error} />
      ) : kit ? (
        <KitBoundary key={shownKitId} id={shownKitId}>
          <SurfaceView kit={kit} surface={surface} />
        </KitBoundary>
      ) : null}
    </>
  );
  return state.proposal ? (
    <AvatarInitialProvider>
      <div className="design-proposal-theme">{page}</div>
    </AvatarInitialProvider>
  ) : (
    page
  );
}

const queryClient = createLabQueryClient();

createRoot(document.getElementById("root")!).render(
  <StrictMode>
    <LabProviders client={queryClient}>
      <Lab />
    </LabProviders>
  </StrictMode>,
);
`;
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: 323kUpdated 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