sb-explore
Iterate on a new or redesigned component in a sandboxed Explore story outside src/components/ (+ Figma), checked against a graduation gate. Use for 'prototype this', 'try a v2', 'explore from Figma', or net-new UI not ready to ship.
How do I install this agent skill?
npx skills add https://github.com/strongeron/storybook-workbench --skill sb-exploreIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a development tool for Storybook, facilitating the scaffolding and graduation of UI components. It uses local bash scripts and standard tools like ast-grep for its operations. No malicious patterns were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
sb-explore — sandboxed iteration (Build mode: Explore)
The component is new or being redesigned. It lives outside src/components/ so production
code can't depend on it. Load references/labs-workflow.md before scaffolding.
If the user pasted a Figma URL, ALSO load references/figma-to-storybook.md. Do NOT
load composition-patterns.md (that's Compare → sb-wrappers).
Naming:
Exploreis the canonical term used throughout this skill (titles, disk paths, tags).references/labs-workflow.mdpredates the rename and saysLabs/src/stories/labs/— read it as the same track (Explore = Labs). Author withExplore; treatLabsonly as a legacy alias you may meet in an existing repo.
Before scaffolding (ask yourself)
- Iterating on a shipping component, or net-new? Determines Path A vs Path B at Ship time.
- Figma URL pasted? If yes — set
parameters.design = { type: 'figma', url }immediately and iterate against the frame (see figma-to-storybook.md). - API stable enough to graduate? See the 4 criteria in labs-workflow.md. If not — stay in Explore.
Scaffold
- Disk path — honor the recorded
storiesLocation(.storybook/audit/status.md): when stories are isolated (the audit/client default), scaffold the experiment under.storybook/explore/<topic>/— don't scatter into asrc/you don't own. Only usesrc/explore/<topic>/when the user opted into co-located for a project they own. Vite excludes either from the production bundle. - Title —
Explore/<topic>/<name>— last instorySort.order, bottom of sidebar. - Tags —
['explore', '!autodocs', '!test']. Optional:'motion','figma-sync','v2-preview'.
Graduation gate (Explore → Component)
Four criteria in labs-workflow.md: stable API · ≥3 callsites planned · designer-reviewed ·
tokens not magic numbers. When all met → trigger sb-ship (it preserves the experiment,
never git mv). Until then, keep iterating here.
Next
Iterate; when the gate is met, hand off to sb-ship. Append progress to .storybook/audit/status.md
so an interrupted session resumes cleanly (CONTEXT.md resume protocol).
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/strongeron/storybook-workbench/sb-explore">View sb-explore on skillZs</a>