Skills(스킬)

스킬은 Agent에게 깊고 작업 전용의 지식을 부여하는 Markdown 파일입니다. 단편 소설 창작용 하나, 책 분석 노트용 하나, 각본 포맷용 하나——Agent는 지금 하는 작업과 관련된 스킬만 로드합니다.

스킬의 작동 방식

스킬은 점진적 로딩으로 컨텍스트를 가볍게 유지합니다. 프로젝트를 열면 Agent는 모든 스킬의 이름과 설명만 봅니다——각각 수십 자입니다. 시작 시 로드되는 것은 이것뿐입니다. 당신의 요청이 어떤 스킬의 설명과 일치하면, Agent는 그 스킬을 활성화하고 전체 지시를 로드합니다. 단편 소설 스킬은 당신이 쿼리 레터를 쓰는 동안 휴면 상태입니다. 호러 소설 스킬은 당신이 스릴러 대강을 짜는 동안 컨텍스트를 소비하지 않습니다.

레벨	로드 시점	내용
메타데이터	항상, 시작 시	frontmatter의 이름과 설명
지시	스킬이 트리거될 때	전체 SKILL.md 본문
지원 파일	필요에 따라	템플릿, 스크립트, 참고 문서

스킬의 구조와 저장 위치

각 스킬은 SKILL.md 파일을 담은 디렉터리이며, 디렉터리 이름이 곧 스킬 이름이 됩니다. 스킬은 세 개의 선택적 하위 디렉터리에 지원 파일을 포함할 수도 있습니다.

your-novel/
├── .soloent/
│   └── skills/                  # 프로젝트 스킬(이 프로젝트만)
│       └── short-story/
│           ├── SKILL.md                   # 필수: 이름, 설명, 지시
│           ├── templates/                 # 선택: 출력 템플릿, 형식 가이드
│           │   ├── chapter-outline.md
│           │   └── character-profile.md
│           ├── docs/                      # 선택: 참고 자료, 조회 테이블
│           │   └── genre-conventions.md
│           └── scripts/                   # 선택: Agent가 실행할 수 있는 처리 스크립트
│               └── word-count.py
├── SOLOENT.md
├── chapters/
└── ...

지원 파일은 지시가 참조할 때만 로드되며, 시작 시에는 컨텍스트를 소비하지 않습니다. 템플릿은 Agent가 그것이 필요한 단계에 도달할 때까지 휴면 상태입니다. 참고 문서는 Agent가 무언가를 조회해야 할 때만 읽힙니다. 전역 스킬 은 시스템 수준의 스킬 디렉터리에 저장되어 모든 프로젝트에서 사용할 수 있습니다. 프로젝트를 넘나들며 일관되게 쓰는 능력에 적합합니다. 예를 들어 오프닝 후크를 생성하는 스킬이나, 표준 원고 리뷰 흐름을 Agent에게 안내하게 하는 스킬입니다. 프로젝트 스킬 은 프로젝트 루트의 .soloent/skills/ 에 둡니다. 특정 프로젝트나 장르에 묶인 능력에 적합합니다——이 로맨스 시리즈 특유의 규칙으로 구성한 스킬이나, 현재 작품의 수위와 서술 스타일에 맞춰 조정한 스킬입니다.

전역 스킬과 프로젝트 스킬이 같은 이름일 때, 프로젝트 스킬이 우선합니다.

스킬 켜기/끄기

각 스킬에는 파일을 삭제하지 않고 활성화/비활성화하는 스위치가 있습니다. 현재 작업에 그 스킬이 필요 없을 때 비활성화하면 컨텍스트에서 빠지고 의도치 않은 활성화를 막을 수 있습니다.

스킬 만들기

SKILL.md 파일은 두 부분으로 이루어집니다: frontmatter(메타데이터)와 지시 본문.

---
name: my-skill
description: 언제 이 스킬을 트리거하는지 설명한다. 무엇을 하는지가 아니다.
---

스킬이 활성화될 때 Agent가 따라야 할 지시.

두 개의 필수 frontmatter 필드:

name 은 디렉터리 이름과 정확히 일치 해야 합니다
description 은 이 스킬을 언제 트리거하는지 설명합니다. 무엇을 하는지가 아닙니다(1,024자 이내)

