Agent skill

S2 Docs

by adobe in adobe/spectrum-design-data

Look up Spectrum 2 (S2) component documentation, design guidelines, and usage patterns when building with React Spectrum or Spectrum Web Components.

Apache-2.0Auto-check passedDevelopment

Install S2 Docs

skills CLI
$ npx skills add adobe/spectrum-design-data --skill s2-docs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install adobe/spectrum-design-data s2-docs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/adobe/spectrum-design-data.git skills-src && mkdir -p .claude/skills && cp -r skills-src/tools/s2-docs-mcp/skills/s2-docs .claude/skills/s2-docs && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
s2-docs
GitHub stars
155
Token cost
~868 tokens
SKILL.md length
272 words
Files
2 (incl. scripts)
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

Look up Spectrum 2 (S2) component documentation, design guidelines, and usage patterns when building with React Spectrum or Spectrum Web Components.

  • Works in 4 steps: Identify the component(s) the user needs… → Fetch the docs with get for each… → Read the "Component options" table —… → …
  • The user mentions Spectrum
  • SKILL.md covers Lookup commands, Workflow, Anti-drift checklist and Key S2 design decisions (quick…
  • Runs JavaScript scripts from its folder; calls node

What it does

S2 Docs is an agent skill from adobe/spectrum-design-data. Look up Spectrum 2 (S2) component documentation, design guidelines, and usage patterns when building with React Spectrum or Spectrum Web Components. Use when the user mentions Spectrum, S2, React Spectrum, RSP, Spectrum Web Components, or SWC, or names a Spectrum component (Button, Picker, ComboBox, TextField, ActionButton, etc.). Helps prevent drift from documented S2 design decisions during prototyping.

Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/lookup.js`).

It sits in Development, covering Architecture decision records and Prototyping. It works with React. The repository describes itself as: Design data, including design tokens, component schemas, and tooling for Spectrum, Adobe's design system. The licence is Apache-2.0.

When your agent uses it

  • The user mentions Spectrum
  • Spectrum Web Components
  • Names a Spectrum component (Button

Example prompts

  • “/s2-docs”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): Bash(node ${CLAUDE_SKILL_DIR}/scripts/lookup.js *)

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Identify the component(s) the user needs — use use-case or search if unsure.
  2. Fetch the docs with get for each relevant component.
  3. Read the "Component options" table — note variants, sizes, required props.
  4. Apply the anti-drift checklist before writing code.

What it can do on your machine

Read from SKILL.md and the folder at commit dc75d47. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(node ${CLAUDE_SKILL_DIR}/scripts/lookup.js *)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

S2 Docs loads about 868 tokens when it runs. Until then it costs about 104 tokens; SKILL.md has 272 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~104
When it runs · the whole SKILL.md, loaded when a task matches
~868

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from adobe/spectrum-design-data at commit dc75d47, republished under its Apache-2.0 licence (© adobe). 272 words, ~868 tokens.

Download SKILL.mdSave it as .claude/skills/s2-docs/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
s2-docs
description
Look up Spectrum 2 (S2) component documentation, design guidelines, and usage patterns when building with React Spectrum or Spectrum Web Components. Use when the user mentions Spectrum, S2, React Spectrum, RSP, Spectrum Web Components, or SWC, or names a Spectrum component (Button, Picker, ComboBox, TextField, ActionButton, etc.). Helps prevent drift from documented S2 design decisions during prototyping.
allowed-tools
Bash(node ${CLAUDE_SKILL_DIR}/scripts/lookup.js *)
metadata.author
adobe
metadata.version
1.2.1
when_to_use
Trigger on: "which Spectrum component", "React Spectrum", "Spectrum Web Components", "@adobe/react-spectrum", "@spectrum-web-components", component name…

Spectrum 2 Docs

Fetch canonical S2 docs before suggesting any Spectrum component or pattern. This prevents common vibe-coding mistakes: wrong variant, hard-coded sizes, divider-first layouts, missing required props.

Lookup commands

Get a specific component (use before writing any RSP/SWC code):

node ${CLAUDE_SKILL_DIR}/scripts/lookup.js get <component-name>

Find components by use case:

node ${CLAUDE_SKILL_DIR}/scripts/lookup.js use-case "<phrase>"

Search by name:

node ${CLAUDE_SKILL_DIR}/scripts/lookup.js search <query>

List all components in a category (actions, containers, feedback, inputs, navigation, status):

node ${CLAUDE_SKILL_DIR}/scripts/lookup.js list --category <category>
When working in Cursor

Cursor does not support inline shell injection. Use Bash explicitly with --cursor for trimmed, delimited output:

node ${CLAUDE_SKILL_DIR}/scripts/lookup.js get <component-name> --cursor
node ${CLAUDE_SKILL_DIR}/scripts/lookup.js use-case "<phrase>" --cursor

Workflow

  1. Identify the component(s) the user needs — use use-case or search if unsure.
  2. Fetch the docs with get <name> for each relevant component.
  3. Read the "Component options" table — note variants, sizes, required props.
  4. Apply the anti-drift checklist before writing code.

Anti-drift checklist

After fetching docs, verify every suggestion against:

  • Correct component — ComboBox (freeform + autocomplete) vs Picker (selection only), ActionButton vs Button, etc.
  • Correct variant — don't default to accent; match the use case (primary, secondary, negative)
  • No hard-coded sizes — use Spectrum size tokens, not px values
  • Spacing-first grouping — S2 uses spacing to separate content, not dividers
  • Required props present — e.g. label on all inputs, necessityIndicator when required
  • Static color used correctly — only when placed on a custom background

Key S2 design decisions (quick reference)

  • Button variants: accent = primary CTA (max 3 per view); primary = medium emphasis; secondary = low emphasis; negative = destructive
  • ActionButton vs Button: ActionButton is compact and icon-focused for toolbars; Button is for primary flows
  • ComboBox vs Picker: ComboBox allows freeform text + autocomplete; Picker is select-only
  • Spacing over dividers: S2 replaced dividers with spacing as the primary grouping mechanism
  • Size tokens: always use size="S|M|L|XL" prop, never hard-coded px

© adobe, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in tools/s2-docs-mcp/skills/s2-docs of adobe/spectrum-design-data.

  • SKILL.md
  • scripts/lookup.js

Open the folder on GitHubat commit dc75d47

Compare with similar skills

S2 Docs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

S2 Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
S2 Docs this skilladobe/spectrum-design-data155—~868Automated safety check: PassApache-2.0
Vibespopmechanic/VibesOS135—~2.6kAutomated safety check: NotesMIT
Writing Specbartstc/vite-ts-react-template122—~3.4kAutomated safety check: PassMIT
Typescript Docsgiuseppe-trisciuoglio/developer-kit355—~2.1kAutomated safety check: NotesMIT
Agentic System Designooiyeefei/ccc494—~7.3kAutomated safety check: PassMIT
LobeHub Interactive Prototypelobehub/lobehub83k—~1.6kAutomated safety check: PassCustom licence

Similar skills

  • Vibes

    popmechanic/VibesOS

    Self-contained app generator — invoke this skill directly, do not decompose into sub-steps.

    135 GitHub stars~2.6k tokensUpdated 2 mo ago
    DevelopmentAuto-check: notes
  • Writing Spec

    bartstc/vite-ts-react-template

    Collaboratively write a feature spec with the developer. An agent skill from bartstc/vite-ts-react-template.

    122 GitHub stars~3.4k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Typescript Docs

    giuseppe-trisciuoglio/developer-kit

    Generates comprehensive TypeScript documentation using JSDoc, TypeDoc, and multi-layered documentation patterns for different audiences.

    355 GitHub stars~2.1k tokensUpdated 27 days ago
    DevelopmentAuto-check: notes
  • Prescriptive Q&A workflow for designing agentic pipelines, multi-model councils, sub-agent hierarchies, and tool-loop hardening for any domain.

    494 GitHub stars~7.3k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Builds single-file interactive HTML prototypes rendered with the real LobeHub UI components and written as production-style React, so they can later be split into files.

    83k GitHub stars~1.6k tokensUpdated today
    Frontend & DesignAuto-check passed
  • @pierre/diffs Code Rendering

    pierrecomputer/pierre

    Guides an agent through using @pierre/diffs to render syntax-highlighted files and diffs, and to build editing and review surfaces in React or plain JavaScript.

    6.2k GitHub starsUsed in 2 repos~803 tokens
    DevelopmentAuto-check passed

More from adobe/spectrum-design-data

  • Design Data

    adobe/spectrum-design-data

    Look up Spectrum design tokens, component schemas, and design-system decisions when building with or extending Adobe Spectrum.

    155 GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check passed
  • Design Data Agent

    adobe/spectrum-design-data

    Validate, query, resolve, diff, and author spec-conformant design tokens and components using the design-data MCP tools against a local dataset.

    155 GitHub stars~2k tokensUpdated 4 days ago
    Auto-check passed
  • Enhance Sync PR

    adobe/spectrum-design-data

    Enhances auto-generated spectrum-design-data PRs from spectrum-tokens-studio-data sync (branch tokens-sync/patch-spectrum2-from-main, author mrcjhicks).

    155 GitHub stars~2.3k tokensUpdated 4 days ago
    Auto-check passed
  • Docs Voice Tone

    adobe/spectrum-design-data

    Reviews docs-site prose (articles, spec pages, READMEs) against Spectrum's voice principles (Clear, Genuine, Concise, Upfront), adapted for public/reference docs rather than in-product UI strings.

    155 GitHub stars~1.1k tokensUpdated 4 days ago
    Auto-check passed

Works with

Questions about S2 Docs

What does S2 Docs do?

Look up Spectrum 2 (S2) component documentation, design guidelines, and usage patterns when building with React Spectrum or Spectrum Web Components. S2 Docs is an agent skill from adobe/spectrum-design-data. Look up Spectrum 2 (S2) component documentation, design guidelines, and usage patterns when building with React Spectrum or Spectrum Web Components.

When should I use S2 Docs?

S2 Docs fits situations like: the user mentions Spectrum; spectrum Web Components; names a Spectrum component (Button.

How do I install S2 Docs in Claude Code?

Run `npx skills add adobe/spectrum-design-data --skill s2-docs -a claude-code`. Or copy the skill folder (tools/s2-docs-mcp/skills/s2-docs in adobe/spectrum-design-data) into .claude/skills/s2-docs in your project. Claude Code loads it when a task matches its description.

How do I install S2 Docs in Codex?

Run `npx skills add adobe/spectrum-design-data --skill s2-docs -a codex`. Or copy the skill folder (tools/s2-docs-mcp/skills/s2-docs in adobe/spectrum-design-data) into .agents/skills/s2-docs in your project. Codex loads it when a task matches its description.

Can I use S2 Docs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add adobe/spectrum-design-data --skill s2-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/s2-docs, .gemini/skills/s2-docs, .github/skills/s2-docs and .opencode/skills/s2-docs in your project.

What does S2 Docs need to run?

Going by SKILL.md and its folder, S2 Docs needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Bash(node ${CLAUDE_SKILL_DIR}/scripts/lookup.js *).

Does S2 Docs access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is S2 Docs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does S2 Docs use?

S2 Docs is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does S2 Docs use?

About 868 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to S2 Docs?

Skills that share tags, products or a category with S2 Docs: Vibes (popmechanic/VibesOS, 135 stars), Writing Spec (bartstc/vite-ts-react-template, 122 stars), Typescript Docs (giuseppe-trisciuoglio/developer-kit, 355 stars) and Agentic System Design (ooiyeefei/ccc, 494 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains S2 Docs?

adobe (a GitHub organization) maintains it in adobe/spectrum-design-data, which has 155 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 2, 2026.

Source: adobe/spectrum-design-data on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.