Agent skill

Quest Design Patterns

by revfactory in revfactory/harness-100

퀘스트디자이너(quest-designer)가 사용하는 퀘스트 설계 패턴 전문 스킬. An agent skill from revfactory/harness-100.

Apache-2.0Auto-check passedDevelopment

Install Quest Design Patterns

skills CLI
$ npx skills add revfactory/harness-100 --skill quest-design-patterns -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install revfactory/harness-100 quest-design-patterns --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ko/05-game-narrative/.claude/skills/quest-design-patterns .claude/skills/quest-design-patterns && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
quest-design-patterns
GitHub stars
1.3k
Token cost
~936 tokens
SKILL.md length
475 words
Files
1
Skills in repo
464
Repo updated
First seen
Licence
Apache-2.0

At a glance

퀘스트디자이너(quest-designer)가 사용하는 퀘스트 설계 패턴 전문 스킬. An agent skill from revfactory/harness-100.

  • Tasks that involve Design patterns
  • SKILL.md covers 왜 패턴이 필요한가, 퀘스트 아키타입 12가지, 퀘스트 구조 설계: 3층 아키텍처 and 보상 심리학: DRIP 모델, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Quest Design Patterns is an agent skill from revfactory/harness-100. 퀘스트디자이너(quest-designer)가 사용하는 퀘스트 설계 패턴 전문 스킬. 퀘스트 아키타입, 보상 심리학, 난이도 곡선, 플레이어 동기 부여 프레임워크를 제공한다. '퀘스트 설계', '보상 체계', '미션 구조', '퀘스트 패턴' 등에 활용한다.

Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Design patterns. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Design patterns

Example prompts

  • “/quest-design-patterns”

What it can do on your machine

Read from SKILL.md and the folder at commit 8e8d35c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Quest Design Patterns loads about 936 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 475 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~936

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from revfactory/harness-100 at commit 8e8d35c, republished under its Apache-2.0 licence (© revfactory). 475 words, ~936 tokens.

