Навички

Навичка — це повторюваний, покроковий процес, розроблений для виконання конкретного завдання без стандартного обміну повідомленнями.

Агент A читає його за запитом, коли завдання відповідає опису навички, а потім виконує будь-які інструкції, які він містить.

Натисніть Preview, щоб побачити фактичні інструкції, які вхідні дані потрібні з вашої сторони, та приклад вибіркового виходу.

Попередньо побудовані навички (підібрані Ahrefs)

Agent A постачається з постійно зростаючою бібліотекою навичок, яку регулярно підтримує та оновлює команда Ahrefs. Завдяки їм Agent A працює як світового класу маркетолог прямо з коробки.

Навички робочої області (ваші навички)

Другий рівень навичок знаходиться у вашому власному робочому просторі в ~/workspace/skills/<skill-name>/SKILL.md. Це правила, унікальні для вашої команди, продукту, голосу та робочих процесів. Ви їх пишете, редагуєте та курируєте.

Ви також можете попросити в чаті повний файл навичок для редагування в одному місці.

Як додати нову навичку

Форма запиту:

"Створіть навичку під назвою <name>, яка охоплює <rules>. Опис тригера повинен бути <one-line>. Приклади для довідки: <paste or attach>."

Агент A:

1. Створює SKILL.md з правилами, структурованим для легкого пошуку.
2. Розміщує його в ~/workspace/skills/<name>/.
3. Тестує його, задаючи собі репрезентативне питання і читаючи навичку під час виконання.

Як оновити навичку

Пряме редагування файлу або "оновіть навичку голосу бренду: додайте правило, що ми ніколи не використовуємо довгі тире." Агент додає або переглядає на місці. Наступний чат автоматично підхоплює зміну.

Як структурована навичка

~/workspace/skills/<skill-name>/
  SKILL.md            ← required; description in frontmatter, body is the playbook
  reference.md        ← optional supporting docs
  examples/...        ← optional examples
  assets/...          ← optional images, templates, CSS

Фронтматер SKILL.md виглядає так:

---
name: ahrefs-brand-voice
description: Voice rules and review checklist for any Ahrefs copy. Load when writing or reviewing copy for landing pages, emails, ads, video scripts, or briefs.
---

description — це те, з чим агент порівнює. Якщо вона розпливчаста, навичка не спрацює, коли вам це потрібно. Якщо вона точна, вона активується саме тоді, коли це релевантно.

Коли агент використовує навичку

На початку чату агент бачить список доступних навичок (як вбудованих, так і робочих) разом з їх описами. Коли запит збігається, він читає тіло перед виконанням роботи.

• Написання цільової сторінки → читає ahrefs-brand-voice та ahrefs-design-manual.
• Генерування PDF → читає PDF (обов'язково; пісочниця блокує кілька поширених бібліотек).
• Виклик API третьої сторони → читає connectors.
• Написання сторінки Console, яка викликає LLM → читає llm та pydantic.

Ви також можете примусово завантажити навичку: "використовуйте навичку голосу бренду перед відповіддю."

Під капотом. Навички — це не магія. Це markdown, який агент вирішує читати на основі збігу описів. Вартість — це читання; користь — це послідовність. Вбудовані навички надходять зі сховища платформи, доступного лише для читання; навички робочої області живуть у вашій робочій області і належать вам для подальшого розвитку. Якщо правило потрібно застосувати до одного чату, просто скажіть це в чаті. Якщо воно має застосовуватися до кожного чату в майбутньому, помістіть його в навичку або в пам'ять.