# Repo Wiki Generate

> Generate citation-backed documentation pages from code index. Creates markdown content with file path and line number citations for every technical claim.

- Skill: `boweneos/repo-wiki-generate` (Agent Skill)
- Install (CLI): `npx skillmds@latest add boweneos/repo-wiki-generate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/boweneos/repo-wiki-generate/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: MIT
- Author: boweneos (https://skillmd.com/u/boweneos)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/boweneos/repo-wiki-generate

---


# Repo Wiki Generate Pages Skill

Generate citation-backed markdown documentation from the code index.

## Purpose

This skill transforms the code index into comprehensive documentation pages with:

1. Technical accuracy backed by source code citations
2. File paths and exact line ranges for every claim
3. Clickable permalinks to source code
4. Structured markdown with managed blocks

## When to Use

Use this skill:

- After running `repo-wiki-index`
- To fill in placeholder pages with actual content
- When generating documentation for the first time

## Step-by-Step Instructions

### Step 1: Load Index and Configuration

Load `.repo_wiki/code_index.json` and `.repo_wiki/state.json`.

### Step 2: Determine Citation Format

Choose between footnote or inline style based on config.

### Step 3: Generate Component Pages

For each component, create documentation with:
- Overview and purpose
- Key files with citations
- Public interfaces
- Configuration options

### Step 4: Generate Architecture Overview

Create system-level documentation with statistics and component relationships.

### Step 5: Generate Getting Started Pages

Document setup, installation, and running instructions.

### Step 6: Update Manifest

Track all citations in `.repo_wiki/manifest.json`.

## Citation Format

```markdown
The service starts an HTTP server[^1].

[^1]: [src/server.ts#L12-L48](https://github.com/org/repo/blob/abc1234/src/server.ts#L12-L48)
```

## Success Criteria

- ✅ All component pages have content
- ✅ Every technical claim has a citation
- ✅ Citations include file paths and line ranges
- ✅ MkDocs builds without errors

## Next Steps

After generation:
1. **Validate output**: Read `repo-wiki-validate/SKILL.md`