Skip to content

tutorial

Chapter 2 of 10

Chapter 2 — First skill (FAQ)

by Rod Rivera Published

Add a prose-only trip FAQ skill with a references folder — no tools required.

Goal

Add trip_faq: a skill that answers Horizon Travel questions from markdown references.

Teach

The minimum viable skill is one file: skills/<name>/skill.md.

  • YAML frontmatter: name and description (description drives Mantle routing)
  • Markdown body: instructions the LLM follows while the skill is active

Optional references/ gives focused context without stuffing every prompt.

Paste

Paste set: tutorial/snippets/step-01-faq/

Copy into:

  • skills/trip_faq/skill.md
  • skills/trip_faq/references/horizon_travel_faq.md

Example frontmatter and body:

---
name: trip_faq
description: >
  Answer common Horizon Travel questions about baggage allowances,
  check-in windows, seats, and change fees from reference material.
---

Answer the traveler's question from the information in your references.
Keep answers short enough to speak aloud — two or three sentences at most.

Train and try

make train
make inspect

Try: “How much cabin baggage can I take?”

Verify: The answer comes from the FAQ references and is short enough to hear aloud.

Talking point

No tools, no memory schema, no registration step. Mantle routes here because the description matches the question.

Next

Chapter 3 — First tool