에디터에서 연 SKILL.md 파일. name과 description 필드를 표시하고, 오른쪽 Skills 패널이 english-short-story 스킬을 Workspace Skills 아래에 나열

Skills 메뉴 열기

Agent 패널의 왼쪽에서 네 번째 아이콘을 클릭해 Skills 관리자로 전환합니다.

스킬 새로 만들기

“New skill…”을 클릭해 이름(예: short-story)을 입력하고 ”+“를 클릭합니다. Agent가 템플릿 SKILL.md 파일을 담은 스킬 디렉터리를 만듭니다.

스킬 지시 작성하기

SKILL.md 파일을 편집합니다:

description 을 업데이트해 이 스킬이 트리거되는 시점을 지정한다
본문에 지시, 체크리스트, 워크플로 단계를 추가한다
선택적으로 templates/ 나 docs/ 하위 디렉터리에 지원 파일을 추가한다

아래는 공식 제공 english-short-story 의 완전한 스킬 파일입니다——이것은 도메인 전문가형 스킬로, 완전한 6단계 워크플로, 체크리스트, 정지 조건을 포함하며 그대로 복사해 사용할 수 있습니다.

완전한 english-short-story 스킬 받기——클릭해 펼치고 복사

---
name: english-short-story
description: A SoloEnt official writing skill. Create English short fiction with strong hooks, sharp reversals, and high emotional intensity using a 6-step workflow: concept brainstorm, character design, outline, chapter writing with auto-review, and optional chapter review and title/hook generation. Explicit scenes and dark emotional registers are available tools, not requirements. Use when writing short stories, drafting chapters, designing characters, building outlines, reviewing fiction chapters, or generating titles and hooks.
---

# English Short Story

Manages the full creation workflow for English short fiction (10–20 chapters, 900–1,200 words each). Designed for stories built on strong hooks, sharp reversals, and high emotional intensity — across any register including thriller, horror, romance, erotic, literary, or hybrid. Explicit scenes and dark emotional content are available tools calibrated per story, not default requirements.

---

## Before Any Task: Read SOLOENT.md

If `SOLOENT.md` exists, read it and extract:

- **Section 8.1 Todo List** — what is the current pending task?
- **Section 7.1 Current Status** — which step/chapter are we on?
- **Section 7.4 Pending Threads** — active hooks and next chapter goal
- **Section 3 Character Index** — is the Character Voice Profile available?

If `SOLOENT.md` does not exist, proceed directly to Step 1. After the user confirms the core concept, run `/init` to create and populate `SOLOENT.md` before Step 2 begins.

---

## Usage

Use this skill whenever you are working on an English short fiction project that prioritizes strong hooks, emotional intensity, and sharp plot reversals. It manages the full creation process from a one-line premise through to finished chapter files. Works across all registers — thriller, horror, romance, erotic, literary, or hybrid. Explicit content level is calibrated per story during Step 1.

**Start a new story**: provide a one-line premise and the skill walks you through Steps 1–4 in sequence, requiring your confirmation at each stage before advancing. Steps 5 and 6 are optional and run on request.

Trigger phrases that activate this flow:
- Direct story ideas: "A woman finds a letter in her dead husband's coat…", "Two strangers trapped in a lighthouse…"
- Intent statements: "I want to write a short story", "I have a story idea", "Let's write a short fiction"
- Explicit skill invocation: "Use the short story skill", "Start the writing workflow", "短篇技能"

**Resume an existing story**: open a project that already has a `SOLOENT.md` and say "continue the story" or "pick up where we left off" — the skill reads current state and resumes from the correct step.

**Jump to a specific step**: name the step directly (e.g. "run Step 4 for Chapter 3", "review Chapter 5") and the skill starts there.

**Prompt templates are optional**: if `templates/Prompt-0X-*.md` files are present the skill loads them; if not, it runs on the built-in instructions and checklists.

---

## The 6-Step Workflow

### Step 1 — Core Concept Brainstorm

**Input**: One-line premise from user
**Output**: Core concept + story arc (3+ reversals + explicit calibration + sensory register)

If `templates/Prompt-01-Core Concept Brainstorm.md` exists, load and follow it. Otherwise proceed using the output spec and checklist below.

