Конфигурация и мультифайловые скиллы

A basic skill works with just a name and description, but here are some other advanced tips that can make your skills really effective in claw code. Базовый skill работает только с именем и описанием, но вот ещё несколько продвинутых советов, которые сделают ваши skills по-настоящему эффективными в Claude Code. The agentskills.io open standard has many available fields. Открытый стандарт agentskills.io содержит множество доступных полей. We already went over the name, which identifies your skill, uses lowercase letters, numbers, and hyphens only. Мы уже разобрали поле name, которое идентифицирует ваш skill и использует только строчные буквы, цифры и дефисы. A maximum of 64 characters and should match your directory name. Максимум 64 символа, и оно должно совпадать с именем вашей директории. a description which is also required which tells Claude when to use the skill. Поле description, также обязательное, сообщает Claude, когда использовать skill. This is a maximum of,024 characters and is the most important field. Максимум 1 024 символа и самое важное поле. Claude uses this for matching. Claude использует его для сопоставления. But we can also add other optional fields. Но можно добавить и другие необязательные поля. One of them is the allowed tools field which restricts which tools Claude can use when the skill is active. Одно из них, поле allowed tools, ограничивает, какие инструменты Claude может использовать, пока skill активен. The model field which specifies which cla model to use for the skill. Поле model указывает, какую версию Claude применять для данного skill. Try to be explicit with your instructions. Старайтесь быть точными в своих инструкциях. For example, if someone told me my job was to help with dogs, I wouldn't know what to do. Например, если бы мне сказали, что моя работа состоит в том, чтобы помогать с собаками, я бы не знал, что делать. So, we have to assume Claude would think the same way. Значит, нужно предположить, что Claude думает так же. A good description answers two questions. Хорошее description отвечает на два вопроса. What does this skill do? Что делает этот skill? And when should Claus use it? И когда Claude должен его использовать? Now, if this job description was given to me, I feel a little bit more confident that I could get the job done. Получив такое описание работы, я чувствую себя заметно увереннее в том, что справлюсь. If your skill isn't triggering, add more keywords that match how you phrase requests. Если ваш skill не срабатывает, добавьте ключевые слова, соответствующие тому, как вы формулируете запросы. Sometimes you want a skill that can only read files, not modify them. Иногда нужен skill, который умеет только читать файлы, но не изменять их. This could be for security sensitive workflows, read only tasks or more. Это может быть нужно для безопасных рабочих процессов, задач только на чтение и других случаев. We have the allowed tools field to make this possible. Для этого существует поле allowed tools. When this skill is active, Claw can only use those tools without asking permission. Пока этот skill активен, Claude может использовать только указанные инструменты без запроса разрешения. No editing, no writing, no bash commands. Никакого редактирования, никакой записи, никаких bash-команд. If you omit allowed tools, the skill doesn't restrict anything. Если опустить allowed tools, skill ничего не ограничивает. Claude uses its normal permission model. Claude использует свою стандартную модель разрешений. Skills share Claw's context window with your conversation. Skills разделяют контекстное окно Claude с вашим диалогом. When Claude wants to use a skill, it will decide to load the contents of that skill into context. Когда Claude хочет применить skill, он решает загрузить содержимое этого skill в контекст. However, sometimes you'll need some references, examples, or some utility scripts that are required by the skill. Однако иногда вам потребуются справочные материалы, примеры или вспомогательные скрипты, необходимые для работы skill. But cramming it all into one 20,000 line text file means you take up a lot of space in the context window. Но запихивать всё это в один текстовый файл на 20 000 строк означает занимать огромное место в контекстном окне. And let's be real here, it's just not a lot of fun to maintain that. И, будем честны, поддерживать такое совсем не весело. This is where progressive disclosure comes in. Именно здесь помогает прогрессивное раскрытие. Put your essential instructions in skill.mmp and detailed reference material in separate files that Claude reads only when needed. Поместите основные инструкции в skill.md, а подробные справочные материалы в отдельные файлы, которые Claude читает только по мере необходимости. The open standard also suggests having a scripts folder for executable code, references for additional documentation and assets for images, templates or other data files that would be relevant for that skill. Открытый стандарт также рекомендует иметь папку scripts для исполняемого кода, references для дополнительной документации и assets для изображений, шаблонов или других файлов данных, нужных для данного skill. Then in skill.md link to the supporting files. Затем в skill.md создайте ссылки на вспомогательные файлы. Here, Claude reads architecture.md only when someone asks about system design. Здесь Claude читает architecture.md только тогда, когда кто-то спрашивает о системном дизайне. If they're asking where to add a component, let's say, it just never loads. Если спрашивают, куда добавить компонент, например, он просто никогда не загружается. It's like having a table of contents in the context window rather than fitting the whole entire document in there. Это всё равно что иметь оглавление в контекстном окне, а не втискивать туда весь документ целиком. Keep skill.md under 500 lines. Держите skill.md не длиннее 500 строк. If you're exceeding that, then maybe consider should this be split up into different content. Если превышаете это, подумайте, стоит ли разбить его на разные части. Scripts in your skill directory can run without loading their contents into context. Скрипты в директории вашего skill могут выполняться без загрузки их содержимого в контекст. The script executes and only the output consumes tokens. Скрипт выполняется, и только результат потребляет токены. Tell claw to run the script, not read it. Скажите Claude запустить скрипт, а не читать его. This is very useful for environment validation, data transformations that need to be consistent, operations that are more reliable as tested code than generated code. Это очень удобно для валидации окружения, преобразований данных, которые должны быть стабильными, и операций, более надёжных в виде протестированного кода, чем в виде сгенерированного. Skills support metadata fields. Skills поддерживают поля метаданных. Name and description which are required. Поля name и description являются обязательными. Allowed tools restricts available tools and model specifies which claw to use. allowed tools ограничивает доступные инструменты, а model задаёт версию Claude для использования. Descriptions need specific actions and trigger phrases to match for reliability. Для надёжного срабатывания descriptions нужны конкретные действия и фразы-триггеры. For larger skills, use progressive disclosure. Для крупных skills используйте прогрессивное раскрытие. Keep your skill.md file under 500 lines and link to the supporting files that load only when needed. Держите файл skill.md не длиннее 500 строк и создавайте ссылки на вспомогательные файлы, которые загружаются только при необходимости. Scripts [music] can execute without loading their contents, keeping context efficient. Скрипты [музыка] могут выполняться без загрузки их содержимого, сохраняя контекст эффективным.