# Review Storybook Stories

Reviews stories against production source and browser tests, reporting each evidence type.

- Repository: https://github.com/paperclipai/paperclip (109885 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add paperclipai/paperclip --skill review-storybook -g -a claude-code -y`
Codex: `npx skills add paperclipai/paperclip --skill review-storybook -g -a codex -y`
Cursor: `npx skills add paperclipai/paperclip --skill review-storybook -g -a cursor -y`
Gemini CLI: `npx skills add paperclipai/paperclip --skill review-storybook -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Review Storybook

Read the [catalog contract](../../../maps/storybook-map/README.md) 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.

When reviewing navigation/index changes, compare the guide and sidebar with the
full ordered index generated from feature recipes' navigation metadata. Open a feature without examples and a
feature whose related suite lives elsewhere; check capability order, gap messages,
classifications, recipe links, and actual suite navigation. Compare built entry IDs
before/after so existing links survive. Generated Overview pages do not establish
new example coverage.

Use [the existing Storybook commands](../../../doc/DEVELOPING.md#storybook):
`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.

The rest: https://github.com/paperclipai/paperclip/blob/HEAD/.agents/skills/review-storybook/SKILL.md