From b4035ddb85ebd9302d2098f76d9d118bea022e7f Mon Sep 17 00:00:00 2001 From: Harlan Wilton Date: Tue, 22 Sep 2026 18:48:05 +1000 Subject: [PATCH 1/4] docs: inline the outlined wordmark and centre the sponsor block --- .github/logos/logo-light.svg | 13 +++---------- .github/logos/logo.svg | 13 +++---------- README.md | 14 +++++++------- 3 files changed, 13 insertions(+), 27 deletions(-) diff --git a/.github/logos/logo-light.svg b/.github/logos/logo-light.svg index f376adc7..da396228 100644 --- a/.github/logos/logo-light.svg +++ b/.github/logos/logo-light.svg @@ -1,13 +1,6 @@ - + - - skilld + + diff --git a/.github/logos/logo.svg b/.github/logos/logo.svg index 412011b5..51f584e4 100644 --- a/.github/logos/logo.svg +++ b/.github/logos/logo.svg @@ -1,13 +1,6 @@ - + - - skilld + + diff --git a/README.md b/README.md index a875b24e..5367ed98 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,8 @@

- - + +skilld -
-skilld

@@ -17,15 +15,17 @@ Open source, privacy friendly Agent Skills, curated by humans.
Search, run, i license

-

+

+ +
-Made possible by my Sponsor Program 💖
Follow me @harlan_zw 🐦 • Join Discord for help
+Made possible by my Sponsor Program 💖
Follow me @harlan_zw 🐦 • Join Discord for help
-

