best-skills

16 готовых скиллов для Cursor, Claude Code и Codex: диссертации, PDF и Office, схемы draw.io, документация проекта

  • 3 129 ★ репозитория
  • Последний коммит
  • Apache-2.0
Скилл

Расширенный доступ

Почему такой уровень

  • Скиллы читают и создают файлы Office и PDF, а `project-docs` пишет в папку `docs/` проекта
  • `office-file-process` и pdf запускают локальные программы: `pandoc`, Python и Node-библиотеки, при отсутствии них на Windows подключают Office через COM
Все причины и проверки

xstongxue/best-skills

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/best-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скиллы читают и создают файлы Office и PDF, а `project-docs` пишет в папку `docs/` проекта
  • `office-file-process` и pdf запускают локальные программы: `pandoc`, Python и Node-библиотеки, при отсутствии них на Windows подключают Office через COM

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

best-skills — сборник из 16 скиллов в папке `skills/`, каждый со своим SKILL.md. Агент подхватывает скилл сам, когда запрос совпадает с ключевыми словами из поля `description`, вызывать вручную ничего не нужно. Автор противопоставляет сборник своему `best-prompts`: там промпты копируют в окно чата, здесь агент выбирает инструкцию автоматически. Набор делится на четыре группы. Для писем и текстов: `paper-write` (проверка плана диссертации, имитация структуры образца, правка текста, список литературы), `patent-write`, `wechat-article-writer` с обложками для статей WeChat и `md-report-summary`. Для схем: `drawio-diagram` (архитектура нейросетей, UML-диаграммы, учебные чертежи по математике, физике, химии и другим предметам), `excalidraw-diagram` с рукописным стилем и `pptgen-drawio`, которая собирает защитные презентации в нескольких стилях. Для файлов: `office-file-process` читает и создает Word, Excel и PowerPoint, pdf извлекает текст и таблицы, склеивает, делит и защищает документы, распознает сканы. Для кода: `project-docs` пишет девять вводных документов о проекте в папку `docs/` со ссылками вида путь:строка, а `codegen-doc` пишет по коду разделы работы, обзор проекта и описание проекта для резюме. Еще два скилла собирают собственные скиллы: skill-create создает новый скилл по описанию задачи, skill-prompt-convert переводит скилл в обычный промпт и обратно.

Для кого. Студентам, исследователям и разработчикам, которые пишут диссертации, документацию и схемы с помощью Cursor, Claude Code или Codex и читают по-китайски.

Подходит, если

  • Диплом или диссертация на подходе: `paper-write` проверит план, перепишет главу по образцу и поможет с литературой
  • Новому коллеге нужен вход в проект: `project-docs` составит девять документов в `docs/` и привяжет код к файлам и строкам
  • Архитектуру модели или последовательность запросов надо показать на схеме: `drawio-diagram` выдает файл для редактирования в draw.io
  • К защите нужна презентация: `pptgen-drawio` собирает слайды из исходника draw.io в нескольких стилях
  • Из PDF нужны таблицы или текст, а скан не читается: навык pdf распознает его через OCR

Не подходит, если

  • Нужен один узкий скилл с командой установки: здесь копируют папки вручную, а набор шире задачи
  • Тексты и сценарии работы нужны на русском: описания скиллов и примеры написаны по-китайски
  • Среда запрещает запуск локальных программ: pdf и `office-file-process` опираются на `pandoc`, Python и Node-библиотеки

Пример запроса к агенту

Проверь план моей магистерской по машинному обучению и скажи, какие разделы нужно развернуть, потом нарисуй схему архитектуры модели в draw.io

Ограничения

  • Команды установки нет: папки из `skills/` копируют в каталог навыков агента, например `.claude/skills/` или `.cursor/skills/`. Пути в README даны для Windows.
  • Описания, триггеры и примеры запросов на китайском, поэтому русскоязычному агенту подсказки придется давать переводом.
  • `office-file-process` при отсутствии `pandoc` и `markitdown` переходит на автоматизацию Windows Office COM, а создает файлы через `docx-js`, `pptxgenjs` и `openpyxl`.
  • Последний коммит датирован 13 сентября 2026 года.

Как отключить. Удалите из каталога навыков агента папки, которые вы копировали из `skills/`. Агент перестанет подхватывать скиллы сразу, перезапуск нужен не во всех клиентах.

Частые вопросы

Как поставить best-skills в Claude Code?

Скопируйте нужные папки из `skills/` в `.claude/skills/` проекта или в домашний каталог `~/.claude/skills/`. Автоматической установки у репозитория нет, зато можно взять один скилл из шестнадцати, не трогая остальные.

Нужно ли вызывать скиллы командой?

Нет. Агент сам решает, подходит ли скилл, по ключевым словам в его `description`, поэтому достаточно сформулировать задачу, например «объедини эти PDF» или «напиши документы для новичка в проекте».

Что умеет `project-docs` из этого набора?

Он пишет девять документов в папку `docs/`: архитектуру, идеи проекта, обзор кода, модель выполнения, сборку, интеграцию, отладку и правила оформления. Если папка уже заполнена, скилл спрашивает, перезаписать, пропустить или сделать копию в `docs.bak/`.

