Bundled skill names violate Agent Skills naming rules and trigger Pi startup warnings
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 74/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- typescript
- Domain
- developer-experience
Research direction
Start by locating the nine bundled skill directories listed in the issue and inspect each skill's frontmatter. Change the name values to the directory names, then find the existing validation or check setup and add a check for the Agent Skills naming constraints. Done when all nine names pass validation and Pi no longer reports invalid-name warnings.
Written by the indexing model from the issue text.
Description
🤖 AI text below 🤖
What happened?
Nine Oleafly-provided skills use human-readable display titles in the name frontmatter field rather than Agent Skills-compatible identifiers. When discovered by Pi, each produces:
name contains invalid characters (must be lowercase a-z, 0-9, hyphens only)
On the affected installation, ~/.agents/skills/<directory> symlinks to ~/.oleafly/skills/<directory>, so the warnings originate from the Oleafly skill files.
Affected skills
| Directory | Original name |
Suggested name |
|---|---|---|
| desktop-apps | Computer Use | desktop-apps |
| import-refine | Import refine | import-refine |
| oleafly-data-analysis | Data analysis | oleafly-data-analysis |
| oleafly-figure-prep | Figure prep | oleafly-figure-prep |
| oleafly-latex-build | Build and fix | oleafly-latex-build |
| oleafly-manuscript-scaffold | Manuscript scaffold | oleafly-manuscript-scaffold |
| openresearch | OpenResearch (orx) | openresearch |
| pdf-to-latex | PDF to LaTeX | pdf-to-latex |
| template-generate | Reusable template | template-generate |
Steps to reproduce
- Install the affected Oleafly skills.
- Make them discoverable in
~/.agents/skills/(symlinks were used here). - Start Pi and inspect the skill diagnostics.
- Observe the nine invalid-name warnings above.
Expected behavior
Bundled skill frontmatter should comply with the Agent Skills specification: lowercase letters, numbers, and hyphens, at most 64 characters, with no leading/trailing or consecutive hyphens. Matching each containing directory also improves portability. Human-readable titles can remain in the Markdown headings.
Environment
- OS: Linux
- Consumer: Pi 1.5.2
- Oleafly application version: not recorded
Local workaround / suggested fix
Changed only the nine name: fields locally to match their directory names and validated all nine against the naming constraints. No skill instructions were changed. This addresses the reported name violations; a Pi reload is needed to refresh discovery.
Please normalize these names in the distributed sources and add a frontmatter validation check to prevent regressions. Local fixes may otherwise be overwritten when skills are refreshed.
- Dominant language
- TypeScript
- Stars
- 838
- Forks
- 50
- Avg merge
- 17h 11m
- Merged PRs (30d)
- 75
Getting set up
This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Oleafly/Oleafly
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 67/100
Maintainers usually reply within 1 day
-
Difficulty 4/5 3-5 days Newbie friendliness 56/100
Maintainers usually reply within 1 day
-
enhancement
Difficulty 4/5 3-5 days Newbie friendliness 48/100
Maintainers usually reply within 1 day
-
enhancement
Difficulty 5/5 Over a week Newbie friendliness 35/100
Maintainers usually reply within 1 day
-
enhancement
Difficulty 4/5 3-5 days Newbie friendliness 48/100
Maintainers usually reply within 1 day
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
vercel-labs/ui#865 ·
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 63/100
outline/outline#14638 · 1 comment ·
Maintainers usually reply within 1 day
-
wayfinder:grilling
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
patricktree/cup#484 ·
-
bot:ai-assisted component:platform-js status:untriaged
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
midnightntwrk/platform-js#69 ·
Maintainers usually reply within 1 day