frontend-skills: Instructions file for Claude Code

AGENTS.md

Project Overview

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

레포 구조

이 레포는 마켓플레이스 — 각 스킬이 개별 플러그인으로 등록되어 사용자가 원하는 것만 골라 설치한다.

frontend-skills/
├── .Codex-plugin/
│   └── marketplace.json          # 마켓플레이스 레지스트리
├── skills/                       # 각 디렉토리가 하나의 플러그인
│   ├── supabase-db-setting/      # 플러그인 예시:
│   │   ├── .Codex-plugin/
│   │   │   └── plugin.json       #   플러그인 매니페스트
│   │   └── skills/
│   │       └── supabase-db-setting/
│   │           ├── SKILL.md      #   스킬 정의
│   │           └── scripts/      #   스킬 리소스
│   ├── Codex-refactoring/
│   ├── claudemd-builder/
│   ├── project-scaffolder/
│   ├── guide-maker/
│   ├── prd-generator/
│   ├── tech-stack-generator/
│   ├── design-system-generator/
│   ├── mvp-roadmap-generator/
│   ├── web-to-markdown/
│   └── e2e-testing/
└── docs/                         # 참고 문서

설치 방식

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

# 원하는 스킬만 골라 설치
/plugin install prd-generator@fs
/plugin install claudemd-builder@fs

Plugin / Skill 구조

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

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

호출: /fs:skill-name

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 시 에이전트 타입 (선택)
---