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
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