diff --git a/packages/coding-agent/docs/skills.md b/packages/coding-agent/docs/skills.md
index 239bdb6a..f8230cad 100644
--- a/packages/coding-agent/docs/skills.md
+++ b/packages/coding-agent/docs/skills.md
@@ -168,14 +168,16 @@ description: Helps with PDFs.
 
 ## Validation
 
-Pi validates skills against the Agent Skills standard and warns (but still loads) non-compliant skills:
+Pi validates skills against the Agent Skills standard. Most issues produce warnings but still load the skill:
 
 - Name doesn't match parent directory
 - Name exceeds 64 characters or contains invalid characters
 - Name starts/ends with hyphen or has consecutive hyphens
-- Description missing or exceeds 1024 characters
+- Description exceeds 1024 characters
 - Unknown frontmatter fields
 
+**Exception:** Skills with missing description are not loaded.
+
 Name collisions (same name from different locations) warn and keep the first skill found.
 
 ## Example