docs: lead Get Started with the Agent, not the human

[harlan-zw]

❓ Type of change

• 📖 Documentation

📚 Description

Get Started had the human typing npx skilld run, reading stdout, and then pasting it into their Agent. That is backwards from how the product is built. skills/skilld/SKILL.md tells the Agent "Run a Skill first. Install a Skill only when the user asks to keep it", and CLAUDE.md says the calling Agent follows the instructions while the CLI never executes them. The one-time skilld install skilld --global is what makes any of that work, and it was buried 40 lines down under a soft heading.

So the section opens on the bootstrap and then on asking in plain language. The manual commands keep their place under "Run it yourself", for people who want them and for piping.

It also links the site, which the README described but never pointed at. Someone who does not already know a selector had no way in.

On "curator": the README said every Skill page names its curator. GLOSSARY.md defines a Curator as a skilld.dev account publishing collections at /@LOGIN, and explicitly bans "author" for that sense; author is separately defined as the GitHub account that wrote the Skill, "the credited writer of one Skill on every surface". A Skill page credits an author, so that line was wrong and now says author. Curators get their own sentence about collections, which is what /community actually lists: 6 accounts, 5 with collections. The term is not drift, it is just a smaller concept than the registry, and the two were conflated.

Checked, not assumed: /skills, /skills/trending, /community and /gh/antfu/skills/vue return 200. antfu/skills/vue is official tier. skilld run skilld resolves as a bundled skilld-maintained Skill with source status local, so the bootstrap needs no network. skilld search vue --json returns _tag: Success with a selector field, which is the contract the Skill tells the Agent to read.

The two .github/logos files in the diff predate the merge base from #161 and are byte identical to main, so this changes README.md only.

Open: the example prompt, "Find a skilld Skill for Vue and use it", is written to read naturally rather than measured against real Agent behaviour. Worth a try in Claude Code and Codex before this merges.

🤖 AI disclosure: Harlan Agent Kit modified this description. My AI open-source policy.

[harlan-github-agent]

🤖 MERGED

Harlan Agent Kit posted this automated review. It is not Harlan's personal review or approval. AI open source policy. Last updated: 2026-09-22 11:02 UTC.

GitHub merged this pull request.

No material findings were recorded.

75d269a9-3728-4e16-83dc-6b53030067bf

[harlan-zw]

The new opening, rendered through POST /markdown with mode=gfm.

Link check, run just now:

200  https://skilld.dev
200  https://skilld.dev/community
200  https://skilld.dev/gh/antfu/skills/vue
200  https://skilld.dev/skills
200  https://skilld.dev/skills/trending

[harlan-zw]

Restructured opening, rendered through POST /markdown with mode=gfm.