# wiki-ado-convert

Скилл wiki-ado-convert генерирует Node.js-скрипт, который переводит markdown-документацию VitePress и GFM в формат, совместимый с Azure DevOps Wiki. Чинит диаграммы Mermaid, ссылки и фронтматтер перед публикацией в вики.

- скилл · `type=skill` · Claude Code, GitHub Copilot, Codex, Cursor, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · 4 установки · ★ 3232 у репозитория
- Автор: Microsoft
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/microsoft/skills/tree/HEAD/.github/plugins/deep-wiki/skills/wiki-ado-convert/SKILL.md
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/wiki-ado-convert

## Что делает

Скилл не редактирует исходные файлы, а создаёт скрипт сборки, который копирует документацию в `dist/ado-wiki/` уже в переработанном виде. Он меняет синтаксис Mermaid-диаграмм (например, `flowchart` на `graph`, обёртку кода на `::: mermaid`), убирает YAML-фронтматтер, который ADO иначе выводит как текст, и превращает ссылки на родительские каталоги с исходным кодом в обычный текст, потому что вики ADO живёт отдельно от репозитория.

Перед генерацией скрипта скилл проверяет `git remote get-url origin` и спрашивает, локальный это репозиторий или есть адрес удалённого, чтобы сохранить ссылки на источник в переведённых файлах. Скрипт собран как ESM-модуль на встроенных модулях Node.js, без внешних зависимостей, и пропускает каталоги `node_modules`, `.vitepress`, `.git`, `dist`, `build`.

Часть диаграмм Mermaid ADO поддерживает не полностью: `mindmap`, `sankey`, `quadrantChart` и `block` рисоваться не будут, а связи от и к подграфам (subgraph) обрезаются, хотя узлы внутри подграфов работают нормально.

## Требования
- Работает с: Azure, Azure DevOps

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/skills --skill wiki-ado-convert -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/wiki-ado-convert/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/wiki-ado-convert/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/skills --skill wiki-ado-convert -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/wiki-ado-convert/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/skills --skill wiki-ado-convert -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/wiki-ado-convert/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install microsoft/skills .github/plugins/deep-wiki/skills/wiki-ado-convert
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/wiki-ado-convert/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/skills --skill wiki-ado-convert -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/microsoft/skills --path .github/plugins/deep-wiki/skills/wiki-ado-convert
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/wiki-ado-convert/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/microsoft/skills/tree/HEAD/.github/plugins/deep-wiki/skills/wiki-ado-convert/SKILL.md

## Когда брать
- перевести VitePress-документацию в формат Azure DevOps Wiki
- исправить синтаксис диаграмм Mermaid под рендер ADO
- убрать YAML-фронтматтер, который ADO показывает как текст
- заменить ссылки на файлы исходного кода на обычный текст
- собрать скрипт конвертации без внешних npm-зависимостей

## Примеры запросов агенту
- Сгенерируй скрипт, который конвертирует нашу документацию в формат ADO Wiki
- Собери сборку docs в dist/ado-wiki с исправленными диаграммами Mermaid
- Проверь, какие диаграммы Mermaid не отрендерятся в Azure DevOps Wiki

## Похожие
- [ado-pipeline-best-practices](https://affpapa.org/nevibecode/skills/ado-pipeline-best-practices.md) — скилл · 182 установки
- [Azure DevOps (ADO)](https://affpapa.org/nevibecode/mcp/azure-devops-ado.md) — MCP-сервер · ★ 2092 у репозитория
- [azure-devops](https://affpapa.org/nevibecode/skills/azure-devops.md) — скилл · 442 установки
- [azure-boards](https://affpapa.org/nevibecode/skills/azure-boards.md) — скилл · 242 установки
- [adf-master](https://affpapa.org/nevibecode/skills/adf-master.md) — скилл · 164 установки
- [azure-devops-specialist](https://affpapa.org/nevibecode/agents/azure-devops-specialist.md) — субагент · ★ 1357 у репозитория

Из того же набора: [microsoft/skills](https://affpapa.org/nevibecode/by/microsoft/skills.md) — 250 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
