Первый навык

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

Демонстрация в этой статье основана на Claude Code. Если вы ещё не установили его, можете обратиться к нашемуучебнику по Claude Code。

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

Навыки хранятся в~/.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: Краткое описание Skill и когда его использовать (до 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 to calculate 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, выпущенным в конце 2025 года:

  • Официальный маркетплейс: посетитеhttps://github.com/anthropics/skillsрепозиторий, чтобы скачать готовые навыки (например, оптимизатор React, инструменты настройки SQL).
  • Skill Creator: Вы можете сказать Claude: «Помоги мне обобщить логику конфигурации Docker, которую я только что вам объяснил, в Skill», и он автоматически создаст файлы для вас в соответствующем каталоге.

Мы можем зарегистрировать этот репозиторий как маркетплейс плагинов для Claude Code, просто выполнив следующую команду в Claude Code:

/plugin marketplace add anthropics/skills

Затем вы можете использовать/plugin для просмотра:

Шаги для установки конкретного набора навыков:

  • Просмотр и установка плагинов (Просмотр и установка плагинов)
  • Выберите источник плагина anthropic-agent-skills

  • Выберите document-skills (навыки для документов) или example-skills (примеры навыков)

  • Нажмите Установить сейчас (Установить сейчас)

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

/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Примечание:Каталог skills, установленный через плагины, находится~/claude/plugins/marketplaces/под.

После завершения установки плагина необходимо перезапустить Claude Code.

При использовании просто упомяните название навыка в инструкции, чтобы вызвать его. Например, после установки плагина document-skills вы можете дать Claude Code инструкцию:

使用 PDF 技能提取 path/to/some-file.pdf 文件中的表单字段

Или создайте PPT:

创建一个 Agent Skill 的演示文稿

Вы можете видеть, что он вызвал/document-skills:pptx:

и начал генерировать:

После этого он сообщит вам расположение созданного файла:

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