**Checklist before advancing to Step 2**:
- [ ] Central tension defined (desire / fear / obsession / transgression)?
- [ ] 3+ major plot reversals designed?
- [ ] Erotic / horror / thriller elements are structural, not decorative?
- [ ] Explicit level calibrated and noted?
- [ ] First-person narration viable?

**Wait for user confirmation.**

→ Once confirmed, run `/init` to initialize `SOLOENT.md` before proceeding to Step 2.

---

## /init — Initialize SOLOENT.md

Run automatically after Step 1 is confirmed, before Step 2 begins.

**Actions**:
1. Create `SOLOENT.md` in the project root.
2. Fill in the following fields from the Step 1 output:
   - **Section 1 Project DNA**: genre, core themes, emotional promise
   - **Section 5 Stylistic Guidelines**: base tone, language register, pacing notes derived from concept
   - **Section 7.1 Current Status**: story title, story time, immediate atmosphere
   - **Section 8.1 Todo List**: check off `[x] Confirm core concept (Step 1)`, leave remaining todos open
   - **Section 8.2 Milestone Log**: add `[Completed] Step 1 — core concept confirmed: [premise summary] / explicit level: [X]`
3. Confirm to user: `SOLOENT.md initialized — ready for Step 2.`

---

### Step 2 — Character Design

**Input**: Confirmed core concept
**Output**: Main cast + Character Voice Profile

If `templates/Prompt-02-Character Design.md` exists, load and follow it. Otherwise proceed using the output spec and checklist below.

**Rules**:
- Complete and confirm characters **before** touching the outline
- Must output a **Character Voice Profile**: 1–2 sentences per character (speech patterns + signature phrases) — pasted into every Step 4 prompt

**Checklist before advancing to Step 3**:
- [ ] Protagonist is active? Clear goal driving them forward?
- [ ] Every character embodies a value, desire, fear, or moral position?
- [ ] Protagonist's voice is distinct, layered, and evolves?
- [ ] Character Voice Profile output and ready for Step 4?
- [ ] Core cast ≤ 4 characters?
- [ ] Relationships generate natural conflict?

**Wait for user confirmation.**

→ Update `SOLOENT.md`:
- **Section 3.1 Character Index**: add each character entry with name, age, role, and pointer to `characters/[name].md`
- **Section 3.2 Relationship Network**: fill in key relationships
- **Section 7.2 Character Snapshot**: fill in current character states
- **Section 8.1**: check off character design todo, add `[ ] Complete story outline`
- **Section 8.2**: log `[Completed] Step 2 — characters confirmed: [names] / Voice Profile ready`

---

### Step 3 — Outline and Chapter Plan

**Input**: Confirmed concept + confirmed characters + chapter count (default 10–20)
**Output**: 3-act outline + chapter-by-chapter plan

If `templates/Prompt-03-Outline and Chapter Plan.md` exists, load and follow it. Otherwise proceed using the output spec and checklist below.

**Chapter plan format** (must match Step 4 input):
- Story beats: 3–5 per chapter
- Intensity peak: note trigger method (dialogue / action / discovery)
- Closing hook: note tension type (reversal / revelation / threat / disappearance)
- No pre-set timestamp transitions

**Checklist before advancing to Step 4**:
- [ ] Chapter count confirmed with user?
- [ ] Chapter 1 opens on immediate conflict?
- [ ] Chapter 1 intensity peak strong enough to lock the reader?
- [ ] Every chapter has: beats + intensity peak (trigger noted) + closing hook (tension type noted)?
- [ ] Reversal points clearly marked?
- [ ] Explicit / horror / thriller peaks distributed throughout, not clustered?

**Wait for user confirmation.**

→ Update `SOLOENT.md`:
- **Section 4.1 Story Structure**: fill in chapter range and act breakdown
- **Section 4.2 Outline Index**: add pointer `[Story Outline] -> outline/master-outline.md`
- **Section 8.1**: check off outline todo, add `[ ] Begin writing Chapter 1`
- **Section 8.2**: log `[Completed] Step 3 — outline confirmed: [X] chapters / [act structure summary]`

---

### Step 4 — Chapter Writing + Auto-Review

