К основному содержанию
скилл CX Codex

expert-instruction — скилл для Claude Code: промпты и установка

Скилл expert-instruction для Claude Code помогает проектировать системные инструкции для ИИ-агентов. Он включается при настройке роли агента, ограничений, формата ответов и работы с инструментами.

MIT 106 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill expert-instruction -a claude-code
Открыть на GitHub

Что делает expert-instruction

Скилл помогает составить системную инструкцию, которая задаёт поведение агента в разных диалогах. В ней описывают его роль и возможности, ограничения, формат ответов, правила вызова инструментов и передачу задачи человеку. Есть рекомендации для многошаговых сценариев и защитных правил.

Материал разбирает типичные ошибки: противоречивые требования, расплывчатую роль и отсутствие обработки сбоев инструментов. Для системной инструкции рекомендуют объём до 2000 токенов, а подробности выносить в справочные документы. Скилл также предлагает проверять поведение на провокационных запросах и отслеживать версии промпта.

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

Какие задачи решает

  • задать агенту роль и границы компетенции
  • описать условия вызова инструментов и действия при сбоях
  • согласовать формат ответов и поведение в длинном диалоге
  • определить случаи передачи задачи человеку
  • проверить системную инструкцию на конфликтующие правила

Примеры запросов агенту

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

Как установить expert-instruction

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill expert-instruction -a claude-code

2Вручную: положить файлы

~/.claude/skills/expert-instruction/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/expert-instruction/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об expert-instruction

Как установить expert-instruction в Claude Code?

Выполни npx skills add oakoss/agent-skills --skill expert-instruction -a claude-code. Файл скилла появится по пути ~/.claude/skills/expert-instruction/SKILL.md.

Что делает expert-instruction?

Помогает проектировать постоянные системные инструкции для ИИ-агентов: от описания роли и ограничений до правил работы с инструментами и поведения в нескольких сообщениях.

Чем expert-instruction отличается от скилла prompt?

expert-instruction посвящён устойчивому поведению агента и его границам. Для разовых запросов и техник вроде few-shot в тексте предлагается использовать скилл prompt.

Исходный текст

SKILL.md · MIT
---
name: expert-instruction
description: |
  System prompt design and instruction crafting for AI agents. Covers persona definition, constraint specification, output formatting, tool use instructions, multi-turn behavior, and guardrail design.

  Use when writing system prompts for AI products, designing agent personas, specifying behavioral constraints, crafting tool-use instructions, or building multi-step agent workflows.
license: MIT
metadata:
  author: oakoss
  version: '1.0'
user-invocable: false
---

# Expert Instruction Design

## Overview

Expert instruction design focuses on crafting system prompts that define how an AI agent behaves, what it can and cannot do, and how it responds across interactions. Unlike general prompt engineering (which optimizes individual queries), this skill covers the **persistent behavioral layer** that shapes an agent's identity, capabilities, and constraints.

**When to use:** Writing system prompts for AI products, defining agent personas for customer-facing tools, specifying behavioral guardrails, crafting tool-use guidance, or designing multi-step agent workflows.

**When NOT to use:** One-off prompt optimization (use the `prompt` skill), fine-tuning or training-time configuration, infrastructure-level safety (use model provider safety features), or tasks that do not involve LLM agent behavior.

## Quick Reference

| Pattern                  | Purpose                                  | Key Points                                       |
| ------------------------ | ---------------------------------------- | ------------------------------------------------ |
| Identity block           | Define who the agent is                  | Role, expertise, communication style             |
| Capability declaration   | State what the agent can do              | Explicit tool list, domain boundaries            |
| Constraint specification | Define behavioral boundaries             | Hard limits, soft preferences, escalation rules  |
| Output format rules      | Ensure consistent response structure     | Templates, progressive disclosure, length limits |
| Tool use instructions    | Guide when and how to use tools          | Selection criteria, error handling, sequencing   |
| Multi-turn behavior      | Handle conversation continuity           | Context tracking, topic switching, memory        |
| Guardrails               | Prevent harmful or out-of-scope behavior | Content boundaries, instruction hierarchy        |
| Escalation triggers      | Define when to hand off to humans        | Confidence thresholds, scope boundaries          |

## Common Mistakes

