Agent Skills
Agent Skills — Коллекция скиллов для AI-агентов
Автономные инструкции (skills) для AI-агентов: Sisyphus, opencode, и совместимые. Каждый скилл — папка с
SKILL.md(инструкция) иskill.json(манифест для установки/поиска).
🌐 Versions: English · Русский · Website
📦 Каталог скиллов
📚 Карта экосистемы: см. docs/SKILLS_CATALOG.md — каталог экосистемы AI agent skills (официальные вендоры, форматы, стандарты, ~4.85M файлов SKILL.md, пробелы и рекомендации).
| Скилл | Категория | Описание | Триггеры |
|---|---|---|---|
| github-repo-hygiene | repository |
Проверка и обновление описательной части GitHub-репозитория: README (EN+RU) + визуальное оформление header/footer локальными анимированными SVG (assets/header.svg + assets/footer.svg, SMIL-маска «фон наплывает», морфинг d-path и рассинхрон волн 30% — без внешних сервисов), LICENSE, CODE_OF_CONDUCT, CONTRIBUTING, SECURITY, SUPPORT, issue/PR-шаблоны, социальное превью, релизы, description, topics, GitHub Pages, community health. |
github hygiene, оформить репозиторий, обновить readme, github page, описание репозитория, теги для поиска, topics, contributing, license, security policy, шапка readme, анимированный svg, waving banner |
| test-graphics | media |
Генерация тестовых изображений, фото, иконок, placeholders через Python + бесплатные API (loremflickr, placehold.co, picsum.dev, Lucide). | test images, placeholder, тестовые картинки, иконки для теста, заглушки, mock data images, сгенерировать фото |
| reddit-karma | social |
Систематическая работа на Reddit для набора кармы вашего аккаунта: поиск тем, подготовка ответов, распознавание тона, шаблоны благодарностей, регулярный забег. Настройте никнейм, сабы и целевой ресурс под себя. | reddit, карма, karma, r/LocalLLaMA, поднять карму, ответить на комментарии, забег по reddit |
| presentation-maker | media |
Генератор презентаций: Markdown-аутлайн, HTML 16:9 слайды, .pptx через python-pptx. Авто-лейауты, темы, дизайн-система (токены, mood), модуль «Продакт-дизайнер» (нарратив, дата-виз, a11y, премиум). | сделай презентацию, presentation, слайды, pptx, сделай доклад, презентация для, generate slides, make a deck |
| docs-system | repository |
Гайд для AI-агента: как правильно составлять продуктовую и проектную документацию и её состав. Продуктовая ветка (VISION/PRD/ROADMAP/FEATURES) и проектная ветка (ARCHITECTURE/ADR/контракты/TEST_CASES/карта REFERENCE), порядок заполнения (фазы), шаблоны, чек-лист полноты, уровни L1/L2/L3 для больших систем. | документация, каталог документов, набор документации, полная документация, documentation, docs catalog, documentation structure, docs for new project |
| commit-message-writer | code |
Генерация Conventional Commits-сообщений на основе git diff --staged: тип по изменённым файлам, scope по путям, краткое описание, опциональный body. Скрипт suggest.py (Python 3) анализирует только застейдженные изменения, сам не коммитит. |
commit message, write commit, git commit, conventional commit, сообщение коммита, написать коммит, закоммитить |
| code-review | code |
Структурированный code review: читает git diff или путь к репозиторию/файлу, применяет чек-лист категорий (correctness, security, performance, style, tests, edge cases) и выдаёт замечания [severity] файл:строка с предлагаемым исправлением. Только анализ — правки не вносит. |
code review, ревью кода, review PR, проверь код, pull request review, code quality, найти баги, review commit |
| diagram-maker | data |
Генерация диаграмм из текстового описания: flowchart, sequence, architecture, ER-схемы в синтаксисе Mermaid. Вход — описание на естественном языке, выход — код Mermaid + рекомендация по рендерингу (mermaid.live / mermaid-cli / MCP). | диаграмма, diagram, mermaid, flowchart, блок-схема, sequence diagram, архитектура, ER-схема, draw a diagram |
| mermaid-to-image | data |
Рендер Mermaid-диаграмм (.mmd) в PNG/SVG: приоритет локальному mmdc (mermaid-cli), fallback на API mermaid.ink; форматы svg/png, фон, масштаб, движок auto/mmdc/ink, файл или stdin. | mermaid в картинку, отрендерить диаграмму, render diagram, диаграмма в svg, mermaid to image |
| pdf-report-builder | media |
Сборка PDF-отчётов из Markdown: HTML через pandoc (или встроенный конвертер), PDF первым доступным движком — Chrome/Chromium headless, weasyprint или pandoc + PDF-движок. Таблицы/код/цитаты. | отчёт в pdf, markdown в pdf, собери отчёт, pdf report, document to pdf |
| skill-suggester | code |
Подбор скиллов из библиотеки под задачу пользователя: какой скилл использовать, что выбрать, рекомендовать скилл, подобрать инструмент. Читает index.json, скорит триггеры и описания, выдаёт топ-5 с релевантностью и комбо до 3 скиллов. | какой скилл использовать, подбор скилла, suggest skill, reкомендовать скилл, какой навык, which skill |
| api-doc-generator | repository |
Генерация Markdown-документации REST API из OpenAPI-схемы (3.x, включая 3.1.0): секции на каждый endpoint с методом, path, параметрами, телом запроса и кодами ответов. FastAPI: app.openapi(); Express: swagger-jsdoc. |
api doc, документация API, openapi, swagger в markdown, api reference, описать API |
| changelog-generator | repository |
Генерация раздела CHANGELOG (Keep a Changelog) из git-истории по Conventional Commits: git log tag..HEAD, маппинг типов feat→Added/fix→Fixed/perf→Changed, breaking — в отдельную секцию. Python 3 stdlib. | changelog, сгенерай чанжлог, release notes, история изменений, keep a changelog |
| plan-skill | code |
Планирование реализации по superpowers v2: brainstorm → writing-plans → executing → verification; HARD-GATE, bite-sized шаги, no placeholders, интерфейсы Produces/Consumes. Скрипт plan_validator.py проверяет план на готовность к исполнению. |
спланируй, составь план, plan, как реализовать, разбей на шаги, план реализации |
| systematic-debugger | code |
Отладка по Iron Law: 4 фазы (воспроизведение → гипотезы → изоляция причины → фикс + регресс-тест), Red Flags, Rationalization Table. Скилл фиксирует причину, не автофиксит. Скрипт debug_log.py оформляет отчёт по фазам. |
debug, отладить, почему не работает, баг, debugging, fix the bug |
| test-generator | code |
Генерация pytest-скелетов из Python-модуля по AST с ghostwriter-эвристикой значений аргументов (bool→True/False, int→0/-1/1, str→sample/пустая, list/dict→пустые, Optional→None): @pytest.mark.parametrize. Референс TS/Go. |
generate tests, сгенерируй тесты, test skeleton, pytest скелет, покрытие тестами |
| video-script-writer | media |
Генерация структурированных видео-сценариев из темы: Hook → Body (5 сцен: Problem/Basics/Walkthrough/Pitfalls/Pro tip) → CTA, таблица таймкодов, ru/en, свой CTA, полный сценарий или аутлайн. | сценарий видео, video script, напиши сценарий, план видео, video outline |
| sql-helper | data |
Генерация SQL по текстовому вопросу и DDL-схеме: in-memory схема в sqlite3 из DDL, слова вопроса маппятся на таблицы/колонки, шаблоны интентов (select/join/where/group/order/count/limit), каждый кандидат проверяется через EXPLAIN, читаемый план с --explain. |
sql helper, sql генерация, сгенерируй sql, explain запроса, sql formatting |
| csv-pro | data |
Профилирование CSV-файлов: типы колонок, min/max/mean, пропуски, уникальные, топ-3 частых; аномалии (нулевая дисперсия, >95% пустых, дубликаты строк, строки >1000 символов, выбросы ≥5×IQR); markdown или JSON, определение разделителя, файл или stdin. | csv profile, профиль csv, анализ csv, аномалии csv, csv anomalies |
| web-scraper | data |
Вежливый скраппинг HTML в Markdown/JSON: простой CSS-селектор (tag/tag#id/tag.class), извлечение текста/ссылок/таблиц; легальные guardrails — проверка robots.txt, честный User-Agent, задержка запросов, лимит 10 МБ. | web scraping, скраппинг, скачать данные с сайта, парсинг сайта, scrape |
| data-analysis | data |
Профилирование датасетов (CSV или JSON-массив): типы полей, count/unique/missing, min/max/mean/std, мода + топ-N, гистограмма 5 корзин, топ-3 корреляции Пирсона, аномалии, рекомендации; markdown или JSON отчёт. | data analysis, анализ данных, профиль датасета, статистика данных, eda |
| seo-toolkit | media |
13 SEO-команд для AI-агентов: технический аудит, Core Web Vitals, crawlability, schema.org, ключевые слова, meta-теги, контент-анализ, изображения, отчёты, сравнение с конкурентами, автономные исправления. URL-режим + файловый режим. Скиптер seo_toolkit.py: аудит meta/заголовков/alt, плотность ключей, валидация JSON-LD. |
seo audit, core web vitals, schema org, json-ld, keywords analysis, seo report, meta tags, crawlability |
| secret-scanner | code |
Сканирование кода и git-репозиториев на утечки секретов и токенов (AWS, GitHub, OpenAI, Anthropic, Stripe, Google, Slack, приватные ключи, JWT) по паттернам gitleaks v8.30.1 + энтропийный фильтр Шеннона + allowlist шума. Чистый Python 3 stdlib, офлайн, отчёты JSON/Markdown/text, редактирование секретов, CI-шлюз. | secret scan, проверь секреты, leaked token, scan for keys, hardcoded credentials |
| security-review | code |
Оркестрация security-ревью зависимостей и кода: инвентаризация lockfiles (npm/pip/cargo/go/gem/maven/gradle/composer), классификатор exit-кодов 13 инструментов (semgrep, bandit, gitleaks, osv-scanner, pip-audit, trufflehog, checkov, trivy, grype, npm audit, cargo audit), нормализация JSON-отчётов в единую схему. Офлайн, stdlib. | security review, audit dependencies, lockfile audit, проверь зависимости, уязвимости, osv-scanner |
| version-bumper | code |
Детерминированный bump семвер-версии по git-истории: читает теги (fallback 0.0.0), считает feat/fix/breaking-коммиты в Conventional Commits, предлагает bump (major/minor/patch) + release-тег, режим -s. Офлайн, stdlib, read-only. Замыкает commit-message-writer/changelog-generator. |
version bump, next version, semver, release tag, какая следующая версия, определи версию |
| commit-lint | code |
Валидация git-коммитов по Conventional Commits v1.0.0: читает git log (или stdin), парсит type/scope/subject, сообщает нарушения (missing/invalid type, регистр, длина subject/header/body, точка в конце), отчёт text/JSON, exit 0/1/2. Офлайн, stdlib, read-only. Локальный аналог commitlint. |
commit lint, lint commits, conventional commits, check commit messages, проверка коммитов, валидация коммитов, commit style check |
| coverage-analyzer | code |
Анализ покрытия кода тестами из coverage.py отчётов (XML/JSON): statement/line/branch coverage, разбивка по файлам с проблемными (ниже порогов), итоговый процент, рекомендации. Офлайн, stdlib. Пара к test-generator. |
coverage, coverage analysis, coverage report, test coverage, покрытие кода, анализ покрытия, branch coverage |
| api-contract-testing | code |
Проверка контракта API против OpenAPI 3.x (JSON/YAML, встроенный YAML-парсер, без PyYAML): перечисляет операции (paths + webhooks), проверяет внутреннюю консистентность ($ref, дубликаты, отсутствующие responses), сверяет manifest эндпоинтов офлайн, в live-режиме шлёт HTTP-запросы и сравнивает статусы. JSON-отчёт, exit 0/1/2. Офлайн, stdlib. | api contract testing, contract test, validate openapi spec, spec vs manifest, endpoint coverage, проверь контракт API, тест контракта |
| frontend-perfection | code |
Аудит и доводка фронтенда до проверяемого идеала: реальный Chrome через chrome-launcher + Lighthouse ≥13 Node API (mobile+desktop, без Playwright-интерналов, с .default-фолбэком и авто-резолюцией зависимостей, exit 0/1/2, компактный JSON с failed audit-id); офлайн Python-stdlib аудит статики (SEO-мета-слой, контрасты WCAG по вычисленной яркости, порядок заголовков, дизайн-токены — ноль raw-hex вне токенов, scroll-padding под fixed-хедер, брейкпоинты); генерация crop-safe OG-изображений (1200×630 с центральной безопасной зоной ~640px, смена имени вместо перезаписи для сброса кеша соцсетей, принудительный reflow перед скриншотом). Каждый фикс привязывается к audit-id. |
frontend audit, lighthouse check, make it 100/100/100/100, perfect the layout, og image, contrast check, design tokens, проверь вёрстку, довести фронтенд до идеала |
🎬 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 # Манифест репозитория (поиск/каталог)
├── README.md # Этот файл (английский)
├── README.ru.md # Русское зеркало
├── CHANGELOG.md # Keep a Changelog
├── LICENSE # MIT License
├── CONTRIBUTING.md # Как добавить/обновить скиллы
├── SECURITY.md # Политика безопасности
├── SUPPORT.md # Где получить помощь
├── CODE_OF_CONDUCT.md # Contributor Covenant 2.1
├── FUNDING.yml # Кнопка Sponsor
├── og-image.png # Социальное превью (1280x640)
├── docs/
│ └── SKILLS_CATALOG.md # Каталог экосистемы (вендоры, форматы, пробелы)
├── .github/
│ ├── ISSUE_TEMPLATE/
│ │ ├── bug_report.yml # Форма issue (баг)
│ │ └── feature_request.yml # Форма issue (фича)
│ ├── pull_request_template.md
│ ├── release.yml # Конфиг авто-релиз-нот
│ └── workflows/
│ └── validate-skills.yml # CI: JSON schema, cross-check, Python syntax
└── skills/
├── github-repo-hygiene/
│ ├── SKILL.md
│ └── skill.json
├── test-graphics/
│ ├── SKILL.md
│ ├── skill.json
│ └── scripts/test-graphics.py
├── reddit-karma/
│ ├── SKILL.md
│ └── skill.json
├── presentation-maker/
│ ├── SKILL.md
│ ├── skill.json
│ ├── references/
│ │ ├── design-system.md
│ │ └── product-designer.md
│ ├── scripts/
│ │ ├── build_html.py
│ │ ├── build_pptx.py
│ │ └── verify_slides.py
│ ├── templates/
│ │ ├── slides.html
│ │ ├── themes/*.json
│ │ └── icons/*.svg
└── docs-system/
├── SKILL.md
├── skill.json
├── ROADMAP.md
├── references/
│ ├── product-docs.md
│ ├── project-docs.md
│ ├── order.md
│ ├── completeness.md
│ └── levels.md
├── templates/
│ ├── product/ (VISION.tmpl, PRD.tmpl, ROADMAP.tmpl)
│ └── project/ (14 *.tmpl)
└── examples/example-monorepo/README.md
├── commit-message-writer/
│ ├── SKILL.md
│ ├── skill.json
│ └── scripts/suggest.py
├── code-review/
│ ├── SKILL.md
│ ├── skill.json
│ ├── scripts/
│ │ ├── review.py
│ │ └── checklists.py
│ ├── templates/review-template.md
│ └── examples/example-pr.md
├── diagram-maker/
│ ├── SKILL.md
│ ├── skill.json
│ ├── scripts/mermaid_to_markdown.py
│ ├── templates/ (flowchart.mmd, sequence.mmd, architecture.mmd, er.mmd)
│ └── examples/ (example-cart-flow.mmd, example-billing-seq.mmd)
├── mermaid-to-image/
│ ├── SKILL.md
│ ├── skill.json
│ └── scripts/mermaid_to_image.py
├── pdf-report-builder/
│ ├── SKILL.md
│ ├── skill.json
│ └── scripts/pdf_report_builder.py
└── skill-suggester/
├── SKILL.md
├── skill.json
└── scripts/skill_suggest.py
├── api-doc-generator/
│ ├── SKILL.md
│ ├── skill.json
│ └── scripts/api_doc.py
├── changelog-generator/
│ ├── SKILL.md
│ ├── skill.json
│ └── scripts/changelog_gen.py
├── plan-skill/
│ ├── SKILL.md
│ ├── skill.json
│ ├── scripts/plan_validator.py
│ ├── templates/implementation-plan.md
│ └── examples/implementation-plan-example.md
├── systematic-debugger/
│ ├── SKILL.md
│ ├── skill.json
│ └── scripts/debug_log.py
├── test-generator/
│ ├── SKILL.md
│ ├── skill.json
│ └── scripts/test_gen.py
└── video-script-writer/
├── SKILL.md
├── skill.json
└── scripts/video_script_writer.py
├── sql-helper/
│ ├── SKILL.md
│ ├── skill.json
│ └── scripts/sql_helper.py
├── csv-pro/
│ ├── SKILL.md
│ ├── skill.json
│ └── scripts/csv_pro.py
├── data-analysis/
│ ├── SKILL.md
│ ├── skill.json
│ └── scripts/data_analyze.py
├── web-scraper/
│ ├── SKILL.md
│ ├── skill.json
│ └── scripts/scrape.py
├── seo-toolkit/
│ ├── SKILL.md
│ ├── skill.json
│ ├── references/canonical-patterns.md
│ ├── scripts/seo_toolkit.py
│ └── commands/ (13 × seo-*.md)
└── frontend-perfection/
├── SKILL.md
├── skill.json
├── references/canonical-patterns.md
├── scripts/audit.js
└── scripts/meta_audit.py
🔍 Поиск скиллов
Используйте 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 License — см. LICENSE.
🤝 Контрибьютинг
См. CONTRIBUTING.md.
🔒 Безопасность
См. SECURITY.md.
📜 Кодекс поведения
См. CODE_OF_CONDUCT.md (Contributor Covenant 2.1).
