# mdx-sanitizer

Скилл mdx-sanitizer для Claude Code экранирует в MDX конструкции, которые MDX 2.x принимает за JSX, перед сборкой Docusaurus. Исправляет ошибки unexpected token в прекоммит-хуках и билде.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 202 установки · ★ 274 у репозитория
- Автор: curiositech
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/curiositech/some_claude_skills/tree/HEAD/.claude/skills/mdx-sanitizer/SKILL.md
- Обновлён: 2026-09-06
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/mdx-sanitizer

## Что делает

Скилл находит и исправляет конструкции, которые MDX 2.x принимает за JSX: неэкранированные `<` и `>` в тексте, дженерики вроде `Promise<T>`, операторы сравнения `<=` и `>=`, стрелки `-->` и псевдотеги `<link>`. Работает в трёх точках: при синхронизации из `.claude/skills/` в `website/docs/`, в git-хуке перед коммитом через `validate-brackets.js` и на этапе билда в `prebuild`.

Внутри код в обратных кавычках и фенсированные блоки не трогает. Заменяет скобки на HTML-сущности (`&lt;`, `&gt;`), чтобы не сломать рендеринг. Запуск `npm run sanitize:mdx` проверяет файлы, `npm run fix:mdx` исправляет на месте. Без FFmpeg, Python или внешних API.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add curiositech/some_claude_skills --skill mdx-sanitizer -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add curiositech/some_claude_skills --skill mdx-sanitizer -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add curiositech/some_claude_skills --skill mdx-sanitizer -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install curiositech/some_claude_skills .claude/skills/mdx-sanitizer
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add curiositech/some_claude_skills --skill mdx-sanitizer -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/curiositech/some_claude_skills --path .claude/skills/mdx-sanitizer
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add curiositech/some_claude_skills --skill mdx-sanitizer -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/curiositech/some_claude_skills/tree/HEAD/.claude/skills/mdx-sanitizer/SKILL.md

## Когда брать
- экранировать дженерики TypeScript и операторы сравнения в MDX перед билдом Docusaurus
- зафиксить падения прекоммит-хука на невалидных угловых скобках
- защитить контент от парсинга как JSX при наличии шаблонов Liquid

## Примеры запросов агенту
- Проверь MDX-файлы в `website/docs/` на незакрытые скобки и дженерики.
- Исправь ошибки `unexpected token <` в файлах `.mdx` каталога `docs/`.
- Запусти `npm run sanitize:mdx -- --fix` для всех файлов проекта.

## Похожие
- [markdown-mdx-content-pipeline-wasp-drone](https://affpapa.org/nevibecode/agents/markdown-mdx-content-pipeline-wasp-drone.md) — субагент · ★ 96 у репозитория
- [docusaurus-expert](https://affpapa.org/nevibecode/agents/docusaurus-expert.md) — субагент · 1143 установки
- [user-manual-generator](https://affpapa.org/nevibecode/skills/user-manual-generator.md) — скилл · 2 установки
- [blog-rewrite](https://affpapa.org/nevibecode/skills/blog-rewrite.md) — скилл · 2700 установок
- [blog-write](https://affpapa.org/nevibecode/skills/blog-write.md) — скилл · 2700 установок
- [docs-write](https://affpapa.org/nevibecode/skills/docs-write.md) — скилл · 2100 установок

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

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

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