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.