**Input**: Current chapter plan + Character Voice Profile; from Chapter 2 onward, also paste previous 1–2 chapters
**Output**: Chapter prose (900–1,200 words) + auto-review report

If `templates/Prompt-04-Chapter Writing.md` exists, load and follow it. Otherwise proceed using the output spec and checklist below.

**Per-chapter process**:
1. Chapter 1: paste chapter plan + Voice Profile
2. Chapter 2+: paste chapter plan + Voice Profile + previous 1–2 chapters
3. Run `wc -w chapters/ch-XX.md` for word count — do not use model self-estimate
4. Output auto-review immediately after prose

**Auto-Review Checklist** (run after every chapter, mark ✅/❌):
- [ ] Word count 900–1,200 (verified via `wc -w`)?
- [ ] All beats executed in order? Intensity peak landed with correct trigger?
- [ ] Closing hook sharp? No moral summary / reflection / epiphany ending?
- [ ] First-person POV clean — no "he thought / she felt" violations?
- [ ] No 3+ consecutive introspective sentences?
- [ ] Dialogue drives plot (≥ 50%)?
- [ ] Each character's speech matches their Voice Profile?
- [ ] No repeated phrasing within the same character's lines?
- [ ] No timestamp scene openers ("The next day…" / "Three weeks later…")?
- [ ] Age/occupation/backstory communicated obliquely after first mention?
- [ ] Explicit intensity consistent with Step 1 calibration?
- [ ] No AI tells (mechanical structures, em-dash overuse, clichéd phrasing)?

→ After each chapter, update `SOLOENT.md`:
- **Section 7.1**: update `Current Chapter` to next chapter number
- **Section 7.3 Recent Plot Flow**: replace with 3–5 key events from this chapter
- **Section 7.4 Pending Threads**: update `Urgent Hooks`, `Active Foreshadowing`, `Next Chapter Goal`
- **Section 7.5 Execution Review**: paste auto-review checklist result + word count
- **Section 8.1**: check off current chapter todo, add next chapter todo
- **Section 8.2**: log `[Completed] Ch-[X] written — [one-line plot summary]`

> For deep-dive review of specific chapters, use Step 5 (optional).

---

### Step 5 — Chapter Review (Optional)

**Input**: User-specified chapter(s)
**Output**: Detailed review report + revision recommendations

If `templates/Prompt-05-Chapter Review.md` exists, load and follow it. Otherwise proceed using the checklist below.

**When to trigger**:
- User questions a chapter's quality
- Reversal chapters need tonal polish
- Multi-chapter continuity check needed
- Explicit content consistency review across chapters

**Checklist**:
- [ ] Word count (900–1,200) + outline fidelity (beats + intensity peak)?
- [ ] Narrative logic continuity, prose style consistency, character voice fidelity?
- [ ] ⚠️ Tag repetition: age/occupation ≤ 2 mentions; timestamp openers = 0; no phrase repetition?
- [ ] Explicit escalation correct? Any tonal inconsistencies?
- [ ] No AI tells (mechanical structures, digressive monologues, em-dash overuse)?

→ Update `SOLOENT.md`:
- **Section 7.5 Execution Review**: log review findings and revision status for reviewed chapter(s)
- **Section 8.1**: check off review todo if applicable

---

### Step 6 — Title and Opening Hook (Optional)

**Input**: Completed full story (or concept + key scene summary)
**Output**: 100–150 word opening hook + 3 title options

If `templates/Prompt-06-Title and Hook.md` exists, load and follow it. Otherwise proceed using the output spec and checklist below.

**Run only when user requests.** Recommended after all chapters are complete — extract tension from the actual draft.

**Checklist**:
- [ ] Opening hook is 100–150 words, names core conflict, creates immediate suspense?
- [ ] 3 titles differ in style (conflict angle / intrigue angle / atmosphere angle)?
- [ ] Titles calibrated for English-language fiction platforms?

**Delivery**: individual chapter files + title and hook; merge into single file only if user requests.

→ Update `SOLOENT.md`:
- **Section 7.1**: set `Current Chapter` to `Complete`
- **Section 8.1**: check off Step 6 todo if present
- **Section 8.2**: log `[Completed] Step 6 — title and hook delivered / project complete`

