Agent Skills
Agent Skills — AI Agent Skill Collection
Autonomous skill instructions for AI agents: Sisyphus, opencode, and compatible. Each skill is a folder with
SKILL.md(instructions) andskill.json(manifest for installation/discovery).
🌐 Versions: English · Русский · Website
📑 Table of Contents
- [📦 Skill Catalog](#sec-catalog) — 59 skills · 6 categories · HTML charts - [🎬 Showcase](#sec-showcase) — real-project examples - [🚀 Installation](#sec-installation) - [📁 Repository Structure](#sec-structure) - [🔍 Skill Discovery](#sec-discovery) - [🛠 Adding a New Skill](#sec-adding) - [📄 Project Info](#sec-project-info) — license · contributing · security · code of conduct📦 Skill Catalog
📚 Ecosystem map: see docs/SKILLS_CATALOG.md — catalog of the AI agent skills ecosystem (official vendors, formats, standards, ~4.85M SKILL.md files tracked, gaps and recommendations). When you update this README (skills added/removed, versions or categories changed), also update
docs/SKILLS_CATALOG.md(section 9) andindex.json— keep all three in sync.
59 skills · 6 categories. Pick a category below; triggers and full metadata live in index.json. HTML charts (Chart.js) available in data-analysis, csv-pro, diagram-maker.
| Category | Skills | What’s inside |
|---|---|---|
| 💻 Development & Code | 27 | commits, review, debugging, tests, coverage, security, planning, frontend, docs integrity, skill authoring |
| 🤖 Agents | 1 | autonomous agent runs (DeepSeek Harness) |
| 📊 Data & Diagrams | 7 | profiling, SQL, diagrams, scraping |
| 🎬 Content & Media | 13 | slides, video, PDF reports, SEO, test graphics |
| 🏗️ Repository & Docs | 10 | README, community files, metadata, documentation, API docs |
| 💬 Social | 1 |
💻 Development & Code · code · 27
| Skill | Purpose |
|---|---|
| commit-message-writer | Conventional Commits message from git diff --staged: type/scope inferred, summary + optional body. |
| commit-lint | Validates commit messages against Conventional Commits v1.0.0 (type, scope, lengths, capitalization); text/JSON report, exit 0/1/2. |
| version-bumper | Deterministic next semver + release tag from git history (feat/fix/breaking); -s mode, read-only. |
| code-review | Structured review of a diff/repo: checklists by category (correctness, security, performance, style, tests, edge cases), [severity] file:line findings. Analysis only — no edits. |
| systematic-debugger | Hypothesis-driven debugging (Iron Law): reproduce → hypotheses → root cause → minimal fix + regression test; Red Flags, phase report. |
| test-generator | pytest skeletons from a Python module AST with ghostwriter arg heuristics; parametrize scaffolding, TS/Go references. |
| coverage-analyzer | Coverage analysis from coverage.py XML: total line/branch %, zero-coverage files, worst-10, delta vs baseline, PASS/FAIL gate. |
| secret-scanner | Static secret scan (AWS, GitHub, OpenAI, Anthropic, Stripe, Google, Slack, keys, JWTs): gitleaks patterns + Shannon entropy + allowlists; offline, redaction, CI exit-code. |
| security-review | Security review orchestrator: lockfile inventory + exit-code classifier for 13 scanners (semgrep, bandit, gitleaks, osv-scanner, trivy, grype…) into one finding schema; OWASP-aligned. |
| plan-skill | Implementation planning (superpowers v2): brainstorm → plan → execute → verify; HARD-GATE, bite-sized steps, no placeholders; validator script. |
| skill-suggester | Recommends the right skill from this library for a task: scores index.json triggers/descriptions, top-5 + combos of up to 3. |
| skill-forge | Meta-skill and design compass for creating new skills and upgrading existing ones: maximally technological, creative, aesthetically disciplined; anti-templated gate. |
| api-contract-testing | Validates an API contract against OpenAPI 3.x (offline manifest check + live HTTP probes); JSON report, exit 0/1/2. |
| frontend-perfection | Frontend audit & polish to verifiable perfection: real-Chrome Lighthouse ≥13 (mobile+desktop), offline meta/SEO/WCAG/token audit, Security/Privacy/i18n audit, OG-image generation. |
| frontend-a11y | Deep accessibility audit (95 Front-End-Checklist a11y rules): offline Python static checks (structure, ARIA, headings, landmarks, tables, forms, media, lists, CSS) plus a Playwright + axe-core runtime runner (contrast, focus order, live regions, modal traps, reflow) and manual screen-reader checks. |
| frontend-performance | Performance depth beyond Lighthouse: offline header/asset analysis (HTTP/2-3, compression, caching, HSTS, TTFB, page weight, bundle size, duplicates, resource hints, SW, speculation, streaming, virtualization) + Lighthouse Core Web Vitals runner (LCP/FCP/INP/CLS). Maps 43 Front-End-Checklist Performance rules. |
| frontend-testing | Frontend testing for production readiness (13 Front-End-Checklist Testing rules): testing pyramid + copy-paste Playwright, jest-axe, Pact contract tests, and a GitHub Actions perf-budget + coverage CI. Scaffolds & advises; does not run user CI. |
| mobile-frontend | Quality mobile-first frontend: codified rules (spacing, type scale, anchors, safe-area, tap-targets), build, and multi-level verification with per-element menu/nav debugging; routes deep a11y/perf/testing to dedicated skills. |
| skill-feedback | Capture and aggregate usage feedback for Agent Skills (wrong trigger, near-miss, broken output, manual correction) into feedback/<skill>/YYYY-MM-DD.jsonl; summarizes for the skill-forge optimization loop. |
| long-running-agent-workflow | Structured protocol for AI agents across many context windows: a .lra/ atomic feature list (id/priority/acceptance criteria/status), session protocol (read context → pick one feature → implement → test → checkpoint), recovery from broken states. |
| chronos | Documentation Timekeeper: 5 AI agents (Chronos, Censor, Dewey, Veles, Canon) for documentation integrity — duplicates, broken links, missing required docs, orphans, L1–L6 classification, stale dates. |
| censor | Fact-checker for documentation: detects duplicates (similarity >70%) and broken internal links in markdown; skips code blocks, inline code, and external URLs. |
| dewey | Document classifier: assigns L1–L6 taxonomy level to each document, enforces required docs per level, detects missing required documents. |
| veles | Documentation statistician: finds orphan documents (no inbound references), computes documentation metrics, detects dead zones, validates link hierarchy L1→L4. |
| canon | Orchestrator for the Chronos Pantheon: runs agent presets (minimal/standard/full), aggregates reports, validates cross-references between L1–L3 (contracts → product → engineering). |
| prd-to-app | Production-ready full-stack web app from PRD documents and prototype images: 8-phase pipeline (Material Discovery → System Design → Seed Data → Backend → Frontend → Visual Verification → Integration Testing → Deployment). |
| web-replication | Frontend visual replication: explores a target site’s public pages via Playwright MCP, captures screenshots and layout, builds a navigation-graph blueprint, then a frontend visual replica. |
🤖 Agents · agents · 1
| Skill | Purpose |
|---|---|
| dsh-runner | Runs autonomous agent tasks via DeepSeek Harness (dsh): isolated one-off workspaces, JSONL session logs, headless dsh_task.py or Web UI, model comparison; requires DEEPSEEK_API_KEY / OpenAI-compatible endpoint. |
📊 Data & Diagrams · data · 7
| Skill | Purpose |
|---|---|
| csv-pro | CSV profiling: column types, statistics, anomalies (empty/duplicates/outliers), delimiter auto-detect; markdown/JSON/HTML with charts. |
| data-analysis | Dataset profiling (CSV/JSON): field stats, modes, histograms, top Pearson correlations, anomalies + recommendations; HTML dashboard with Chart.js. |
| sql-helper | SQL from a text question + DDL: in-memory sqlite schema, intent templates, every candidate verified via EXPLAIN. |
| diagram-maker | Diagrams from text: Mermaid (flowchart, sequence, architecture, ER) + HTML charts (bar, line, pie, scatter) via Chart.js. |
| mermaid-to-image | Renders .mmd to PNG/SVG: local mermaid-cli preferred, mermaid.ink fallback; format/scale/background options. |
| raster-to-svg | PNG → vector SVG: vtracer-cli when installed, built-in stdlib tracer otherwise (contour with Bezier curves / mosaic of primitives); deterministic, XML-validated; web UI with color palette editor (recolor/merge), export DXF R12 (layers by color)/EPS/PNG, batch → .zip, optional MCP server. |
| web-scraper | Polite HTML scraping to Markdown/JSON: CSS selectors, text/links/tables; legal guardrails — robots.txt, honest UA, rate limit. |
🎬 Content & Media · media · 13
| Skill | Purpose |
|---|---|
| video-script-writer | Structured video script: Hook → Body (5 timed scenes) → CTA; timecodes, ru/en, full script or outline. |
| pdf-report-builder | Markdown/HTML → PDF report: HTML via pandoc/built-in converter, PDF via Chrome headless / weasyprint / pandoc; tables, code, quotes, embedded charts. |
| doc-compare | Side-by-side visual comparison of markdown documents with diff highlighting (removed/changed in red on the left, added/changed in green on the right, word-level inside edits); “only changes” mode, fetch a version from a public GitHub repo via gh:owner/repo@ref:path, --diff table mode. |
| test-graphics | Test images, placeholders, icons, avatars for mocks/staging/e2e: Python + free APIs (loremflickr, placehold.co, picsum, Lucide). |
| frontend-design-taste | Distinctive visual direction that doesn’t read as templated AI: subject grounding, token system, uniqueness gate, user-side copy. |
| seo-audit | Technical SEO audit: meta/headings/alt/links/sitemap/robots, Core Web Vitals, scored report (7 dimensions), autonomous P1–P5 fixes. |
| seo-schema | Structured data & meta: JSON-LD schema.org (Product/Article/Organization/Breadcrumb/FAQ) + title/description/OG/Twitter. |
| seo-content | On-page content: thin/duplicates, readability, E-E-A-T, keywords (density, cannibalization, LSI, long-tail), heading hierarchy, image SEO. |
| seo-crawl | Crawlability: robots.txt, noindex, canonical, redirects, sitemap, internal linking, click depth, orphan pages, competitor comparison. |
| seo-toolkit | ⚠️ Deprecated router → use seo-audit / seo-schema / seo-content / seo-crawl. |
| presentation-maker | End-to-end decks from a topic: outline → JSON spec → 16:9 HTML slides (mandatory Playwright check) + real .pptx; strategy presets, PDF export, deck-quality audit (deck_audit.py), and structural Bento validation (qa_bento.py). One command per stage. |
| presentation-craft | Router for high-quality decks: orchestrates docs-product → frontend-design-taste → presentation-maker → frontend-perfection per stage (narrative, visual direction, build, audit). |
| presentation-engineering | Story engineering: turning ideas into world-changing presentations — narrative engineering, visual language, and performance design (not a slide generator). |
🏗️ Repository & Docs · repository · 10
| Skill | Purpose |
|---|---|
| repo-readme-assets | README.md (EN) + localized mirror + local animated SVG header/footer (4 presets), zero external services. |
| repo-community-files | Community/legal files: LICENSE, CODE_OF_CONDUCT, CONTRIBUTING, SECURITY, SUPPORT, issue/PR templates, FUNDING; drives Community Health. |
| repo-metadata-health | Repo metadata & health: description, topics (≤20), Pages link, Community Health % via gh API + 16-point checklist. |
| repo-social-preview | GitHub social preview (og:image) PNG 1280×640: header + waves, <1 MB, solid background recommended. |
| api-doc-generator | REST API docs in Markdown from OpenAPI 3.x: per-endpoint sections (method, params, request/response); FastAPI/Express references. |
| changelog-generator | Keep a Changelog section from git history (Conventional Commits): tag..HEAD, type mapping, dates, commit links. |
| docs-system | Meta-guide + router for documentation: product branch (why/what) vs project branch (how), phases, L1–L3 levels, completeness checklist. |
| docs-product | Product docs branch — «why» and «what»: VISION → PRD → ROADMAP → FEATURES, from an idea forward; templates + checklist. |
| docs-project | Engineering docs branch — «how»: README, ENTRY, ARCHITECTURE, ADR, contracts (OpenAPI/AsyncAPI), tests, REFERENCE map; templates + checklist. |
| github-repo-hygiene | ⚠️ Deprecated router → use repo-readme-assets / repo-community-files / repo-metadata-health / repo-social-preview. |
💬 Social · social · 1
| Skill | Purpose |
|---|---|
| reddit-karma | Systematic Reddit karma building: topic search, tone-aware replies, thank-you templates, routine runs; configurable for your account. |
🎬 Showcase — real-project examples
Live demonstrations of skills on real projects (not abstract examples). Reference project: lovii.ru (
lovii_demo). Every new skill must ship a showcase. Template:docs/showcase-template.md.
| Skill | Project | What’s demonstrated |
|---|---|---|
web-scraper |
lovii.ru landing (White Paper) | Scraping the public page → Markdown summary (sections, metrics, contacts, table) |
diagram-maker |
lovii_demo docs/ARCHITECTURE.md |
Textual SPA architecture → Mermaid flowchart of role-based screen structure |
github-repo-hygiene |
lovii_demo repository | Community Health audit (0% → 100%): missing files, metadata, API checklists |
test-graphics |
lovii_demo mock data + brand | Partner avatars, product placeholders, Lucide icons, batch for e2e |
seo-toolkit |
lovii.ru landing (White Paper) | SEO-audit of the public page: meta/OG/headings/alt via helper + Core Web Vitals checklist, JSON-LD (0 blocks) |
secret-scanner |
lovii_demo repo | Secret scan of the repo: 1 Medium (generic-api-key, UUID false positive, index.js:7) — entropy + allowlist interpretation |
security-review |
lovii_demo repo | Lockfile inventory (npm package-lock.json in .opencode/), exit-code classification (osv-scanner 129 = API error, semgrep 1 = findings) |
version-bumper |
agent-skills + lovii_demo | Next semver from git history: 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 validation: 12/12 agent-skills (long subjects + i18n type), lovii_demo type-case + missing-type classes |
coverage-analyzer |
agent-skills | Coverage report from coverage.py XML: statements/line/branch, files below threshold, summary percentage |
frontend-perfection |
lovii_demo | Real-Chrome Lighthouse across form factors (mobile 94/96/100/91, desktop 72/96/100/91) + offline meta audit (17 checks, 12 violations: meta layer, tokens, contrast, scroll-padding) |
🚀 Installation
For opencode
Copy the desired skill folder to ~/.config/opencode/skills/:
# Example: install presentation-maker
cp -r skills/presentation-maker ~/.config/opencode/skills/
Or load directly via skill tool pointing to SKILL.md:
# In opencode session
skill load path/to/skills/presentation-maker/SKILL.md
For Sisyphus / other agents
Each skill contains:
SKILL.md— full instruction (Markdown)skill.json— manifest with metadata (name, version, triggers, requirements, files)
Agent can parse index.json to discover skills by triggers/categories and load the needed one.
📁 Repository Structure
agent-skills/
├── index.json # Master catalog: name, version, category, description, triggers
├── README.md · README.ru.md # This document (EN / RU mirror)
├── CHANGELOG.md · LICENSE · CONTRIBUTING.md · SECURITY.md · SUPPORT.md · CODE_OF_CONDUCT.md · FUNDING.yml
├── og-image.png # Social preview 1280×640
├── assets/ # README header/footer SVG
├── docs/
│ ├── SKILLS_CATALOG.md # AI agent skills ecosystem catalog
│ ├── showcase/ # Real-project demonstrations (+ template)
│ └── plans/ # Planning documents
├── .github/
│ ├── ISSUE_TEMPLATE/ · pull_request_template.md · release.yml
│ └── workflows/validate-skills.yml # CI: manifest validation
└── skills/ # 59 skills, one folder each
└── <skill-name>/
├── SKILL.md # Agent instruction (required)
├── skill.json # Manifest: name, version, triggers, files (required)
├── scripts/ # Executable helpers (Python/JS)
├── templates/ # Reusable templates
└── references/ # Deep-dive materials
Skill folder anatomy (example — code-review):
skills/code-review/
├── SKILL.md # Agent instruction: intro → steps → examples → constraints
├── skill.json # Manifest: name, version, category, triggers, files
├── scripts/ # review.py, checklists.py
├── templates/ # review-template.md
└── examples/ # example-pr.md
Only
SKILL.mdandskill.jsonare required — everything else is optional and depends on the skill.
🔍 Skill Discovery
Use index.json — it contains a skills array with fields:
name,version,category,description,path,triggers,updated
Example filtering by trigger (Python):
import json
with open('index.json') as f:
data = json.load(f)
# Find skills matching trigger "presentation"
matches = [s for s in data['skills'] if 'presentation' in ' '.join(s['triggers'])]
🛠 Adding a New Skill
- Create folder in
skills/<name>/ - Add two required files:
SKILL.md— full agent instruction (English primary; Russian optional, with YAML frontmattername,description)skill.json— manifest (see schema below)
- Optionally add scripts/templates in subfolders (
scripts/,templates/,icons/) - Update
index.json(add entry toskills[]) - Open PR
skill.json Schema (required fields)
{
"name": "kebab-case-name",
"version": "1.0.0",
"description": "Brief description (1-2 sentences)",
"author": "github-username",
"license": "MIT",
"keywords": ["tag1", "tag2"],
"triggers": ["trigger phrase 1", "trigger на русском"],
"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"
}
Categories: repository, media, social, code, data
Triggers: phrases that cause the agent to load the skill. Provide English; Russian optional.
SKILL.md Requirements
- Language: English (primary, instructions for agent); Russian optional
- Required YAML frontmatter:
--- name: skill-name description: "Description for catalog/search" --- - Structure: intro → parameters/steps → examples → constraints/know-how
- No emojis as icons (SVG only)
- Concrete commands, paths, invocation examples
Pre-PR Checklist
# Validate JSON
python3 -m json.tool index.json >/dev/null
python3 -m json.tool skills/<name>/skill.json >/dev/null
# Check required files exist
ls skills/<name>/SKILL.md skills/<name>/skill.json
📄 Project Info
| License | MIT |
| Contributing | CONTRIBUTING.md |
| Security | SECURITY.md |
| Code of Conduct | CODE_OF_CONDUCT.md — Contributor Covenant 2.1 |
