Agent Skills
Agent Skills — Коллекция скиллов для AI-агентов
Автономные инструкции (skills) для AI-агентов: Sisyphus, opencode, и совместимые. Каждый скилл — папка с
SKILL.md(инструкция) иskill.json(манифест для установки/поиска).
🌐 Versions: English · Русский · Website
📑 Оглавление
- [📦 Каталог скиллов](#sec-catalog) — 59 скиллов · 6 категорий - [🎬 Showcase](#sec-showcase) — примеры на реальных проектах - [🚀 Установка](#sec-installation) - [📁 Структура репозитория](#sec-structure) - [🔍 Поиск скиллов](#sec-discovery) - [🛠 Добавление нового скилла](#sec-adding) - [📄 Информация о проекте](#sec-project-info) — лицензия · контрибьютинг · безопасность · кодекс📦 Каталог скиллов
📚 Карта экосистемы: см. docs/SKILLS_CATALOG.md — каталог экосистемы AI agent skills (официальные вендоры, форматы, стандарты, ~4.85M файлов SKILL.md, пробелы и рекомендации). При обновлении этого README (добавление/удаление скиллов, смена версий или категорий) обновляйте также
docs/SKILLS_CATALOG.md(раздел 9) иindex.json— держите все три места синхронно.
59 скиллов · 6 категорий. Выбери категорию ниже; триггеры и полные метаданные — в index.json.
| Категория | Скиллов | Что входит |
|---|---|---|
| 💻 Разработка и код | 27 | коммиты, ревью, отладка, тесты, покрытие, безопасность, планирование, фронтенд, целостность доков, создание скиллов |
| 🤖 Агенты | 1 | автономные агентные задачи (DeepSeek Harness) |
| 📊 Данные и диаграммы | 7 | профилирование, SQL, диаграммы, скраппинг |
| 🎬 Контент и медиа | 13 | слайды, видео, PDF-отчёты, SEO, тестовая графика |
| 🏗️ Репозиторий и документация | 10 | README, community-файлы, метаданные, документация, API-доки |
| 💬 Соцсети | 1 |
💻 Разработка и код · code · 27
| Скилл | Назначение |
|---|---|
| commit-message-writer | Генерация Conventional Commits-сообщения из git diff --staged: тип по файлам, scope по путям, описание и body. |
| commit-lint | Валидация commit-сообщений по Conventional Commits v1.0.0 (тип, scope, длины, регистр); отчёт text/JSON, exit 0/1/2. |
| version-bumper | Детерминированный семвер-бамп + релизный тег по git-истории (feat/fix/breaking); режим -s, read-only. |
| code-review | Структурированное ревью diff/репозитория: чек-листы по категориям (correctness, security, performance, style, tests, edge cases), замечания [severity] файл:строка с фиксами. Только анализ — правок не вносит. |
| systematic-debugger | Отладка по Iron Law: воспроизведение → гипотезы → корень → минимальный фикс + регресс-тест; Red Flags, отчёт по фазам. |
| test-generator | pytest-скелеты из AST Python-модуля с ghostwriter-эвристикой аргументов; каркас parametrize, референсы TS/Go. |
| coverage-analyzer | Анализ покрытия из coverage.py XML: общий % строк/веток, файлы без покрытия, худшие-10, дельта от базовой, гейт PASS/FAIL. |
| secret-scanner | Поиск утечек секретов (AWS, GitHub, OpenAI, Anthropic, Stripe, Google, Slack, ключи, JWT): паттерны gitleaks + энтропия + allowlist; офлайн, редактирование, exit-коды для CI. |
| security-review | Оркестратор security-ревью: инвентаризация lockfile’ов + классификатор exit-кодов 13 сканеров (semgrep, bandit, gitleaks, osv-scanner, trivy, grype…) в единую схему находок; по OWASP. |
| plan-skill | Планирование реализации (superpowers v2): брейншторм → план → исполнение → проверка; HARD-GATE, мелкие шаги, без заглушек; скрипт-валидатор. |
| skill-suggester | Подбор нужного скилла из библиотеки под задачу: скоринг триггеров/описаний в index.json, топ-5 + комбо до 3 скиллов. |
| skill-forge | Мета-скилл и дизайн-компас для создания новых скиллов и апгрейда существующих: максимально технологичные, креативные, эстетически дисциплинированные; гейт против шаблонности. |
| api-contract-testing | Сверка контракта API с OpenAPI 3.x (офлайн по манифесту + живые HTTP-пробы); JSON-отчёт, exit 0/1/2. |
| frontend-perfection | Аудит и доводка фронтенда до проверяемого идеала: Lighthouse ≥13 в реальном Chrome (mobile+desktop), офлайн-аудит мета/SEO/WCAG/токенов, Security/Privacy/i18n, генерация OG-изображений. |
| frontend-a11y | Глубокий аудит доступности (95 правил Front-End-Checklist): офлайн-проверки на Python (структура, ARIA, заголовки, landmarks, таблицы, формы, медиа, списки, CSS) + раннер Playwright + axe-core (контраст, порядок фокуса, live regions, ловушки модалок, reflow) и ручные проверки скринридером. |
| frontend-performance | Глубина производительности за пределами Lighthouse: офлайн-анализ заголовков/ассетов (HTTP/2-3, сжатие, кэш, HSTS, TTFB, вес страницы, размер бандла, дубли, resource hints, SW, speculation, streaming, виртуализация) + раннер Lighthouse Core Web Vitals (LCP/FCP/INP/CLS). Покрывает 43 правила Performance. |
| frontend-testing | Фронтенд-тестирование для production-readiness (13 правил Testing): пирамида тестов + копипаста Playwright, jest-axe, Pact (contract) и GitHub Actions perf-budget + coverage CI. Скаффолдит и советует, не запускает ваш CI. |
| mobile-frontend | Качественный mobile-first фронтенд: правила (отступы, шкала типа, якоря, safe-area, tap-targets), сборка и многоуровневая проверка с отладкой меню/навигации; перенаправляет глубокие a11y/perf/тесты в профильные скиллы. |
| skill-feedback | Сбор и агрегация фидбека по скиллам (неверный триггер, near-miss, сломанный вывод, ручная правка) в feedback/<skill>/YYYY-MM-DD.jsonl; резюмирует для цикла оптимизации skill-forge. |
| long-running-agent-workflow | Структурированный протокол для AI-агентов в длинных сессиях: атомарный feature-лист .lra/ (id/приоритет/критерии приёмки/статус), протокол сессии (контекст → одна фича → реализация → тест → чекпоинт), восстановление из сломанных состояний. |
| chronos | Хранитель документации — 5 AI-агентов (Chronos, Censor, Dewey, Veles, Canon) для целостности доков: дубли, битые ссылки, отсутствующие обязательные документы, сироты, классификация L1–L6, устаревшие даты. |
| censor | Факт-чекер документации: дубли (сходство >70%) и битые внутренние ссылки в markdown; пропускает блоки кода, inline-код и внешние URL. |
| dewey | Классификатор документов: уровень L1–L6 для каждого документа, обязательные документы по уровню, поиск отсутствующих. |
| veles | Статистик документации: сироты (без входящих ссылок), метрики, мёртвые зоны, иерархия ссылок L1→L4. |
| canon | Оркестратор Chronos Pantheon: пресеты (minimal/standard/full), агрегация отчётов, кросс-проверка L1–L3 (контракты → продукт → инженерия). |
| prd-to-app | Production-ready full-stack веб-приложение из PRD и макетов: пайплайн из 8 фаз (Material Discovery → System Design → Seed Data → Backend → Frontend → Visual Verification → Integration Testing → Deployment). |
| web-replication | Визуальная репликация фронтенда: разведка публичных страниц сайта через Playwright MCP, скриншоты и лейаут, blueprint с графом навигации, затем визуальная копия. |
🤖 Агенты · agents · 1
| Скилл | Назначение |
|---|---|
| dsh-runner | Автономные агентные задачи через DeepSeek Harness (dsh): изолированные одноразовые workspace, JSONL-логи сессий, headless dsh_task.py или Web UI, сравнение моделей; требует DEEPSEEK_API_KEY / OpenAI-совместимый endpoint. |
📊 Данные и диаграммы · data · 7
| Скилл | Назначение |
|---|---|
| csv-pro | Профилирование CSV: типы колонок, статистика, аномалии (пустые/дубли/выбросы), автоопределение разделителя; markdown/JSON. |
| data-analysis | Профилирование датасета (CSV/JSON): статистика полей, моды, гистограммы, топ-3 корреляции Пирсона, аномалии и рекомендации. |
| sql-helper | Генерация SQL по текстовому вопросу и DDL: схема в памяти sqlite, шаблоны интентов, каждый запрос проверяется через EXPLAIN. |
| diagram-maker | Диаграммы из текстового описания в синтаксисе Mermaid: flowchart, sequence, architecture, ER + рекомендация по рендеру. |
| mermaid-to-image | Рендер .mmd в PNG/SVG: локальный mermaid-cli, fallback на mermaid.ink; форматы, масштаб, фон. |
| raster-to-svg | PNG → векторный SVG: vtracer-cli при наличии, иначе встроенный stdlib-трассировщик (контурные Bezier / мозаика из примитивов); детерминированный, XML-валидируемый; веб-UI с редактором палитры (перекраска/слияние), экспорт DXF R12 (слои по цвету)/EPS/PNG, пакет → .zip, опциональный MCP-сервер. |
| web-scraper | Вежливый скраппинг HTML в Markdown/JSON: CSS-селекторы, текст/ссылки/таблицы; легальные ограничители — robots.txt, честный UA, задержки. |
🎬 Контент и медиа · media · 13
| Скилл | Назначение |
|---|---|
| video-script-writer | Сценарий видео: Hook → Body (5 сцен с таймслотами) → CTA; таймкоды, ru/en, полный сценарий или план. |
| pdf-report-builder | Markdown → PDF-отчёт: HTML через pandoc/встроенный конвертер, PDF через Chrome headless / weasyprint / pandoc; таблицы, код, цитаты. |
| doc-compare | Визуальное сравнение markdown-документов бок о бок с подсветкой правок: слева красным (удалено/изменено), справа зелёным (добавлено/изменено), пословная подсветка внутри правок; «только изменения», версия из публичного GitHub через gh:owner/repo@ref:path, режим --diff. |
| test-graphics | Тестовые картинки, заглушки, иконки, аватары для моков/staging/e2e: Python + бесплатные API (loremflickr, placehold.co, picsum, Lucide). |
| frontend-design-taste | Выразительное дизайн-направление без «AI-шаблонности»: погружение в тему, система токенов, гейт уникальности, копирайт под пользователя. |
| seo-audit | Технический SEO-аудит: мета/заголовки/alt/ссылки/sitemap/robots, Core Web Vitals, скоринг-отчёт (7 измерений), автофиксы P1–P5. |
| seo-schema | Разметка и мета: JSON-LD schema.org (Product/Article/Organization/Breadcrumb/FAQ) + title/description/OG/Twitter. |
| seo-content | Контент страниц: тонкие/дубли, читаемость, E-E-A-T, ключевые слова (плотность, каннибализация, LSI, long-tail), иерархия заголовков, SEO картинок. |
| seo-crawl | Индексация: robots.txt, noindex, canonical, редиректы, sitemap, перелинковка, глубина кликов, сироты, сравнение с конкурентами. |
| seo-toolkit | ⚠️ Устарел (роутер) → используй seo-audit / seo-schema / seo-content / seo-crawl. |
| presentation-maker | Презентации «под ключ» из темы: план → JSON-спека → HTML-слайды 16:9 (с обязательной проверкой Playwright) + настоящий .pptx; пресеты-стратегии, экспорт в PDF, аудит качества (deck_audit.py) и структурная валидация Bento (qa_bento.py). Одна команда на этап. |
| presentation-craft | Роутер качественных дек: оркестрирует docs-product → frontend-design-taste → presentation-maker → frontend-perfection по этапам (смысл, визуальное направление, сборка, аудит). |
| presentation-engineering | Инженерия историй: превращение идей в меняющие мир презентации — нарративная инженерия, визуальный язык и перформанс-дизайн (не генератор слайдов). |
🏗️ Репозиторий и документация · repository · 10
| Скилл | Назначение |
|---|---|
| repo-readme-assets | README.md (EN) + локализованное зеркало + локальные анимированные SVG header/footer (4 пресета), без внешних сервисов. |
| repo-community-files | Community/легальные файлы: LICENSE, CODE_OF_CONDUCT, CONTRIBUTING, SECURITY, SUPPORT, шаблоны issue/PR, FUNDING; поднимает Community Health. |
| repo-metadata-health | Метаданные и здоровье репозитория: описание, topics (≤20), ссылка Pages, % Community Health через gh API + чек-лист из 16 пунктов. |
| repo-social-preview | Социальная превью GitHub (og:image) PNG 1280×640: шапка + волны, <1 МБ, рекомендуется сплошной фон. |
| api-doc-generator | Markdown-документация REST API из OpenAPI 3.x: секции по эндпоинтам (метод, параметры, запрос/ответ); референсы FastAPI/Express. |
| changelog-generator | Раздел CHANGELOG (Keep a Changelog) из git-истории (Conventional Commits): tag..HEAD, маппинг типов, даты, ссылки на коммиты. |
| docs-system | Мета-гайд + роутер документации: продуктовая ветка (зачем/что) vs проектная (как), фазы, уровни L1–L3, чек-лист полноты. |
| docs-product | Продуктовая ветка — «зачем» и «что»: VISION → PRD → ROADMAP → FEATURES, от идеи вперёд; шаблоны + чек-лист. |
| docs-project | Проектная ветка — «как»: README, ENTRY, ARCHITECTURE, ADR, контракты (OpenAPI/AsyncAPI), тесты, карта REFERENCE; шаблоны + чек-лист. |
| github-repo-hygiene | ⚠️ Устарел (роутер) → используй repo-readme-assets / repo-community-files / repo-metadata-health / repo-social-preview. |
💬 Соцсети · social · 1
| Скилл | Назначение |
|---|---|
| reddit-karma | Системный набор кармы на Reddit: поиск тем, ответы с учётом тона, шаблоны благодарностей, регулярные забеги; настраивается под аккаунт. |
🎬 Showcase — примеры на реальных проектах
Живые демонстрации скиллов на реальных проектах (не абстрактные примеры). Эталон: lovii.ru (
lovii_demo). Требование к new скиллов — обязательный showcase. Шаблон:docs/showcase-template.md.
| Скилл | Проект | Что показано |
|---|---|---|
web-scraper |
lovii.ru (лендинг White Paper) | Скраппинг публичной страницы → Markdown-сводка (разделы, метрики, контакты, таблица) |
diagram-maker |
lovii_demo docs/ARCHITECTURE.md |
Текстовая архитектура SPA → Mermaid flowchart структуры экранов по ролям |
github-repo-hygiene |
lovii_demo репозиторий | Аудит Community Health (0% → 100%): отсутствующие файлы, метаданные, API-чеклисты |
test-graphics |
lovii_demo мок-данные + бренд | Аватары партнёров, placeholder-ы товаров, иконки Lucide, batch для e2e |
seo-toolkit |
lovii.ru (лендинг White Paper) | SEO-аудит публичной страницы: meta/OG/заголовки/alt через helper + Core Web Vitals + пробелы JSON-LD |
secret-scanner |
lovii_demo репо | Скан репозитория: 1 Medium (generic-api-key, UUID false positive, index.js:7) — энтропия + allowlist |
security-review |
lovii_demo репо | Инвентаризация lockfiles (npm package-lock.json в .opencode/), классификация exit-кодов (osv-scanner 129 = API-ошибка, semgrep 1 = находки) |
version-bumper |
agent-skills + lovii_demo | Следующая semver-версия по git-истории: agent-skills v1.0.0 → v1.1.0 (minor), lovii_demo fallback 0.0.0 → v0.1.0 |
commit-lint |
agent-skills + lovii_demo | Валидация Conventional Commits: 12/12 agent-skills (длинные subject + тип i18n), lovii_demo — классы type-case и missing-type |
coverage-analyzer |
agent-skills | Отчёт покрытия из coverage.py XML: statements/line/branch, файлы ниже порога, итоговый процент |
frontend-perfection |
lovii_demo | Реальный Chrome-Lighthouse по форм-факторам (mobile 94/96/100/91, desktop 72/96/100/91) + офлайн meta-аудит (17 проверок, 12 нарушений: мета-слой, токены, контраст, scroll-padding) |
🚀 Установка
Для opencode
Скопируйте нужную папку скилла в ~/.config/opencode/skills/:
# Пример: установка presentation-maker
cp -r skills/presentation-maker ~/.config/opencode/skills/
Или загрузите напрямую через skill tool, указав путь к SKILL.md:
# В сессии opencode
skill load path/to/skills/presentation-maker/SKILL.md
Для Sisyphus / других агентов
Каждый скилл содержит:
SKILL.md— полная инструкция (Markdown)skill.json— манифест с метаданными (name, version, triggers, requirements, files)
Агент может парсить index.json для поиска скиллов по триггерам/категориям и загружать нужный.
📁 Структура репозитория
agent-skills/
├── index.json # Мастер-каталог: name, version, category, description, triggers
├── README.md · README.ru.md # Этот документ (EN / RU-зеркало)
├── CHANGELOG.md · LICENSE · CONTRIBUTING.md · SECURITY.md · SUPPORT.md · CODE_OF_CONDUCT.md · FUNDING.yml
├── og-image.png # Социальная превью 1280×640
├── assets/ # SVG header/footer для README
├── docs/
│ ├── SKILLS_CATALOG.md # Каталог экосистемы AI agent skills
│ ├── showcase/ # Примеры на реальных проектах (+ шаблон)
│ └── plans/ # Планировочные документы
├── .github/
│ ├── ISSUE_TEMPLATE/ · pull_request_template.md · release.yml
│ └── workflows/validate-skills.yml # CI: валидация манифестов
└── skills/ # 59 скиллов, по папке на каждый
└── <skill-name>/
├── SKILL.md # Инструкция для агента (обязательно)
├── skill.json # Манифест: name, version, triggers, files (обязательно)
├── scripts/ # Исполняемые скрипты (Python/JS)
├── templates/ # Шаблоны
└── references/ # Дополнительные материалы
Анатомия папки скилла (пример — code-review):
skills/code-review/
├── SKILL.md # Инструкция: введение → шаги → примеры → ограничения
├── skill.json # Манифест: name, version, category, triggers, files
├── scripts/ # review.py, checklists.py
├── templates/ # review-template.md
└── examples/ # example-pr.md
Обязательны только
SKILL.mdиskill.json— всё остальное опционально и зависит от скилла.
🔍 Поиск скиллов
Используйте index.json — он содержит массив skills с полями:
name,version,category,description,path,triggers,updated
Пример фильтрации по триггеру (Python):
import json
with open('index.json') as f:
data = json.load(f)
# Найти скиллы по триггеру "presentation"
matches = [s for s in data['skills'] if 'presentation' in ' '.join(s['triggers'])]
🛠 Добавление нового скилла
- Создайте папку в
skills/<name>/ - Добавьте два обязательных файла:
SKILL.md— полная инструкция для агента (на английском — основной язык, русский по желанию; с YAML-фронтматтеромname,description)skill.json— манифест (см. схему ниже)
- При необходимости добавьте скрипты/шаблоны в подпапки (
scripts/,templates/,icons/) - Обновите
index.json(добавьте запись в массивskills[]) - Создайте PR
Схема skill.json (обязательные поля)
{
"name": "kebab-case-name",
"version": "1.0.0",
"description": "Краткое описание (1-2 предложения)",
"author": "github-username",
"license": "MIT",
"keywords": ["tag1", "tag2"],
"triggers": ["trigger phrase 1", "триггер на русском"],
"category": "repository|media|social|code|data",
"entrypoint": "SKILL.md",
"files": ["SKILL.md", "scripts/*.py"],
"requirements": {
"tools": ["python3", "gh"],
"permissions": ["repo:read"]
},
"updated": "YYYY-MM-DD"
}
Категории: repository, media, social, code, data
Триггеры: фразы, по которым агент должен загрузить скилл. Укажите на английском (основной), русский — по желанию.
Требования к SKILL.md
- Язык: английский (основной, инструкции для агента); русский — по желанию
- Обязательный YAML-фронтматтер:
--- name: skill-name description: "Описание для каталога/поиска" --- - Структура: введение → параметры/шаги → примеры → ограничения/ноу-хау
- Без эмодзи в качестве иконок (только SVG)
- Конкретные команды, пути, примеры вызовов
Проверка перед PR
# Валидация JSON
python3 -m json.tool index.json >/dev/null
python3 -m json.tool skills/<name>/skill.json >/dev/null
# Проверка наличия файлов
ls skills/<name>/SKILL.md skills/<name>/skill.json
📄 Информация о проекте
| Лицензия | MIT |
| Контрибьютинг | CONTRIBUTING.md |
| Безопасность | SECURITY.md |
| Кодекс поведения | CODE_OF_CONDUCT.md — Contributor Covenant 2.1 |
