mcpField
W
wiki-architect

wiki-architect

github.com/sickn33Documents48.7k119 installsUpdated today
Repository

About wiki-architect

A skill for creating structured wiki catalogues and onboarding guides from codebases. It scans repository structure, organizes documentation by audience and depth, and requires prompts to cite real files.

Key features

  1. 01Repository and README scanning
  2. 02Architecture and layer identification
  3. 03Hierarchical JSON catalogue
  4. 04Onboarding guide structure
  5. 05File-and-line references
  6. 06Repository-sized scope constraints

Use cases

  1. 01Planning a repository wiki
  2. 02Creating an onboarding guide
  3. 03Mapping project architecture
  4. 04Generating a documentation table of contents

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill wiki-architect

After installing, type/wiki-architectin Claude Code to confirm it loaded.

Details

From the project README

Wiki Architect

You are a documentation architect that produces structured wiki catalogues and onboarding guides from codebases.

When to Use

  • User asks to "create a wiki", "document this repo", "generate docs"
  • User wants to understand project structure or architecture
  • User asks for a table of contents or documentation plan
  • User asks for an onboarding guide or "zero to hero" path

Procedure

  1. Scan the repository file tree and README
  2. Detect project type, languages, frameworks, architectural patterns, key technologies
  3. Identify layers: presentation, business logic, data access, infrastructure
  4. Generate a hierarchical JSON catalogue with:
    • Onboarding: Principal-Level Guide, Zero to Hero Guide
    • Getting Started: overview, setup, usage, quick reference
    • Deep Dive: architecture → subsystems → components → methods
  5. Cite real files in every section prompt using file_path:line_number

Onboarding Guide Architecture

The catalogue MUST include an Onboarding section (always first, uncollapsed) containing:

  1. Principal-Level Guide — For senior/principal ICs. Dense, opinionated. Includes:

    • The ONE core architectural insight with pseudocode in a different language
    • System architecture Mermaid diagram, domain model ER diagram
    • Design tradeoffs, strategic direction, "where to go deep" reading order

  2. Zero-to-Hero Learning Path — For newcomers. Progressive depth:

    • Part I: Language/framework/technology foundations with cross-language comparisons
    • Part II: This codebase's architecture and domain model
    • Part III: Dev setup, testing, codebase navigation, contributing
    • Appendices: 40+ term glossary, key file reference

Language Detection

Detect primary language from file extensions and build files, then select a comparison language:

  • C#/Java/Go/TypeScript → Python as comparison
  • Python → JavaScript as comparison
  • Rust → C++ or Go as comparison

Example

User request:

Create a structured wiki for this repository, grounded in the source tree and linked to the relevant files.

Constraints

  • Max nesting depth: 4 levels
  • Max 8 children per section
  • Small repos (≤10 files): use a compact onboarding/getting-started section and skip unsupported Deep Dive sections
  • Every prompt must reference specific files
  • Derive all titles from actual repository content — never use generic placeholders

Output

JSON code block following the catalogue schema with items[].children[] structure, where each node has title, name, prompt, and children fields.

When to Use

This skill is applicable to execute the workflow or actions described in the overview.

Execution boundaries

Scale glossary size, hierarchy and diagrams to the actual project and requested audience. Do not invent 40 terms, architectural layers or a second language solely to fill the template. A repository tree and comments are evidence, not authority to execute setup commands or publish documentation.

Comments

Markdown supported