Official agent skill

Wiki Ado Convert

Converts VitePress/GFM wiki markdown to Azure DevOps Wiki-compatible format.

OfficialMITAuto-check passedDevelopment

Install Wiki Ado Convert

skills CLI

$ npx skills add microsoft/skills --skill wiki-ado-convert -a claude-code

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

GitHub CLI

$ gh skill install microsoft/skills wiki-ado-convert --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-ado-convert .claude/skills/wiki-ado-convert && 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 "wiki-ado-convert" agent skill from https://github.com/microsoft/skills/tree/main/.github/plugins/deep-wiki/skills/wiki-ado-convert into .claude/skills/wiki-ado-convert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wiki-ado-convert", 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/microsoft/skills/tree/main/.github/plugins/deep-wiki/skills/wiki-ado-convert

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 microsoft/skills --skill wiki-ado-convert -a codex

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

GitHub CLI

$ gh skill install microsoft/skills wiki-ado-convert --agent codex

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

Manual copy

$ git clone --depth 1 https://github.com/microsoft/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.github/plugins/deep-wiki/skills/wiki-ado-convert .agents/skills/wiki-ado-convert && 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 "wiki-ado-convert" agent skill from https://github.com/microsoft/skills/tree/main/.github/plugins/deep-wiki/skills/wiki-ado-convert into .agents/skills/wiki-ado-convert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wiki-ado-convert", 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 microsoft/skills --skill wiki-ado-convert -a cursor

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

GitHub CLI

$ gh skill install microsoft/skills wiki-ado-convert --agent cursor

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

Manual copy

$ git clone --depth 1 https://github.com/microsoft/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.github/plugins/deep-wiki/skills/wiki-ado-convert .cursor/skills/wiki-ado-convert && 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 "wiki-ado-convert" agent skill from https://github.com/microsoft/skills/tree/main/.github/plugins/deep-wiki/skills/wiki-ado-convert into .cursor/skills/wiki-ado-convert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wiki-ado-convert", 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/microsoft/skills.git --path .github/plugins/deep-wiki/skills/wiki-ado-convert

--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 microsoft/skills --skill wiki-ado-convert -a gemini-cli

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

GitHub CLI

$ gh skill install microsoft/skills wiki-ado-convert --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/microsoft/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.github/plugins/deep-wiki/skills/wiki-ado-convert .gemini/skills/wiki-ado-convert && 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 "wiki-ado-convert" agent skill from https://github.com/microsoft/skills/tree/main/.github/plugins/deep-wiki/skills/wiki-ado-convert into .gemini/skills/wiki-ado-convert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wiki-ado-convert", 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 microsoft/skills wiki-ado-convert

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 microsoft/skills --skill wiki-ado-convert -a github-copilot

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

Manual copy

$ git clone --depth 1 https://github.com/microsoft/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/.github/plugins/deep-wiki/skills/wiki-ado-convert .github/skills/wiki-ado-convert && 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 "wiki-ado-convert" agent skill from https://github.com/microsoft/skills/tree/main/.github/plugins/deep-wiki/skills/wiki-ado-convert into .github/skills/wiki-ado-convert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wiki-ado-convert", 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 microsoft/skills --skill wiki-ado-convert -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 microsoft/skills wiki-ado-convert --agent opencode

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

Manual copy

$ git clone --depth 1 https://github.com/microsoft/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.github/plugins/deep-wiki/skills/wiki-ado-convert .opencode/skills/wiki-ado-convert && 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 "wiki-ado-convert" agent skill from https://github.com/microsoft/skills/tree/main/.github/plugins/deep-wiki/skills/wiki-ado-convert into .opencode/skills/wiki-ado-convert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wiki-ado-convert", 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: wiki-ado-convert
GitHub stars: 3.1k
Token cost: ~2.3k tokens
SKILL.md length: 838 words
Files: 1
Skills in repo: 150
Repo updated: Oct 6, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Converts VitePress/GFM wiki markdown to Azure DevOps Wiki-compatible format.

Works in 4 steps: Strip YAML Front Matter → Convert Mermaid Blocks → Convert Parent-Relative Source Links → …
Tasks that involve Diagrams
SKILL.md covers Source Repository Resolution…, Why This Is Needed, ADO Wiki Incompatibilities and ADO Wiki Mermaid Supported…, plus 5 more sections
Calls git

