name: skill-requirements-standard
description: >
Unified standard for skill file requirements and architecture in poreklame.tech.
Covers: SKILL.md structure, YAML frontmatter, description triggers, progressive
disclosure, Tier 1 prompts, S1-S10 criteria, Gate Check.
Версия: 2.0.0 | Дата: 07.05.2026 | Авторы: Егор (PE) + Мила (CMO) | Обновлено: Вера (COO)
Единый стандарт требований к файлам скиллов и их архитектуре. Объединяет пользовательский (Мила) и архитектурный (Егор) взгляды.
---
name: skill-name # lowercase, цифры, дефисы. Уникальный ID.
description: > # ОДНА строка — ТРИГГЕР. Модель видит ТОЛЬКО это,
# решая читать ли SKILL.md.
# Должна содержать:
# (а) что делает скилл
# (б) конкретные сценарии/действия-триггеры
metadata: # опционально
openclaw:
requires: # gating: если условие не выполнено → скилл не eligible
bins: ["curl", "jq"]
env: ["API_TOKEN"]
user-invocable: true # true = /slash команда для пользователя
# false = background/internal скилл
---
Правила:
name + description — обязательны. Без них скилл НЕ виден в <available_skills>.description — единственный триггер. Содержит конкретные действия: «Use when agent needs to [action1], [action2]».metadata.openclaw.requires — gating на бинарники и переменные окружения.| # | Секция | Содержание | Обязательность |
|---|---|---|---|
| 1 | Когда использовать | Детализация триггеров, сценарии | ✅ |
| 2 | Workflow | Пошаговая инструкция с tool calls | ✅ |
| 3 | Safety | Что НЕ делать, destructive → confirm | ✅ |
| 4 | Scope | Границы, ссылки на смежные скиллы | ✅ |
| 5 | Примеры | Tool calls, параметры, примеры ввода/вывода | Рекомендовано |
Лимит: ≤200 строк. Всё что сверх → в references/.
skill-name/
├── SKILL.md # core workflow (≤200 строк)
├── scripts/ # .py, .sh — исполняемый код
├── references/ # .md — документация, API-спеки
└── assets/ # шаблоны, изображения для output
Progressive Disclosure:
| # | Блок | Назначение |
|---|---|---|
| 1 | ROLE | Роль агента при выполнении |
| 2 | GOAL | Конкретная цель + success criteria |
| 3 | CONTEXT | Операционный контекст |
| 4 | INPUT | Что подаётся на вход |
| 5 | OUTPUT_FORMAT | Структура ответа |
| 6 | CONSTRAINTS | Ограничения |
| 7 | PROCESS | Пошаговая декомпозиция |
| 8 | VALIDATE | Самопроверка перед output |
| Критерий | Что проверять |
|---|---|
| S1 | Источник: ClawHub SUSPICIOUS/FLAGGED → ❌ |
| S2 | Exec: curl |
| S3 | Сеть: S3/OSS upload endpoints → ❌ |
| S4 | Файлы: /etc/shadow, .ssh/* → ❌ |
| S5 | Права: sudo, chmod 777 → ❌ |
| S7 | Secrets: хардкод токенов → ❌ |
| Frontmatter | name + description валидны |
| Краткость | ≤200 строк |
| Критерий | Что проверять |
|---|---|
| S6 | Зависимости: нет deprecated |
| S8 | Ingress: не открывает порты |
| S9 | SBOM: source verification |
| S10 | Impact: обратимость, нужен бэкап |
Этап 0: Определить AT-категорию, проверить дубликаты
Этап 1: Написать description-триггер, спроектировать workflow
Этап 2: Написать SKILL.md (≤200 строк, Tier 1 блоки)
Этап 3: Создать references/ и scripts/
Этап 4: Gate Check (S2, frontmatter, краткость)
Этап 5: Активация + аудит (weekly S2, monthly S1-S10)
Skill Quality Checker (100 баллов):
Verdict: PASS ≥ 80 И нет CRITICAL findings.