Agent skill

Knowledge Base Design

by revfactory in revfactory/harness-100

지식 베이스 구축 가이드. An agent skill from revfactory/harness-100.

Apache-2.0Auto-check passedSales & Support

Install Knowledge Base Design

skills CLI
$ npx skills add revfactory/harness-100 --skill knowledge-base-design -a claude-code

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

GitHub CLI
$ gh skill install revfactory/harness-100 knowledge-base-design --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/92-operations-manual/.claude/skills/knowledge-base-design .claude/skills/knowledge-base-design && 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
knowledge-base-design
GitHub stars
1.3k
Token cost
~514 tokens
SKILL.md length
157 words
Files
1
Skills in repo
464
Repo updated
First seen
Licence
Apache-2.0

At a glance

지식 베이스 구축 가이드. An agent skill from revfactory/harness-100.

  • Tasks that involve Help center and FAQ content
  • SKILL.md covers FAQ 설계 원칙, 트러블슈팅 가이드 구조, 지식 관리 수명주기 and 검색성 최적화, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Knowledge bases

What it does

Knowledge Base Design is an agent skill from revfactory/harness-100. 지식 베이스 구축 가이드. faq-builder와 manual-writer 에이전트가 FAQ, 트러블슈팅 가이드를 체계적으로 구성할 때 참조. 'FAQ 설계', '지식 관리', '트러블슈팅 가이드' 요청 시 사용. 단, 위키 시스템 구축은 범위 밖.

Its SKILL.md is about 510 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 Sales & Support, covering Help center and FAQ content and Knowledge bases. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Help center and FAQ content
  • Tasks that involve Knowledge bases

Example prompts

  • “FAQ 설계”
  • “/knowledge-base-design”

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 (its code samples are markdown and mermaid).

    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

Knowledge Base Design loads about 514 tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 157 words of instructions outside code blocks.

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

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). 157 words, ~514 tokens.

