skilld

What is skilld?

skilld.dev is a curated registry of Agent Skills. Real maintainers write them in their own GitHub Repositories. skilld.dev and the open-source skilld CLI cover four steps:

Step	What you do	Where
🔥 Find	See the Skills devs talk about this week.	Trending Skills, skilld trending, skilld search
🧑‍🎨 Preview	See what a Skill makes before you run it.	Skill demos
🏃‍♂️ Run	Run a Skill once, fork it, or install it.	skilld run, skilld install
👀 Watch	Get a digest when the Skills you use change.	skilld watch, skilld changes

A Skill is a directory with a SKILL.md file in the Agent Skills format. Most Skill directories rank by install count, or ship a generated doc dump. skilld names the author, links the exact file, and records the commit it came from. Read it before your Agent follows it.

The skilld CLI searches, runs, installs, updates, verifies, and removes Skills. It contains no Skill generation logic and no Agent runtime. Skill authoring lives in visible skilld-maintained Skills and the optional Harness.

Features

• 💬 Ask your Agent to find and run Skills. Install the skilld Skill once, then describe your task. Your Agent searches the registry and loads a Skill for you.
• 📖 Use a Skill for one task. Give your Agent a Skill URL and ask it to run the Skill. Loading the instructions writes no files.
• 🎯 Keep Skills across sessions and Agents. Ask your Agent to install a Skill when you want to keep it. skilld supports Claude Code, Codex, Cursor, Gemini CLI, Zed, and more.
• 🔏 Know where a Skill came from. Remote installs record the exact source commit. Ask your Agent to check for updates when you need them.
• 🛡️ No telemetry. The CLI sends no analytics. Account credentials go to your operating system keychain, never to a plain text file.

Get started

Install the skilld Skill so your Agent can find and run Skills:

npx skilld install skilld --global

This installs the Skill for your detected Agents across projects. Start a new Agent session, then ask for what you need:

Find me a good Skill for reviewing my Vue app.

Run this Skill: https://skilld.dev/gh/antfu/skills/vue

Your Agent searches the registry, reads the Skill, and follows it for the current task. To keep a Skill across sessions, ask your Agent to install it.

For setup through your Agent, paste this:

Read https://skilld.dev/agent.md and follow it to set up skilld for me.

Use the CLI

Every command below works through npx with no install. To install the CLI, see Install the CLI.

Find a Skill

Trending Skills ranks Skills by how many separate devs talked about each one this week. Search the registry from a terminal:

npx skilld search vue
npx skilld trending

Every Skill page credits its author and links the source file on GitHub. Curators publish collections of the Skills they use.

Preview it

Some Skills have demos. Each demo is one recorded run: the prompt, and what the Agent built with the Skill. Browse every demo, or open the Demo panel on a Skill page.

Run it

Give your Agent a Skill URL. There is nothing to install:

Use this Skill: https://skilld.dev/gh/antfu/skills/vue

Your Agent reads the page and follows it for that session. Nothing is written to your project. Add .md to any Skill URL for the raw SKILL.md.

From a terminal, skilld run does the same:

npx skilld run antfu/skills/vue

It prints SKILL.md to stdout and writes no file. Pass the output to your Agent.

To change a Skill, ask your Agent to fork it:

Fork this Skill: https://skilld.dev/gh/antfu/skills/vue

A fork creates an editable local Skill with its original author and license.

To keep a Skill in every session of one project, install it:

npx skilld install antfu/skills/vue

An install writes files. If an Agent runs the install, it asks you first.

	skilld run	skilld install
Use it for	The task in front of you	Every session in this project
Files written	None	.skills, the lockfile, and Agent targets
Cleanup	None	skilld remove
Updates	Loads the source each time	skilld update
Skill scripts	Never printed or executed	On disk for the Skill to use

Start with skilld run. Install when you reach for the same Skill again.

Watch for changes

Sign in, then watch the Repositories and collections you use:

npx skilld auth login
npx skilld watch antfu/skills

Each month, the digest email lists what changed. If nothing changed, skilld.dev sends nothing. skilld changes prints the same changes from the last 30 days. skilld outdated and skilld update keep your installed Skills current.

Install the CLI

