Agent skill

Knowledge Base Design

Knowledge base design guide. An agent skill from revfactory/harness-100.

Apache-2.0Auto-check passedKnowledge Management

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/en/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/

Paste into Claude Code

Install the "knowledge-base-design" agent skill from https://github.com/revfactory/harness-100/tree/main/en/92-operations-manual/.claude/skills/knowledge-base-design into .claude/skills/knowledge-base-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "knowledge-base-design", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/revfactory/harness-100/tree/main/en/92-operations-manual/.claude/skills/knowledge-base-design

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add revfactory/harness-100 --skill knowledge-base-design -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install revfactory/harness-100 knowledge-base-design --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .agents/skills && cp -r skills-src/en/92-operations-manual/.claude/skills/knowledge-base-design .agents/skills/knowledge-base-design && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "knowledge-base-design" agent skill from https://github.com/revfactory/harness-100/tree/main/en/92-operations-manual/.claude/skills/knowledge-base-design into .agents/skills/knowledge-base-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "knowledge-base-design", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add revfactory/harness-100 --skill knowledge-base-design -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install revfactory/harness-100 knowledge-base-design --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/en/92-operations-manual/.claude/skills/knowledge-base-design .cursor/skills/knowledge-base-design && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "knowledge-base-design" agent skill from https://github.com/revfactory/harness-100/tree/main/en/92-operations-manual/.claude/skills/knowledge-base-design into .cursor/skills/knowledge-base-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "knowledge-base-design", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/revfactory/harness-100.git --path en/92-operations-manual/.claude/skills/knowledge-base-design

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add revfactory/harness-100 --skill knowledge-base-design -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install revfactory/harness-100 knowledge-base-design --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/en/92-operations-manual/.claude/skills/knowledge-base-design .gemini/skills/knowledge-base-design && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "knowledge-base-design" agent skill from https://github.com/revfactory/harness-100/tree/main/en/92-operations-manual/.claude/skills/knowledge-base-design into .gemini/skills/knowledge-base-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "knowledge-base-design", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install revfactory/harness-100 knowledge-base-design

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add revfactory/harness-100 --skill knowledge-base-design -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .github/skills && cp -r skills-src/en/92-operations-manual/.claude/skills/knowledge-base-design .github/skills/knowledge-base-design && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "knowledge-base-design" agent skill from https://github.com/revfactory/harness-100/tree/main/en/92-operations-manual/.claude/skills/knowledge-base-design into .github/skills/knowledge-base-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "knowledge-base-design", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add revfactory/harness-100 --skill knowledge-base-design -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install revfactory/harness-100 knowledge-base-design --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/en/92-operations-manual/.claude/skills/knowledge-base-design .opencode/skills/knowledge-base-design && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "knowledge-base-design" agent skill from https://github.com/revfactory/harness-100/tree/main/en/92-operations-manual/.claude/skills/knowledge-base-design into .opencode/skills/knowledge-base-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "knowledge-base-design", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: knowledge-base-design
GitHub stars: 1.3k
Token cost: ~897 tokens
SKILL.md length: 167 words
Files: 1
Skills in repo: 464
Repo updated: Mar 22, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Knowledge base design guide. An agent skill from revfactory/harness-100.

Tasks that involve Help center and FAQ content
SKILL.md covers FAQ Design Principles, Troubleshooting Guide Structure, Knowledge Management Lifecycle and Search Optimization, 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. Knowledge base design guide. Referenced by faq-builder and manual-writer agents when systematically organizing FAQs and troubleshooting guides. Used for 'FAQ design', 'knowledge management', 'troubleshooting guide' requests. Note: wiki system implementation is out of scope.

Its SKILL.md is about 900 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 Knowledge Management, 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 design”
“knowledge management”
“troubleshooting guide”
“/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 897 tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 167 words of instructions outside code blocks.

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

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). 167 words, ~897 tokens.

