feat(cli): run and add accept repository, curator, and collection refs

[harlan-zw]

❓ Type of change

• ✨ New feature

📚 Description

The homepage, owner pages, and collection pages print npx skilld add gh:owner/repo, npx skilld add @login, and npx skilld add @login/slug. The v3 CLI had no add, and run refused anything but one Skill, so every one of those commands failed against skilld@beta. ROADMAP "Now" item 4.

skilld run <ref> answers with an index and loads nothing. skilld add <ref> installs every Skill the ref names through the same hosted Artifact path install uses, with --global, --agent, and --mode. skilld add <selector> is install for one Skill, so the site can settle on one verb if it wants to. gh:owner/repo/skill and npm: are rejected with a message that names the form to use instead.

Live, against skilld.dev:

$ skilld run @harlan-zw/agent-workflow-stack --plain
subagent-driven-development	obra/superpowers	Split a larger plan into focused tasks, with review between each result.	npx skilld run skilld:obra/superpowers/subagent-driven-development
dispatching-parallel-agents	obra/superpowers	Run independent investigations in parallel before changing code.	npx skilld run skilld:obra/superpowers/dispatching-parallel-agents
verification-before-completion	obra/superpowers	Require fresh evidence before the agent declares the work complete.	npx skilld run skilld:obra/superpowers/verification-before-completion
workflow	brianlovin/claude-config	Connect planning, execution, and branch cleanup in one practical loop.	npx skilld run skilld:brianlovin/claude-config/workflow
using-superpowers	obra/superpowers	Select and compose the right workflow skill at each stage of the task.	npx skilld run skilld:obra/superpowers/using-superpowers
executing-plans	obra/superpowers	Move through written steps without redesigning the plan midway through execution.	npx skilld run skilld:obra/superpowers/executing-plans

$ skilld run @harlan-zw --json     # 28 Skills across 5 collections
$ skilld run @harlan-zw/nope --plain
SOURCE_NOT_FOUND: skilld.dev has no collection @harlan-zw/nope

Endpoints: GET /api/skills?owner=&limit=200 (filtered to the repository client side), GET /api/curators/{login}, GET /api/collections/by-author/{login}/{slug}. None of these are in skilld-protocol or the /api/v1 OpenAPI. I went with the collection detail route over the protocol-typed /manifest because the manifest reports the seeded collections as npm packages (for example apple-apps is six npm items), while the detail route has them resolved to owner/repo/name plus the curator's reason, which the index prints as the description.

Protocol gaps worth a site PR: a repository filter on /api/v1/skills (or owner + repository query params reusing presentSkillSearch) so the Repository listing stops paging an owner's whole index, and v1 routes for curator and collection listings. A missing curator returns 200 with no collections, so the CLI reports SOURCE_NOT_FOUND: @x names no Skills that skilld.dev lists rather than "no such curator".

Open question: add stops at the first failed install and says how many landed. Should it continue and report the failures at the end instead?

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

https://claude.ai/code/session_018T67Ndp8FAjnHWthXABbJW

[harlan-github-agent]

🤖 STOPPED

Harlan Agent Kit posted this automated review. It is not Harlan's personal review or approval. AI open source policy. A person still decides the merge. Last updated: 2026-09-01 18:17 UTC.

The automated review stopped. Reason: The current head commit already has an automated review.

Push a new commit to start a new review. To review this commit again, comment /harlan-agent rerun.