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 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="520" height="120" viewBox="0 0 520 120">
+<svg xmlns="http://www.w3.org/2000/svg" width="396" height="82" viewBox="-6.00 16.00 395.51 82.00" role="img" aria-label="skilld">
   <!-- Mark -->
   <path d="M55 22 L110 92 L97 92 L55 41 L13 92 L0 92 Z" fill="#e11d48"/>
-  <!-- Wordmark -->
-  <text
-    x="130"
-    y="88"
-    font-family="'IBM Plex Mono', 'Geist Mono', ui-monospace, SFMono-Regular, monospace"
-    font-size="72"
-    font-weight="500"
-    fill="#1c1917"
-  >skilld</text>
+  <!-- Wordmark: IBM Plex Mono 500, outlined to paths so no font is needed. -->
+  <path d="M151.672 88.864Q145.624 88.864 141.268 86.92Q136.912 84.976 134.248 81.736L139.072 77.416Q141.52 80.08 144.57999999999998 81.48400000000001Q147.64 82.888 151.816 82.888Q155.632 82.888 157.972 81.59200000000001Q160.312 80.296 160.312 77.56Q160.312 76.408 159.88 75.616Q159.448 74.824 158.656 74.32Q157.864 73.816 156.82 73.528Q155.776 73.24000000000001 154.624 73.096L148.72 72.16Q146.56 71.872 144.328 71.22399999999999Q142.096 70.576 140.332 69.388Q138.568 68.2 137.452 66.328Q136.336 64.456 136.336 61.576Q136.336 55.888000000000005 140.692 52.93600000000001Q145.048 49.984 152.176 49.984Q157.36 49.984 161.14 51.532000000000004Q164.92 53.080000000000005 167.44 55.816L163.048 60.42400000000001Q161.608 58.768 158.94400000000002 57.364000000000004Q156.28 55.96 151.888 55.96Q144.04 55.96 144.04 60.928Q144.04 63.304 145.732 64.20400000000001Q147.424 65.104 149.728 65.392L155.632 66.328Q157.864 66.688 160.06 67.26400000000001Q162.256 67.84 164.01999999999998 69.028Q165.784 70.21600000000001 166.89999999999998 72.08800000000001Q168.016 73.96000000000001 168.016 76.84Q168.016 82.456 163.66 85.66Q159.304 88.864 151.672 88.864Z M179.536 34.720000000000006H187.384V66.904H187.744L193.576 60.928L204.016 50.848000000000006H213.30399999999997L198.25599999999997 65.464L214.95999999999998 88.0H205.528L192.56799999999998 69.928L187.384 74.752V88.0H179.536Z M240.30399999999997 44.080000000000005Q237.27999999999997 44.080000000000005 236.09199999999998 42.85600000000001Q234.90399999999997 41.632000000000005 234.90399999999997 39.832V38.32Q234.90399999999997 36.52 236.09199999999998 35.29600000000001Q237.27999999999997 34.072 240.23199999999997 34.072Q243.25599999999997 34.072 244.44399999999996 35.29600000000001Q245.63199999999998 36.52 245.63199999999998 38.32V39.832Q245.63199999999998 41.632000000000005 244.44399999999996 42.85600000000001Q243.25599999999997 44.080000000000005 240.30399999999997 44.080000000000005ZM223.67199999999997 81.664H236.34399999999997V57.184H223.67199999999997V50.848000000000006H244.19199999999998V81.664H256.072V88.0H223.67199999999997Z M265.0 81.664H277.312V41.056000000000004H265.0V34.720000000000006H285.16V81.664H297.47200000000004V88.0H265.0Z M308.19999999999993 81.664H320.51199999999994V41.056000000000004H308.19999999999993V34.720000000000006H328.35999999999996V81.664H340.67199999999997V88.0H308.19999999999993Z M375.664 81.664H375.23199999999997Q373.576 85.048 370.84000000000003 86.956Q368.104 88.864 364.0 88.864Q357.448 88.864 353.56 83.968Q349.672 79.072 349.672 69.424Q349.672 59.776 353.56 54.88Q357.448 49.984 364.0 49.984Q368.104 49.984 370.84000000000003 51.892Q373.576 53.800000000000004 375.23199999999997 57.184H375.664V34.720000000000006H383.512V88.0H375.664ZM367.24 82.456Q368.968 82.456 370.48 82.024Q371.992 81.592 373.144 80.72800000000001Q374.296 79.864 374.98 78.604Q375.664 77.344 375.664 75.616V63.232Q375.664 61.504000000000005 374.98 60.244Q374.296 58.984 373.144 58.120000000000005Q371.992 57.256 370.48 56.824Q368.968 56.392 367.24 56.392Q362.776 56.392 360.36400000000003 59.128Q357.952 61.864000000000004 357.952 66.4V72.44800000000001Q357.952 76.984 360.36400000000003 79.72Q362.776 82.456 367.24 82.456Z" fill="#1c1917"/>
 </svg>
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 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="520" height="120" viewBox="0 0 520 120">
+<svg xmlns="http://www.w3.org/2000/svg" width="396" height="82" viewBox="-6.00 16.00 395.51 82.00" role="img" aria-label="skilld">
   <!-- Mark -->
   <path d="M55 22 L110 92 L97 92 L55 41 L13 92 L0 92 Z" fill="#fb7185"/>