---

## Core Creative Principles

- **Hook before everything**: the opening must create immediate tension — a question, a threat, a desire the reader cannot ignore
- **Emotional intensity over social melodrama**: drive the story with visceral feeling — desire, dread, obsession, grief, rage — not domestic drama for its own sake
- **Escalating stakes**: each act pushes further than the reader expects — in intimacy, danger, revelation, or moral cost
- **Active protagonist**: story engine is what the protagonist *chooses to do*, not what happens to them
- **Characters embody value**: each character represents a desire, a fear, a moral position, a kind of power
- **3+ major reversals** distributed across the full story
- **First-person narration** for maximum immersion
- **Explicit content is a calibrated tool**: level set in Step 1 — can range from zero to high depending on the story's needs

자주 쓰는 세 가지 스킬 유형

유형 1: 체크리스트형

고정된 지점에서 여러 기준을 한 번에 검증해 누락을 막는 데 적합합니다. 예를 들어 각 챕터를 마친 뒤의 제출 전 점검:

---
name: chapter-submission-check
description: Use before finalizing a chapter to verify word count, consistency, and all checklist items.
---

## 제출 전 점검(모두 통과해야 진행)
- [ ] 글자 수 900–1,200(도구로 확인, 추정 아님)
- [ ] 모든 챕터 비트를 실행, 강도 피크가 안착함
- [ ] 결말 후크가 선명, 도덕적 요약/감상 마무리 없음
- [ ] 인물 이름 일관성 점검 통과
- [ ] SOLOENT.md 업데이트됨

## 출력
항목별 통과/실패. 실패 항목은 모두 수정한 뒤 진행한다.

유형 2: 워크플로형

명확한 단계 순서가 있고 실행 전에 확인이 필요한 작업에 적합합니다.

---
name: chapter-rewrite
description: Rewrite a chapter from scratch. Run only when explicitly requested.
---

## 단계
1. 백업: 현재 챕터를 ch-XX-original.md로 저장해 원고를 보존한다
2. 설명: 이번 재작성의 핵심 방향을 한 단락으로 요약하고 사용자 확인을 기다린 뒤 쓰기 시작한다
3. 실행: 새 방향으로 챕터를 통째로 쓴다(900–1,200자)
4. 검증: 원본과 대조해 챕터 체크리스트를 실행하고 신구 버전의 주요 차이를 출력한다

유형 3: 도메인 전문가형

Agent가 감이 아니라 전문가의 경험으로 일하기를 바라는 상황에 적합합니다. 예를 들어 집필이 막혔을 때의 진단 스킬:

---
name: story-diagnosis
description: Use when a chapter feels flat, pacing is off, or a scene isn't landing.
---

## 증거 수집
1. 문제 챕터의 전문을 읽는다
2. SOLOENT.md 4절의 챕터 비트 계획과 대조한다
3. 앞뒤 챕터의 감정 곡선을 확인한다

## 결정 매트릭스
| 증상 | 먼저 확인 |
|---|---|
| 템포가 늘어짐 | 비트 밀도 / 무의미한 문단 유무 |
| 감정이 안 닿음 | 인물 목소리 일관성 / 내적 독백 과다 여부 |
| 결말 후크 실패 | 긴장 유형 / 챕터 내에서 긴장을 이미 방출했는지 |

## 출력 형식
근본 원인 / 영향 범위 / 수정 단계 / 검증 방법

완전한 사례: 작품 요약

이것은 도메인 전문가형 스킬입니다. 콘텐츠 획득 경로(스크립트가 필요에 따라 챕터를 추출), 전문 정의(docs/ 에 챕터 식별 패턴 저장), 고정 출력 형식(templates/ 의 노트 템플릿)을 정의합니다——이 세 요소가 바로 도메인 전문가형 스킬의 전형적 구조입니다. 이 스킬은 로컬 책 파일에서 구조화된 노트——챕터 요약, 핵심 관점, 명구——를 추출해 포맷된 Markdown으로 저장합니다.

디렉터리 구조

