​

SKILL.md

​

In plain terms

1. Show a tiny index: name + one-line description.
2. If the agent needs the booklet, it calls get_skill_instructions.
3. Extra files (examples, scripts) are read with get_skill_reference.

​

Folder layout

skills/
  pdf-export/
    SKILL.md
    references/
      paper-sizes.md

---
name: pdf-export
description: Turn a web page or markdown file into a PDF
---

# PDF export

1. Prefer A4.
2. Embed fonts.
3. Don't invent a file path — ask the user.

• name is lowercase kebab-case (pdf-export), max 64 chars
• description max 1024 chars
• YAML frontmatter is required for discovery

​

Wire it up

const agent = new Agent({
  name: "assistant",
  model: openai("gpt-4o"),
  skillDirs: ["./skills"],
});

​

Two skill systems