+
## Features From 24024d5d7491114f9eca4cbfda7b9bb662b72091 Mon Sep 17 00:00:00 2001 From: Harlan Wilton Date: Tue, 22 Sep 2026 19:10:47 +1000 Subject: [PATCH 2/4] docs: rework Get Started around finding a Skill on skilld.dev --- README.md | 31 ++++++++++++++++++------------- 1 file changed, 18 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 5367ed98..29d904c9 100644 --- a/README.md +++ b/README.md @@ -52,18 +52,26 @@ Skill authoring lives in visible [skilld-maintained Skills](#author-a-skill) and ## Get Started -Run a Skill once. You need no install and no project files: +Find a Skill on [skilld.dev](https://skilld.dev/skills), or search from your terminal: ```sh npx skilld search vue +``` + +[Trending Skills](https://skilld.dev/skills/trending) shows what is moving this month. +Every Skill page names its [curator](https://skilld.dev/community) and links the source file on GitHub. + +Run one. skilld installs nothing and writes no file: + +```sh npx skilld run antfu/skills/vue ``` -`skilld run` prints `SKILL.md` to stdout and writes no file. -Ask your Agent to run the command and follow the printed instructions. +That prints [`vue` by antfu](https://skilld.dev/gh/antfu/skills/vue) to stdout. +Ask your Agent to run the command and follow what it prints. If you run it yourself, pass the output to your Agent. -Install a Skill only when you want it in every session: +Install a Skill when you want it in every session: ```sh npx skilld install antfu/skills/vue @@ -83,24 +91,21 @@ An install writes files. If an Agent runs the install, it asks you first. Start with `skilld run`. Install when you reach for the same Skill again. -If you use skilld often, install the CLI globally: +### Teach your Agent the CLI -```sh -npm install --global skilld -``` - -Teach your Agent the CLI with the skilld-maintained `skilld` Skill: +Install the CLI and the skilld-maintained `skilld` Skill once. +Your Agent then knows every command: ```sh +npm install --global skilld skilld install skilld --global ``` -Use `--agent` when you want an explicit Agent target. -Repeat it for several targets. Use `--agent all` for every known target. +Use `--agent` to name a target. Repeat it for several, or use `--agent all`. `-g` is the short form of `--global`. ```sh -skilld install skilld --global --agent codex +skilld install skilld -g --agent codex skilld install skilld -g --agent kiro --agent zed skilld install skilld -g --agent all ``` From 4d2c4e0a0cf85aec07832505d6409429c12140ec Mon Sep 17 00:00:00 2001 From: Harlan Wilton Date: Tue, 22 Sep 2026 19:16:08 +1000 Subject: [PATCH 3/4] docs: lead Get Started with the Agent running skilld --- README.md | 38 +++++++++++++++++++++----------------- 1 file changed, 21 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 29d904c9..4e6e42fd 100644 --- a/README.md +++ b/README.md @@ -52,26 +52,38 @@ Skill authoring lives in visible [skilld-maintained Skills](#author-a-skill) and ## Get Started -Find a Skill on [skilld.dev](https://skilld.dev/skills), or search from your terminal: +Your Agent runs skilld, not you. Teach it the CLI once: ```sh -npx skilld search vue +npm install --global skilld +skilld install skilld --global ``` +Then ask for what you need, in your own words: + +> Find a skilld Skill for Vue and use it + +Your Agent searches the registry, reads the descriptions, and loads the Skill for that session. +It installs nothing unless you ask it to. + +Find a Skill yourself on [skilld.dev](https://skilld.dev/skills). [Trending Skills](https://skilld.dev/skills/trending) shows what is moving this month. -Every Skill page names its [curator](https://skilld.dev/community) and links the source file on GitHub. +Every Skill page credits its author and links the source file on GitHub. +[Curators](https://skilld.dev/community) publish named collections that `skilld add` installs in one command. + +### Run it yourself -Run one. skilld installs nothing and writes no file: +You need no install and no project files: ```sh +npx skilld search vue npx skilld run antfu/skills/vue ``` -That prints [`vue` by antfu](https://skilld.dev/gh/antfu/skills/vue) to stdout. -Ask your Agent to run the command and follow what it prints. -If you run it yourself, pass the output to your Agent. +`skilld run` prints `SKILL.md` to stdout and writes no file. +Pass the output to your Agent. -Install a Skill when you want it in every session: +Keep a Skill when you want it in every session: ```sh npx skilld install antfu/skills/vue @@ -91,15 +103,7 @@ An install writes files. If an Agent runs the install, it asks you first. Start with `skilld run`. Install when you reach for the same Skill again. -### Teach your Agent the CLI - -Install the CLI and the skilld-maintained `skilld` Skill once. -Your Agent then knows every command: - -```sh -npm install --global skilld -skilld install skilld --global -``` +### Agent targets Use `--agent` to name a target. Repeat it for several, or use `--agent all`. `-g` is the short form of `--global`. From 2ec9121a43f478f5a6805729a32bf6e82c18de1c Mon Sep 17 00:00:00 2001 From: Harlan Wilton Date: Tue, 22 Sep 2026 19:19:51 +1000 Subject: [PATCH 4/4] docs: open Get Started with the transient Skill URL --- README.md | 41 ++++++++++++++++++++++++----------------- 1 file changed, 24 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 4e6e42fd..c43a0303 100644 --- a/README.md +++ b/README.md @@ -52,28 +52,21 @@ Skill authoring lives in visible [skilld-maintained Skills](#author-a-skill) and ## Get Started -Your Agent runs skilld, not you. Teach it the CLI once: +Give your Agent a Skill URL. There is nothing to install: -```sh -npm install --global skilld -skilld install skilld --global -``` +> Use this Skill: https://skilld.dev/gh/antfu/skills/vue -Then ask for what you need, in your own words: +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`. -> Find a skilld Skill for Vue and use it - -Your Agent searches the registry, reads the descriptions, and loads the Skill for that session. -It installs nothing unless you ask it to. - -Find a Skill yourself on [skilld.dev](https://skilld.dev/skills). +Find one on [skilld.dev](https://skilld.dev/skills). [Trending Skills](https://skilld.dev/skills/trending) shows what is moving this month. Every Skill page credits its author and links the source file on GitHub. -[Curators](https://skilld.dev/community) publish named collections that `skilld add` installs in one command. +[Curators](https://skilld.dev/community) publish named collections. -### Run it yourself +### Run it from your terminal -You need no install and no project files: +Same transient run, from a shell. You need no install and no project files: ```sh npx skilld search vue @@ -83,10 +76,24 @@ npx skilld run antfu/skills/vue `skilld run` prints `SKILL.md` to stdout and writes no file. Pass the output to your Agent. -Keep a Skill when you want it in every session: +### Set it up properly + +Once a Skill earns its place, install the CLI and teach your Agent to drive it: + +```sh +npm install --global skilld +skilld install skilld --global +``` + +Your Agent then searches the registry and loads Skills on its own. +Ask for what you need, in your own words: + +> Find a skilld Skill for Vue and use it + +Keep a Skill in every session of one project: ```sh -npx skilld install antfu/skills/vue +skilld install antfu/skills/vue ``` An install writes files. If an Agent runs the install, it asks you first.