Lessons from Building Claude Code: How We Use Skills

Skills have become one of the most used extension points in Claude Code. They’re flexible, easy to make, and simple to distribute.

Навыки (Skills) стали одной из самых популярных точек расширения в Claude Code. Они гибкие, их легко создавать и просто распространять.

But this flexibility also makes it hard to know what works best. What type of skills are worth making? What’s the secret to writing a good skill? When do you share them with others?

Но эта гибкость также усложняет понимание того, что работает лучше всего. Какие типы навыков стоит создавать? В чем секрет написания хорошего навыка? Когда стоит делиться ими с другими?

We’ve been using skills in Claude Code extensively at Anthropic with hundreds of them in active use. These are the lessons we’ve learned about using skills to accelerate our development.

В Anthropic мы активно используем навыки в Claude Code — сотни из них находятся в постоянной эксплуатации. Вот уроки, которые мы извлекли об использовании навыков для ускорения нашей разработки.

What are Skills? / Что такое Навыки?

A common misconception we hear about skills is that they are “just markdown files”, but the most interesting part of skills is that they’re not just text files. They’re folders that can include scripts, assets, data, etc. that the agent can discover, explore and manipulate.

Распространенное заблуждение о навыках заключается в том, что это «просто файлы markdown», но самое интересное в навыках то, что это не просто текстовые файлы. Это папки, которые могут включать скрипты, ресурсы, данные и т. д., которые агент может обнаруживать, изучать и которыми может манипулировать.

In Claude Code, skills also have a wide variety of configuration options including registering dynamic hooks. We’ve found that some of the most interesting skills in Claude Code use these configuration options and folder structure creatively.

В Claude Code навыки также имеют широкий спектр параметров конфигурации, включая регистрацию динамических хуков. Мы обнаружили, что некоторые из самых интересных навыков в Claude Code творчески используют эти параметры конфигурации и структуру папок.

Types of Skills / Типы Навыков

After cataloging all of our skills, we noticed they cluster into a few recurring categories. The best skills fit cleanly into one; the more confusing ones straddle several. This isn’t a definitive list, but it is a good way to think about if you’re missing any inside of your org.

Каталогизировав все наши навыки, мы заметили, что они группируются в несколько повторяющихся категорий. Лучшие навыки четко вписываются в одну; более запутанные — охватывают сразу несколько. Это не окончательный список, но это хороший способ подумать о том, не упускаете ли вы что-то внутри своей организации.

1. Library & API Reference / Справочники библиотек и API

Skills that explain how to correctly use a library, CLI, or SDKs. These could be both for internal libraries or common libraries that Claude Code sometimes has trouble with. These skills often included a folder of reference code snippets and a list of gotchas for Claude to avoid when writing a script.

Навыки, объясняющие, как правильно использовать библиотеку, CLI или SDK. Это могут быть как внутренние библиотеки, так и распространенные библиотеки, с которыми у Claude Code иногда возникают трудности. Эти навыки часто включают папку с примерами кода и список «подводных камней» (gotchas), которых Claude должен избегать при написании скриптов.

Examples: billing-lib, internal-platform-cli, frontend-design.

2. Product Verification / Верификация продукта

Skills that describe how to test or verify that your code is working. These are often paired with an external tool like playwright, tmux, etc. for doing the verification. Verification skills are extremely useful for ensuring Claude’s output is correct.

Навыки, описывающие, как протестировать или проверить работоспособность вашего кода. Они часто работают в паре с внешними инструментами, такими как Playwright, tmux и т. д. Навыки верификации чрезвычайно полезны для обеспечения корректности вывода Claude.

Consider techniques like having Claude record a video of its output or enforcing programmatic assertions on state.

Рассмотрите такие методы, как запись видео вывода Claude или использование программных проверок состояния (assertions) на каждом этапе.

3. Data Fetching & Analysis / Сбор и анализ данных

Skills that connect to your data and monitoring stacks. These skills might include libraries to fetch your data with credentials, specific dashboard ids, etc.

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

Examples: funnel-query, cohort-compare, grafana.