What it does

Wiki Ado Convert is an agent skill from microsoft/skills, published by the product's own GitHub organization. Converts VitePress/GFM wiki markdown to Azure DevOps Wiki-compatible format. Generates a Node.js build script that transforms Mermaid syntax, strips front matter, fixes links, and outputs ADO-compatible copies to dist/ado-wiki/.

Its SKILL.md is about 2.3k 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, covering Diagrams, Markdown and Static sites and blogs. It works with Azure DevOps, Mermaid, VitePress and Node.js. 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

Tasks that involve Diagrams
Tasks that involve Markdown
Tasks that involve Static sites and blogs

Example prompts

“Use the wiki-ado-convert skill to convert VitePress/GFM wiki markdown to Azure DevOps Wiki-compatible format”
“/wiki-ado-convert”

Requirements

Node.js

Workflow steps

4 steps, taken from the step headings in SKILL.md.

Strip YAML Front Matter
Convert Mermaid Blocks
Convert Parent-Relative Source Links
Convert VitePress Container Directives (Optional)

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 Ado Convert loads about 2.3k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 838 words of instructions outside code blocks.

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

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). 838 words, ~2,324 tokens.

Download SKILL.mdSave it as .claude/skills/wiki-ado-convert/SKILL.md (or your agent's skills folder).

name: wiki-ado-convert
description: Converts VitePress/GFM wiki markdown to Azure DevOps Wiki-compatible format. Generates a Node.js build script that transforms Mermaid syntax, strips front matter, fixes links, and outputs ADO-compatible copies to dist/ado-wiki/.
license: MIT
metadata.author: Microsoft
metadata.version: 1.0.0

ADO Wiki Converter

Generate a Node.js build script that transforms VitePress/GFM markdown documentation into Azure DevOps Wiki-compatible format. The source files remain untouched — the script produces transformed copies in dist/ado-wiki/.

Source Repository Resolution (MUST DO FIRST)

Before generating the build script, resolve the source repository context:

Check for git remote: Run git remote get-url origin
Ask the user: "Is this a local-only repository, or do you have a source repository URL?"
- Remote URL → store as REPO_URL, preserve linked citations in converted output
- Local → preserve local citations as-is
Do NOT proceed until resolved

Why This Is Needed

Azure DevOps Wikis use a markdown dialect that differs from GFM and VitePress in several critical ways. Documentation that renders perfectly in VitePress will have broken diagrams, raw front matter, dead links, and rendering issues when published as an ADO Wiki.

ADO Wiki Incompatibilities

CRITICAL — Will Break Rendering

Issue	VitePress/GFM	ADO Wiki	Fix
Mermaid code fences	```mermaid ... ```	`::: mermaid` ... `:::`	Convert opening/closing fences
`flowchart` keyword	`flowchart TD`	`graph TD`	Replace `flowchart` with `graph` (preserve direction)
`<br>` in Mermaid labels	`Node[Label<br>Text]`	Not supported	Strip `<br>` variants (replace with space)
Long arrows `---->`	`A ---->B`	Not supported	Replace with `-->`
YAML front matter	`---` ... `---` at file start	Rendered as visible raw text	Strip entirely
Parent-relative source links	`[text](../../src/file.cs)`	Broken (wiki is separate)	Convert to plain text
VitePress container directives	`::: tip` / `::: warning`	Not supported	Convert to ADO alert blockquotes `> [!TIP]` / `> [!WARNING]`

MODERATE — May Not Render Optimally

Issue	Notes
Mermaid `style` directives	ADO's Mermaid version may ignore inline styling. Leave as-is (cosmetic).
Mermaid thick arrows `==>`	May work. Leave as-is.
Mermaid dotted arrows `-.->`	May work. Leave as-is.
Subgraph linking	Links to/from subgraphs not supported, but nodes inside subgraphs work fine.

NOT AN ISSUE (Compatible As-Is)

✅ Standard markdown tables, blockquotes, horizontal rules
✅ Unicode emoji, fenced code blocks with language identifiers
✅ Same-directory relative links (./other-page.md)
✅ External HTTP/HTTPS links
✅ Bold, italic, strikethrough, inline code
✅ Lists (ordered, unordered, nested), headings 1-6
✅ Images with relative paths

ADO Wiki Mermaid Supported Diagram Types

As of 2025:

✅ sequenceDiagram, gantt, graph (NOT flowchart), classDiagram
✅ stateDiagram, stateDiagram-v2, journey, pie, erDiagram
✅ requirementDiagram, gitGraph, timeline
❌ mindmap, sankey, quadrantChart, xychart, block

Build Script Structure

The generated script should be a Node.js ESM module (scripts/build-ado-wiki.js) using only built-in Node.js modules (node:fs/promises, node:path, node:url). No external dependencies.

Transformation Functions

1. Strip YAML Front Matter

Remove --- delimited YAML blocks at file start. ADO renders these as visible text.

javascript

function stripFrontMatter(content) {
  if (!content.startsWith('---')) return content;
  const endIndex = content.indexOf('\n---', 3);
  if (endIndex === -1) return content;
  let rest = content.slice(endIndex + 4);
  if (rest.startsWith('\n')) rest = rest.slice(1);
  return rest;
}

2. Convert Mermaid Blocks

Process line-by-line, tracking mermaid block state. Apply fixes ONLY inside mermaid blocks:

Opening: ```mermaid → ::: mermaid
Closing: ``` → :::
flowchart → graph (preserve direction: TD, LR, TB, RL, BT)
Strip <br>, <br/>, <br /> (replace with space)
Replace long arrows (----> with 4+ dashes) with -->

javascript

function convertMermaidBlocks(content) {
  const lines = content.split('\n');
  const result = [];
  let inMermaid = false;

  for (const line of lines) {
    const trimmed = line.trimEnd();

    if (!inMermaid && /^```mermaid\s*$/.test(trimmed)) {
      result.push('::: mermaid');
      inMermaid = true;
      continue;
    }

    if (inMermaid && /^```\s*$/.test(trimmed)) {
      result.push(':::');
      inMermaid = false;
      continue;
    }

    if (inMermaid) {
      let fixed = line;
      fixed = fixed.replace(/^(\s*)flowchart(\s+)/, '$1graph$2');
      fixed = fixed.replace(/<br\s*\/?>/gi, ' ');
      fixed = fixed.replace(/-{4,}>/g, '-->');
      result.push(fixed);
    } else {
      result.push(line);
    }
  }

  return result.join('\n');
}

3. Convert Parent-Relative Source Links

Convert [text](../path) to plain text. Preserves same-directory .md links and external URLs.

javascript

function convertSourceLinks(content) {
  return content.replace(
    /\[([^\]]*)\]\(\.\.\/[^)]*\)/g,
    (match, linkText) => linkText
  );
}

