fix: dont load root mds as skills in settings (#8012)

* fix: dont load root mds as skills in settings

* changelogololol

---------

Co-authored-by: Mario Zechner <badlogicgames@gmail.com>
This commit is contained in:
Cristina Poncela Cubeiro 2026-08-17 09:37:37 +02:00 • committed by GitHub
parent ca21c16861
commit 8c2529daeb
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
5 changed files with 96 additions and 44 deletions

View file

@ -34,9 +34,10 @@ Pi loads skills from:
- CLI: `--skill <path>` (repeatable, additive even with `--no-skills`)
Discovery rules:
- In `~/.pi/agent/skills/` and `.pi/skills/`, direct root `.md` files are discovered as individual skills
- In `~/.pi/agent/skills/` and `.pi/skills/`, direct root `.md` files are discovered as individual skills when they have valid skill frontmatter with a non-empty `description`
- In all skill locations, directories containing `SKILL.md` are discovered recursively
- In `~/.agents/skills/` and project `.agents/skills/`, root `.md` files are ignored
- Root Markdown files other than `SKILL.md` that do not look like skills are ignored silently
Disable discovery with `--no-skills` (explicit `--skill` paths still load).
@ -183,7 +184,7 @@ Pi validates skills against the Agent Skills standard. Most issues produce warni
Unknown frontmatter fields are ignored.
**Exception:** Skills with missing description are not loaded.
Declared skills with missing descriptions are not loaded. Malformed `SKILL.md` files and `SKILL.md` files without a description produce warnings and are not loaded. Other Markdown files without valid skill frontmatter are ignored.
Name collisions (same name from different locations) warn and keep the first skill found.