book-summary/
├── SKILL.md                    # 워크플로 지시
├── templates/
│   └── note-template.md        # 독서 노트의 출력 형식
├── docs/
│   └── chapter-patterns.md     # 중국어·영어 책의 챕터 제목 식별 패턴
└── scripts/
    └── analyze-book.py         # Agent가 읽기 전에 책 파일을 전처리

왜 스크립트가 필요한가

책은 깁니다. 챕터 구조를 추출하려고 책 전체를 컨텍스트에 로드하는 것은 낭비이고 느립니다. 전처리 스크립트가 이를 해결합니다:

info 명령 — 앞 50줄을 읽어 책 제목, 인코딩, 총 줄 수를 식별한다
chapters 명령 — 전문을 읽지 않고 챕터 제목을 스캔해 줄 번호를 반환한다
extract 명령 — 특정 챕터의 내용만 읽어 Agent가 챕터별로 처리하게 한다

Agent는 워크플로의 각 단계에서 스크립트를 호출합니다. 컨텍스트에 들어가는 것은 스크립트의 출력뿐이며, 책 자체는 들어가지 않습니다.

왜 docs 파일이 필요한가

중국어와 영어 책은 챕터 제목 형식이 크게 다릅니다. 모든 식별 패턴을 SKILL.md 에 넣기보다 docs/chapter-patterns.md 에 저장하는 편이 낫습니다. Agent는 챕터 경계를 식별해야 할 때 이 파일을 읽고, 그 외에는 무시합니다. 참고 자료를 docs/ 에 두면 두 가지 이점이 있습니다: SKILL.md 를 워크플로 로직에 집중시킬 수 있고, 주 지시를 건드리지 않고 패턴을 업데이트할 수 있습니다.

왜 템플릿이 필요한가

출력 형식은 고정입니다: 모든 독서 노트는 같은 구조를 따릅니다——책 개요, 챕터 요약(핵심 관점과 명구 포함), 전체 하이라이트, 개인 고찰. 매번 프롬프트에서 형식을 다시 설명하기보다 templates/note-template.md 에 저장하는 편이 낫습니다. 5단계(최종 조립)를 실행할 때 Agent는 템플릿을 로드해 자리 표시자를 채웁니다. 형식은 매번 일관되고, 한 곳에서만 유지하면 됩니다.

SKILL.md가 지원 파일을 어떻게 참조하는가

SKILL.md 의 지시는 각 지원 파일을 명시적으로 가리킵니다:

### 단계 1: 책 구조 분석

전처리 스크립트를 실행해 책 정보를 얻는다:
  python3 scripts/analyze-book.py <파일 경로> info

### 단계 5: 노트 조립

템플릿에 따라 출력한다: templates/note-template.md

챕터 제목 식별 패턴은 다음을 참고: docs/chapter-patterns.md

효과적인 스킬 작성하기

description은 “언제 나를 쓰는지”를 쓰고 “무엇을 하는지”를 쓰지 않는다

이 둘은 비슷하게 들리지만 트리거 정확도에 큰 영향을 줍니다.

# 잘못——기능을 설명하며 트리거 조건이 아니다
description: This skill helps improve writing quality and checks chapters for common issues.

# 올바름——언제 활성화할지를 설명한다
description: Use when reviewing a completed chapter draft for pacing, voice, and consistency issues.

설명은 항상 컨텍스트에 상주 하며, 활성화된 모든 스킬이 지속적으로 token 예산을 소비합니다. 짧게, 정확하게, 트리거 상황을 직접 씁니다:

# 비효율(약 45 tokens)
description: |
  This skill helps you review and improve your writing chapters.
  It checks for common issues like pacing problems, character voice...
  Use this when you want to ensure your chapter quality before proceeding.

# 효율적(약 9 tokens)
description: Use when reviewing a chapter for quality issues.

완전한 단계, 입력, 출력, 정지 조건을 갖춘다

프로세스의 시작만 쓰고 명확한 완료 신호가 없는 스킬 지시는 Agent가 언제 멈출지 스스로 정하게 합니다——대개 당신이 원하는 지점이 아닙니다. 각 단계에는 다음이 있어야 합니다:

입력: 이 단계에 필요한 컨텍스트나 파일
출력: 이 단계가 만들어내는 것
정지 조건: 언제 확인을 기다리고 언제 계속하는지