4. Business Process & Team Automation / Бизнес-процессы и командная автоматизация

Skills that automate repetitive workflows into one command. These skills are usually fairly simple instructions but might have more complicated dependencies on other skills or MCPs. For these skills, saving previous results in log files can help the model stay consistent.

Навыки, автоматизирующие повторяющиеся рабочие процессы в одну команду. Обычно это довольно простые инструкции, но они могут иметь сложные зависимости от других навыков или MCP. Для таких навыков сохранение предыдущих результатов в лог-файлах помогает модели оставаться последовательной.

5. Code Scaffolding & Templates / Шаблоны и генерация кода (Scaffolding)

Skills that generate framework boilerplate for a specific function in codebase. You might combine these skills with scripts that can be composed.

Навыки, генерирующие заготовки (boilerplate) фреймворка для конкретной функции в кодовой базе. Вы можете объединять эти навыки со скриптами, которые можно комбинировать.

Examples: new-framework-workflow, create-app.

6. Code Quality & Review / Качество кода и ревью

Skills that enforce code quality inside of your org and help review code. These can include deterministic scripts or tools for maximum robustness.

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

Examples: adversarial-review, code-style.

7. CI/CD & Deployment / CI/CD и развертывание

Skills that help you fetch, push, and deploy code inside of your codebase.

Навыки, которые помогают получать, отправлять и развертывать код внутри вашей кодовой базы.

Examples: babysit-pr, deploy-service.

8. Runbooks / Ранбуки (инструкции по эксплуатации)

Skills that take a symptom, walk through a multi-tool investigation, and produce a structured report.

Навыки, которые принимают «симптом», проводят исследование с использованием нескольких инструментов и создают структурированный отчет.

Examples: service-debugging, oncall-runner.

9. Infrastructure Operations / Инфраструктурные операции

Skills that perform routine maintenance and operational procedures — some of which involve destructive actions that benefit from guardrails.

Навыки, выполняющие рутинное обслуживание и операционные процедуры — некоторые из них включают деструктивные действия, требующие защитных барьеров (guardrails).

Examples: resource-orphans, dependency-management.

Tips for Making Skills / Советы по созданию Навыков

Don’t State the Obvious / Не констатируйте очевидное: Focus on information that pushes Claude out of its normal way of thinking.

Сфокусируйтесь на информации, которая выводит Claude за рамки его привычного мышления.

Build a Gotchas Section / Создайте раздел «Подводные камни»: The highest-signal content in any skill.

Это контент с самым высоким приоритетом (сигналом) в любом навыке.

Use the File System & Progressive Disclosure / Используйте файловую систему и метод раскрытия по необходимости: A skill is a folder. Split detailed references into subfiles.

Навык — это папка. Разделяйте подробные справочные материалы на подфайлы.

Avoid Railroading Claude / Не ограничивайте Claude слишком жестко: Give it information, but let it adapt.

Дайте ему информацию, но позвольте адаптироваться к ситуации.

Think through the Setup / Продумайте настройку: Use config.json or AskUserQuestion for user-specific data.

Используйте config.json или инструмент AskUserQuestion для данных, специфичных для пользователя.

Memory & Storing Data / Память и хранение данных: Skills can keep logs (e.g., standups.log) to track history.

Навыки могут вести логи (например, standups.log) для отслеживания истории.

Store Scripts & Generate Code / Храните скрипты и генерируйте код: Giving Claude code lets it spend turns on composition.

Предоставление Claude готового кода позволяет ему тратить свои «ходы» на композицию, а не на написание бойлерплейта.

Conclusion / Заключение

Skills are incredibly powerful, flexible tools for agents. The best way to understand skills is to get started, experiment, and see what works for you. Most of ours began as a few lines and a single gotcha, and got better because people kept adding to them as Claude hit new edge cases.

Навыки — это невероятно мощные и гибкие инструменты для агентов. Лучший способ понять их — начать действовать, экспериментировать и смотреть, что подходит именно вам. Большинство наших навыков начинались как несколько строк и один «подводный камень», и становились лучше по мере того, как люди дополняли их, сталкивая Claude с новыми крайними случаями.