Dovednosti / Skills

CZ

Dovednost je modulární kus know-how, který agent umí použít. Oproti agentovi (jedna osoba s obecnými instrukcemi) je dovednost úzce zaměřená na jeden úkol nebo postup.

Každá dovednost je samostatná složka obsahující:

• SKILL.md — co dovednost umí, kdy ji má agent použít, jak s ní pracovat.
• Další soubory — šablony, vzorové dokumenty, checklisty, reference, ukázkové odpovědi, skripty.

Proč dovednosti

Bez dovedností byste museli psát dlouhé instrukce do každého agenta znovu a znovu. Dovednosti to oddělí:

• Agent — styl, role, obecná pravidla.
• Dovednost — konkrétní postup pro konkrétní úkol.

Agent si sám vybere správnou dovednost podle otázky. Vy píšete jednu dovednost, používají ji všichni vaši agenti.

Vlastní vs. pluginové dovednosti

• Vlastní dovednosti — uloženy ve vašem pracovním adresáři. Upravíte editorem uvnitř CODEXISu.
• Dovednosti pluginů — dodané doplňkem. Aktualizují se centrálně.

Vytvořit vlastní dovednost

V sekci Dovednosti → Nová dovednost:

1. Jméno a slug — používá se pro identifikaci (agent ji bude volat podle jména).
2. Popis — kdy dovednost použít. Agent podle tohoto textu rozhoduje, jestli je dovednost relevantní k dotazu.
3. Instrukce (SKILL.md) — jaký postup dodržet. Strukturovaný markdown:
   • Kdy použít
   • Jak to udělat krok za krokem
   • Na co dát pozor
   • Vzorová odpověď / formát
4. Soubory — připojené šablony, reference, datové podklady.

Struktura složky

my-skill/
├─ SKILL.md           # instrukce (povinné)
├─ template.md        # šablona výstupu
├─ reference/
│  ├─ zakon.md
│  └─ vzor-prednesu.md
└─ examples/
   └─ odpoved-ukazka.md

Jak agent dovednost používá

1. Uživatel položí dotaz.
2. Agent prochází popisy dostupných dovedností.
3. Vybere dovednost, jejíž description nejvíce odpovídá.
4. Načte si SKILL.md a případné referenční soubory.
5. Zareaguje dle postupu.

Vy vidíte, kterou dovednost agent použil — v chatu se zobrazí jako badge.

Příklady dovedností

• Rozbor smlouvy — extrakce klíčových ustanovení, identifikace rizik, návrhy úprav.
• Draft odvolání — struktura podání, povinné náležitosti, citace.
• Citace judikatury — správný formát sp. zn. ČR i EU.
• Rešerše předpisu — najít původní znění + všechny novelizace.
• Výpočet lhůty — spočítat procesní lhůtu s ohledem na svátky.

Editace a mazání

Smazáním vlastní dovednosti se odstraní celá složka včetně souborů. Pluginové dovednosti mizí s odinstalací doplňku.

EN

A skill is a modular unit of know-how that an agent can use. Unlike an agent (a single persona with generic instructions), a skill is narrowly scoped to a single task or procedure.

Every skill is a self-contained folder with:

• SKILL.md — what the skill does, when the agent should use it, how to work with it.
• Supporting files — templates, sample documents, checklists, references, example responses, scripts.

Why Skills

Without skills you would have to write long instructions into every agent again and again. Skills separate the two layers:

• Agent — tone, role, general rules.
• Skill — specific procedure for a specific task.

The agent picks the right skill on its own based on the question. You write a skill once and all your agents use it.

Custom vs. Plugin Skills

• Custom skills — stored in your workspace directory. Edited in the editor inside CODEXIS.
• Plugin skills — delivered by a plugin. Updated centrally.

Create a Custom Skill

Under Skills → New Skill:

1. Name and slug — used for identification (the agent invokes the skill by name).
2. Description — when to use the skill. The agent uses this text to decide whether the skill is relevant to the query.
3. Instructions (SKILL.md) — what procedure to follow. Structured markdown:
   • When to use
   • Step-by-step procedure
   • Things to watch out for
   • Sample response / format
4. Files — attached templates, references, data materials.

Folder Structure

my-skill/
├─ SKILL.md           # instructions (required)
├─ template.md        # output template
├─ reference/
│  ├─ statute.md
│  └─ sample-submission.md
└─ examples/
   └─ answer-example.md

How the Agent Uses a Skill

1. The user asks a question.
2. The agent scans the descriptions of the available skills.
3. It selects the skill whose description best matches.
4. It loads SKILL.md and any reference files.
5. It responds according to the procedure.

You can see which skill the agent used — it is shown in chat as a badge.

Examples of Skills

• Contract analysis — extraction of key clauses, risk identification, edit suggestions.
• Draft appeal — submission structure, mandatory elements, citations.
• Case law citations — correct format of case file numbers for Czech and EU courts.
• Statute research — locate the original text and all amendments.
• Time-limit calculation — compute a procedural deadline accounting for holidays.

Editing and Deleting

Deleting a custom skill removes the entire folder, including files. Plugin skills disappear when the plugin is uninstalled.