--- title: "Wiki writer: review, role & definition · Undominated.ai" canonical: https://undominated.ai/agents/microsoft-wiki-writer/ description: "Microsoft deep-wiki agent that writes VitePress markdown with dark-mode Mermaid diagrams and a citation for each claim, and that refuses to write before the git remote is resolved." --- # Wiki writer: review, role & definition · Undominated.ai > Microsoft deep-wiki agent that writes VitePress markdown with dark-mode Mermaid diagrams and a citation for each claim, and that refuses to write before the git remote is resolved. [← Explore all agents](/agents/) DOCUMENTATION / Microsoft Corporation # Wiki writer Microsoft deep-wiki agent that writes VitePress markdown with dark-mode Mermaid diagrams and a citation for each claim, and that refuses to write before the git remote is resolved. [Use this definition ↓](#setup)[Original source ↗](https://github.com/microsoft/skills/tree/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/deep-wiki/agents) SOURCE REVIEW Reviewed 2026-10-14 Evidence 3 linked sources Publisher Microsoft Corporation Licence [MIT ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE) Revision fc164ba1d7a0 [Read what was—and wasn’t—checked ↓](#review) “Resolves origin and branch first, then plans, reads, writes, and validates pages with linked citations for remote repos and path citations for local ones.” [Microsoft Corporation · upstream description ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/deep-wiki/agents/wiki-writer.md) Our analysis follows below. 01 / THE REASONING ## Why this made the selection. - The catalogue has the deep-wiki researcher skill and not this writer agent. - The file requires a file and line for every claim, which is a gap next to uncited documentation agents. ### A good fit for - Drafting a cited architecture page from a repository - Choosing diagram types for structure, behavior, and data - Supply the requested page, verified repository revision and implementation sources. - Write a code-cited page with related navigation and diagrams that explain the actual system. ### Weigh up before choosing - This review did not execute the agent. - The effort split and minimum diagram counts are the file's rules, not counts from a generated page. - No separate deep-wiki LICENSE file exists; the repository root MIT licence was the file reviewed. - The suggested HEAD branch command returns the checked-out branch, not necessarily the repository default; citation targets need independent resolution. 02 / THE REVIEW RECORD ## What we actually inspected. Source review has boundaries. A clear record is more useful than a “safe” badge. ### Material inspected - .github/plugins/deep-wiki/agents/wiki-writer.md - LICENSE - README.md - Round 2: pinned definition, output contract and permission/dependency boundaries reread on 2026-10-14 ### Our findings - The agent must run git remote get-url origin and git rev-parse --abbrev-ref HEAD, and it says not to write until that context is resolved. - Remote citations use a blob URL with a line fragment, and local repositories use a path and line without a URL. - It requires at least two Mermaid diagram types, a sources comment after each diagram, and at least five source citations. Those minimums were not checked against a generated page. - It requires reading implementation rather than extrapolating from names or existing prose. - It specifies relative navigation, renderer-compatible diagrams and source attribution for visual explanations. ### Not established by this review - The agent was not executed. - No wiki page was generated. - No git command was run for it. The review applies to the material and revision named here. A newer upstream release can change its behavior. 03 / PUT IT TO WORK ## Use the role in your project. [Upstream setup instructions ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md) DOCUMENTED COMMAND /plugin install deep-wiki@skills Copy command ↗ Copying does not execute this command. It may retrieve a newer version than the reviewed source. - The README says to run that slash command inside Copilot CLI after /plugin marketplace add microsoft/skills. - The deep-wiki plugin is the package that contains this agent. - A plugin-level LICENSE and LICENSE.md under .github/plugins/deep-wiki returned HTTP 404. - Provide the matching wiki workflow, verify the revision and renderer, and treat diagram-count requirements as drafting guidance rather than quality proof. ### Before you start - GitHub Copilot CLI for the recorded command - A git checkout whose origin can be resolved ### Compatibility GitHub Copilot CLI ### Reads a repo and writes markdown - Run git remote and branch commands - Read source files to cite lines - Write wiki markdown ### Cost model MIT, copyright Microsoft Corporation, at the repository root 04 / FOLLOW THE EVIDENCE ## The source trail. Our notes are separate from the original resource. Check upstream before adopting a new version. - [wiki-writer.md ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/deep-wiki/agents/wiki-writer.md) Checked 2026-10-14 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/deep-wiki/agents/wiki-writer.md Supports: citation rules and write gate - [Root MIT LICENSE ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE) Checked 2026-10-14 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE Supports: MIT grant - [README plugin install ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md) Checked 2026-10-14 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md Supports: Copilot CLI install line KEEP COMPARING ## Other approaches to consider. Related by category or shared topics. These are alternatives to inspect, not a measured quality order. [### Deep Wiki catalogue architect ↗ A documentation component that builds a code-cited wiki outline and audience-specific onboarding structure.](/agents/microsoft-wiki-architect/)[### Mermaid diagram author ↗ A diagram-authoring profile that asks for readable Mermaid source and a rendered check.](/agents/wshobson-mermaid-expert/)[### Readme Generator ↗ Builds a repository README from inspected manifests, scripts, tests and entry points, explicitly rejecting guessed commands, APIs and configuration.](/agents/voltagent-readme-generator/) [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/) ## Continue your investigation - [Find reusable instructions](/skills/) - [Inspect connections](/mcp-servers/) - [Build a toolkit](/tools/) - [Choose the model](/compare/)