Docus — скилл
Два скилла для справки на Nuxt: первый собирает сайт Docus под проект, второй проверяет готовые страницы и пишет отчет.
- 3 126 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скилл создает папку документации в репозитории, пишет страницы и ставит зависимости через менеджер пакетов.
Установка
- Работает в
Ручная установка
npx skills add nuxt-content/docusКоманда из README ставит скиллы Docus для создания и проверки документации.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скилл создает папку документации в репозитории, пишет страницы и ставит зависимости через менеджер пакетов.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Docus — тема документации на Nuxt и Markdown, а скиллы из ее репозитория подключают к ней агента. `create-docs` определяет менеджер пакетов и устройство проекта, в том числе монорепозиторий, создает папку документации, пишет страницы по шаблонам и настраивает MCP-сервер и `llms.txt`. `review-docs` читает готовые страницы и проверяет frontmatter, синтаксис MDC, структуру, SEO и переводы. Итог — отчет, где замечания разбиты на критичные, важные и желательные. Исправлять агент начинает после вашего согласия. Каждый сайт на Docus отдает собственный MCP-сервер по адресу `/mcp`, поэтому собранную справку можно подключить к Cursor или VS Code.
Для кого. Авторам справки к проектам на Nuxt и Vue и командам, которым нужен сайт документации из Markdown без ручной сборки.
Подходит, если
- В репозитории нет сайта справки, и агент должен собрать его по README и структуре проекта.
- Проект лежит в монорепозитории с папками `apps/` и `packages/`, и документацию надо поместить в правильное место.
- Перед релизом страницы хочется прогнать на сломанный frontmatter и MDC-компоненты без префикса `u-`.
- Справка выходит на нескольких языках, и структуру переводов надо сверить.
Не подходит, если
- Сайт справки уже работает на другом движке, и переносить его на Nuxt не планируют.
- Репозиторий нельзя менять автоматически: `create-docs` создает папку документации и пишет в нее страницы.
- Документация живет в вики-системе или текстовом редакторе, а оба скилла читают только файлы Markdown.
Пример запроса к агенту
Создай для проекта сайт документации на Docus, потом проверь страницы и покажи отчет по приоритетам.Ограничения
Скиллы рассчитаны на Docus и Nuxt Content. `create-docs` создает проект Docus, а `review-docs` читает и обычный Markdown, но проверки синтаксиса MDC и файлов `.navigation.yml` относятся только к Docus. Для запуска сайта нужны Node.js и менеджер пакетов, который `create-docs` выбирает по файлу блокировки, а без него берет npm. Папка документации записывается прямо в репозиторий, поэтому свои правки лучше закоммитить заранее. AI-ассистент на сайте Docus работает через Vercel AI Gateway и требует отдельной настройки.
Как отключить. Удалите папки `create-docs` и `review-docs` из каталога скиллов агента. Созданную папку документации и зависимости Docus уберите из проекта вручную.
Частые вопросы
Как поставить скиллы Docus в Claude Code?
Выполните `npx skills add nuxt-content/docus`. После установки опишите задачу словами, например «создай документацию для проекта», и агент выберет `create-docs`.
Чем create-docs отличается от review-docs?
`create-docs` строит сайт справки с нуля, `review-docs` проверяет готовые страницы и пишет отчет. Первый скилл меняет репозиторий сразу, второй сначала только читает файлы.
Как создать проект Docus без скилла?
Выполните `npx create-docus my-docs`, затем `cd my-docs` и `npm run dev`: сайт откроется на `http://localhost:3000`. Для нескольких языков добавьте ключ `-t i18n`.
Как подключить MCP-сервер документации к Cursor?
Каждый сайт Docus отдает сервер по адресу `/mcp`. Кнопки установки для Cursor и VS Code в README ведут на страницы `/mcp/deeplink` этого сайта.
Можно ли раздавать собственные скиллы через сайт Docus?
Да. Файлы из папки `skills/` сайт отдает по адресу `/.well-known/skills/`, а пользователи ставят их командой `npx skills add https://your-docs-domain.com`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыCLI и скилл: агент публикует отчеты как HTML-документы, команда их комментирует, а каждая версия сохраняется
Четыре плагина Claude Code от Mintlify: чтение чужой документации, соавторство, автономное письмо с запросом на слияние и проверка текстов по стилю
md-to-docx собирает из Markdown готовый документ Word: таблицы, сноски, подписи рисунков, колонтитулы и подстановку в шаблон.
Скилл, MCP-сервер и CLI превращают Markdown от агента в короткую ссылку на веб-страницу, которую открывают без входа.
Скилл-конвейер документов: что угодно в markdown, markdown в аккуратный html и docx уровня издательства, html обратно в markdown
Официальный набор скиллов «Золотых документов» WPS: Claude Code и Codex создают и правят облачные документы через kdocs-cli
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Docus (эта карточка) | нет | 3 126 | |
| Mintlify Workflows | да | 466 | строит и проверяет справку на Mintlify; скиллы Docus работают с Nuxt Content и разметкой MDC |
| AI Documentation Generator | нет | 771 | собирает README и конфиги по коду репозитория; здесь на выходе сайт справки с поиском и MCP |
Коротко о README
Репозиторий хранит исходники CLI `create-docus`, слоя `docus` для Nuxt, официальную документацию и стартовые шаблоны. Готовый сайт получает поиск, темную тему, поддержку нескольких языков и страницы `llms.txt` без дополнительной настройки.
Бейдж для README
Исходный SKILL.md
--- name: create-docs description: | Create complete documentation sites for projects. Use when asked to: "create docs", "add documentation", "setup docs site", "generate docs", "document my project", "write docs", "initialize documentation", "add a docs folder", "create a docs website". Generates Docus-based sites with search, dark mode, MCP server, and llms.txt integration. --- # Create Docs Generate a complete, production-ready documentation site for any project. ## Workflow 1. **Analyze** - Detect package manager, monorepo structure, read context 2. **Initialize** - Create docs directory with correct setup 3. **Generate** - Write documentation pages using templates 4. **Configure** - Set up AI integration (MCP, llms.txt) 5. **Finalize** - Provide next steps with correct commands --- ## Package Manager Reference Detect from lock files, default to npm if none found: | Lock File | PM | Install | Run | Add | |-----------|------|---------|-----|-----| | `pnpm-lock.yaml` | pnpm | `pnpm install` | `pnpm run` | `pnpm add` | | `package-lock.json` | npm | `npm install` | `npm run` | `npm install` | | `yarn.lock` | yarn | `yarn install` | `yarn` | `yarn add` | | `bun.lockb` | bun | `bun install` | `bun run` | `bun add` | Use `[pm]` as placeholder in commands below. --- ## Step 1: Analyze Project ### Detect Project Structure ``` Check for: