Руководство по навыкам

Навыки — это по сути инструкции по эксплуатации, которые учат ИИ выполнять действия по фиксированному процессу. После написания их можно вызывать повторно, как функции.

Мы можем рассматривать навыки какКак профессионально выполнять определённый тип задачЭто «как делать» упаковывается в переиспользуемый, автоматически срабатывающий модуль возможностей.

Навыки существуют в виде файлов Markdown. Они не выполняют функции; вместо этого за счёт загрузки по требованию и постепенного раскрытия они обеспечивают эффективную и многократно используемую передачу знаний.

Самое большое отличие навыков от традиционных промптов: загрузка по требованию + прогрессивное раскрытие (толстый SOP добавляется в контекст только при необходимости, что экономит много токенов).

Пункт сравнения	Обычный промпт	Механизм Skills
Приходится описывать заново каждый раз	Да	Нет (описывается только один раз)
Использование длины контекста	Полная загрузка каждый раз	Прогрессивная загрузка (полное содержимое читается только при срабатывании)
Согласованность	Зависит от качества каждого промпта	Высокая (фиксированная SOP + шаблоны)
Переиспользуемость	Ручное копирование и вставка	Автоматическое сопоставление / слэш-команды / совместное использование проекта
Способ поддержки	Любое изменение промпта требует повторной отправки	Изменение файла SKILL.md; действует глобально/для проекта

Например, когда мы обычно пишем статьи, до появления Skills нам приходилось каждый раз повторять следующие шаги:

帮我总结文章 → 翻译 → 改成公众号风格 → 加标题 → 输出 Markdown

Со Skills:

Достаточно одной фразы:

使用「技术文章转公众号」Skill

ИИ автоматически выполнит действия согласно заданным вами шагам.

Представьте ИИ какУмного, но неопытного стажёра-выпускника：

• Обычный промпт= Вам приходится каждый раз учить его всему с нуля (сегодня научили — завтра переучивать)
• Правило / Память= Вы вешаете на его рабочем месте «корпоративный кодекс поведения» (действует всегда, но регулирует только отношение к работе и формат)
• MCP / Инструменты= Вы устанавливаете на его компьютер кучу программ и API (он может вызывать внешние инструменты, но не знает, когда их использовать и как их комбинировать)
• Skills= Вы сразу даёте ему целый набор"Пакет обучения работе"(PDF + блок-схема + SOP + шаблоны скриптов для разговора + типовые скрипты), и говорите ему: "Когда начальник попросит тебя сделать что-то подобное, следуй методам из этой папки."

Популярные клиенты, которые в настоящее время поддерживают Skills:

Рейтинг	Название инструмента	Бесплатно ли использовать Skills	Рекомендуемые пользователи	Путь по умолчанию для хранения навыков	Примечания
1	Claude Code	Да (официально)	Все	~/.claude/skills	Законодатель стандартов, самая всеобъемлющая экосистема
2	Cursor	Да	Чаще всего используется для программирования	~/.cursor/skills	Почти бесшовно совместим с Claude Skills
3	Trae / OpenCode	Да	Ищущие выгодные предложения	Зависит от настроек инструмента	Больше пользователей в Китае
4	VS Code + плагин	Частичная поддержка	Уже глубоко используют VS Code	Настройка в настройках плагина	Быстро догоняет
5	Coze / другие китайские платформы	Частичная поддержка	Предпочитайте веб-версию	Платформа включает маркетплейс навыков	Некоторые требуют членства

Разница между навыками и MCP:Навыки используются дляповторного использования знаний, MCP используется длярасширения возможностей。

---

Основная структура навыка

В основе навыков лежит:Папка + файл SKILL.md。

Файл SKILL.md содержит:

• Метаданные (как минимум имя и описание)
• Инструкции, сообщающие ИИ, как выполнить конкретную задачу

Навык — это по сути файл Markdown (имя файла фиксировано как SKILL.md)

my-skill/
└── SKILL.md   （唯一必需）

Базовый шаблон SKILL.md:

---
name: pdf-processing
description: 从 PDF 中提取文本和表格，填写表单，并合并文档
---

# PDF 处理

