S-skills
Claude Code 커스텀 하네스 + 스킬 모음.
하네스(harness)가 프로젝트 상태를 감지해 어떤 스킬을 실행할지 오케스트레이션한다.
각 스킬(docs-organize, test-scenario)은 독립 호출도 가능하다.
skills/
├── harness/ ← 오케스트레이터. /s-skills 하나로 전체 흐름 제어
├── docs-organize/ ← 스킬. 문서 생성 + 건강 점수
└── test-scenario/ ← 스킬. 사이클 기반 테스트 하네스
설치
방법 1 — 플러그인 (권장)
claude plugin install s0613/S-skills
방법 2 — 수동 심링크 (개발/로컬)
# 1. 레포 클론
git clone https://github.com/s0613/S-skills.git ~/S-skills
# 2. 심링크 연결 (skills/ 하위 경로 기준)
ln -sf ~/S-skills/skills/harness ~/.claude/skills/s-skills
ln -sf ~/S-skills/skills/docs-organize ~/.claude/skills/docs-organize
ln -sf ~/S-skills/skills/test-scenario ~/.claude/skills/test-scenario
수동 설치 후 업데이트는 cd ~/S-skills && git pull만으로 반영.
구성 요소
| 종류 | 트리거 | 설명 |
|---|
| 하네스 | /s-skills | 프로젝트 상태 감지 → docs-organize / test-scenario 오케스트레이션 |
| 스킬 | /docs-organize | 프로젝트 분석 → 표준 문서 생성 → 건강 점수 0–100 |
| 스킬 | /test-scenario | 사이클 기반 테스트 — 프롬프트 생성 → 결과 평가 → 목표 통과율 달성까지 반복 |
harness
역할
/s-skills 하나만 호출하면 현재 프로젝트 상태를 읽고 무엇을 해야 할지 판단한다.
┌─────────────────────────────────────────────┐
│ /s-skills │
│ │
│ 프로젝트 상태 감지 (preamble bash) │
│ - docs/ 존재 여부 + STATUS.md 점수 │
│ - test-scenarios/ 사이클 + 통과율 │
│ ↓ │
│ 상태에 따라 스킬 선택 │
│ 문서 없음 → docs-organize 추천 │
│ 문서만 있음 → test-scenario 추천 │
│ 테스트 진행 → 결과 보고 / 재생성 선택 │
│ 모두 완료 → 완료 리포트 │
│ ↓ │
│ 선택된 스킬 호출 (Skill 도구) │
└─────────────────────────────────────────────┘
상태 요약 출력 형식
S-skills 상태 요약
──────────────────
문서 : yes (점수: 72/100)
시나리오 : IN_PROGRESS (사이클: 2, 통과율: 60%)
다음 추천 : 결과 블록 붙여넣기 → report 모드
docs-organize
한 줄 설명
프로젝트 디렉토리에서 실행하면 코드를 분석하고 질문 몇 가지를 통해 docs/ 폴더에 표준 문서를 자동 생성한다. 실행할 때마다 테스트를 돌리고 프로젝트 건강 점수(0–100)를 업데이트한다.
언제 쓰나
- 새 프로젝트를 시작하거나 인수받았을 때
- PRD, 아키텍처 문서가 없거나 오래된 상태일 때
- 클로드에게 이 프로젝트를 빠르게 이해시키고 싶을 때
- 주기적으로 프로젝트 상태를 점검하고 싶을 때
사용법
# 아무 프로젝트 디렉토리에서
/docs-organize
자연어로도 동작:
docs 정리
문서 정리
처음 실행하면 코드 분석 후 최소 1개 질문을 한다. 이미 문서가 있으면 기존 내용을 유지하면서 병합한다.
실행 흐름
1. Phase 0 기존 점수 저장 (delta 계산용)
2. Phase 1 코드 분석 — tech stack, 프로젝트 타입, 프론트엔드 여부
3. Phase 2 인터뷰 — 코드로 알 수 없는 것만 질문 (최대 5개, 최소 1개)
4. Phase 3 문서 생성 — docs/ 하위 파일 작성
5. Phase 4 테스트 실행 — 테스트 러너 자동 감지 후 실행
6. Phase 5 점수 계산 — 4개 차원 채점 후 STATUS.md 업데이트
7. Phase 6 결과 보고
생성 파일 구조
{project}/
├── CLAUDE.md ← 이 프로젝트용 Claude 지시사항 (루트)
└── docs/
├── prd.md ← 제품 요구사항
├── architecture.md ← 시스템 구조 & 기술 결정
├── UI_GUIDE.md ← UI 디자인 가이드 (프론트엔드만)
├── STATUS.md ← 구현 상태 + 프로젝트 건강 점수
└── adr/
└── YYYY-MM-DD-{title}.md ← Architecture Decision Records (최대 3개)
docs/spec/은 처음부터 생성하지 않음. 첫 spec 요청 시 생성됨.
인터뷰 방식
코드 분석 후 아래 4가지를 모두 확신할 수 없으면 질문한다 (최대 5개, 기본 최소 1개):
| 항목 | 예시 |
|---|
| 제품 목적 | "중고차 수출 업무를 자동화하는 B2B SaaS" |
| 주요 타겟 유저 | 수출 딜러, 내부 운영팀 |
| 현재 단계 | POC / MVP / Production |
| 핵심 제약 | "외부 API 없이 자체 처리", "모바일 퍼스트" 등 |
문서별 포맷
prd.md
Problem / Target Users / Features (in scope) / Out of Scope / Success Metrics
architecture.md
Overview / Tech Stack / Key Decisions / Data Flow / Constraints
UI_GUIDE.md (프론트엔드만)
Design Direction / Color Palette / Typography /
Spacing & Layout / Component Patterns / Motion / Do Not
STATUS.md
Score: XX/100 (prev: XX → +/-N)
Score Breakdown (4개 차원)
Test Results
Milestones / Features / Technical Debt / Infrastructure
adr/YYYY-MM-DD-{title}.md
Status / Context / Decision / Consequences
CLAUDE.md (프로젝트 루트)
Project Summary / Tech Stack / Conventions / Do Not / Docs Reference
점수 시스템 (0–100)
| 차원 | 배점 | 채점 기준 |
|---|
| 문서 완성도 | 25 | prd / architecture / ADR / STATUS / CLAUDE.md 각 5pt |
| 기능 구현율 | 25 | 테스트 통과율. 테스트 없으면 코드 구조 분석 폴백 (3–20pt) |
| 코드 품질 | 25 | 테스트 파일 존재 5pt + 통과율 최대 10pt + TODO/FIXME 최대 10pt |
| 인프라 준비도 | 25 | CI/CD 8pt + .env.example 7pt + README 5pt + 모니터링 5pt |
점수는 매 실행마다 갱신되고 이전 점수와 비교한다:
Score: 72 / 100 (prev: 61 → +11)
기능 구현율 폴백 (테스트 없는 POC 등):
PRD 기능 대비 구현된 코드 비율로 채점. STATUS.md에 Runner: none — scored via code structure analysis 기록.
test-scenario
한 줄 설명
사이클 기반 테스트 하네스 — 시나리오 생성 → Chrome 확장 실행(유저) → 결과 보고 → 목표 통과율(기본 80%) 달성까지 반복.
언제 쓰나
- 기능 구현 후 E2E 동작 검증을 사이클 단위로 관리하고 싶을 때
- 테스트 코드 없이 Claude Chrome 확장으로 E2E 테스트를 하는 프로젝트
- 개선 → 재검증 사이클을 추적하고 통과율 목표를 달성하고 싶을 때
- 어떤 기능이 안정적이고 어떤 기능이 반복 실패하는지 추이를 보고 싶을 때
하네스 루프 개요
