From cbc354c2ffb5cf7e682455a9118180ccd5f27c2a Mon Sep 17 00:00:00 2001
From: Jonathan Hefner <jonathan@hefner.pro>
Date: Fri, 6 Mar 2026 16:00:09 -0600
Subject: [PATCH] Expand directory tree in specification doc

Show optional directories (`scripts/`, `references/`, `assets/`)
directly in the directory tree with inline annotations, replacing the
separate `<Tip>` block.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs/specification.mdx | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/docs/specification.mdx b/docs/specification.mdx
index 3e816e8..f10f8be 100644
--- a/docs/specification.mdx
+++ b/docs/specification.mdx
@@ -11,13 +11,12 @@ A skill is a directory containing at minimum a `SKILL.md` file:
 
 ```
 skill-name/
-└── SKILL.md          # Required
+├── SKILL.md          # Required: metadata + instructions
+├── scripts/          # Optional: executable code
+├── references/       # Optional: documentation
+└── assets/           # Optional: templates, resources
 ```
 
-<Tip>
-You can optionally include [additional directories](#optional-directories) such as `scripts/`, `references/`, and `assets/` to support your skill.
-</Tip>
-
 ## `SKILL.md` format
 
 The `SKILL.md` file must contain YAML frontmatter followed by Markdown content.