본문에는 내비게이션과 핵심 제약만 두고, 큰 자료는 지원 파일로 분리한다

SKILL.md 본문은 5,000자 이내로 유지합니다. 스타일 참조, 식별 패턴, 인물 프로필 등 대량 자료가 필요하면 docs/ 하위 디렉터리에 두고 지시에서는 파일 이름으로 참조합니다——Agent는 필요할 때만 로드하고 그 외에는 컨텍스트를 차지하지 않습니다.

호출 빈도로 자동 트리거 여부를 정한다

사용 빈도	권장 전략
고빈도(세션당 1회 초과)	자동 트리거를 유지하고 설명을 최적화해 트리거를 더 정확하게
저빈도(세션당 1회 이하)	자동 트리거를 끄고 수동 호출, 설명은 컨텍스트에서 빼도 됨
극저빈도(월 1회 이하)	스킬을 제거하고 대신 SOLOENT.md에 문서로 기록

자주 빠지는 함정

문제	증상	고치는 법
설명이 너무 넓음	`description: help with writing`——모든 집필 요청이 트리거됨	구체적 상황으로 좁히고 실제 트리거 문구를 넣는다
본문이 너무 긺	수백 줄의 작업 매뉴얼을 통째로 `SKILL.md` 본문에 넣음	참고 자료를 `docs/` 로 분리하고 지시는 뼈대만 남긴다
하나의 스킬이 다섯 가지 일을 함	같은 스킬이 교열·이어쓰기·개요·인물 설계·진단을 모두 다룸	나눈다, 도메인마다 하나의 스킬로 만들어 개별로 켜고 끌 수 있게 한다

문제 해결

스킬이 기대한 대로 활성화되지 않음

가장 가능성 높은 원인: 설명이 충분히 구체적이지 않거나 스킬이 꺼져 있음.

스킬이 Skills 패널에서 켜져 있는지 확인한다
description 을 다시 써서 실제로 쓰는 문구와 작업 유형을 넣는다——“집필을 돕는다”로는 잘 트리거되지 않습니다. 구체적인 워크플로, 출력 유형, 예시 트리거 문장을 나열한다
스킬 디렉터리에 name 과 description 두 frontmatter 필드를 포함한 유효한 SKILL.md 가 있는지 확인한다
frontmatter의 name 이 디렉터리 이름과 정확히 일치 하는지 확인한다

스킬이 원치 않을 때 계속 활성화됨

설명이 너무 넓습니다——트리거하고 싶지 않은 요청에 일치합니다.

description 을 좁혀 이 스킬이 다루는 구체적 작업만 설명한다
어떤 스킬이 필요 없을 때는 Skills 패널에서 끈다
여러 스킬의 설명이 겹친다면 각 설명을 더 구체적으로 써서 각자의 적용 범위를 명확히 한다

스킬 지시가 무시되거나 일부만 실행됨

다음 흔한 문제를 확인하세요:

지시가 컨텍스트 한도를 초과했을 수 있음——SKILL.md 를 5,000자 이내로 유지하고 참고 자료를 docs/ 하위 디렉터리로 옮긴다
어떤 전역 또는 프로젝트 규칙이 스킬의 일부 동작을 덮어썼을 수 있음——현재 활성 규칙이 스킬 지시와 충돌하는지 확인한다
스킬이 체크리스트를 쓴다면 각 핵심 지점에 명확한 “확인 대기” 게이트가 있는지 확인한다. 없으면 Agent가 자동으로 진행한다
지시가 참조하는 지원 파일은 지정된 경로에 존재해야 한다——파일이 없으면 그 단계는 조용히 건너뛰어진다

지원 파일(템플릿, docs, 스크립트)이 로드되지 않음

Agent는 지시가 명시적으로 참조할 때만 지원 파일을 로드합니다.

지시의 파일 경로가 실제 위치와 일치하는지 확인한다(예: chapter-outline.md 가 아니라 templates/chapter-outline.md)
파일이 스킬 디렉터리 아래 올바른 하위 디렉터리(templates/, docs/, scripts/)에 있는지 확인한다
SKILL.md 에서 파일 이름으로 참조되지 않으면 Agent가 그것을 로드할 이유가 없다

