starlight-skills-companion-files

When authoring a skill, there is often a limit to how much information should be written directly into the main .md document.

If an AI agent needs to understand a massive API schema, a JSON configuration format, or an entire script template, pasting hundreds of lines of code into your main document makes it incredibly difficult for a human to read.

The subfiles Field

A skill can possess supplementary text files. You define these via the subfiles array inside your frontmatter using glob patterns.

---
title: System Configuration Skill
description: Instructions on how to update our internal system configuration.
skill: true
subfiles:
  - "schemas/config-schema.json"
  - "examples/**/*.yml"
---