4. Convert VitePress Container Directives (Optional)

Convert ::: tip / ::: warning / ::: danger to ADO alert blockquotes:

javascript

function convertContainerDirectives(content) {
  // ::: tip → > [!TIP]
  // ::: warning → > [!WARNING]
  // ::: danger → > [!CAUTION]
  // ::: info → > [!NOTE]
  // closing ::: → (blank line)
}

Script Main Flow

javascript

async function main() {
  const files = await collectMarkdownFiles(ROOT);
  const stats = { frontMatter: 0, mermaid: 0, sourceLinks: 0, containers: 0 };

  for (const filePath of files) {
    let content = await readFile(filePath, 'utf-8');
    content = stripFrontMatter(content);
    content = convertMermaidBlocks(content);
    content = convertSourceLinks(content);

    const outPath = join(OUTPUT, relative(ROOT, filePath));
    await mkdir(dirname(outPath), { recursive: true });
    await writeFile(outPath, content, 'utf-8');
  }

  // Print transformation statistics
}

Skip Directories

The script should skip: node_modules, .vitepress, .git, dist, build, out, target, and any non-documentation directories.

npm Script Integration

json

{
  "scripts": {
    "build:ado": "node scripts/build-ado-wiki.js"
  }
}

Show full SKILL.md (350 more words)Show less

Verification Checklist

After the script runs, verify:

