Home / ai / hermes-skill-template-repo / skill-template.md

Skill Template — English Original

---
name: my-skill
description: Use when the user needs a scoped, repeatable workflow with explicit outputs and verification.
version: 1.0.0
author: Hermes Agent
license: MIT
metadata:
  hermes:
    tags: [example, production, workflow]
    related_skills: [writing-plans, requesting-code-review]
---

My Skill

Overview

One or two paragraphs covering purpose, scope, and intended usage.

When to Use

  • The user asks for ...
  • The task requires ...
  • The environment contains ...
  • Don't use for: ...

Required Inputs

  • Required input A
  • Required input B
  • Optional context C

Procedure

  1. Confirm the request and identify the deliverable.
  2. Gather prerequisite context.
  3. Use tools in the preferred order.
  4. Produce the result in the required format.
  5. Verify the result before claiming success.

Tool Rules

  • Use read/search tools before asking the user to repeat known context.
  • Use execution tools only when they materially improve correctness.
  • Retry transient tool failures up to 2 times.
  • Do not retry invalid-input failures unchanged.
  • Ask before destructive commands or external side effects.

Output Format

  • Executive summary
  • Findings / main body
  • Risks or caveats
  • Final recommendation / next step

Failure / Escalation

  • If required inputs are missing and cannot be retrieved, ask targeted questions.
  • If the task is out of scope, say so explicitly.
  • If verification is impossible, label the claim as unverified.

Common Pitfalls

  1. Over-broad scope
  2. Missing output contract
  3. Unclear tool policy
  4. No verification step

Verification Checklist

  • [ ] Trigger matched intended use case
  • [ ] Output matches contract
  • [ ] Tool policy respected
  • [ ] Result verified where possible

Šablona skillu — český překlad

---
name: my-skill
description: Použijte, když uživatel potřebuje vymezený, opakovatelný postup s explicitními výstupy a ověřením.
version: 1.0.0
author: Hermes Agent
license: MIT
metadata:
  hermes:
    tags: [example, production, workflow]
    related_skills: [writing-plans, requesting-code-review]
---

My Skill

Přehled

Jeden nebo dva odstavce popisující účel, rozsah a zamýšlené použití.

Kdy použít

  • Uživatel žádá o ...
  • Úkol vyžaduje ...
  • Prostředí obsahuje ...
  • Nepoužívejte pro: ...

Požadované vstupy

  • Povinný vstup A
  • Povinný vstup B
  • Volitelný kontext C

Postup

  1. Potvrďte požadavek a určete výstup.
  2. Shromážděte potřebný kontext.
  3. Použijte nástroje v preferovaném pořadí.
  4. Vytvořte výsledek v požadovaném formátu.
  5. Ověřte výsledek před tím, než prohlásíte úspěch.

Pravidla pro nástroje

  • Předtím, než požádáte uživatele o zopakování známého kontextu, použijte nástroje pro čtení a vyhledávání.
  • Nástroje pro vykonávání používejte jen tehdy, když podstatně zlepší správnost.
  • Přechodná selhání nástrojů zkuste opakovat až 2krát.
  • Selhání kvůli neplatnému vstupu bez změny neopakujte.
  • Před destruktivními příkazy nebo externími vedlejšími účinky se zeptejte.

Formát výstupu

  • Stručné shrnutí pro vedení
  • Zjištění / hlavní část
  • Rizika nebo omezení
  • Konečné doporučení / další krok

Selhání / eskalace

  • Pokud chybí povinné vstupy a nelze je získat, položte cílené otázky.
  • Pokud je úkol mimo rozsah, uveďte to výslovně.
  • Pokud ověření není možné, označte tvrzení jako neověřené.

Běžné chyby

  1. Příliš široký rozsah
  2. Chybějící specifikace výstupu
  3. Nejasná politika používání nástrojů
  4. Chybějící krok ověření

Kontrolní seznam ověření

  • [ ] Spouštěč odpovídá zamýšlenému případu použití
  • [ ] Výstup odpovídá zadání
  • [ ] Byla dodržena politika používání nástrojů
  • [ ] Výsledek byl tam, kde to bylo možné, ověřen