docs(coding-agent): clarify that missing description prevents skill loading

This commit is contained in:
Mario Zechner 2026-01-25 20:58:02 +01:00
parent 6cc370c446
commit 0be68c9b4b

View file

@ -168,14 +168,16 @@ description: Helps with PDFs.
## Validation ## 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 doesn't match parent directory
- Name exceeds 64 characters or contains invalid characters - Name exceeds 64 characters or contains invalid characters
- Name starts/ends with hyphen or has consecutive hyphens - Name starts/ends with hyphen or has consecutive hyphens
- Description missing or exceeds 1024 characters - Description exceeds 1024 characters
- Unknown frontmatter fields - 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. Name collisions (same name from different locations) warn and keep the first skill found.
## Example ## Example