prompt-engineering-guidance — скилл для Claude Code: обзор
Скилл учит управлять ответами языковых моделей через библиотеку Guidance от Microsoft Research. Помогает фиксировать формат вывода с помощью регулярных выражений и грамматик.
npx claude-code-templates@latest --skill ai-research/prompt-engineering-guidanceЧто делает prompt-engineering-guidance
Скилл даёт Claude Code инструкции по работе с библиотекой Guidance. С её помощью модель принудительно выдаёт данные по строгой схеме: валидный JSON, значения из фиксированного списка select или строку по регулярному выражению. Фильтрация недопустимых токенов происходит прямо во время генерации, поэтому сломанная разметка исключена.
Внутри описаны готовые шаблоны для моделей OpenAI, Anthropic и локальных чекпоинтов через Hugging Face Transformers или llama.cpp. Дополнительно включена механика исправления стыков токенов (token healing), которая убирает двойные пробелы между промптом и ответом. Для запуска примеров в окружении понадобятся Python и пакет guidance.
Какие задачи решает
- Ограничить генерацию модели регулярным выражением для почты или дат
- Зафиксировать выбор ответа из строгого списка вариантов
- Собрать многошаговый агентный конвейер через декоратор
@guidance - Сформировать валидный JSON без синтаксических ошибок
Примеры запросов агенту
- Покажи, как через Guidance ограничить ответ модели регулярным выражением для email
- Напиши функцию с декоратором @guidance для выбора одного варианта из списка
- Настрой генерацию JSON-объекта с полями name и age через контекстные менеджеры Guidance
Как установить prompt-engineering-guidance
1Через claude-code-templates
npx claude-code-templates@latest --skill ai-research/prompt-engineering-guidance2Через Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill prompt-engineering-guidance -a claude-code3Вручную: положить файлы
~/.claude/skills/prompt-engineering-guidance/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/prompt-engineering-guidance/
Вручную: положить файлы
.agents/skills/prompt-engineering-guidance/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/prompt-engineering-guidance/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates prompt-engineering-guidance2Вручную: положить файлы
.github/skills/prompt-engineering-guidance/SKILL.mdКомандой платформы
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/ai-research/prompt-engineering-guidanceВручную: положить файлы
.devin/skills/prompt-engineering-guidance/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о prompt-engineering-guidance
Как установить prompt-engineering-guidance в Claude Code?
Выполните npx claude-code-templates@latest --skill ai-research/prompt-engineering-guidance или команду npx skills add davila7/claude-code-templates --skill prompt-engineering-guidance -a claude-code. Также можно сохранить файл вручную по пути ~/.claude/skills/prompt-engineering-guidance/SKILL.md.
Что делает prompt-engineering-guidance?
Он предоставляет готовые шаблоны для генерации с ограничениями на базе библиотеки Guidance. Это помогает строить предсказуемые форматы ответов и избегать ошибок парсинга.
Что такое token healing в Guidance?
Это механизм, который автоматически делает шаг назад на один токен на границе между промптом и ответом модели. Из-за этого исчезают лишние пробелы и противоестественные стыки токенизатора.