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) and skill.json (manifest for installation/discovery).

🌐 Versions: English · Русский · Website

📦 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).

🎬 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.

🚀 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                 # Repository manifest (search/catalog)
├── README.md                  # This file (English)
├── README.ru.md               # Russian mirror
├── CHANGELOG.md               # Keep a Changelog
├── LICENSE                    # MIT License
├── CONTRIBUTING.md            # How to add/update skills
├── SECURITY.md                # Security policy
├── SUPPORT.md                 # Where to get help
├── CODE_OF_CONDUCT.md         # Contributor Covenant 2.1
├── FUNDING.yml                # Sponsor button
├── og-image.png               # Social preview (1280x640)
├── docs/
│   └── SKILLS_CATALOG.md      # Ecosystem catalog (vendors, formats, gaps)
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.yml     # Issue form (bug)
│   │   └── feature_request.yml # Issue form (feature)
│   ├── pull_request_template.md
│   ├── release.yml            # Auto-generated release notes config
│   └── 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
    ├── video-script-writer/
    │   ├── SKILL.md
    │   ├── skill.json
    │   └── scripts/video_script_writer.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
    ├── 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

🔍 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

1. Create folder in skills/<name>/
2. Add two required files:
   • SKILL.md — full agent instruction (English primary; Russian optional, with YAML frontmatter name, description)
   • skill.json — manifest (see schema below)
3. Optionally add scripts/templates in subfolders (scripts/, templates/, icons/)
4. Update index.json (add entry to skills[])
5. 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

📄 License

MIT License — see LICENSE.

🤝 Contributing

See CONTRIBUTING.md.

🔒 Security

See SECURITY.md.

📜 Code of Conduct

See CODE_OF_CONDUCT.md (Contributor Covenant 2.1).