프로젝트 스킬이 같은 이름의 전역 스킬과 충돌함

프로젝트 스킬은 항상 같은 이름의 전역 스킬보다 우선합니다.

이는 예상된 동작입니다——프로젝트 스킬이 활성이면 같은 이름의 전역 스킬은 완전히 무시됩니다
전역 스킬을 적용하려면 프로젝트 스킬의 이름을 바꾸거나 삭제하세요
둘 다 공존해야 한다면 서로 다른 이름을 주고 각자의 설명을 업데이트하세요

더 많은 고급 팁

Workflows(워크플로)

워크플로 파일로 반복되는 다단계 프로세스를 자동화하기

Rules(규칙)

당신의 집필 선호를 규칙에 기록해 Agent가 항상 당신의 스타일로 쓰게 하기

Rule·Workflow·Skill 선택법

세 가지 AI 지시 방식은 각기 다른 일을 맡는다——차이와 적합한 상황 알아보기

소개

빠른 시작

유연한 글쓰기

고품질 글쓰기

번역

구독 및 결제

무료 리소스

문제 해결

스킬의 작동 방식

스킬의 구조와 저장 위치

스킬 켜기/끄기

스킬 만들기

자주 쓰는 세 가지 스킬 유형

유형 1: 체크리스트형

유형 2: 워크플로형

유형 3: 도메인 전문가형

완전한 사례: 작품 요약

디렉터리 구조

왜 스크립트가 필요한가

왜 docs 파일이 필요한가

왜 템플릿이 필요한가

SKILL.md가 지원 파일을 어떻게 참조하는가

효과적인 스킬 작성하기

description은 “언제 나를 쓰는지”를 쓰고 “무엇을 하는지”를 쓰지 않는다

완전한 단계, 입력, 출력, 정지 조건을 갖춘다

본문에는 내비게이션과 핵심 제약만 두고, 큰 자료는 지원 파일로 분리한다

호출 빈도로 자동 트리거 여부를 정한다

자주 빠지는 함정

문제 해결

더 많은 고급 팁

Workflows(워크플로)

Rules(규칙)

Rule·Workflow·Skill 선택법

​스킬의 작동 방식

​스킬의 구조와 저장 위치

​스킬 켜기/끄기

​스킬 만들기

​자주 쓰는 세 가지 스킬 유형

​유형 1: 체크리스트형

​유형 2: 워크플로형

​유형 3: 도메인 전문가형

​완전한 사례: 작품 요약

​디렉터리 구조

​왜 스크립트가 필요한가

​왜 docs 파일이 필요한가

​왜 템플릿이 필요한가

​SKILL.md가 지원 파일을 어떻게 참조하는가

​효과적인 스킬 작성하기

​description은 “언제 나를 쓰는지”를 쓰고 “무엇을 하는지”를 쓰지 않는다

​완전한 단계, 입력, 출력, 정지 조건을 갖춘다

​본문에는 내비게이션과 핵심 제약만 두고, 큰 자료는 지원 파일로 분리한다

​호출 빈도로 자동 트리거 여부를 정한다

​자주 빠지는 함정

​문제 해결

​더 많은 고급 팁

Workflows(워크플로)

Rules(규칙)

Rule·Workflow·Skill 선택법

스킬의 작동 방식

스킬의 구조와 저장 위치

스킬 켜기/끄기

스킬 만들기

자주 쓰는 세 가지 스킬 유형

유형 1: 체크리스트형

유형 2: 워크플로형

유형 3: 도메인 전문가형

완전한 사례: 작품 요약

디렉터리 구조

왜 스크립트가 필요한가

왜 docs 파일이 필요한가

왜 템플릿이 필요한가

SKILL.md가 지원 파일을 어떻게 참조하는가

효과적인 스킬 작성하기

description은 “언제 나를 쓰는지”를 쓰고 “무엇을 하는지”를 쓰지 않는다

완전한 단계, 입력, 출력, 정지 조건을 갖춘다

본문에는 내비게이션과 핵심 제약만 두고, 큰 자료는 지원 파일로 분리한다

호출 빈도로 자동 트리거 여부를 정한다

자주 빠지는 함정

문제 해결

더 많은 고급 팁