mcpField
S
skilly-cli

skilly-cli

github.com/timschochAgent workflows1687 installsUpdated today
Repository

About skilly-cli

skilly-cli manages repository skills from the skilly hub for developers maintaining Agent skill setups. Its commands add, remove, and update skills while handling the commit, push, and PR workflow.

Key features

  1. 01Add a bundle or single skill
  2. 02Remove skills while keeping shared ones
  3. 03Sync the hub’s current state
  4. 04Handle commits, pushes, and PRs

Use cases

  1. 01Install skills in a repository
  2. 02Remove an unused skill bundle
  3. 03Sync skill changes from the hub

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/timschoch/skilly --skill skilly-cli

After installing, type/skilly-cliin Claude Code to confirm it loaded.

Details

From the project README

Skilly CLI

This repo's skills are managed by skilly, a hub at timschoch/skilly. Always use the CLI; never install skills by manual copies.

Exception — the user posts a skills.sh URL: that skill lives outside the hub. Hand-pin it with the skills CLI: npx -y skills add <url> --agent claude-code -y. It lands in skills-lock.json and survives the sync; skilly never touches hand-pins.

  • Add a bundle or single skill: npx -y github:timschoch/skilly add <name...> — bundle names and what they contain: catalog
  • Remove: npx -y github:timschoch/skilly remove <name...> — removing a bundle keeps skills still claimed by another bundle
  • Pull the hub's current state: npx -y github:timschoch/skilly update

Every verb ends with its own commit, push, and PR — do not commit or push for it. On main it branches to chore/skilly-setup by itself. On any other branch it stops before the commit when .agents/skills/verify/scripts/check-branch-name.mjs refuses the name: rename with git branch -m <type>/<description>, then run the verb again.

Never hand-edit skilly-owned files — the nightly sync wipes and rewrites them:

  • .claude/skills/ and .agents/skills/ (installed skills)
  • .claude/rules/<name>-*.md (installed router rules)
  • .skilly/config.json, skills-lock.json

A change to a skill belongs in its source repo (see skills-lock.json for the source), a repo-local rule in CLAUDE.md. A bug in an installed skill, hook, or rule: file it before you work around it, see .claude/rules/workflow-hazards.md.

Comments

Markdown supported