## 使用场景
当需要对 PDF 文件进行操作时使用，例如：

- 提取 PDF 文本或表格数据
- 填写 PDF 表单
- 合并多个 PDF 文件

## 提取文本
- 使用 `pdfplumber` 提取文本型 PDF 内容  
- 扫描版 PDF 需配合 OCR 工具  

## 填写表单
- 读取 PDF 表单字段  
- 按输入数据填充并生成新文件  

Минимальный обязательный пример:

---
name: skill-name
description: 说明该 Skill 的功能以及适用场景
---

Пример с необязательными полями:

---
name: pdf-processing
description: 从 PDF 中提取文本和表格，填写表单，并合并文档
license: Apache-2.0
metadata:
  author: example-org
  version: "1.0"
---

Поле	Обязательный	Описание
name	Да	Имя навыка, до 64 символов, можно использовать только строчные буквы, цифры и-, и не может начинаться или заканчиваться на-начало или конец
description	Да	Описание функциональности и сценариев использования, до 1024 символов, не может быть пустым
license	нет	Название лицензии или указатель на файл лицензии, поставляемый со Skill
совместимость	нет	Описание окружения и зависимостей (продукты, системные пакеты, сетевые разрешения и т. д.), до 500 символов
metadata	нет	Пользовательские пары ключ-значение для расширения метаданных (например, автор, версия)
allowed-tools	нет	Список разрешённых инструментов (разделённые пробелами, экспериментальная функция)

Если вам нужны справочные материалы, примеры для справки или скрипты выполнения, вы можете использовать структуру каталогов более сложного навыка:

my-skill/
├── SKILL.md      # 必需：指令 + 元数据
├── scripts/      # 可选：可执行代码
├── references/   # 可选：文档资料
└── assets/       # 可选：模板、资源

Как работают навыки

Навыки используют прогрессивную загрузку для эффективного управления контекстом:

• Обнаружение:При запуске ИИ загружает только имя и описание каждого навыка, сохраняя только самую базовую идентификационную информацию.
• Активация:Когда задача соответствует описанию навыка, ИИ загружает полные инструкции SKILL.md в контекст.
• Выполнение:ИИ выполняет инструкции, загружая справочные файлы или запуская код по требованию.

Такое решение позволяет ИИ оставаться быстрым и при этом получать больше информации по требованию.

---

Навыки Claude Code

Далее на примере Claude Code создадим простой навык.

Claude Code ищет и загружает навыки в следующем порядке (чем конкретнее местоположение, тем выше приоритет):

Уровень	Путь	Область действия
Корпоративный	Настраивается через консоль администратора (управляемые настройки)	Все пользователи в организации
Личный	~/.claude/skills/<skill-name>/SKILL.md	Все ваши проекты
Проект	.claude/skills/<skill-name>/SKILL.md	Только текущий проект
Плагин	<plugin>/skills/<skill-name>/SKILL.md	Среды, в которых включён этот плагин

Каждый навык — это папка, и имя папки является идентификатором навыка (kebab-case, строчные буквы + дефисы, рекомендуется).

Минимальная структура:

~/.claude/skills/
  └── code-comment-expert/          # 技能文件夹名
      └── SKILL.md                  # 唯一必填文件（必须全大写 + .md 小写）

Полный формат SKILL.md:

---                                 #  YAML frontmatter 开始（顶格）
name: code-comment-expert           # 必填：技能名（也是 /slash 命令名）
description: >-                     # 必填：最关键一行！Claude 靠它判断是否加载
  为代码添加专业、清晰的中英双语注释。
  适合缺少文档、可读性差、需要分享审查的代码。
  常见触发场景：加注释、注释一下、加文档、explain this、improve readability

trigger_keywords:                   # 强烈推荐（大幅提升自动触发率）
  - 加注释
  - 注释
  - 加文档
  - explain code
  - document
  - comment this
  - readability

version: 1.0                        # 可选
author: yourname                    # 可选
---                                 # ← YAML 结束

# 这里开始是正文（Markdown）—— Claude 真正执行时的指令

你现在是「专业代码注释专家」。

