What is storybook-mcp copilot-instructions.md?

Project instructions for forgekit-storybook-mcp, a command-line tool that creates Storybook stories, tests, and documentation for React component libraries. Storybook is a tool for developing and checking interface components in isolation.

Use them when working on the forgekit-storybook-mcp codebase, especially its component scanning, file generation, configuration, and Storybook-related tools.

They give an AI agent the project's architecture, file responsibilities, requirements, and data flow so it can make changes consistently.

How the-single-gentlemans-club/storybook-mcp configures GitHub Copilot

Reuse

Borrowing it

Nothing to install: this file belongs to the-single-gentlemans-club/storybook-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/the-single-gentlemans-club/storybook-mcp/master/.github/copilot-instructions.md

Clone the repo

git clone --depth 1 https://github.com/the-single-gentlemans-club/storybook-mcp

Made for: GitHub Copilot.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/the-single-gentlemans-club/storybook-mcp/copilot-instructions/github.svg)](https://agentmods.dev/instructions/the-single-gentlemans-club/storybook-mcp/copilot-instructions)

Your own site

<a href="https://agentmods.dev/instructions/the-single-gentlemans-club/storybook-mcp/copilot-instructions"><img src="https://agentmods.dev/badge/instructions/the-single-gentlemans-club/storybook-mcp/copilot-instructions/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/the-single-gentlemans-club/storybook-mcp/copilot-instructions"><img src="https://agentmods.dev/badge/instructions/the-single-gentlemans-club/storybook-mcp/copilot-instructions.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 1,829 This file is loaded in full into every session.

When invoked 1,829 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.01829	$0.01829
Opus 5.5	$0.00732	$0.00732
Sonnet 5.5	$0.00366	$0.00366
Haiku 4.5	$0.00183	$0.00183

Measured 2mo ago against content hash 1e90ea501a1d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

storybook-mcp copilot-instructions.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.github/copilot-instructions.md · 111 lines

How it starts

The opening of the file, as written. The whole thing — 111 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Copilot Instructions — forgekit-storybook-mcp

Project Overview

MCP (Model Context Protocol) server that auto-generates Storybook stories, tests, and MDX docs for React component libraries. Published to npm as forgekit-storybook-mcp, runs as a CLI via stdio transport. It is not a React app—it analyzes and generates files in consumer projects. Requires Node ≥ 20 and targets Storybook 10+.

Architecture

src/
  cli.ts              → Entry: loads .env/.env.local, resolves config, runs preflight + init sync, starts MCP server
  index.ts            → MCP server: registers 15 tools via @modelcontextprotocol/sdk request handlers
  tools.ts            → 15 tool functions: listComponents, analyzeComponent, generateStory, updateStory,
                         validateStory, getStoryTemplate, listTemplates, getComponentCoverage, suggestStories,
                         syncAll, syncComponent, generateTest, generateDocs, checkHealth, generateCodeConnect
  types.ts            → All shared TypeScript interfaces + DEFAULT_CONFIG
  utils/
    scanner.ts          → Component discovery (fast-glob) + prop/dependency extraction via regex
    generator.ts        → Story file generation (framework-aware: Chakra/shadcn/RN/etc.)
    initializer.ts      → Startup sync engine: MD5 hash diff via .storybook-mcp-cache.json; file watcher
    setup.ts            → Storybook bootstrapper: .storybook/ config, Nx monorepo detection
    templates.ts        → 8 built-in story templates (basic, with-controls, with-msw, form, etc.)
    validator.ts        → Story validator: 8 rule categories, 0-100 score
    test-generator.ts   → Generates Playwright or Vitest test files
    docs-generator.ts   → Generates MDX documentation files
    code-connect-generator.ts → Generates @figma/code-connect .figma.tsx files
    story-merger.ts     → Pure functions: merges regenerated templates with user-added story blocks
    story-history.ts    → Writes .forgekit/story-history.json (max 10 versions per story)
    preflight.ts        → Storybook 10 compatibility checks before server starts
    errors.ts           → StorybookMCPError class + ErrorCode enum (typed error codes)
    constants.ts        → Single source of truth for all hardcoded values

Read the full file on GitHub · 111 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 111 lines · 1,829 tokens per session scan A 1e90ea501a1d

Subscribe to this mod's changes

storybook-mcp copilot-instructions.md is an instructions file published in the GitHub repository the-single-gentlemans-club/storybook-mcp (1 stars, last pushed 6mo ago), licensed MIT. It adds 1,829 tokens to every session, about $0.0073 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

storybook-mcp copilot-instructions.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
storybook-mcp copilot-instructions.mdthe-single-gentlemans-club/storybook-mcp	Instructions file	1	6mo ago	MIT	A	1,829	GitHub Copilot
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	today	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

storybook-mcp: Instructions file for GitHub Copilot