Bundled skill names violate Agent Skills naming rules and trigger Pi startup warnings

Open Beginner friendly
#488 0 comments 0 reactions 0 assignees View on GitHub

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

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
  1. Install the affected Oleafly skills.
  2. Make them discoverable in ~/.agents/skills/ (symlinks were used here).
  3. Start Pi and inspect the skill diagnostics.
  4. 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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Oleafly/Oleafly

All issues in Oleafly/Oleafly

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.