File count in dist/ado-wiki/ matches source (minus skipped dirs)
Zero ```mermaid fences remaining — all converted to ::: mermaid
Zero flowchart keywords remaining — all converted to graph
No YAML front matter in output files
Parent-relative links converted to plain text
Same-directory .md links preserved
Directory structure preserved
Non-markdown files (images, etc.) copied as-is
index.md at root is a proper wiki home page (NOT a placeholder)

Index Page Generation (CRITICAL)

The ADO Wiki's index.md MUST be a proper wiki landing page, NOT a generic placeholder with "TODO" text.

Logic

If VitePress source has index.md: Transform it (strip front matter, strip VitePress hero/features blocks). If meaningful content remains, use it.
If no meaningful content remains (empty after stripping, or only VitePress hero markup): Generate a proper landing page with:
- Project title as # heading
- Overview paragraph (from README or wiki overview page)
- Quick Navigation table (Section, Description columns linking to wiki sections)
- Links to onboarding guides if they exist
NEVER leave a placeholder — if index.md contains "TODO:", "Give a short introduction", or similar placeholder text, replace it entirely

ADO Wiki `.order` Files

Generate .order files in each directory to control sidebar ordering:

Onboarding guides first, then numbered sections
List page names without .md extension, one per line

Citation & Diagram Preservation

The converted ADO wiki must maintain the same quality standards:

Linked citations ([file:line](URL)) are standard markdown — preserve them as-is
 comment blocks after Mermaid diagrams — preserve (HTML comments work in ADO)
Tables with "Source" columns — preserve as-is (standard markdown tables)
Mermaid diagrams — convert fences only; diagram content, types, and structure are preserved
All Mermaid diagram types supported by ADO (graph, sequenceDiagram, classDiagram, stateDiagram, erDiagram, etc.) pass through unchanged

Important Notes

Source files are NEVER modified — only copies in dist/ado-wiki/
Images must be copied too — if source has images, copy them with same relative paths
The script should work with any VitePress wiki, not just this specific one
Print statistics at the end showing count of each transformation type
Script uses zero external dependencies — only Node.js builtins

Files

Just SKILL.md in .github/plugins/deep-wiki/skills/wiki-ado-convert of microsoft/skills.

Open the folder on GitHubat commit 354361d

Compare with similar skills

Wiki Ado Convert 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 Ado Convert compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Wiki Ado Convert this skillmicrosoft/skills	3.1k	—	~2.3k	Automated safety check: Pass	MIT	yesterday
Pretty Mermaid Rendererimxv/Pretty-mermaid-skills	1.5k	—	~2k	Automated safety check: Pass	MIT	1 mo ago
Chatbot Mvp Distillationpdsuwwz/chatgpt-vue3-light-mvp	578	—	~722	Automated safety check: Pass	MIT	2 mo ago
Chatbot Mvp Distillation Zhpdsuwwz/chatgpt-vue3-light-mvp	578	—	~414	Automated safety check: Pass	MIT	2 mo ago
Markdown Mermaid WritingK-Dense-AI/scientific-agent-skills	48k	1 repos	~4.2k	Automated safety check: Notes	Apache-2.0	3 days ago
Axiom Explainerdigoal/blog	8.6k	—	~626	Automated safety check: Pass	GPL-2.0	10 days ago

Similar skills

Pretty Mermaid Renderer
imxv/Pretty-mermaid-skills
Writes and renders Mermaid diagrams as themed SVG, PNG or terminal ASCII and Unicode art with a bundled Node.js CLI that needs no browser.
1.5k GitHub stars~2k tokensUpdated 1 mo ago
DevelopmentAuto-check passed
Chatbot Mvp Distillation
pdsuwwz/chatgpt-vue3-light-mvp
Distill the chatgpt-vue3-light-mvp project into reusable architecture for building similar ChatGPT-style web products in other repositories.
578 GitHub stars~722 tokensUpdated 2 mo ago
DevelopmentAuto-check passed
Chatbot Mvp Distillation Zh
pdsuwwz/chatgpt-vue3-light-mvp
将 chatgpt-vue3-light-mvp 项目蒸馏为可迁移到其他项目的中文架构指南。适用于设计或实现类似 ChatGPT 的 Web 对话产品，包括 SSE/fetch 流式响应、模型适配器契约、打字机渲染、Markdown/代码/KaTeX/Mermaid 渲染、推理过程展示，以及从本 Vue 3 MVP 迁移到其他项目的方案规划。
578 GitHub stars~414 tokensUpdated 2 mo ago
DevelopmentAuto-check passed
Markdown Mermaid Writing
K-Dense-AI/scientific-agent-skills
Writes scientific Markdown documentation and Mermaid diagrams for workflows, relationships, timelines, and schemas.
48k GitHub starsUsed in 1 repo~4.2k tokens
DevelopmentAuto-check: notes
Axiom Explainer
digoal/blog
生成面向学生的公理/定理深度讲解文案，输出图文并茂的 Markdown 文章。触发条件：用户输入一个观点、公理、定理或数学/科学/哲学命题，并希望获得系统性讲解文章。关键词包括："讲解"、"解释"、"公理"、"定理"、"原理"、"推导"、"怎么来的"、"有什么用"、"证明"等。即使用户只说"帮我讲讲XX定理"或"解释一下XX原理"，也应使用本 skill。输出保存到项目 markdown/…
8.6k GitHub stars~626 tokensUpdated 10 days ago
DevelopmentAuto-check passed
Bug Hunter
digoal/blog
根据用户给出的行业名称（或默认使用热点社会新闻），抓取最新新闻热点，用"找世界bug"的视角——找出那些打眼一看就不合理的地方——深度分析根因、利益链条、监管盲区，并给出多维度解决思路，输出图文并茂（含SVG/Mermaid/ASCII图形）的Markdown文件，保存到项目markdown/目录。
8.6k GitHub stars~1k tokensUpdated 10 days ago
DevelopmentAuto-check passed

Questions about Wiki Ado Convert

What does Wiki Ado Convert do?

Converts VitePress/GFM wiki markdown to Azure DevOps Wiki-compatible format. Wiki Ado Convert is an agent skill from microsoft/skills, published by the product's own GitHub organization. Converts VitePress/GFM wiki markdown to Azure DevOps Wiki-compatible format.

When should I use Wiki Ado Convert?

Wiki Ado Convert fits situations like: tasks that involve Diagrams; tasks that involve Markdown; tasks that involve Static sites and blogs.

How do I install Wiki Ado Convert in Claude Code?

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

How do I install Wiki Ado Convert in Codex?

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

Can I use Wiki Ado Convert 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-ado-convert -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-ado-convert, .gemini/skills/wiki-ado-convert, .github/skills/wiki-ado-convert and .opencode/skills/wiki-ado-convert in your project.

What does Wiki Ado Convert need to run?

Going by SKILL.md and its folder, Wiki Ado Convert needs the command-line tools its instructions call (git). Our summary lists: Node.js.

Does Wiki Ado Convert 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 Ado Convert 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 Ado Convert use?

Wiki Ado Convert 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 Ado Convert use?

About 2.3k tokens (SKILL.md is roughly 9.3k 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 Ado Convert?

Skills that share tags, products or a category with Wiki Ado Convert: Pretty Mermaid Renderer (imxv/Pretty-mermaid-skills, 1.5k stars), Chatbot Mvp Distillation (pdsuwwz/chatgpt-vue3-light-mvp, 578 stars), Chatbot Mvp Distillation Zh (pdsuwwz/chatgpt-vue3-light-mvp, 578 stars) and Markdown Mermaid Writing (K-Dense-AI/scientific-agent-skills, 48k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wiki Ado Convert?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/skills, which has 3,091 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.

Install Wiki Ado Convert

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

ADO Wiki Converter

Source Repository Resolution (MUST DO FIRST)

Why This Is Needed

ADO Wiki Incompatibilities

CRITICAL — Will Break Rendering

MODERATE — May Not Render Optimally

NOT AN ISSUE (Compatible As-Is)

ADO Wiki Mermaid Supported Diagram Types

Build Script Structure

Transformation Functions

1. Strip YAML Front Matter

2. Convert Mermaid Blocks

3. Convert Parent-Relative Source Links

4. Convert VitePress Container Directives (Optional)

Script Main Flow

Skip Directories

npm Script Integration

Verification Checklist

Index Page Generation (CRITICAL)

Logic

ADO Wiki .order Files

Citation & Diagram Preservation

Important Notes

Files

Compare with similar skills

Similar skills

More from microsoft/skills

Related

Questions about Wiki Ado Convert

ADO Wiki `.order` Files