> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getskillmd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The skill file

> What lives inside a generated skill.md and why.

A `skill.md` is plain Markdown with two parts: a small **metadata header** and a
**structured body**. The header makes the skill discoverable and installable; the body
is what your agent reads.

## Metadata header

The header is YAML frontmatter describing the skill at a glance:

```markdown theme={null}
---
title: "Stripe API"
description: "Payments, Checkout, and webhooks for the Stripe REST API."
source: "https://docs.stripe.com"
mode: "api"
tags: ["payments", "rest", "webhooks"]
---
```

| Field         | Purpose                                                     |
| ------------- | ----------------------------------------------------------- |
| `title`       | Human-readable name shown in the app and editor             |
| `description` | One-line summary used in search and listings                |
| `source`      | The URL the skill was generated from                        |
| `mode`        | The [generation mode](/docs/concepts/generation-modes) used |
| `tags`        | Topics for discovery and filtering                          |

## Structured body

Below the header is the content your agent consumes — organized into the sections that
matter for the source type. The exact headings depend on the mode, but the goal is
constant: **everything the agent needs, nothing it doesn't.**

<AccordionGroup>
  <Accordion title="Overview" icon="circle-info">
    A short orientation: what the source is, who it's for, and the core mental model.
  </Accordion>

  <Accordion title="Key concepts" icon="lightbulb">
    The vocabulary and ideas an agent must hold to reason about the source correctly.
  </Accordion>

  <Accordion title="Reference" icon="book">
    The concrete details — endpoints, components, tokens, or APIs — depending on mode.
  </Accordion>

  <Accordion title="Examples" icon="code">
    Representative snippets that show real usage, not just signatures.
  </Accordion>

  <Accordion title="Gotchas" icon="triangle-exclamation">
    Edge cases, limits, and footguns worth flagging before the agent hits them.
  </Accordion>
</AccordionGroup>

## Designed for agents

<CardGroup cols={2}>
  <Card title="Token-aware" icon="gauge-high">
    Distilled rather than dumped, so it fits a context window with room to spare.
  </Card>

  <Card title="Self-contained" icon="box">
    One file your agent can read start to finish without fetching anything else.
  </Card>
</CardGroup>