frontend-skills: Instructions file for Claude Code

CLAUDE.md

Project Overview

Claude Code Plugin 레포지토리. AI 에이전트(Claude Code)의 기능을 확장하는 커스텀 스킬을 개발하고 마켓플레이스로 배포한다.

레포 구조

이 레포는 마켓플레이스 — 각 플러그인이 목적별로 그룹화되어 있고, 그 안에 여러 스킬을 담는다. 사용자는 원하는 플러그인만 골라 설치한다.

frontend-skills/
├── .claude-plugin/
│   └── marketplace.json          # 마켓플레이스 레지스트리
├── skills/                       # 각 디렉토리가 하나의 플러그인
│   ├── supabase/                 # 그룹 플러그인 예시:
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json       #   플러그인 매니페스트
│   │   └── skills/
│   │       └── initial-setting/  #   플러그인 안의 스킬
│   │           ├── SKILL.md
│   │           └── scripts/
│   ├── project-packages/         # setup-all, tailwind-cn, dayjs-kst, supabase-clients, tanstack-query, zustand-store, form-validation, package-map
│   ├── spec-generator/           # prd, tech-stack, design-system, mvp-roadmap
│   ├── claudemd/                 # builder, refactoring
│   ├── guide-maker/              # 단독 (Notion MCP 포함)
│   ├── project-scaffolder/       # 단독
│   ├── web-to-markdown/          # 단독
│   └── e2e-testing/              # 단독
└── docs/                         # 참고 문서

설치 방식

# 마켓플레이스 등록
/plugin marketplace add heechan/frontend-skills

# 원하는 플러그인 골라 설치
/plugin install supabase@frontend-skills
/plugin install spec-generator@frontend-skills
/plugin install claudemd@frontend-skills

Plugin / Skill 구조

각 플러그인은 plugin.json 매니페스트와 skills/ 하위 디렉토리를 가진다:

plugin-name/                      # 플러그인 루트
├── .claude-plugin/
│   └── plugin.json               # 플러그인 매니페스트 (필수)
└── skills/
    └── skill-name/               # 스킬 디렉토리
        ├── SKILL.md              # YAML frontmatter + Markdown 지침 (필수)
        ├── scripts/              # 실행 가능 코드 (Python/Bash)
        ├── references/           # 참조 문서
        └── assets/               # 출력용 파일

호출: /{plugin-name}:{skill-name} (예: /supabase:initial-setting, /spec-generator:prd)

SKILL.md Frontmatter

---
name: skill-name                    # 소문자, 하이픈만, 64자 이하 (선택, 없으면 디렉토리명)
description: >                      # 권장. 트리거 판단 기준. 1024자 이하
  스킬 설명 및 트리거 조건.
disable-model-invocation: false     # true면 사용자만 호출 가능 (선택)
allowed-tools: Read, Grep, Glob     # 스킬 활성 시 허용 도구 (선택)
context: fork                       # fork면 서브에이전트로 실행 (선택)
agent: Explore                      # context: fork 시 에이전트 타입 (선택)
---