yao-meta-skill/references/skill-template.md

Skill Template

Use this skeleton when generating a new skill.

---
name: skill-name
description: Describe what the skill does and when to use it. Include realistic trigger phrases, task types, artifacts, or adjacent scenarios that should activate it.
metadata:
  author: Your team
---

# Skill Title

One-sentence summary of the capability.

## When To Use This Skill

- Trigger scenario 1
- Trigger scenario 2
- Trigger scenario 3

## Workflow

### 1. Understand the request

- Identify the actual job to be done
- Check assumptions and inputs

### 2. Choose the path

- Use path A when ...
- Use path B when ...

### 3. Execute

- Step 1
- Step 2
- Step 3

### 4. Validate

- Minimum acceptance checks

## Reference Map

- Read `[topic-a](references/topic-a.md)` when ...
- Read `[topic-b](references/topic-b.md)` when ...

Optional Folders

Create only when justified:

• agents/interface.yaml
• references/
• scripts/
• assets/
• evals/

agents/interface.yaml Template

interface:
  display_name: "Human Friendly Name"
  short_description: "Short capability summary"
  default_prompt: "Use $skill-name to ..."
compatibility:
  canonical_format: "agent-skills"
  adapter_targets:
    - "openai"
    - "claude"
    - "generic"
  activation:
    mode: "manual"
    paths: []
  execution:
    context: "inline"
    shell: "bash"
  trust:
    source_tier: "local"
    remote_inline_execution: "forbid"
    remote_metadata_policy: "allow-metadata-only"
  degradation:
    openai: "metadata-adapter"
    claude: "neutral-source-plus-adapter"
    generic: "neutral-source"