Урок 05

Agent Skills: точечные знания

Agent Skills — это модули знаний, которые AI-ассистент активирует только когда нужно .

Отличие от Guidelines

Guidelines загружаются всегда — это базовый контекст. Skills загружаются по необходимости — это детальные паттерны для конкретной задачи .

Пример: когда ты работаешь с Livewire-компонентом, активируется Skill livewire-development. Когда с Pest-тестами — pest-testing.

Формат Skill

Skill — это папка с файлом SKILL.md :

.ai/skills/livewire-development/
└── SKILL.md

Файл содержит:

  • YAML frontmatter — name и description
  • Markdown — инструкции, примеры кода, команды

Пример:

---
name: package-name-development
description: Build and work with PackageName features.
---

# Package Name Development

## When to use this skill
Use this skill when working with PackageName...

Встроенные Skills

Boost включает Skills для популярных пакетов :

  • livewire-development
  • inertia-react-development
  • inertia-vue-development
  • inertia-svelte-development
  • pest-testing
  • tailwindcss-development
  • filament-development
  • mcp-development
  • pennant-development
  • volt-development
  • wayfinder-development

Устанавливаются автоматически, если пакет есть в composer.json .

Кастомные Skills

Создай свой Skill в .ai/skills/{skill-name}/SKILL.md :

mkdir -p .ai/skills/my-domain

---
name: my-domain-development
description: Patterns for working with MyDomain features.
---

# My Domain Development

## When to use
Use when building features related to MyDomain.

## Patterns

### Creating an invoice

```php
$invoice = Invoice::create([
    'user_id' => $user->id,
    'total' => $total,
]);

Sending an invoice

Use the SendInvoice action:

SendInvoice::dispatch($invoice);


После `boost:install` или `boost:update` кастомный Skill установится вместе со встроенными .

## Переопределение встроенных Skills

Создай Skill с тем же именем, что и встроенный. Boost использует твой вместо встроенного :

.ai/skills/livewire-development/SKILL.md


Переопределит встроенный `livewire-development`.

## Skills для пакетов

Если ты поддерживаешь сторонний пакет — добавь Skills в него :

resources/boost/skills/{skill-name}/SKILL.md


Boost установит их, если пакет в `composer.json` .

## Итоги

- Skills активируются по необходимости
- Формат: `SKILL.md` с YAML frontmatter
- Встроенные для популярных пакетов
- Кастомные в `.ai/skills/`
- Переопределение встроенных
- Пакеты могут содержать свои Skills