## 核心原则
- 只在缺少注释或可读性明显不足处添加
- 优先使用英文 JSDoc / TSDoc 风格
- 复杂逻辑 / 非明显意图处额外加一行中文解释
- 注释精炼，每行不超过 80 字符
- 绝不修改原有逻辑

## 输出格式（严格遵守）
1. 先输出完整修改后的代码块（用 ```语言 包裹）
2. 再用 diff 形式展示只改动注释的部分
3. 最后说明加了哪些注释、理由

现在直接开始处理用户提供的代码，不要闲聊。

Расширенная структура файлов (рекомендуется, когда навыки становятся сложными)

Когда навык превышает 500–800 строк или требует шаблонов/скриптов/справочных материалов, рекомендуется следующая организация:

~/.claude/skills/react-component-review/
  ├── SKILL.md                  # 核心指令 + 元数据（建议控制在 400 行内）
  │
  ├── templates/                # 常用模板（Claude 按需读取）
  │   ├── functional.tsx.md
  │   └── class-component.md
  │
  ├── examples/                 # 优秀/反例（给 Claude 看标准）
  │   ├── good.md
  │   └── anti-pattern.md
  │
  ├── references/               # 规范、规则、禁用词表
  │   ├── hooks-rules.md
  │   └── naming-convention.md
  │
  └── scripts/                  # 可执行脚本（需开启 code execution）
      ├── validate-props.py
      └── check-cycle-deps.sh

Пример ссылки в SKILL.md:

Markdown需要给出标准函数组件时，参考 templates/functional.tsx.md 的结构。

如果违反 Hooks 规则，对照 references/hooks-rules.md 第 3–5 条说明。

如需校验 propTypes，可执行 scripts/validate-props.py "{代码片段}"。

После того как Claude видит ссылку на путь, он загружает соответствующий файл по требованию, а не вставляет всё в контекст сразу, что значительно экономит токены.

---

Ваш первый навык

Давайте временно забудем о сложном процессе создания и начнём сиспользования готового навыка, чтобы ощутить удобство, которое он приносит.

Создайте каталог навыков

Навыки хранятся в~/.claude/skills/(персональные глобальные) или в каталоге проекта.claude/skills/(для конкретного проекта).

В этом разделе проверка выполняется в каталоге проекта. Сначала создайте каталог claude-test:

mkdir claude-test

Перейдите в этот каталог, создайте каталог skills и файлы:

mkdir -p .claude/skills/python-naming-standard

Напишите файл конфигурации SKILL.md

Создайте SKILL.md в этом каталоге. Это мозг навыка, который сообщает Claude, когда его использовать.

---
name: Python 内部命名规范技能
description: 当用户要求重构、审查或编写 Python 代码时，请参考此规范。
---

## 指令
1. 所有的内部辅助函数必须以 `_internal_` 前缀命名。
2. 如果发现不符合此规则的代码，请自动提出修改建议。
3. 在执行 `claude commit` 前，必须检查此规范。

## 参考示例
- 正确：`def _internal_calculate_risk():`
- 错误：`def _calculate_risk():`

Требования к полям:

• name: Должно состоять только из строчных букв, цифр и дефисов (максимум 64 символа)
• description: Краткое описание навыка и того, когда его использовать (максимум 1024 символа)

После создания структура файлов выглядит так:

Теперь ваш проект должен выглядеть так:

my-project/
├─ src/
│  └─ test.py              # 项目源码
├─ .claude/
│  ├─ skills/
│  │  └─ hello-world/
│  │     ├─ skill.md       # Skill 定义（YAML + Instructions，机器可执行）
│  │     └─ README.md      # Skill 说明（人类阅读，可选）
│  └─ config.yml           # Claude 项目级配置（可选）
├─ .gitignore
└─ README.md               # 项目整体说明

Затем выполните следующую команду в терминале, чтобы запустить Claude Code:

claude

Введите задачу:

Help me write a function that calculates user discounts.

Claude просканирует установленные Skills, обнаружит, что ваш запрос связан с "написанием кода на Python", и сопоставит его с python-naming-standard.

Он сгенерирует следующий код на основе требований в SKILL.md:

def _internal_get_discount(user_score):
    # 计算逻辑...
    return discount

Добавьте файлы ресурсов (необязательно)

Кроме того, мы можем добавить следующие каталоги в.claude/skills/:

Добавьте в ту же папку:

• examples/: Хранит примеры файлов.
• references/: Хранит справочные документы.
• scripts/: Хранит исполняемые скрипты (например, Python для обработки PDF).

Затем укажите ссылки на них в SKILL.md:

查看示例 commit：./examples/good-commit.txt
运行脚本：使用工具执行 ./scripts/process.py

---

Подборка ресурсов, связанных с Agent Skills

Описание ресурса	Ссылка
Точка входа агрегации навыков	https://skills.sh/
Магазин навыков (китайский интерфейс)	https://skillsmp.com/zh
Магазин навыков Tencent	https://skillhub.tencent.com/
Официальный сайт стандарта Agent Skills	https://agentskills.io
Официальная инженерная статья Anthropic (практические концепции Agent Skills)	https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
Документация VS Code Copilot Agent Skills	https://code.visualstudio.com/docs/copilot/customization/agent-skills
Официальный репозиторий Anthropic Skills на GitHub	https://github.com/anthropics/skills
Курируемый список навыков Claude (серия Awesome)	https://github.com/ComposioHQ/awesome-claude-skills
Коллекция навыков автоматизации рабочего процесса разработки программного обеспечения	https://github.com/obra/superpowers
Навык, который автоматически генерирует навыки (официальный пример)	https://github.com/anthropics/skills/tree/main/skills/skill-creator

Рекомендуемые навыки:

Навык	Основная функция	Команда установки
find-skills (vercel-labs)	Центр поиска и рекомендаций навыков	npx skills add vercel-labs/skills
vercel-react-best-practices	Стандарты оптимизации производительности React / Next	npx skills add vercel-labs/agent-skills --skill vercel-react-best-practices
frontend-design (anthropics)	Возможность высококачественного UI-дизайна	npx skills add anthropics/skills --skill frontend-design
web-design-guidelines	Стандарты веб-доступности и UX	npx skills add vercel-labs/agent-skills --skill web-design-guidelines
remotion-best-practices	Лучшие практики видеопроизводства с React	npx skills add remotion-dev/skills --skill remotion-best-practices
мозговой штурм (суперспособности)	Способность к структурированному мышлению и планированию	npx skills add obra/superpowers --skill brainstorming
agent-browser	Управление автоматизацией браузера	npx skills add vercel-labs/agent-browser
browser-use	Высокопроизводительное взаимодействие с браузером	npx skills add browser-use/browser-use
supabase-postgres-best-practices	Оптимизация Supabase / PostgreSQL	npx skills add supabase/agent-skills --skill supabase-postgres-best-practices
azure-cost-optimization	Оптимизация затрат на облако Azure	npx skills add microsoft/github-copilot-for-azure --skill azure-cost-optimization
cloudflare/skills	Практики Workers и периферийных вычислений	npx skills add cloudflare/skills
redis/agent-skills	Продвинутые паттерны и антипаттерны Redis	npx skills add redis/agent-skills
vercel-composition-patterns	Стандарты паттернов композиции React	npx skills add vercel-labs/agent-skills --skill vercel-composition-patterns
vercel-react-native-skills	Официальные лучшие практики React Native	npx skills add vercel-labs/agent-skills --skill vercel-react-native-skills
sleek-design-mobile-apps	Современное руководство по дизайну мобильных приложений	npx skills add sleekdotdesign/agent-skills --skill sleek-design-mobile-apps
ui-skills	Практики UI и взаимодействия уровня дизайнера	npx skills add ibelick/ui-skills
pdf (anthropics)	Возможность генерации и парсинга PDF	npx skills add anthropics/skills --skill pdf
seo-audit	SEO-аудит и оптимизация	npx skills add coreyhaines31/marketingskills --skill seo-audit
skill-creator	Возможность создания пользовательских навыков	npx skills add anthropics/skills --skill skill-creator
code-review-expert	Возможность профессионального ревью кода	npx skills add sanyuan0704/code-review-expert

Другие расширения