-  <!-- Wordmark -->
-  <text
-    x="130"
-    y="88"
-    font-family="'IBM Plex Mono', 'Geist Mono', ui-monospace, SFMono-Regular, monospace"
-    font-size="72"
-    font-weight="500"
-    fill="#fafaf9"
-  >skilld</text>
+  <!-- Wordmark: IBM Plex Mono 500, outlined to paths so no font is needed. -->
+  <path d="M151.672 88.864Q145.624 88.864 141.268 86.92Q136.912 84.976 134.248 81.736L139.072 77.416Q141.52 80.08 144.57999999999998 81.48400000000001Q147.64 82.888 151.816 82.888Q155.632 82.888 157.972 81.59200000000001Q160.312 80.296 160.312 77.56Q160.312 76.408 159.88 75.616Q159.448 74.824 158.656 74.32Q157.864 73.816 156.82 73.528Q155.776 73.24000000000001 154.624 73.096L148.72 72.16Q146.56 71.872 144.328 71.22399999999999Q142.096 70.576 140.332 69.388Q138.568 68.2 137.452 66.328Q136.336 64.456 136.336 61.576Q136.336 55.888000000000005 140.692 52.93600000000001Q145.048 49.984 152.176 49.984Q157.36 49.984 161.14 51.532000000000004Q164.92 53.080000000000005 167.44 55.816L163.048 60.42400000000001Q161.608 58.768 158.94400000000002 57.364000000000004Q156.28 55.96 151.888 55.96Q144.04 55.96 144.04 60.928Q144.04 63.304 145.732 64.20400000000001Q147.424 65.104 149.728 65.392L155.632 66.328Q157.864 66.688 160.06 67.26400000000001Q162.256 67.84 164.01999999999998 69.028Q165.784 70.21600000000001 166.89999999999998 72.08800000000001Q168.016 73.96000000000001 168.016 76.84Q168.016 82.456 163.66 85.66Q159.304 88.864 151.672 88.864Z M179.536 34.720000000000006H187.384V66.904H187.744L193.576 60.928L204.016 50.848000000000006H213.30399999999997L198.25599999999997 65.464L214.95999999999998 88.0H205.528L192.56799999999998 69.928L187.384 74.752V88.0H179.536Z M240.30399999999997 44.080000000000005Q237.27999999999997 44.080000000000005 236.09199999999998 42.85600000000001Q234.90399999999997 41.632000000000005 234.90399999999997 39.832V38.32Q234.90399999999997 36.52 236.09199999999998 35.29600000000001Q237.27999999999997 34.072 240.23199999999997 34.072Q243.25599999999997 34.072 244.44399999999996 35.29600000000001Q245.63199999999998 36.52 245.63199999999998 38.32V39.832Q245.63199999999998 41.632000000000005 244.44399999999996 42.85600000000001Q243.25599999999997 44.080000000000005 240.30399999999997 44.080000000000005ZM223.67199999999997 81.664H236.34399999999997V57.184H223.67199999999997V50.848000000000006H244.19199999999998V81.664H256.072V88.0H223.67199999999997Z M265.0 81.664H277.312V41.056000000000004H265.0V34.720000000000006H285.16V81.664H297.47200000000004V88.0H265.0Z M308.19999999999993 81.664H320.51199999999994V41.056000000000004H308.19999999999993V34.720000000000006H328.35999999999996V81.664H340.67199999999997V88.0H308.19999999999993Z M375.664 81.664H375.23199999999997Q373.576 85.048 370.84000000000003 86.956Q368.104 88.864 364.0 88.864Q357.448 88.864 353.56 83.968Q349.672 79.072 349.672 69.424Q349.672 59.776 353.56 54.88Q357.448 49.984 364.0 49.984Q368.104 49.984 370.84000000000003 51.892Q373.576 53.800000000000004 375.23199999999997 57.184H375.664V34.720000000000006H383.512V88.0H375.664ZM367.24 82.456Q368.968 82.456 370.48 82.024Q371.992 81.592 373.144 80.72800000000001Q374.296 79.864 374.98 78.604Q375.664 77.344 375.664 75.616V63.232Q375.664 61.504000000000005 374.98 60.244Q374.296 58.984 373.144 58.120000000000005Q371.992 57.256 370.48 56.824Q368.968 56.392 367.24 56.392Q362.776 56.392 360.36400000000003 59.128Q357.952 61.864000000000004 357.952 66.4V72.44800000000001Q357.952 76.984 360.36400000000003 79.72Q362.776 82.456 367.24 82.456Z" fill="#fafaf9"/>
 </svg>
