Claude Skill

agent-builder

Создаёт полноценных persistent skill-агентов с собственной памятью, system prompt-ом и data-файлами. Автоматизирует создание агентов как у OpenClaw (Doctor, AutoMechanic и т.д.).

LLM Mart · 0 points · 2 views 70 listing impressions 0 install-command copies
Download alekseiul-sprut-agent-kit-skills_agent-builder-bb8e6a1.zip · 4 KB

Install

skills CLI npx skills add https://github.com/AlekseiUL/sprut-agent-kit/tree/main/skills/agent-builder
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install alekseiul-sprut-agent-kit@llmmart
Git git clone https://github.com/AlekseiUL/sprut-agent-kit.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole alekseiul/sprut-agent-kit collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

🤖 Agent Builder — Создатель Persistent Agent-ов

Когда использовать

Пользователь говорит:

  • "Создай агента X"
  • "Новый агент для Y"
  • "Сделай persistent agent Z"
  • Описывает задачу агента который должен:
    • Помнить контекст между разговорами
    • Вести структурированные записи
    • Иметь специализированную экспертизу

Не использовать

  • Простые одноразовые скиллы без памяти
  • Skills.sh скиллы (brainstorming, debugging и т.д.)
  • Субагенты для параллелизации (это другое)

Процесс создания

1. Собери требования

Спроси владельца:

Обязательные:

  • Имя агента (slug-format, напр. auto-mechanic)
  • Роль/экспертиза (напр. "Автомеханик для Mazda CX-5")
  • Триггеры (слова активации, напр. "машина", "масло", "ТО")

Опциональные:

  • Кого/что обслуживает (напр. "Mazda CX-5 2019, 120K км")
  • Какие данные хранить (напр. "журнал ТО", "пробег", "замены")
  • Стиль общения (напр. "технический", "дружелюбный")
  • Референсы (примеры ответов, стиль письма)

2. Создай структуру

~/.claude/skills/<agent-name>/
├── SKILL.md                    # триггеры + инструкции
├── data/
│   ├── profile.md             # статический профиль (кто/что)
│   └── events/
│       └── log.md             # хронология событий
└── references/                # примеры, стиль (опционально)
    └── examples.md

3. Сгенерируй SKILL.md

Шаблон:

---
name: <agent-name>
trigger:
  - <trigger1>
  - <trigger2>
  - ...
description: >
  <краткое описание: кто, для кого, что делает>
---

# <Emoji> <Agent Title>

## Активация

При триггере:
1. Прочитай профиль: `data/profile.md`
2. Прочитай последние события: `data/events/log.md` (последние 10 записей)
3. Ответь как <роль>

## Роль

Ты — **<Agent Name>**, <детальное описание экспертизы>.

<Стандарты работы, если нужны>

Язык: русский. Тон: <стиль общения>.

## Профиль

Полная информация в `data/profile.md`.

## Автофиксация (ОБЯЗАТЕЛЬНО)

После КАЖДОГО взаимодействия с пользователем:

1. **Проверь чеклист:**
   - ✅ Новая информация требующая записи? (диагноз, событие, дата, замена, покупка)
   - ✅ Изменение существующих данных? (вес, пробег, статус, прогресс)
   - ❌ Простой вопрос без новой информации

2. **Если ✅ → ОБЯЗАТЕЛЬНО запиши:**
   - В `data/events/log.md` (хронология событий)
   - Обнови `data/profile.md` (если изменились постоянные данные)

