@jeril/skills_cli

A small CLI for managing reusable agent skills across AI coding assistants such as Claude Code and Pi.

It installs skills into one shared project directory and wires assistant-specific skill folders to it with symlinks:

.agents/skills
.claude/skills -> .agents/skills
.pi/skills     -> .agents/skills

This is useful when you want to pull skills from GitHub into a project, edit them locally, and optionally push your changes back to a central skills repo.

Requirements

• Node.js 24+
• git installed and available in PATH

Install / run

Run directly with npx:

npx @jeril/skills_cli --help

Or install globally and use skills_cli:

npm install -g @jeril/skills_cli
skills_cli --help

Commands

skills_cli add <source> [...]
skills_cli push <skill_name>
skills_cli clean

Add skills

skills_cli add <skill_name|owner/repo[/path]|github-tree-url> [...]

add clones a source repo, finds skill directories containing SKILL.md, and copies them into:

.agents/skills/<skill_name>

A skill directory must contain a SKILL.md file with YAML frontmatter including name and description.

Supported add sources

| Source form | What it does | Example | | --- | --- | --- | | <skill_name> | Adds a skill from the default repo, jerilseb/skills | skills_cli add nuxt | | owner/repo | Opens a picker for skills under the repo's top-level skills/ directory | skills_cli add mattpocock/skills | | owner/repo/path/to/skill | Adds the skill at that repo path if it contains SKILL.md | skills_cli add mattpocock/skills/skills/productivity/grill-me | | owner/repo/path/to/folder | Recursively finds skill dirs under that path and opens a picker | skills_cli add mattpocock/skills/skills/productivity | | GitHub /tree/<ref>/<path> URL to a skill | Adds that skill directly | skills_cli add https://github.com/mattpocock/skills/tree/main/skills/productivity/grill-me | | GitHub /tree/<ref>/<path> URL to a folder | Recursively finds skill dirs under that path and opens a picker | skills_cli add https://github.com/theuser/my_skills/tree/main/skills/ |

Common examples

Add a skill from the default repo:

skills_cli add nuxt

Equivalent to:

skills_cli add jerilseb/skills/skills/nuxt

Open a picker for all top-level skills in a repo:

skills_cli add owner/repo

Add a specific skill from a repo path:

skills_cli add owner/repo/skills/skill1

Add a skill from a GitHub folder URL:

skills_cli add https://github.com/mattpocock/skills/tree/main/skills/productivity/grill-me

Open a picker for skills under a GitHub folder URL:

skills_cli add https://github.com/mattpocock/skills/tree/main/skills/productivity

Add multiple sources in one command:

skills_cli add nuxt owner/repo/skills/skill1 https://github.com/mattpocock/skills/tree/main/skills/productivity/grill-me

Note: the old owner/repo@skill_name form is no longer supported. Use owner/repo/skills/skill_name instead.

Interactive picker

When a source points to multiple skills, the CLI opens a multi-select picker:

• ↑ / ↓ or j / k to move
• Space to toggle a skill
• a to toggle all
• Enter to install selected skills
• q or Esc to cancel

Push a skill

skills_cli push <skill_name>

push copies a local skill from:

.agents/skills/<skill_name>

into the default remote skills repo under:

skills/<skill_name>

Example:

skills_cli push my-skill

By default, pushes go to:

https://github.com/jerilseb/skills.git

Override the push remote with SKILLS_PUSH_REMOTE:

SKILLS_PUSH_REMOTE=https://github.com/your-org/skills.git skills_cli push my-skill

This uses your existing Git authentication.

Clean generated directories

skills_cli clean

Removes these directories from the current project after confirmation:

.agents
.claude
.pi

Local development

Install dependencies:

npm install

Run in dev mode:

npm run dev -- --help
npm run dev -- add nuxt
npm run dev -- add owner/repo/skills/skill_name
npm run dev -- add https://github.com/mattpocock/skills/tree/main/skills/productivity/grill-me
npm run dev -- push skill_name
npm run dev -- clean

Build and run:

npm run build
node dist/cli.js --help