Download SKILL.mdSave it as .claude/skills/knowledge-base-design/SKILL.md (or your agent's skills folder).
name
knowledge-base-design
description
지식 베이스 구축 가이드. faq-builder와 manual-writer 에이전트가 FAQ, 트러블슈팅 가이드를 체계적으로 구성할 때 참조. 'FAQ 설계', '지식 관리', '트러블슈팅 가이드' 요청 시 사용. 단, 위키 시스템 구축은 범위 밖.

Knowledge Base Design — 지식 베이스 구축 가이드

faq-builder / manual-writer 에이전트의 지식 체계화 역량 강화.

FAQ 설계 원칙

FAQ 카테고리 설계
1단계: 사용자 여정 기반 분류
  시작하기 → 기본 사용 → 고급 기능 → 트러블슈팅 → 관리

2단계: 각 카테고리 5~10개 질문
  - 빈도 높은 순 정렬
  - 질문은 사용자 언어로

3단계: 크로스 레퍼런스
  - 관련 FAQ 간 링크
  - 매뉴얼 해당 섹션 링크
FAQ 작성 템플릿
markdown
## Q: [사용자가 실제로 묻는 형태의 질문]

**A:** [1~2문장 핵심 답변]

[필요 시 상세 설명]

**단계:**
1. [구체적 행동 1]
2. [구체적 행동 2]
3. [구체적 행동 3]

> 참고: [관련 매뉴얼 섹션 링크]
> 관련 질문: [관련 FAQ 링크]
FAQ 품질 규칙
규칙설명
질문 = 사용자 언어전문용어 아닌 일상 표현
답변 = 1줄 요약 + 상세스캔하기 쉽게
1 FAQ = 1 주제복합 질문은 분리
스크린샷/다이어그램시각적 설명 포함
갱신 날짜마지막 검증일 명시

트러블슈팅 가이드 구조

증상 기반 진단 트리
mermaid
flowchart TD
    S([증상: X가 안 됩니다]) --> Q1{네트워크 연결 상태?}
    Q1 -->|연결됨| Q2{로그인 상태?}
    Q1 -->|안됨| FIX1[네트워크 확인 → 재시도]
    Q2 -->|로그인됨| Q3{권한 있는가?}
    Q2 -->|안됨| FIX2[재로그인]
    Q3 -->|있음| FIX3[캐시 삭제 → 재시도]
    Q3 -->|없음| FIX4[관리자에게 권한 요청]
트러블슈팅 카드 템플릿
markdown
## 문제: [증상 설명]

### 영향
- 영향 범위: [전체/부분/개인]
- 긴급도: [즉시/24시간/72시간]

### 원인 후보
| # | 원인 | 확률 | 확인 방법 |
|---|------|------|----------|
| 1 | [가장 흔한 원인] | 높음 | [확인 명령/방법] |
| 2 | [두 번째 원인] | 중간 | [확인 명령/방법] |
| 3 | [드문 원인] | 낮음 | [확인 명령/방법] |

### 해결 절차
**원인 1일 경우:**
1. [단계 1]
2. [단계 2]
3. 확인: [성공 기준]

### 에스컬레이션
- 30분 내 미해결 → [L2 담당자]
- 서비스 장애 → [긴급 연락처]

지식 관리 수명주기

단계활동주기
생성신규 절차/FAQ 작성수시
검토정확성/최신성 확인분기
갱신변경사항 반영수시
폐기불필요 문서 아카이브연간
측정조회수, 유용성, 피드백월간

검색성 최적화

기법설명
키워드 태깅사용자 검색어 기반 태그
동의어 매핑"안 됨" = "오류" = "에러"
카테고리 계층최대 3단계
관련 문서 링크상호 참조 5개 이내
요약 (Excerpt)검색 결과에 표시될 요약

품질 체크리스트

항목기준
FAQ 수카테고리당 5~10개
트러블슈팅상위 10개 문제 커버
진단 트리3단계 이내 해결 도달
에스컬레이션시간 기준 명시
갱신 날짜모든 문서에 표시

© 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/92-operations-manual/.claude/skills/knowledge-base-design of revfactory/harness-100.

Open the folder on GitHubat commit 8e8d35c

Compare with similar skills

Knowledge Base Design 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.

Knowledge Base Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Knowledge Base Design this skillrevfactory/harness-1001.3k—~514Automated safety check: PassApache-2.0
Firecrawl Knowledge Ingestfirecrawl/skills115—~565Automated safety check: PassISC
Update Knowledge Baseamplitude/builder-skills159—~746Automated safety check: PassNone
Cs Kb Articleevolution-foundation/evo-nexus544—~3.4kAutomated safety check: PassCustom licence
Kb Auditmohitagw15856/pm-claude-skills1.4k—~959Automated safety check: PassMIT
Knowledge Managementw95/awesome-claude-corporate-skills235—~2.4kAutomated safety check: PassMIT

Similar skills

  • Ingest public or authenticated knowledge bases and docs portals with Firecrawl browser.

    115 GitHub stars~565 tokensUpdated today
    Sales & SupportAuto-check passed
  • Update Knowledge Base

    amplitude/builder-skills

    Cross-reference recently shipped tickets against your help center and changelog to detect outdated articles, missing documentation, and undocumented features.

    159 GitHub stars~746 tokensUpdated 2 mo ago
    Sales & SupportAuto-check passed
  • Cs Kb Article

    evolution-foundation/evo-nexus

    Redige um artigo para base de conhecimento a partir de um problema resolvido ou pergunta frequente.

    544 GitHub stars~3.4k tokensUpdated 4 mo ago
    Sales & SupportAuto-check passed
  • Kb Audit

    mohitagw15856/pm-claude-skills

    Audit a knowledge base / help center for coverage, accuracy, and findability.

    1.4k GitHub stars~959 tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Knowledge Management

    w95/awesome-claude-corporate-skills

    Write and maintain knowledge base articles from resolved support issues.

    235 GitHub stars~2.4k tokensUpdated 7 mo ago
    Sales & SupportAuto-check passed
  • Yao Geo Page Blueprint

    yaojingang/yao-geo-skills

    A skill your agent uses when the user needs a GEO-friendly page blueprint for a specific product, topic, article, ranking, comparison, FAQ, knowledge-base, or case page, especially when the work…

    864 GitHub stars~789 tokensUpdated 6 days ago
    Writing & ContentAuto-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

Questions about Knowledge Base Design

What does Knowledge Base Design do?

지식 베이스 구축 가이드. An agent skill from revfactory/harness-100. Knowledge Base Design is an agent skill from revfactory/harness-100. 지식 베이스 구축 가이드.

When should I use Knowledge Base Design?

Knowledge Base Design fits situations like: tasks that involve Help center and FAQ content; tasks that involve Knowledge bases.

How do I install Knowledge Base Design in Claude Code?

Run `npx skills add revfactory/harness-100 --skill knowledge-base-design -a claude-code`. Or copy the skill folder (ko/92-operations-manual/.claude/skills/knowledge-base-design in revfactory/harness-100) into .claude/skills/knowledge-base-design in your project. Claude Code loads it when a task matches its description.

How do I install Knowledge Base Design in Codex?

Run `npx skills add revfactory/harness-100 --skill knowledge-base-design -a codex`. Or copy the skill folder (ko/92-operations-manual/.claude/skills/knowledge-base-design in revfactory/harness-100) into .agents/skills/knowledge-base-design in your project. Codex loads it when a task matches its description.

Can I use Knowledge Base Design 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 knowledge-base-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/knowledge-base-design, .gemini/skills/knowledge-base-design, .github/skills/knowledge-base-design and .opencode/skills/knowledge-base-design in your project.

What does Knowledge Base Design need to run?

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

Does Knowledge Base Design 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 Knowledge Base Design 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 Knowledge Base Design use?

Knowledge Base Design 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 Knowledge Base Design use?

About 514 tokens (SKILL.md is roughly 2.1k 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 Knowledge Base Design?

Skills that share tags, products or a category with Knowledge Base Design: Firecrawl Knowledge Ingest (firecrawl/skills, 115 stars), Update Knowledge Base (amplitude/builder-skills, 159 stars), Cs Kb Article (evolution-foundation/evo-nexus, 544 stars) and Kb Audit (mohitagw15856/pm-claude-skills, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Knowledge Base Design?

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.