Review Paperclip stories for a feature or change using the Storybook catalog, production source, and existing browser tests. Report component, mock, interaction, and visual evidence separately.
Read the catalog contract and find the
requested capability in its generated index. Check the relevant feature recipe,
production subject, and story before driving it. Catalog status is prior review
context, not proof of the current revision. This skill consumes the maps/catalog;
corrections belong to maintain-storybook or maintain-verification-skill.
Choose discriminating states for the requested change: the normal action and result, relevant failure/retry, gate/permission presentation, and mobile/theme variants where affected. Record chosen files/exports and omitted scope. For a full source review, account for every file; do not describe sampling as full render or interaction coverage.
Use the existing Storybook commands:
pnpm build-storybook, or an owned Storybook dev server on an available local
port. Use the built ui/storybook-static/index.json for actual story IDs and
links. Do not trust an unrelated server on the default port. Keep the process
handle and stop only the server this review started, retaining useful evidence.
Inspect the real rendered subject, including errors and browser console output.
For interactive stories, wait for their play assertions to complete and inspect
the observable result. A screenshot alone does not prove play passed. Verify
fixture isolation by revisiting/resetting relevant stories when they mutate
fetch handlers, storage, query caches, time, or module state. Avoid real provider
actions; explicitly document any live dependency required by a story.
The existing visual suite is
tests/storybook-visual/storybook-visual.spec.ts. It uses external baselines and
a pinned Linux environment. Inspect baseline-manifest.json before claiming
visual regression proof. An unpublished manifest blocks comparisons; a macOS
capture is useful inspection, not the Linux baseline. Do not update/publish
baselines just to make a review pass. Use existing focused browser suites where
they cover the requested scenario, and the production verification skill when
the question requires backend persistence, real authorization, or provider proof.
Report each selected case as passed, failed, blocked, or not run, naming revision, story ID, environment, production versus prototype subject, simulated boundaries, action/assertion and observed result. Separate render, interaction, visual comparison, and production acceptance evidence. Report proven drift with exact source references and a proposed correction; do not lower expectations, remove failing cases, or silently bless historical behavior as current.
Copy a source-pinned command for your client. You run it yourself.
Destination: .claude/skills/review-storybook · pinned to the source commit
# Run from your project root
git clone https://github.com/paperclipai/paperclip.git .skillboard-tmp
git -C .skillboard-tmp checkout 4a641d0980fdaffc4c4e805f6f0a8809eb5702f2
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.agents/skills/review-storybook" ".claude/skills/"
rm -rf .skillboard-tmpReview the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.
sudo apt update && sudo apt install -y gitnpm install -g @anthropic-ai/claude-code# Run from your project root
git clone https://github.com/paperclipai/paperclip.git .skillboard-tmp
git -C .skillboard-tmp checkout 4a641d0980fdaffc4c4e805f6f0a8809eb5702f2
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.agents/skills/review-storybook" ".claude/skills/"
rm -rf .skillboard-tmpDestination: .claude/skills/review-storybook
Scanner static-checks@0.1.0 · commit 4a641d0980fd. Static checks cannot prove runtime safety – review the source and the exact diff before installing. How checks work.
References parent-directory traversal, which can escape a target directory.
Evidence: ../· fingerprint fa08499e14d0113b