Источники проверены 7 июня 2026.

Как использовать AI Agent Skills

Практическая инструкция по SKILL.md, AGENTS.md, Claude Code, Codex, Cursor, Windsurf, Copilot, Gemini CLI, OpenCode, Zed, Continue, Cline и Aider.

Вернуться в каталог скиллов

Порядок настройки

1. Выберите правильный слой

Не каждую инструкцию надо превращать в skill. Skill нужен, когда агенту нужен повторяемый workflow, дополнительные файлы, скрипты, примеры или чеклист.

  • AGENTS.md, CLAUDE.md или GEMINI.md подходят для устойчивого контекста репозитория.

  • Cursor, Copilot, Continue и Cline rules подходят для coding conventions и правил по file patterns.

  • SKILL.md подходит, когда процедуру надо подгружать только под конкретную задачу.

  • Workflows или slash commands лучше для действий, которые должны запускаться только явно.

2. Напишите узкое description

Description - это поверхность триггера. Оно должно быть достаточно точным, чтобы агент выбирал skill для нужных задач и игнорировал соседние.

  • Хорошо: "Review pull requests for correctness bugs and missing verification."

  • Слабо: "Helps with code."

  • Добавляйте слова пользователя, которые должны включать skill: review, deploy, PDF, Figma, CI failed.

3. Держите SKILL.md коротким

В `SKILL.md` оставьте порядок решений и действий, а длинные материалы вынесите в папки, которые агент читает только при необходимости.

  • scripts/ - повторяемые команды или генераторы.

  • references/ - длинные справки, rubrics, examples и API notes.

  • assets/ - шаблоны, картинки или sample files.

4. Добавьте явную проверку

Хороший coding skill должен объяснять, как понять, что задача готова. Verification должна жить в skill, а не только в памяти.

  • Укажите focused tests, browser smoke checks или lint commands.

  • Скажите, что сообщать, если команду нельзя запустить.

  • Для production workflow добавьте backup или rollback checks.

5. Проверьте активацию

Прогоните промпты, которые должны включать skill, и промпты, которые не должны. Сужайте description, пока поведение не станет предсказуемым.

  • Проверьте один прямой промпт, один соседний и один нерелевантный.

  • Опасные workflows держите manual-only, если система это поддерживает.

  • Сторонние skills просматривайте перед установкой.

Куда класть файлы

Claude Code

Проектные: .claude/skills/<name>/SKILL.md; личные: ~/.claude/skills/; память: CLAUDE.md.

OpenAI Codex

Skills используют формат Agent Skills. Инструкции проекта живут в AGENTS.md; устанавливаемые пакеты - plugins.

Cursor

Rules: .cursor/rules/*.mdc; для project context также подходит AGENTS.md.

Windsurf / Devin

Skills: .windsurf/skills/; rules: .devin/rules/; workflows: .windsurf/workflows/.

GitHub Copilot

Repo-wide: .github/copilot-instructions.md; path-specific: .github/instructions/*.instructions.md.

Gemini CLI

Context files используют GEMINI.md на global, project и subdirectory уровнях.

OpenCode / Zed

OpenCode читает .opencode/skills/, .claude/skills/, .agents/skills/; Zed использует .agents/skills/.

Continue / Cline / Aider

Continue: .continue/rules/*.md; Cline: .clinerules/; Aider: convention files через /read или config.

Стартовые файлы

SKILL.md

---
name: pr-review
description: Review pull requests for correctness bugs, risky behavior changes, and missing verification. Use when the user asks for PR review, code review, or risk analysis.
---

## Inputs
- Current diff or PR URL
- Project test commands
- Known invariants from AGENTS.md or repository docs

## Workflow
1. Read the diff before giving findings.
2. Prioritize correctness, security, data loss, and regressions.
3. Cite exact files and lines.
4. Separate required fixes from optional cleanup.
5. End with verification gaps.

AGENTS.md

# Project Instructions

## Commands
- Build: npm run build
- Test: npm test
- Lint: npm run lint

## Architecture
- Business logic lives in app/services.
- UI components live in src/components.

## Agent Rules
- Keep changes scoped to the requested task.
- Do not edit generated files unless generation is part of the task.
- Run the smallest relevant verification before reporting done.

Cursor .mdc rule

---
description: React component conventions for this codebase
globs: ["src/components/**/*.{ts,tsx}"]
alwaysApply: false
---

- Use existing design system components first.
- Keep server data fetching outside leaf UI components.
- Add tests for behavior, not implementation details.
- Prefer named exports for shared components.

GitHub Copilot instructions

---
applyTo: "app/**/*.php"
---

Use Laravel 11 conventions.
Prefer constructor injection for services.
Return typed responses from controllers.
For public write endpoints, fail closed and add feature tests.

Чеклист безопасности

  • Проверяйте сторонние skills перед установкой. Skill может менять поведение будущих агентных сессий.

  • Deploy, deletion, payments и data export держите manual-only, если approval policy не прописан явно.

  • Не храните API keys, passwords или customer data в skills, rules, prompt files и repository memory.

  • Длинные справки выносите в references/, чтобы агент читал их только при необходимости.

  • Фиксируйте external scripts и зависимости. Script-backed skill надо проверять как обычный код.

  • Проверяйте trigger behavior на промптах, которые должны и не должны активировать skill.

Официальные источники