Skilly pro agenty

Skill je jeden obyčejný soubor .md, který AI agenta naučí jednu práci: kdy ji dělat, jaká pravidla dodržet a jaký přesně výstup vytvořit. Žádný kód, žádný runtime, žádný vendor lock-in — agent soubor prostě přečte. A protože jde o Markdown, přečtete si ho i vy, můžete porovnat změny a připnout přesně tu verzi, kterou jste zkontrolovali.

Skilly odpovídají na otázku jak pracovat. Co platí ve vašem kontextu — vaše technologie, zvyklosti, zákazníci — patří do soukromého Brainu. Obojí se potkává v agentovi: skill je návod, Brain je paměť.

# vyzkoušejte si to — nainstaluje .md do ./skills
npx @emdly/cli add opsmith/jira-ticket-scorer

Anatomie skillu

Pevné schéma neexistuje, dobré skilly ale mají podobnou stavbu. Uveďte, kdy se skill použije, vyjmenujte závazná pravidla (co agent nikdy nesmí dělat) a popište výstup tak přesně, aby se dva běhy daly porovnat:

---
name: jira-ticket-scorer            # front matter je v katalogu volitelný —
description: Scores Jira tickets…   # varianta SKILL.md ho doplní, pokud chybí
---

# Jira ticket scorer

Use when the user asks to triage, score or prioritise tickets.

## Rules
- Never invent fields that are not in the ticket.
- Ask before scoring more than 50 tickets at once.

## Output
A table: ID · title · score 1–5 · one-line reason.

Udržte ho do několika kilobajtů: agenti načítají skilly do kontextu. Jeden skill = jedna práce — „a“ v popisu obvykle znamená, že by to měly být dva skilly.

Instalace

Tři cesty, stejný soubor. Žádná nevyžaduje účet:

# CLI — zkopíruje .md do ./skills
npx @emdly/cli add {owner}/{skill}

# přímá URL — stabilní, vhodná pro skripty
curl https://emdly.com/raw/{owner}/{skill}.md

# MCP — agent si skill nainstaluje sám
claude mcp add --transport http emdly https://emdly.com/mcp
# pak: „nainstaluj {owner}/{skill} z emdly“

Přes MCP předá install_skill agentovi soubor i přesnou cestu pro jeho prostředí: Claude Code zapíše ~/.claude/skills/<name>/SKILL.md, takže se skill objeví jako /<name> v každém projektu (scope=project ho ponechá jen v .claude/skills aktuálního projektu); Hermes dostane ~/.hermes/skills/<category>/<name>/SKILL.md; vše ostatní ./skills/<name>.md. Varianta SKILL.md vždy obsahuje front matter name/description/version — pokud ho autor vynechal, doplníme ho.

Verze a připnutí

Každá schválená aktualizace se stane číslovanou verzí. URL bez verze vždy vrací poslední schválenou verzi; verzi připněte, když záleží na přesném znění — v CI, u více agentů najednou, u všeho, co jste prověřili:

https://emdly.com/raw/{owner}/{skill}.md        → poslední schválená
https://emdly.com/raw/{owner}/{skill}@v12.md    → přesně v12, navždy
get_skill(owner/skill, version: 12)       → totéž přes MCP

Publikování a schválení

Skill může odeslat kdokoli přihlášený (přes Google nebo GitHub) — ve webovém editoru, nahráním souboru, přes REST API, nebo tak, že požádá svého agenta o zavolání submit_skill. Každé odeslání, ať jde o první verzi, nebo aktualizaci, prochází stejným procesem:

1. Automatické kontroly — kontrola formátu Markdownu, přítomnost licence, kontrola prompt injection.
2. AI kontrola bezpečnosti — označí pro schvalovatele manipulaci, nebezpečné instrukce a vzory prompt injection.
3. Schválení člověkem — člověk verzi schválí, nebo ji s odůvodněním zamítne. Nic se nepublikuje samo.

Verze, které vším projdou bez nálezů, mají na stránce skillu označení Bezpečnostně prověřeno. Stejně si budují reputaci i autoři: za publikovanou práci získávají autorské odznaky Ověřený, Doporučený a Certifikovaný.

Časté dotazy