| Mistake                                  | Correct Pattern                                               |
| ---------------------------------------- | ------------------------------------------------------------- |
| System prompt over 4000 tokens           | Keep under 2000 tokens, move details to reference docs        |
| Contradictory instructions               | Audit for conflicts, establish priority order                 |
| Vague persona ("be helpful")             | Specific: expertise domain, response style, knowledge bounds  |
| No escalation path                       | Define when agent should defer to human or say "I don't know" |
| Listing every edge case                  | State principles, provide examples for ambiguous cases only   |
| Mixing identity and task instructions    | Separate: identity block first, task instructions second      |
| No output format specification           | Define structure: headings, lists, code blocks, length        |
| Tool instructions without error handling | Include fallback behavior when tools fail or return errors    |
| Testing only happy-path inputs           | Test adversarial, off-topic, and edge case inputs             |
| Deploying without versioning             | Track system prompt versions, log changes, enable rollback    |

## Delegation

- **Prompt technique exploration**: Use `Explore` agent to research patterns
- **System prompt testing**: Use `Task` agent to run adversarial test suites
- **Code review**: Delegate to `code-reviewer` agent for integration code

> If the `prompt` skill is available, delegate general prompt engineering techniques (CoT, few-shot, structured output) to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s prompt -a claude-code -y`

## References

- [System prompt design: anatomy, personas, tools, and multi-turn behavior](references/system-prompt-design.md)
- [Guardrails and testing: behavioral boundaries, versioning, and production readiness](references/guardrails-and-testing.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Каталог скиллов SKILL.md →
gjkim-instruction gjkim42 Скилл gjkim-instruction ведёт корневой документ для долгих циклов агента: фиксирует цель, минимальные требования и подтверждённые решения. CX Codex +1 4 600установок 10_instruction_stress centminmod Промпт 10_instruction_stress для Claude Code проверяет, соблюдает ли модель четыре одновременных ограничения при описании вымышленной кофейни. GP ChatGPT ★ 2 744звёзд репо find-skills vercel-labs Скилл find-skills для Claude Code ищет скиллы по задаче и помогает выбрать, что установить. Он включается, когда нужно найти готовую возможность для агента. CX Codex +1 4 400 000установок frontend-design официальный anthropics Скилл frontend-design для Claude Code задаёт осмысленное визуальное направление для новых интерфейсов и редизайна. Помогает уйти от шаблонного UI. CX Codex +1 1 025 790установок agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок design-taste-frontend Leonxlnx Скилл design-taste-frontend для Claude Code задаёт правила оформления и проверки сайтов. Подключается при создании или переделке страницы, а также при просьбе убрать шаблонный вид. CX Codex +1 802 600установок grill-me Matt Pocock Скилл grill-me проводит жёсткое интервью по плану или дизайну, чтобы найти пробелы и уточнить решения. Подойдёт перед началом разработки. CX Codex +1 1 424 476установок grill-with-docs Matt Pocock Скилл grill-with-docs проводит жёсткое интервью по плану или дизайну и по ходу создаёт ADR и глоссарий. Подойдёт перед началом сложной разработки. CX Codex +1 1 219 756установок

Из того же набора106

Весь набор →
turborepo Помогает настраивать Turborepo в монорепозиториях на JavaScript и TypeScript. Запускается при настройке задач, кэша, зависимостей между пакетами и CI. CX Codex +1 108установок realtime-sync Скилл realtime-sync помогает проектировать синхронизацию данных с низкой задержкой, связывать WebTransport, CRDT и пакетный рендеринг потоков ИИ-токенов. CX Codex +1 108установок plan-first-development Скилл plan-first-development для Claude Code помогает спланировать проект до начала разработки и вести прогресс между сессиями. Он включается при запуске проекта, крупных изменениях и разбиении работы на этапы. CX Codex +1 107установок tracer-bullets Скилл tracer-bullets для Claude Code разбивает многоуровневую разработку на вертикальные срезы. Каждый срез проверяется до начала следующего. CX Codex +1 107установок codebase-packager Скилл codebase-packager для Claude Code готовит контекст крупного репозитория для ИИ-кодинга. Он собирает дайджесты, упаковывает файлы и помогает проследить связи между ними. CX Codex +1 105установок skill-management Скилл skill-management для Claude Code помогает создавать, проверять и исправлять скиллы по стандарту Agent Skills. Он включается для аудита структуры, описаний и соответствия файлов манифесту. CX Codex +1 105установок meta-agent-creator Скилл meta-agent-creator для Claude Code помогает создавать субагентов и настраивать их параметры. Используйте его при проектировании делегирования задач и ограничении доступа к инструментам. CX Codex +1 104установок localization-engineer Скилл localization-engineer для Claude Code внедряет паттерны интернационализации и локализации в веб-приложения. Помогает настроить ICU, плюрализацию CLDR, RTL-вёрстку и теги hreflang. CX Codex +1 103установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой