Принципы написания навыков для Claude Code на основе 159 открытых исходных навыков
Разработчик опубликовал 10 принципов написания эффективных навыков для Claude Code, выведенных из создания и поддержки открытого реестра навыков с 159 навыками. Принципы сосредоточены на практических шаблонах реализации, наблюдаемых в реальном использовании агентами.
Ключевые принципы написания навыков
- Не указывайте очевидное — Выводите Claude за пределы его стандартного поведения, а не укрепляйте его
- Раздел с подводными камнями — Считается контентом с самой высокой окупаемостью инвестиций в любом навыке
- Навыки — это папки, а не файлы — Используйте подкаталоги references/, scripts/, assets/
- Не ограничивайте жёстко — Предоставляйте рекомендации вместо жёстких последовательностей шагов
- Первоначальная настройка через config.json — Размещайте файлы конфигурации непосредственно в папке навыка
- Поле описания — это условие запуска — Не просто краткое описание
- Дайте навыкам память — Используйте логи, JSON или SQLite между запусками
- Поставляйте скрипты вместе с описанием — Пример: fetch_events.py ценнее, чем 200 строк объяснений
- Хуки по требованию — Используйте блоки /careful для ограничения деструктивных команд только при вызове
- Навыки комбинируются — Ссылайтесь на другие навыки по имени; Claude будет вызывать их, если они установлены
Детали реализации
Принципы взяты из репозитория AbsolutelySkilled (github.com/AbsolutelySkilled/AbsolutelySkilled), который содержит 159 открытых навыков. Все навыки можно установить через npx skills add. Разработчик подчёркивает, что эти шаблоны возникли из наблюдений за тем, как агенты фактически используют навыки на практике, а не из теоретического проектирования.
Для разработчиков, создающих навыки для ИИ-агентов программирования, эти принципы дают конкретные рекомендации по эффективной структуризации навыков. Акцент на практической реализации — например, использование папок вместо отдельных файлов и включение реальных скриптов, а не только объяснений — отражает реальные модели использования.
📖 Прочитать полный источник: r/ClaudeAI
👀 Смотрите также
Onboarding в OpenClaw: как правильно обучить своего AI-агента
Замена стандартной памяти OpenClaw на Redis и Qdrant для производственных мультиагентных систем
Разработчик заменил стандартную память SQLite в OpenClaw на Redis для временного состояния и Qdrant для постоянной векторной памяти, чтобы решить проблемы масштабирования в многозадачных агентных системах, реализовав семантический поиск, обмен данными между агентами и параллельную запись.
Настройка Qwen3.5-27B локально: сравнение vLLM и llama.cpp
Пользователь Reddit делится практическими советами по локальному запуску Qwen3.5-27B, сравнивая бэкенды llama.cpp и vLLM с конкретными рекомендациями по настройке и результатами тестирования.
Запись на Reddit: Разработчикам нужны лучшие практики работы с ИИ, а не просто лучшие инструменты
В посте на Reddit утверждается, что недовольство разработчиков инструментами ИИ для написания кода проистекает из плохих практик составления промптов, а именно из использования «сырых промптов» без контекста или структуры. Автор рекомендует использовать каркасы, такие как CLAUDE.md, и структурированные рабочие процессы для получения готового к производству кода от Claude.