From 0be68c9b4b4f9f087df83dd327a052e51f9c37b1 Mon Sep 17 00:00:00 2001 From: Mario Zechner Date: Sun, 25 Jan 2026 20:58:02 +0100 Subject: [PATCH] docs(coding-agent): clarify that missing description prevents skill loading --- packages/coding-agent/docs/skills.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) 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