Чем best-skills отличается от одиночного скилла для draw.io?

Здесь `drawio-diagram` — одна из шестнадцати папок, рядом лежат скиллы для PDF, Office, диссертаций и документации. Если нужна только draw.io с экспортом, проще поставить отдельный скилл.

Какие агенты подходят для best-skills?

README называет Cursor, Claude Code, Codex и OpenCode, а в списке документации еще Trae, GitHub Copilot и OpenClaw. Папки с SKILL.md копируют в каталог навыков нужного клиента, формат у всех общий.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Набор из трех скиллов для научной работы: письмо статей, учебные документы Word и PowerPoint, научные расчеты и графики

СкиллРасширенный доступ5,7 тыс.Звезды репозитория

Три скилла для академических текстов: схема статьи для генерации иллюстрации, переписывание текста без машинного звучания и написание с нуля

СкиллМинимальный доступ10Звезды репозитория

Четыре скилла для Codex и Claude Code собирают редактируемые PPTX и Word-отчеты, демо-ролики сайтов и карточки для Xiaohongshu.

СкиллРасширенный доступ178Звезды репозитория

Скилл верстает по шаблонам резюме, одностраничники, письма, отчеты и слайды в PDF, PNG и PPTX и проверяет результат скриптами до выдачи

СкиллРасширенный доступ12,3 тыс.Звезды репозитория

CLI превращает PDF, видео, веб-страницы, аудио и репозитории в учебные пакеты с тестами и карточками, а также в каталоги SKILL.md

CLIРасширенный доступ345Звезды репозитория

Скилл с 30 шаблонами промптов для научных статей на английском и китайском: от обзора литературы до заявки на грант

СкиллМинимальный доступ542Звезды репозитория

Коротко о README

README открывается примерами результатов: обложки статей, рукописные схемы, защитные презентации и учебные чертежи. Затем идут таблицы по группам задач с примерами фраз для агента, список способов установки по клиентам (Cursor, Claude Code, Codex, OpenCode) и подборка сайтов и репозиториев со скиллами. Лицензия Apache-2.0.

Бейдж для README

Исходный SKILL.md

---
name: project-docs
description: 对任意代码项目生成一套面向新人的循序渐进文档集,输出到 docs/ 目录。含架构、设计思想、语言特性、代码导读、运行时模型、构建、对接、调试、设计规范共 9 篇,支持全部生成 / 只写几篇 / 更新已有文档。当用户提到"生成项目文档"、"新人文档"、"上手文档"、"架构文档"、"代码导读"、"项目理解"、"深入理解项目"、"onboarding 文档"、"给新同事看的文档"时使用。要按用户给的格式写论文章节、项目梳理、重点问题、简历项目描述的,用 codegen-doc。
---

# project-docs:项目深度文档生成

输出到项目的 `docs/` 目录。核心约束:文档里的代码、类名、路径都必须来自真实文件,见 Phase 3。

## Step 0:判断要做哪种

| 用户表述 | 做什么 |
|---|---|
| 生成项目文档 / 新人文档 / 深入理解项目(没指定篇目) | 全部生成,Phase 1 → 2 → 3 → 4 |
| 帮我写架构文档 / 只要代码导读 / 写构建和调试 | 只写指定的几篇,读项目的范围可相应缩小 |
| 代码改了,更新文档 / 文档过期了 | 读 `docs/.project-map.md`,比对现在的代码,只重写受影响的篇目 |

**`docs/` 已经有内容时**:先列出已有文件,问用户是覆盖、跳过已存在的、还是备份到 `docs.bak/`。不要直接盖掉。

**不该用这个 skill 的情况**:用户要的是论文章节、项目梳理、重点问题清单、简历项目描述——也就是给导师、评委、HR、领导看,且格式由对方指定的东西,用 **codegen-doc**。这个 skill 只管给新同事看、要能照着上手的文档。

---

## Phase 1:先读项目,把结果记下来

记到 `docs/.project-map.md`。后面每一篇要用的路径、类名、代码,都从这个文件取。

分三步读,**不要试图把所有源文件都读完**:

1. **看轮廓** —— 目录树、构建和依赖文件、README,判断用什么语言、属于哪类项目
2. **看骨架** —— 入口文件读全文、接口和类型定义、列出每个模块干什么
3. **跟一个完整例子走一遍** —— 挑一个有代表性的示例或功能,从入口追到结束

怎么读、记成什么格式、什么时候可以停,见 [reference/explore.md](reference/explore.md)。把那份模板填完再进 Phase 2,其中术语表至少 5 条。

---

## Phase 2:按项目类型决定写哪几篇

```
01_architecture.md        → 架构:项目长什么样
02_philosophy.md          → 思想:为什么这样设计
03_lang_concepts.md       → 语言特性:读代码前的准备
04_code_walkthrough.md    → 代码导读:跟着真实流程走一遍
05_runtime_model.md       → 运行时:并发和生命周期
06_build_guide.md         → 构建:怎么编译运行
07_integration_guide.md   → 对接:怎么写新功能
08_debug_guide.md         → 调试:出问题怎么查
09_design_conventions.md  → 规范:怎么设计得更好
```

Сообщить о проблеме

Foxx AIbest-skills
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.