Download SKILL.mdSave it as .claude/skills/quest-design-patterns/SKILL.md (or your agent's skills folder).
name
quest-design-patterns
description
퀘스트디자이너(quest-designer)가 사용하는 퀘스트 설계 패턴 전문 스킬. 퀘스트 아키타입, 보상 심리학, 난이도 곡선, 플레이어 동기 부여 프레임워크를 제공한다. '퀘스트 설계', '보상 체계', '미션 구조', '퀘스트 패턴' 등에 활용한다.

Quest Design Patterns — 퀘스트 설계 패턴 방법론

quest-designer 에이전트가 메인/사이드 퀘스트를 설계할 때 활용하는 게임 디자인 전문 지식.

왜 패턴이 필요한가

퀘스트는 게임의 서사와 게임플레이를 연결하는 접착제다. "가서 10마리 잡아와"만 반복하면 플레이어는 이탈한다. 다양한 구조적 패턴을 조합해야 플레이어가 "한 퀘스트만 더"를 반복하게 된다.

퀘스트 아키타입 12가지

전투/행동 계열
#아키타입핵심 루프서사적 기능위험 요소
1사냥특정 대상 처치위협 제거, 영웅성 증명단순 반복이 되기 쉬움 → 타깃에 스토리 부여
2방어거점/NPC 보호책임감, 시간 압박실패 시 좌절감 → 부분 성공 옵션 제공
3추격도망치는 대상 추적긴장감, 시공간 활용반복 실패 → 단계별 단서로 난이도 조절
탐색/발견 계열
#아키타입핵심 루프서사적 기능위험 요소
4탐험미지 영역 발견세계관 확장, 호기심방향감 상실 → 환경 스토리텔링으로 유도
5수집아이템/정보 모으기세계 이해 심화지루한 심부름 → 각 아이템에 미니 서사
6수수께끼퍼즐/암호 해결지적 성취감, 세계 규칙 학습막힘 → 힌트 시스템 단계적 제공
사회/관계 계열
#아키타입핵심 루프서사적 기능위험 요소
7호위NPC와 동행관계 형성, 캐릭터 발전느린 NPC → AI 행동 품질 확보
8협상대화로 해결세력 관계 탐구, 롤플레이정답이 뻔함 → 모든 선택에 대가 부여
9배달물건/정보 전달세계 이동, NPC 네트워크단순 이동 → 이동 중 이벤트 삽입
변형/복합 계열
#아키타입핵심 루프서사적 기능위험 요소
10잠입발각 없이 목표 달성긴장감, 대안적 플레이발각=실패 금지 → 발각 시 전투 전환
11경쟁NPC/플레이어와 경쟁성취감, 사회적 비교불공정 → 시각적 진행 표시
12딜레마양립 불가 선택도덕적 무게, 플레이어 정체성정답 존재 → 모든 선택이 일장일단

퀘스트 구조 설계: 3층 아키텍처

[표면층] 플레이어가 보는 것: "마을 장로가 약초를 구해달라고 한다"
[기계층] 게임이 추적하는 것: 이동→수집→전투→귀환 + 플래그 변경
[서사층] 이야기가 전달하는 것: 장로의 숨겨진 과거, 약초의 진짜 용도
표면층 설계 규칙
  • 목표가 즉시 이해되어야 한다 — "무엇을 해야 하는가"가 3초 안에 파악
  • 목표 달성 경로가 2가지 이상 있어야 한다 — 전투/잠입/설득
  • 진행 상황이 눈에 보여야 한다 — 0/5 → 3/5 → 완료
Show full SKILL.md (193 more words)Show less
기계층 설계 규칙
  • 퀘스트 스텝은 3~7단계 (3 미만: 너무 단순, 7 초과: 피로)
  • 각 스텝은 다른 게임 메카닉을 활용 — 전투→대화→탐색 변주
  • 실패 상태를 정의한다 — 실패 시 어떻게 되는가? (리트라이/분기/영구 결과)
서사층 설계 규칙
  • 퀘스트 완료 후 플레이어가 세계에 대해 새로운 것을 1개 이상 알게 된다
  • NPC의 요청에는 숨겨진 동기가 있다 — 표면적 이유와 진짜 이유
  • 퀘스트 결과가 이후 퀘스트에 영향을 미친다 — 고립된 퀘스트 금지

보상 심리학: DRIP 모델

요소설명적용
Delayed지연 보상 — 즉각적이지 않은 보상메인 퀘스트 보상은 챕터 끝에
Random랜덤 보상 — 변동비율 강화전리품 확률 시스템
Intrinsic내적 보상 — 스토리, 캐릭터 성장감동적 컷신, 관계 변화
Progressive점진적 보상 — 누적되는 성취도전과제, 칭호, 스킬트리
보상 밸런스 공식
퀘스트 보상 가치 = (소요 시간 x 기본 보상률) x 난이도 계수 x 선택 보너스

- 기본 보상률: 분당 경험치/골드 기준선
- 난이도 계수: 쉬움(0.8), 보통(1.0), 어려움(1.5), 숨겨진(2.0)
- 선택 보너스: 추가 목표/도덕적 선택 완수 시 1.2~1.5배

난이도 곡선 설계

이상적 난이도 곡선: 톱니 패턴
난이도
  ↑
  │    /\      /\        /\
  │   /  \    /  \      /  \
  │  /    \  /    \    /    \    ← 각 톱니 = 퀘스트 체인
  │ /      \/      \  /      \
  │/                \/        \
  └───────────────────────────→ 진행도
  • 각 톱니의 꼭짓점: 보스 전투 또는 핵심 분기
  • 각 톱니의 골짜기: 회복 퀘스트, 스토리 전개, 탐색
  • 전체 기울기: 서서히 상승 — 챕터 1 최고 난이도 < 챕터 3 최저 난이도
메인 vs 사이드 퀘스트 배치
진행도메인 퀘스트사이드 퀘스트 역할
0~20%튜토리얼 + 세계 소개기본 메카닉 학습
20~40%첫 번째 위기세력/인물 깊이 추가
40~60%반전 + 새로운 목표숨겨진 서사 발견
60~80%최종 준비핵심 아이템/동맹 확보
80~100%클라이맥스 + 엔딩후일담, 히든 콘텐츠

퀘스트 문서 템플릿

### 퀘스트: [제목]
- **ID**: Q_[챕터]_[번호]
- **유형**: 메인 / 사이드 / 히든
- **아키타입**: [12가지 중 선택]
- **선행 퀘스트**: Q_XX_XX
- **추천 레벨**: Lv.XX

#### 개요
[1~2문장 요약]

#### 트리거 조건
[퀘스트 시작 조건]

#### 스텝
1. [행동] — [게임 메카닉] — [서사 기능]
2. ...

#### 분기
- 선택 A: [결과] → [후속 영향]
- 선택 B: [결과] → [후속 영향]

#### 보상
- 경험치: X / 골드: X / 아이템: [이름]
- 서사 보상: [관계 변화, 새로운 정보]

#### 플래그 변경
- SET: [flag_name] = [value]

© revfactory, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in ko/05-game-narrative/.claude/skills/quest-design-patterns of revfactory/harness-100.

Open the folder on GitHubat commit 8e8d35c

Compare with similar skills

Quest Design Patterns next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Quest Design Patterns compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Quest Design Patterns this skillrevfactory/harness-1001.3k—~936Automated safety check: PassApache-2.0
Swiftui View RefactorDimillian/Skills4k5 repos~2kAutomated safety check: PassMIT
RTK Rust Design Patternsrtk-ai/rtk83k—~1.9kAutomated safety check: PassApache-2.0
Effect Client WrapperUsefulSoftwareCo/executor4.1k1 repos~1.4kAutomated safety check: PassMIT
Architecture PatternsKartikLabhshetwar/better-shot2.4k2 repos~1.4kAutomated safety check: PassCustom licence
GitVersion .NET DevelopmentGitTools/GitVersion3.1k—~1.7kAutomated safety check: PassMIT

Similar skills

  • Swiftui View Refactor

    Dimillian/Skills

    Refactor and review SwiftUI view files with strong defaults for small dedicated subviews, MV-over-MVVM data flow, stable view trees, explicit dependency injection, and correct Observation usage.

    4k GitHub starsUsed in 5 repos~2k tokens
    DevelopmentAuto-check passed
  • Describes seven Rust design patterns for the RTK CLI filter modules, with when to use each, RTK examples, and notes on when a pattern is overkill.

    83k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Effect Client Wrapper

    UsefulSoftwareCo/executor

    Pattern for wrapping third-party SDK clients (Stripe, Resend, AWS, etc.) with Effect.

    4.1k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • Architecture Patterns

    KartikLabhshetwar/better-shot

    Deep dive into software architecture for macOS. An agent skill from KartikLabhshetwar/better-shot.

    2.4k GitHub starsUsed in 2 repos~1.4k tokens
    DevelopmentAuto-check passed
  • GitVersion .NET Development

    GitTools/GitVersion

    Gives repository-specific .NET guidance for GitVersion: build and test commands, central package management, project layout and coding conventions.

    3.1k GitHub stars~1.7k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Official

    Replaces a plain TypeScript union plus switch statements with frozen subclasses and a visitor interface when several places dispatch on the same variants.

    48k GitHub stars~830 tokensUpdated today
    DevelopmentAuto-check passed

More from revfactory/harness-100

All 464 skills in this repo
  • Anti Bot Analyzer

    revfactory/harness-100

    A skill for analyzing website anti-bot defense mechanisms and developing legitimate evasion strategies.

    1.3k GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed
  • API Error Design Patterns

    revfactory/harness-100

    Reference for designing how an API reports failures: structured error codes, response shapes, client-friendly messages, an error catalog and retry or fallback advice.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed
  • API Security Checklist

    revfactory/harness-100

    Walks a backend-dev agent through OWASP API Top 10 checks, authentication and authorization patterns, and defense code during API design.

    1.3k GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Arg Parser Generator

    revfactory/harness-100

    Methodology for systematically designing and generating CLI tool argument parser structures.

    1.3k GitHub stars~1.2k tokensUpdated 6 mo ago
    Auto-check passed
  • Audience Segmentation

    revfactory/harness-100

    Audience segmentation skill used by the analyst and curator agents.

    1.3k GitHub stars~1.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Audio Storytelling

    revfactory/harness-100

    Audio storytelling skill used by the podcast scriptwriter and show note editor.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about Quest Design Patterns

What does Quest Design Patterns do?

퀘스트디자이너(quest-designer)가 사용하는 퀘스트 설계 패턴 전문 스킬. An agent skill from revfactory/harness-100. Quest Design Patterns is an agent skill from revfactory/harness-100. 퀘스트디자이너(quest-designer)가 사용하는 퀘스트 설계 패턴 전문 스킬.

When should I use Quest Design Patterns?

Quest Design Patterns fits situations like: tasks that involve Design patterns.

How do I install Quest Design Patterns in Claude Code?

Run `npx skills add revfactory/harness-100 --skill quest-design-patterns -a claude-code`. Or copy the skill folder (ko/05-game-narrative/.claude/skills/quest-design-patterns in revfactory/harness-100) into .claude/skills/quest-design-patterns in your project. Claude Code loads it when a task matches its description.

How do I install Quest Design Patterns in Codex?

Run `npx skills add revfactory/harness-100 --skill quest-design-patterns -a codex`. Or copy the skill folder (ko/05-game-narrative/.claude/skills/quest-design-patterns in revfactory/harness-100) into .agents/skills/quest-design-patterns in your project. Codex loads it when a task matches its description.

Can I use Quest Design Patterns in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add revfactory/harness-100 --skill quest-design-patterns -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/quest-design-patterns, .gemini/skills/quest-design-patterns, .github/skills/quest-design-patterns and .opencode/skills/quest-design-patterns in your project.

What does Quest Design Patterns need to run?

SKILL.md names no scripts, command-line tools or credentials: Quest Design Patterns is instructions for the agent only.

Does Quest Design Patterns access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Quest Design Patterns safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Quest Design Patterns use?

Quest Design Patterns is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Quest Design Patterns use?

About 936 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Quest Design Patterns?

Skills that share tags, products or a category with Quest Design Patterns: Swiftui View Refactor (Dimillian/Skills, 4k stars), RTK Rust Design Patterns (rtk-ai/rtk, 83k stars), Effect Client Wrapper (UsefulSoftwareCo/executor, 4.1k stars) and Architecture Patterns (KartikLabhshetwar/better-shot, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Quest Design Patterns?

revfactory (a GitHub user) maintains it in revfactory/harness-100, which has 1,290 GitHub stars. The repository holds 464 skills in this directory. The repository was last updated on March 22, 2026.

Source: revfactory/harness-100 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.