Official agent skill

Wiki Architect

by microsoft in microsoft/skills

Analyzes code repositories and generates hierarchical documentation structures with onboarding guides.

OfficialMITAuto-check passedDevelopment

Install Wiki Architect

skills CLI
$ npx skills add microsoft/skills --skill wiki-architect -a claude-code

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

GitHub CLI
$ gh skill install microsoft/skills wiki-architect --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/microsoft/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/plugins/deep-wiki/skills/wiki-architect .claude/skills/wiki-architect && 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
wiki-architect
GitHub stars
3.1k
Used in
5 other repos
Token cost
~1k tokens
SKILL.md length
465 words
Files
1
Skills in repo
150
Repo updated
First seen
Licence
MIT

At a glance

Analyzes code repositories and generates hierarchical documentation structures with onboarding guides.

  • Works in 4 steps: Check for git remote: Run git remote… → Ask the user: "Is this a local-only… → Determine default branch: Run git… → …
  • The user wants to create a wiki
  • SKILL.md covers When to Activate, Source Repository Resolution…, Procedure and Onboarding Guide Architecture, plus 3 more sections
  • Calls git

What it does

Wiki Architect is an agent skill from microsoft/skills, published by the product's own GitHub organization. Analyzes code repositories and generates hierarchical documentation structures with onboarding guides. Use when the user wants to create a wiki, generate documentation, map a codebase structure, or understand a project's architecture at a high level.

Its SKILL.md is about 1k 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. It works with Azure DevOps and Git. The repository describes itself as: Skills, MCP servers, Custom Agents, Agents.md for SDKs to ground Coding Agents. The licence is MIT.

When your agent uses it

  • The user wants to create a wiki
  • Generate documentation
  • Map a codebase structure
  • Understand a projects architecture at a high level

Example prompts

  • “Use the wiki-architect skill to analyz code repositories and generates hierarchical documentation structures with onboarding guides”
  • “/wiki-architect”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Check for git remote: Run git remote get-url origin to detect if a remote exists
  2. Ask the user: "Is this a local-only repository, or do you have a source repository URL (e.g., GitHub, Azure DevOps)?"
  3. Determine default branch: Run git rev-parse --abbrev-ref HEAD
  4. Do NOT proceed until source repo context is resolved

What it can do on your machine

Read from SKILL.md and the folder at commit 354361d. 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

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Wiki Architect loads about 1k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 465 words of instructions outside code blocks.

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

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 microsoft/skills at commit 354361d, republished under its MIT licence (© microsoft). 465 words, ~1,010 tokens.