Download SKILL.mdSave it as .claude/skills/knowledge-base-design/SKILL.md (or your agent's skills folder).

name: knowledge-base-design
description: Knowledge base design guide. Referenced by faq-builder and manual-writer agents when systematically organizing FAQs and troubleshooting guides. Used for 'FAQ design', 'knowledge management', 'troubleshooting guide' requests. Note: wiki system implementation is out of scope.

Knowledge Base Design

Enhances the knowledge systematization capabilities of faq-builder / manual-writer agents.

FAQ Design Principles

FAQ Category Design

Step 1: User journey-based classification
  Getting started → Basic usage → Advanced features → Troubleshooting → Administration

Step 2: 5-10 questions per category
  - Sort by frequency (highest first)
  - Write questions in user language

Step 3: Cross-references
  - Link between related FAQs
  - Link to corresponding manual sections

FAQ Writing Template

markdown

## Q: [Question in the form users actually ask]

**A:** [1-2 sentence key answer]

[Detailed explanation if needed]

**Steps:**
1. [Specific action 1]
2. [Specific action 2]
3. [Specific action 3]

> Reference: [Link to related manual section]
> Related question: [Link to related FAQ]

FAQ Quality Rules

Rule	Description
Question = User language	Everyday expressions, not jargon
Answer = 1-line summary + details	Easy to scan
1 FAQ = 1 topic	Split compound questions
Screenshots/diagrams	Include visual explanations
Updated date	Specify last verified date

Troubleshooting Guide Structure

Symptom-Based Diagnostic Tree

mermaid

flowchart TD
    S([Symptom: X is not working]) --> Q1{Network connection?}
    Q1 -->|Connected| Q2{Logged in?}
    Q1 -->|Not connected| FIX1[Check network → Retry]
    Q2 -->|Logged in| Q3{Has permissions?}
    Q2 -->|Not logged in| FIX2[Re-login]
    Q3 -->|Yes| FIX3[Clear cache → Retry]
    Q3 -->|No| FIX4[Request permissions from admin]

Troubleshooting Card Template

markdown

## Problem: [Symptom description]

### Impact
- Scope: [All/Partial/Individual]
- Urgency: [Immediate/24 hours/72 hours]

### Possible Causes
| # | Cause | Likelihood | How to Verify |
|---|-------|-----------|---------------|
| 1 | [Most common cause] | High | [Verification command/method] |
| 2 | [Second cause] | Medium | [Verification command/method] |
| 3 | [Rare cause] | Low | [Verification command/method] |

### Resolution Steps
**If Cause 1:**
1. [Step 1]
2. [Step 2]
3. Verify: [Success criteria]

### Escalation
- Not resolved within 30 min → [L2 owner]
- Service outage → [Emergency contact]

Knowledge Management Lifecycle

Phase	Activity	Frequency
Create	Write new procedures/FAQs	As needed
Review	Verify accuracy/currency	Quarterly
Update	Reflect changes	As needed
Retire	Archive obsolete documents	Annually
Measure	Views, usefulness, feedback	Monthly

Search Optimization

Technique	Description
Keyword tagging	Tags based on user search terms
Synonym mapping	"not working" = "error" = "failure"
Category hierarchy	Maximum 3 levels
Related document links	Up to 5 cross-references
Summary (Excerpt)	Summary displayed in search results

Quality Checklist

Item	Criteria
FAQ count	5-10 per category
Troubleshooting	Covers top 10 issues
Diagnostic tree	Resolution reached in 3 steps or fewer
Escalation	Time-based criteria specified
Updated date	Displayed on all documents

Files

Just SKILL.md in en/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
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Knowledge Base Design this skillrevfactory/harness-100	1.3k	—	~897	Automated safety check: Pass	Apache-2.0	6 mo ago
Internal Wiki PageFerroxLabs/wayland	608	—	~3.6k	Automated safety check: Pass	Apache-2.0	yesterday
Wellally Techhuifer/WellAlly-health	960	5 repos	~4.8k	Automated safety check: Pass	MIT	2 mo ago
Knowledge Base For Startupsaws/agent-toolkit-for-aws	2.8k	—	~2.9k	Automated safety check: Pass	Apache-2.0	today
Knowledge Base WriterFerroxLabs/wayland	608	—	~4.1k	Automated safety check: Pass	Apache-2.0	yesterday
Yao Geo Knowledge Base Builderyaojingang/yao-geo-skills	864	—	~1.8k	Automated safety check: Pass	MIT	6 days ago

Similar skills

Internal Wiki Page
FerroxLabs/wayland
Creates internal documentation pages with context, process descriptions, decision rationale, ownership, and cross-references for team wikis and knowledge management systems.
608 GitHub stars~3.6k tokensUpdated yesterday
Knowledge ManagementAuto-check passed
Wellally Tech
huifer/WellAlly-health
Integrate digital health data sources (Apple Health, Fitbit, Oura Ring) and connect to WellAlly.tech knowledge base.
960 GitHub starsUsed in 5 repos~4.8k tokens
Knowledge ManagementAuto-check passed
Knowledge Base For Startups
aws/agent-toolkit-for-aws
Official
AWS Startups reference content — Activate FAQ, credits guide, programs, partner offers, sample architectures, and hundreds of learn articles spanning generative AI, cloud architecture, cost…
2.8k GitHub stars~2.9k tokensUpdated today
Knowledge ManagementAuto-check passed
Knowledge Base Writer
FerroxLabs/wayland
Expert knowledge base articles covering article taxonomy, search optimization, troubleshooting article format, how-to article format, conceptual article format, FAQ design, article templates…
608 GitHub stars~4.1k tokensUpdated yesterday
Knowledge ManagementAuto-check passed
Yao Geo Knowledge Base Builder
yaojingang/yao-geo-skills
Build evidence-backed GEO brand knowledge bases from official sites, product pages, help centers, white papers, sales materials, media releases, certifications, and trusted third-party sources.
864 GitHub stars~1.8k tokensUpdated 6 days ago
Knowledge ManagementAuto-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

Questions about Knowledge Base Design

What does Knowledge Base Design do?

Knowledge base design guide. An agent skill from revfactory/harness-100. Knowledge Base Design is an agent skill from revfactory/harness-100. Knowledge base design guide.

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 (en/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 (en/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 897 tokens (SKILL.md is roughly 3.6k 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: Internal Wiki Page (FerroxLabs/wayland, 608 stars), Wellally Tech (huifer/WellAlly-health, 960 stars), Knowledge Base For Startups (aws/agent-toolkit-for-aws, 2.8k stars) and Knowledge Base Writer (FerroxLabs/wayland, 608 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.

Install Knowledge Base Design

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Knowledge Base Design

FAQ Design Principles

FAQ Category Design

FAQ Writing Template

FAQ Quality Rules

Troubleshooting Guide Structure

Symptom-Based Diagnostic Tree

Troubleshooting Card Template

Knowledge Management Lifecycle

Search Optimization

Quality Checklist

Files

Compare with similar skills

Similar skills

More from revfactory/harness-100

Related

Questions about Knowledge Base Design