macOS and Linux:

curl -fsSL https://skilld.dev/install.sh | sh

Windows PowerShell:

irm https://skilld.dev/install.ps1 | iex

npm, which needs Node.js:

npm install --global skilld

The script installs one native binary to ~/.skilld/bin. It adds that directory to PATH: in your shell profile on macOS and Linux, in your user PATH on Windows. On macOS and Linux, set SKILLD_NO_MODIFY_PATH=1 to leave your shell profile alone.

skilld checks for CLI upgrades in the background once a day. If a newer release is cached, the next terminal invocation offers to upgrade. Choose Upgrade now, Not now, or Don't remind me for this version. The script install verifies the signed release manifest before replacing the executable. Restart skilld to use the new version. Recognized global npm, pnpm, Yarn, and Bun installs run their package manager after you confirm. Local and transient installs show upgrade guidance instead. After an upgrade, run your command again. Set SKILLD_NO_UPGRADE=1 to turn off upgrade checks. See SECURITY.md for each check.

The npm package selects the same native executable for your system. It carries no JavaScript engine and no fallback.

Claude Code plugin

The plugin installs the skilld-maintained Skills and adds the skilld.dev MCP server. Run these in Claude Code:

/plugin marketplace add skilld-dev/skilld
/plugin install skilld@skilld

The MCP server searches the registry and returns run and install commands. It never runs a Skill. For ChatGPT, Claude, Codex, Cursor, and VS Code, see skilld.dev/developers.

Agent targets

Use --agent to name a target. Repeat it for several, or use --agent all. -g is the short form of --global.

skilld install skilld -g --agent codex
skilld install skilld -g --agent kiro --agent zed
skilld install skilld -g --agent all

Some targets share a directory with an earlier target, such as warp and pi with .agents/skills. Detection skips them, so name them with --agent. Run skilld install --help for every Agent target value.

How runs and installs work

Selectors

OWNER/REPOSITORY/SKILL names one Skill in the registry. OWNER/REPOSITORY names every Skill in one Repository. skilld search prints the selector for each result. In skilld-dev/skills/find-skill, skilld-dev/skills is the Repository and find-skill is the Skill directory inside it. skilld 3.0 printed skilld:OWNER/REPOSITORY/SKILL and gh:OWNER/REPOSITORY. The CLI still accepts both.

Repositories, curators, and collections

skilld run with a Repository, curator, or collection ref prints an index. The index has one line per Skill with its run command. It loads no Skill.

skilld add installs the Skills the same ref names. It accepts the skilld install flags. A normal terminal asks which Skills to install when several are listed. Agents, pipes, CI, and --plain require --all when several Skills are listed. One listed Skill installs without a picker. add does not support JSON output.

skilld add antfu/skills --all --agent codex

Success lists the installed agent paths, exact source commit, and source status. Read the instructions before your agent uses a Skill.

A Repository that skilld.dev does not list yet falls back to its public GitHub tree. Listing does not request registry indexing or wait for an index job. The listed GitHub paths still use hosted delivery by default. If delivery fails, skilld reports the failure and an explicit direct installation command where possible. It never switches source paths automatically.

To choose direct installation for a public Repository:

skilld add antfu/skills --all --direct --agent codex

This command lists and reads files from GitHub without skilld.dev. It records unverified and checks no Artifact attestation. Behavior approval still applies. Curator and collection refs require hosted delivery.

skilld add ./PATH installs one local Skill. The path must contain its SKILL.md. It does not search a local Repository for several Skills.

Supporting files

skilld names the supporting files a Skill carries and prints none of them. Read one when the instructions call for it:

skilld run skilld-dev/skills/find-skill --revision <commit> --file agents/openai.yaml

Use the revision and file-read command from the initial output. skilld never prints executable or binary files. A Skill that must run its own script needs an install.

Skill behaviors

Every run lists what the Skill files ask an Agent to do, with the file and line. skilld finds behaviors with the fixed text patterns in packages/protocol/rules/skill-behaviors.json. Markdown that forbids a command does not count as that behavior: "Don't read: id_rsa", a table row marked rejected, or a list under an "Anti-patterns" heading. Patterns miss obfuscated code, so an empty list proves nothing.