Download SKILL.mdSave it as .claude/skills/wiki-architect/SKILL.md (or your agent's skills folder).
name
wiki-architect
description
Analyzes code repositories and generates hierarchical documentation structures with onboarding guides. Use when the user wants to create a wiki, generate documentation, map a codebase structure, or understand a project's architecture at a high level.
license
MIT
metadata.author
Microsoft
metadata.version
1.0.0

Wiki Architect

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

When to Activate

  • 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

Source Repository Resolution (MUST DO FIRST)

Before any analysis, you MUST determine the source repository context:

  1. Check for git remote: Run git remote get-url origin to detect if a remote exists
  2. Ask the user: "Is this a local-only repository, or do you have a source repository URL (e.g., GitHub, Azure DevOps)?"
    • Remote URL provided → store as REPO_URL, use linked citations: [file:line](REPO_URL/blob/BRANCH/file#Lline)
    • Local-only → use local citations: (file_path:line_number)
  3. Determine default branch: Run git rev-parse --abbrev-ref HEAD
  4. Do NOT proceed until source repo context is resolved

Procedure

  1. Resolve source repo (see above — MUST be first)
  2. Scan the repository file tree and README
  3. Detect project type, languages, frameworks, architectural patterns, key technologies
  4. Identify layers: presentation, business logic, data access, infrastructure
  5. Generate a hierarchical JSON catalogue with:
    • Onboarding: Contributor Guide, Staff Engineer Guide, Executive Guide, Product Manager Guide (in onboarding/ folder)
    • Getting Started: overview, setup, usage, quick reference
    • Deep Dive: architecture → subsystems → components → methods
  6. Cite real files in every section prompt using linked or local citation format
Show full SKILL.md (233 more words)Show less

Onboarding Guide Architecture

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

  1. Contributor Guide — For new contributors (assumes Python/JS). 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
  2. Staff Engineer Guide — For staff/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, decision log, dependency rationale, "where to go deep" reading order
  3. Executive Guide — For VP/director-level leaders. NO code snippets. Includes:

    • Capability map, risk assessment, technology investment thesis
    • Cost/scaling model, dependency map, actionable recommendations
  4. Product Manager Guide — For PMs. ZERO engineering jargon. Includes:

    • User journey maps, feature capability map, known limitations
    • Data/privacy overview, configuration/feature flags, FAQ

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

Constraints

  • Max nesting depth: 4 levels
  • Max 8 children per section
  • Small repos (≤10 files): Getting Started only (skip Deep Dive, still include onboarding)
  • 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.

© microsoft, MIT. 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 .github/plugins/deep-wiki/skills/wiki-architect of microsoft/skills.

Open the folder on GitHubat commit 354361d

Used in 5 other repositories

We found 14 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in microsoft/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Wiki Architect 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.

Wiki Architect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wiki Architect this skillmicrosoft/skills3.1k5 repos~1kAutomated safety check: PassMIT
Azdo Internalmicrosoft/aspire6.3k—~4.5kAutomated safety check: PassMIT
PR ReviewJocysCom/FocusLogger213—~12kAutomated safety check: WarnGPL-3.0
Qodo PR Resolversbusso/claudeclaw194—~4kAutomated safety check: PassMIT
Azure DevopsOpenHands/extensions157—~979Automated safety check: PassMIT
Authoring GitHub Workflowsdotnet/skills5.6k1 repos~2.3kAutomated safety check: PassMIT

Similar skills

  • Azdo Internal

    microsoft/aspire

    Official

    A skill your agent uses when asked to trigger or inspect Aspire internal Azure DevOps builds, source-index runs, or release validation on dnceng/internal; push to the internal mirror; download build…

    6.3k GitHub stars~4.5k tokensUpdated today
    DevelopmentAuto-check passed
  • PR Review

    JocysCom/FocusLogger

    AI-assisted pull request review workflow for Azure DevOps Git repositories.

    213 GitHub stars~12k tokensUpdated 3 mo ago
    DevelopmentAuto-check: warnings
  • Qodo PR Resolver

    sbusso/claudeclaw

    Review and resolve PR issues with Qodo - get AI-powered code review issues and fix them interactively (GitHub, GitLab, Bitbucket, Azure DevOps)

    194 GitHub stars~4k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Azure Devops

    OpenHands/extensions

    Interact with Azure DevOps repositories, pull requests, and APIs using the AZUREDEVOPSTOKEN environment variable.

    157 GitHub stars~979 tokensUpdated today
    DevelopmentAuto-check passed
  • Official

    Author and review GitHub Actions workflow YAML safely so syntactically-valid YAML can't ship a workflow that GitHub Actions refuses to run.

    5.6k GitHub starsUsed in 1 repo~2.3k tokens
    DevOps & CloudAuto-check passed
  • Adf Master

    Kilo-Org/kilo-marketplace

    Azure Data Factory (ADF) CI/CD, deployment, and pipeline development.

    189 GitHub stars~3.2k tokensUpdated 8 days ago
    DevOps & CloudAuto-check passed

More from microsoft/skills

All 150 skills in this repo
  • Official

    Reference for building on Microsoft Foundry with the azure-ai-projects Python SDK: project clients, versioned agents, evaluations, connections, datasets and indexes.

    3.1k GitHub starsUsed in 6 repos~2.8k tokens
    Auto-check passed
  • Official

    Python guidance for the Azure AI Search SDK covering vector, hybrid and semantic search, index management and indexers, with Entra ID authentication preferred over keys.

    3.1k GitHub starsUsed in 6 repos~4.4k tokens
    Auto-check passed
  • Official

    Covers producer, consumer, and checkpoint-store setup for Azure Event Hubs streaming in Python, with Entra ID auth and partition targeting.

    3.1k GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Pydantic Models Py

    microsoft/skills

    Official

    Create Pydantic models following the multi-model pattern with Base, Create, Update, Response, and InDB variants.

    3.1k GitHub starsUsed in 6 repos~496 tokens
    Auto-check passed
  • Official

    Builds podcast-style audio narration from text with Azure OpenAI's GPT Realtime Mini over WebSocket, from a Python FastAPI backend to a React player.

    3.1k GitHub starsUsed in 1 repo~947 tokens
    Auto-check passed
  • Frontend UI Dark TS

    microsoft/skills

    Official

    Build dark-themed React applications using Tailwind CSS with custom theming, glassmorphism effects, and Framer Motion animations.

    3.1k GitHub starsUsed in 5 repos~3.6k tokens
    Auto-check passed

Works with

Categories

Questions about Wiki Architect

What does Wiki Architect do?

Analyzes code repositories and generates hierarchical documentation structures with onboarding guides. Wiki Architect is an agent skill from microsoft/skills, published by the product's own GitHub organization. Analyzes code repositories and generates hierarchical documentation structures with onboarding guides.

When should I use Wiki Architect?

Wiki Architect fits situations like: the user wants to create a wiki; generate documentation; map a codebase structure; understand a projects architecture at a high level.

How do I install Wiki Architect in Claude Code?

Run `npx skills add microsoft/skills --skill wiki-architect -a claude-code`. Or copy the skill folder (.github/plugins/deep-wiki/skills/wiki-architect in microsoft/skills) into .claude/skills/wiki-architect in your project. Claude Code loads it when a task matches its description.

How do I install Wiki Architect in Codex?

Run `npx skills add microsoft/skills --skill wiki-architect -a codex`. Or copy the skill folder (.github/plugins/deep-wiki/skills/wiki-architect in microsoft/skills) into .agents/skills/wiki-architect in your project. Codex loads it when a task matches its description.

Can I use Wiki Architect 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 microsoft/skills --skill wiki-architect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wiki-architect, .gemini/skills/wiki-architect, .github/skills/wiki-architect and .opencode/skills/wiki-architect in your project.

What does Wiki Architect need to run?

Going by SKILL.md and its folder, Wiki Architect needs the command-line tools its instructions call (git). Our summary lists: Python 3.

Does Wiki Architect access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Wiki Architect 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 Wiki Architect use?

Wiki Architect is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Wiki Architect use?

About 1k tokens (SKILL.md is roughly 4k 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 Wiki Architect?

Skills that share tags, products or a category with Wiki Architect: Azdo Internal (microsoft/aspire, 6.3k stars), PR Review (JocysCom/FocusLogger, 213 stars), Qodo PR Resolver (sbusso/claudeclaw, 194 stars) and Azure Devops (OpenHands/extensions, 157 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wiki Architect?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/skills, which has 3,086 GitHub stars. The repository holds 150 skills in this directory. The repository was last updated on October 6, 2026.

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