3. **Формат записи в log.md:**
   ```markdown
   ## YYYY-MM-DD — [Субъект]: [Событие]
   - **Что:** краткое описание
   - **Детали:** конкретика (пробег, вес, дата, стоимость)
   - **Действия:** что было сделано/рекомендовано
  1. Используй Edit tool:
    • НЕ используй Write (перезапишет файл целиком)
    • Используй Edit для дописывания в конец:
    Edit data/events/log.md
    old_string: (последняя строка файла)
    new_string: (последняя строка + \n\n## YYYY-MM-DD — [Субъект]: [Событие]\n- **Что:** ...)
    

Это НЕ опционально. Если информация соответствует чеклисту - запись ОБЯЗАТЕЛЬНА.

Примеры работы

Вопрос

"Когда менять масло?"

Процесс

  1. Read data/profile.md → узнаю интервал замены (10K км)
  2. Read data/events/log.md → последняя замена 115K км
  3. Текущий пробег из профиля → 120K км
  4. Ответ: "Пора менять! Последняя замена была 5K км назад"

Запись события

Пользователь: "Поменял масло сегодня, пробег 120500"

Дописываю в data/events/log.md:

## 2026-03-01
- **Замена масла**: 120500 км, Castrol Edge 5W-40, 4.5 л
- Стоимость: 80 GEL

Автоматическая запись

Используй Edit tool:

Edit data/events/log.md
old_string: (последняя строка файла)
new_string: (последняя строка + \n\n## YYYY-MM-DD\n- **Событие**: детали)

Не используй Write (перезапишет файл целиком).


Workflow создания агента

Когда Пользователь говорит "создай агента X":

Шаг 1: Собери информацию

Спроси через AskUserQuestion:

questions: [
  {
    question: "Как назвать агента? (slug-format, напр. auto-mechanic)",
    header: "Agent Name",
    options: [
      { label: "auto-mechanic", description: "Автомеханик" },
      { label: "tax-advisor", description: "Налоговый советник" },
      { label: "recipe-keeper", description: "Хранитель рецептов" },
      { label: "Другое", description: "Свой вариант" }
    ]
  },
  {
    question: "Какая роль/экспертиза?",
    header: "Role",
    options: [
      { label: "Эксперт", description: "Технический эксперт" },
      { label: "Советник", description: "Дружелюбный советник" },
      { label: "Журналист", description: "Фиксирует факты" }
    ]
  },
  {
    question: "Какие данные хранить?",
    header: "Data",
    multiSelect: true,
    options: [
      { label: "Профиль объекта", description: "Характеристики (машина, человек и т.д.)" },
      { label: "Журнал событий", description: "Хронология (ТО, покупки, изменения)" },
      { label: "Примеры/референсы", description: "Образцы текстов, стиль" }
    ]
  }
]

Шаг 2: Создай структуру

mkdir -p ~/.claude/skills/<agent-name>/data/events
mkdir -p ~/.claude/skills/<agent-name>/references

Шаг 3: Сгенерируй файлы

SKILL.md — используй шаблон выше, подставь:

  • <agent-name>
  • Триггеры (попроси у владельца или предложи 5-7 релевантных)
  • Роль и экспертизу
  • ОБЯЗАТЕЛЬНО блок "Автофиксация (ОБЯЗАТЕЛЬНО)" со специфичным чеклистом для агента
  • Инструкции по data-файлам

data/profile.md — создай заготовку:

# <Agent Title> — Профиль

## Основная информация
- **Название**: <объект>
- **Характеристики**: <детали>

## <Специфичные разделы>
(зависит от типа агента)

data/events/log.md — пустой файл с заголовком:

# Журнал событий — <Agent Name>

(События будут добавляться автоматически)

references/examples.md (опционально):

# Примеры и референсы

## Стиль общения
<примеры ответов>

## Образцы текстов
<если нужно>

Шаг 4: Подтверди создание

Покажи владельцу структуру:

✅ Создан агент: <name>
📁 Структура:
   ~/.claude/skills/<name>/
   ├── SKILL.md (триггеры, инструкции)
   ├── data/
   │   ├── profile.md (заполни вручную)
   │   └── events/log.md (автозапись)
   └── references/ (опционально)

🎯 Активация: <триггеры>
📝 Заполни profile.md вручную или дай мне информацию

Шаг 5: Первое наполнение

Если Пользователь даёт информацию сразу:

  • Заполни profile.md структурированно
  • Если есть первое событие → запиши в log.md

Примеры агентов

AutoMechanic (Автомеханик)

Чеклист автофиксации для AutoMechanic:

✅ Записывать:
- Пробег на дату обслуживания
- Замена масла/фильтров/резины
- Ремонт (что сломалось, что заменили, стоимость)
- Покупка запчастей
- Визит на СТО

❌ НЕ записывать:
- "Когда менять масло?" (общий вопрос)
- "Что входит в ТО-2?" (справка)

Профиль (data/profile.md):

# 🚗 Автомобиль

- **Марка/Модель**: Mazda CX-5 2019
- **VIN**: JMXXXXXXXXXXXXXXX
- **Пробег текущий**: 120500 км (на 01.03.2026)
- **Двигатель**: 2.5L SKYACTIV-G
- **Коробка**: 6AT

## Регламент ТО
- Масло: каждые 10K км (Castrol Edge 5W-40, 4.5 л)
- Фильтр воздушный: каждые 20K км
- Тормозная жидкость: каждые 2 года
...

События (data/events/log.md):

## 2026-03-01 — Mazda CX-5: Замена масла
- **Что:** Плановое ТО
- **Детали:** 120500 км, Castrol Edge 5W-40, 4.5 л
- **Действия:** Замена масла и масляного фильтра, стоимость 80 GEL

## 2025-12-15 — Mazda CX-5: Замена аккумулятора
- **Что:** Аварийная замена
- **Детали:** Varta Blue 70Ah, старый 5 лет, не держал заряд зимой
- **Действия:** Замена аккумулятора, стоимость 180 GEL

## 2025-10-20 — Mazda CX-5: Замена масла
- **Что:** Плановое ТО
- **Детали:** 110200 км, Castrol Edge 5W-40, 4.5 л
- **Действия:** Замена масла и масляного фильтра, стоимость 75 GEL

CopywriterStyle (Стиль копирайтера)

Профиль (data/profile.md):

# ✍️ Стиль владельца

## Принципы
- Короткие предложения
- Без воды и лишних слов
- Прямо в суть
- Живой разговорный язык
- Мат приветствуется

Примеры (references/examples.md):

## Пример поста (хороший)
<текст поста>

## Пример поста (плохой)
<что НЕ делать>

Интеграция с memory.sqlite

Агент работает гибридно:

  1. MD-файлы = структурированное хранение (профиль, события)
  2. memory.sqlite = быстрый поиск по всем разговорам

Когда записываешь событие:

// 1. Дописать в MD
Edit("data/events/log.md", ...)

// 2. Сохранить в память
storeMemory("Замена масла 120500 км, 01.03.2026", "episodic", "auto-mechanic")

Это даёт:

  • ✅ Хронологию в MD (читабельно, структурировано)
  • ✅ Поиск в SQLite (быстро, semantic search)
  • ✅ Лучшее из двух миров
Files (sprut-agent-kit)
  • SKILL.md 13.2 KB
    ---
    name: agent-builder
    trigger:
    triggers:
      - создай агента
      - новый агент
      - agent builder
      - сделай агента
      - персональный агент
      - создай агента
      - новый агент
      - agent builder
      - агентский скилл
      - persistent agent
      - сделай агента
    description: >
      Создаёт полноценных persistent skill-агентов с собственной памятью,
      system prompt-ом и data-файлами. Автоматизирует создание агентов
      как у OpenClaw (Doctor, AutoMechanic и т.д.).
    ---
    
    # 🤖 Agent Builder — Создатель Persistent Agent-ов
    
    ## Когда использовать
    
    Пользователь говорит:
    - "Создай агента X"
    - "Новый агент для Y"
    - "Сделай persistent agent Z"
    - Описывает задачу агента который должен:
      - Помнить контекст между разговорами
      - Вести структурированные записи
      - Иметь специализированную экспертизу
    
    ## Не использовать
    
    - Простые одноразовые скиллы без памяти
    - Skills.sh скиллы (brainstorming, debugging и т.д.)
    - Субагенты для параллелизации (это другое)
    
    ## Процесс создания
    
    ### 1. Собери требования
    
    Спроси владельца:
    
    **Обязательные:**
    - Имя агента (slug-format, напр. `auto-mechanic`)
    - Роль/экспертиза (напр. "Автомеханик для Mazda CX-5")
    - Триггеры (слова активации, напр. "машина", "масло", "ТО")
    
    **Опциональные:**
    - Кого/что обслуживает (напр. "Mazda CX-5 2019, 120K км")
    - Какие данные хранить (напр. "журнал ТО", "пробег", "замены")
    - Стиль общения (напр. "технический", "дружелюбный")
    - Референсы (примеры ответов, стиль письма)
    
    ### 2. Создай структуру
    
    ```
    ~/.claude/skills/<agent-name>/
    ├── SKILL.md                    # триггеры + инструкции
    ├── data/
    │   ├── profile.md             # статический профиль (кто/что)
    │   └── events/
    │       └── log.md             # хронология событий
    └── references/                # примеры, стиль (опционально)
        └── examples.md
    ```
    
    ### 3. Сгенерируй SKILL.md
    
    **Шаблон:**
    
    ```markdown
    ---
    name: <agent-name>
    trigger:
      - <trigger1>
      - <trigger2>
      - ...
    description: >
      <краткое описание: кто, для кого, что делает>
    ---
    
    # <Emoji> <Agent Title>
    
    ## Активация
    
    При триггере:
    1. Прочитай профиль: `data/profile.md`
    2. Прочитай последние события: `data/events/log.md` (последние 10 записей)
    3. Ответь как <роль>
    
    ## Роль
    
    Ты — **<Agent Name>**, <детальное описание экспертизы>.
    
    <Стандарты работы, если нужны>
    
    Язык: русский. Тон: <стиль общения>.
    
    ## Профиль
    
    Полная информация в `data/profile.md`.
    
    ## Автофиксация (ОБЯЗАТЕЛЬНО)
    
    После КАЖДОГО взаимодействия с пользователем:
    
    1. **Проверь чеклист:**
       - ✅ Новая информация требующая записи? (диагноз, событие, дата, замена, покупка)
       - ✅ Изменение существующих данных? (вес, пробег, статус, прогресс)
       - ❌ Простой вопрос без новой информации
    
    2. **Если ✅ → ОБЯЗАТЕЛЬНО запиши:**
       - В `data/events/log.md` (хронология событий)
       - Обнови `data/profile.md` (если изменились постоянные данные)
    
    3. **Формат записи в log.md:**
       ```markdown
       ## YYYY-MM-DD — [Субъект]: [Событие]
       - **Что:** краткое описание
       - **Детали:** конкретика (пробег, вес, дата, стоимость)
       - **Действия:** что было сделано/рекомендовано
       ```
    
    4. **Используй Edit tool:**
       - НЕ используй Write (перезапишет файл целиком)
       - Используй Edit для дописывания в конец:
       ```
       Edit data/events/log.md
       old_string: (последняя строка файла)
       new_string: (последняя строка + \n\n## YYYY-MM-DD — [Субъект]: [Событие]\n- **Что:** ...)
       ```
    
    **Это НЕ опционально. Если информация соответствует чеклисту - запись ОБЯЗАТЕЛЬНА.**
    
    ## Примеры работы
    
    ### Вопрос
    "Когда менять масло?"
    
    ### Процесс
    1. Read `data/profile.md` → узнаю интервал замены (10K км)
    2. Read `data/events/log.md` → последняя замена 115K км
    3. Текущий пробег из профиля → 120K км
    4. Ответ: "Пора менять! Последняя замена была 5K км назад"
    
    ### Запись события
    Пользователь: "Поменял масло сегодня, пробег 120500"
    
    Дописываю в `data/events/log.md`:
    ```markdown
    ## 2026-03-01
    - **Замена масла**: 120500 км, Castrol Edge 5W-40, 4.5 л
    - Стоимость: 80 GEL
    ```
    
    ## Автоматическая запись
    
    Используй Edit tool:
    ```
    Edit data/events/log.md
    old_string: (последняя строка файла)
    new_string: (последняя строка + \n\n## YYYY-MM-DD\n- **Событие**: детали)
    ```
    
    Не используй Write (перезапишет файл целиком).
    
    ---
    
    ## Workflow создания агента
    
    **Когда Пользователь говорит "создай агента X":**
    
    ### Шаг 1: Собери информацию
    
    Спроси через AskUserQuestion:
    
    ```
    questions: [
      {
        question: "Как назвать агента? (slug-format, напр. auto-mechanic)",
        header: "Agent Name",
        options: [
          { label: "auto-mechanic", description: "Автомеханик" },
          { label: "tax-advisor", description: "Налоговый советник" },
          { label: "recipe-keeper", description: "Хранитель рецептов" },
          { label: "Другое", description: "Свой вариант" }
        ]
      },
      {
        question: "Какая роль/экспертиза?",
        header: "Role",
        options: [
          { label: "Эксперт", description: "Технический эксперт" },
          { label: "Советник", description: "Дружелюбный советник" },
          { label: "Журналист", description: "Фиксирует факты" }
        ]
      },
      {
        question: "Какие данные хранить?",
        header: "Data",
        multiSelect: true,
        options: [
          { label: "Профиль объекта", description: "Характеристики (машина, человек и т.д.)" },
          { label: "Журнал событий", description: "Хронология (ТО, покупки, изменения)" },
          { label: "Примеры/референсы", description: "Образцы текстов, стиль" }
        ]
      }
    ]
    ```
    
    ### Шаг 2: Создай структуру
    
    ```bash
    mkdir -p ~/.claude/skills/<agent-name>/data/events
    mkdir -p ~/.claude/skills/<agent-name>/references
    ```
    
    ### Шаг 3: Сгенерируй файлы
    
    **SKILL.md** — используй шаблон выше, подставь:
    - `<agent-name>`
    - Триггеры (попроси у владельца или предложи 5-7 релевантных)
    - Роль и экспертизу
    - **ОБЯЗАТЕЛЬНО** блок "Автофиксация (ОБЯЗАТЕЛЬНО)" со специфичным чеклистом для агента
    - Инструкции по data-файлам
    
    **data/profile.md** — создай заготовку:
    ```markdown
    # <Agent Title> — Профиль
    
    ## Основная информация
    - **Название**: <объект>
    - **Характеристики**: <детали>
    
    ## <Специфичные разделы>
    (зависит от типа агента)
    ```
    
    **data/events/log.md** — пустой файл с заголовком:
    ```markdown
    # Журнал событий — <Agent Name>
    
    (События будут добавляться автоматически)
    ```
    
    **references/examples.md** (опционально):
    ```markdown
    # Примеры и референсы
    
    ## Стиль общения
    <примеры ответов>
    
    ## Образцы текстов
    <если нужно>
    ```
    
    ### Шаг 4: Подтверди создание
    
    Покажи владельцу структуру:
    ```
    ✅ Создан агент: <name>
    📁 Структура:
       ~/.claude/skills/<name>/
       ├── SKILL.md (триггеры, инструкции)
       ├── data/
       │   ├── profile.md (заполни вручную)
       │   └── events/log.md (автозапись)
       └── references/ (опционально)
    
    🎯 Активация: <триггеры>
    📝 Заполни profile.md вручную или дай мне информацию
    ```
    
    ### Шаг 5: Первое наполнение
    
    Если Пользователь даёт информацию сразу:
    - Заполни `profile.md` структурированно
    - Если есть первое событие → запиши в `log.md`
    
    ---
    
    ## Примеры агентов
    
    ### AutoMechanic (Автомеханик)
    
    **Чеклист автофиксации для AutoMechanic:**
    ```markdown
    ✅ Записывать:
    - Пробег на дату обслуживания
    - Замена масла/фильтров/резины
    - Ремонт (что сломалось, что заменили, стоимость)
    - Покупка запчастей
    - Визит на СТО
    
    ❌ НЕ записывать:
    - "Когда менять масло?" (общий вопрос)
    - "Что входит в ТО-2?" (справка)
    ```
    
    **Профиль** (`data/profile.md`):
    ```markdown
    # 🚗 Автомобиль
    
    - **Марка/Модель**: Mazda CX-5 2019
    - **VIN**: JMXXXXXXXXXXXXXXX
    - **Пробег текущий**: 120500 км (на 01.03.2026)
    - **Двигатель**: 2.5L SKYACTIV-G
    - **Коробка**: 6AT
    
    ## Регламент ТО
    - Масло: каждые 10K км (Castrol Edge 5W-40, 4.5 л)
    - Фильтр воздушный: каждые 20K км
    - Тормозная жидкость: каждые 2 года
    ...
    ```
    
    **События** (`data/events/log.md`):
    ```markdown
    ## 2026-03-01 — Mazda CX-5: Замена масла
    - **Что:** Плановое ТО
    - **Детали:** 120500 км, Castrol Edge 5W-40, 4.5 л
    - **Действия:** Замена масла и масляного фильтра, стоимость 80 GEL
    
    ## 2025-12-15 — Mazda CX-5: Замена аккумулятора
    - **Что:** Аварийная замена
    - **Детали:** Varta Blue 70Ah, старый 5 лет, не держал заряд зимой
    - **Действия:** Замена аккумулятора, стоимость 180 GEL
    
    ## 2025-10-20 — Mazda CX-5: Замена масла
    - **Что:** Плановое ТО
    - **Детали:** 110200 км, Castrol Edge 5W-40, 4.5 л
    - **Действия:** Замена масла и масляного фильтра, стоимость 75 GEL
    ```
    
    ### CopywriterStyle (Стиль копирайтера)
    
    **Профиль** (`data/profile.md`):
    ```markdown
    # ✍️ Стиль владельца
    
    ## Принципы
    - Короткие предложения
    - Без воды и лишних слов
    - Прямо в суть
    - Живой разговорный язык
    - Мат приветствуется
    ```
    
    **Примеры** (`references/examples.md`):
    ```markdown
    ## Пример поста (хороший)
    <текст поста>
    
    ## Пример поста (плохой)
    <что НЕ делать>
    ```
    
    ---
    
    ## Интеграция с memory.sqlite
    
    Агент работает **гибридно**:
    
    1. **MD-файлы** = структурированное хранение (профиль, события)
    2. **memory.sqlite** = быстрый поиск по всем разговорам
    
    Когда записываешь событие:
    ```typescript
    // 1. Дописать в MD
    Edit("data/events/log.md", ...)
    
    // 2. Сохранить в память
    storeMemory("Замена масла 120500 км, 01.03.2026", "episodic", "auto-mechanic")
    ```
    
    Это даёт:
    - ✅ Хронологию в MD (читабельно, структурировано)
    - ✅ Поиск в SQLite (быстро, semantic search)
    - ✅ Лучшее из двух миров
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.