diff --git a/README.md b/README.md
index a875b24e..c43a0303 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,8 @@
 <h1 align="center">
 <a href="https://skilld.dev"><picture>
-<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/skilld-dev/skilld/main/.github/logos/logo-mark.svg">
-<img alt="" src="https://raw.githubusercontent.com/skilld-dev/skilld/main/.github/logos/logo-mark-light.svg" width="90">
+<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/skilld-dev/skilld/main/.github/logos/logo.svg">
+<img alt="skilld" src="https://raw.githubusercontent.com/skilld-dev/skilld/main/.github/logos/logo-light.svg" width="220">
 </picture></a>
-<br>
-skilld
 </h1>
 
 <p align="center">
@@ -17,15 +15,17 @@ Open source, privacy friendly Agent Skills, curated by humans.<br>Search, run, i
 <a href="https://github.com/skilld-dev/skilld/blob/main/LICENSE"><img alt="license" src="https://img.shields.io/github/license/skilld-dev/skilld?style=flat&labelColor=1c1917&color=e11d48"></a>
 </p>
 
-<p align="center">
+<div align="center">
 <table>
 <tbody>
+<tr>
 <td align="center">
-<sub>Made possible by my <a href="https://github.com/sponsors/harlan-zw">Sponsor Program 💖</a><br> Follow me <a href="https://twitter.com/harlan_zw">@harlan_zw</a> 🐦 • Join <a href="https://discord.gg/275MBUBvgP">Discord</a> for help</sub><br>
+<sub>Made possible by my <a href="https://github.com/sponsors/harlan-zw">Sponsor Program 💖</a><br> Follow me <a href="https://twitter.com/harlan_zw">@harlan_zw</a> 🐦 • Join <a href="https://discord.gg/275MBUBvgP">Discord</a> for help</sub>
 </td>
+</tr>
 </tbody>
 </table>
-</p>
+</div>
 
 ## Features
 
@@ -52,7 +52,21 @@ 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:
+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`.
+
+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.
+
+### Run it from your terminal
+
+Same transient run, from a shell. You need no install and no project files:
 
 ```sh
 npx skilld search vue
@@ -60,13 +74,26 @@ 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.
-If you run it yourself, pass the output to your Agent.
+Pass the output to your Agent.
 
-Install a Skill only 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
-npx skilld install antfu/skills/vue
+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
+skilld install antfu/skills/vue
 ```
 
 An install writes files. If an Agent runs the install, it asks you first.
@@ -83,24 +110,13 @@ 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:
-
-```sh
-npm install --global skilld
-```
-
-Teach your Agent the CLI with the skilld-maintained `skilld` Skill:
-
-```sh
-skilld install skilld --global
-```
+### Agent targets
 
-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
 ```