setup

setup is a command for Claude Code from sodam-ai/SoDam-Design-Kit. It costs 32 tokens per session (607 once invoked), scanned A, original, Apache-2.0.

A project setup command for SoDam Design Kit, a toolkit that maps coded interface components to their design references.

In plain words
What is it for?
Use it once per project to create the .design-kit folders and files, scan shadcn/ui components, and optionally record a Figma file URL.
Why use it?
It creates the initial configuration and component list, reducing the manual setup needed before using the toolkit.

Command for Claude Code

Written for Claude Code: ${CLAUDE_PLUGIN_ROOT} variable.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the sodam-design-kit plugin — 1 skill, 5 commands, 1 hook shipped together

Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add sodam-ai/SoDam-Design-Kit
Claude Code
/plugin install sodam-design-kit

Made for: Claude Code.

Or install sodam-design-kit, the plugin that ships this one along with the rest of its 1 skill, 5 commands, 1 hook.

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.

agentmods badge for setup

README.md
[![agentmods](https://agentmods.dev/badge/commands/sodam-ai/sodam-design-kit/setup.svg)](https://agentmods.dev/commands/sodam-ai/sodam-design-kit/setup)
Your own site
<a href="https://agentmods.dev/commands/sodam-ai/sodam-design-kit/setup"><img src="https://agentmods.dev/badge/commands/sodam-ai/sodam-design-kit/setup.svg" alt="Measured on agentmods" height="20"></a>
Per session 32 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 607 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00032 $0.00607
Opus 5 $0.00016 $0.00303
Sonnet 5 $0.00006 $0.00121
Haiku 4.5 $0.00003 $0.00061

Measured 6d ago against content hash ac22590a2a1e, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

setup 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 6d 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.

commands/setup.md · 27 lines

What it actually says

/sodam-design-kit:setup

목적

현재 프로젝트에 .design-kit/ 폴더를 만들고 킷을 사용할 준비를 합니다. 프로젝트당 1회만 실행합니다.

실행

node "${CLAUDE_PLUGIN_ROOT}/scripts/setup-wizard.mjs" --project <현재 프로젝트 경로>
  • shadcn/ui가 설치되어 있지 않으면(스크립트가 shadcn/ui가 설치되어 있지 않습니다 출력) npx shadcn init 실행 여부를 사용자에게 확인 후 수행하고, 완료되면 setup을 다시 실행하세요.
  • 이미 .design-kit/config.json이 있으면 스크립트가 자동으로 건너뜁니다(멱등성 — 재실행해도 기존 설정을 덮어쓰지 않음). 재스캔이 필요하면 --force를 추가하세요 — 이미 확보한 Figma 매핑(figmaNodeId/figmaName/propsHint/lastVerified)은 보존되고, 코드에 새로 생긴 컴포넌트만 빈 값으로 추가됩니다(2026-07-20 실측 확인 — 과거엔 매핑이 통째로 초기화되는 결함이 있었음, 수정 완료).
  • Figma 파일이 있으면 --figmaFileUrl <URL>을 추가할 수 있습니다(선택 — 없어도 정상 동작).

동작 (scripts/setup-wizard.mjs, 실측 검증 완료 — .PRD/02_DATA_MODEL.md 스키마 그대로)

  1. components.json(shadcn 자체 설정 — 단일 출처)과 tsconfig.json의 경로 별칭을 읽어 실제 UI 컴포넌트 디렉터리를 정확히 찾음(하드코딩 금지)
  2. 그 디렉터리의 .tsx 파일을 스캔해 .design-kit/component-map.json 초기 시드 생성 (figmaNodeId/figmaName은 빈 값 — Figma 매핑은 /sodam-design-kit:pipeline이 채움)
  3. .design-kit/config.json 생성 — framework("nextjs" 고정)·uiLibrary("shadcn")·viewports([360,768,1440])·gateEnabled(true)·maxAutoRetry(3)·a11yLevel("serious")
  4. .design-kit/runs/, .design-kit/reports/ 폴더 생성

금지 (04_PROJECT_SPEC.md DO NOT)

  • 셸 문자열 조합 실행 금지 (spawn+인자 배열만)
  • 개인정보·실데이터가 담긴 Figma 파일 연결 금지
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.

  1. 6d ago First seen · 27 lines · 32 tokens per session scan A ac22590a2a1e

Subscribe to this mod's changes

setup is a command published in the GitHub repository sodam-ai/SoDam-Design-Kit (10 stars, last pushed 2d ago), licensed Apache-2.0. It adds 32 tokens to every session and 607 once invoked, about $0.0002 per session on Opus 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.