fix(cli): integrate provenance with multi-skill refs

Author: harlan-zw

GLOSSARY.md

@@ -22,13 +22,18 @@ Every public export, command, error, route, and document uses these terms.
 | Source status | lockfile and protocol | published value | skilld CLI, CI | source status |
 | Update relation | skilld CLI JSON v1 | published value | Agent, developer, CI | update relation |
 | Agent target | skilld CLI | published configuration | Agent | Agent target |
+| Curator | skilld.dev | published route | skilld.dev, skilld CLI | curator |
+| Collection | skilld.dev | published route | skilld.dev, skilld CLI | collection |
+| Multi-skill ref | `skilld run`, `skilld add` | published argument | developer, Agent | ref |
 
 | Identifier | Term |
 | --- | --- |
 | `skilld search` | Skill search |
 | `skilld run` | transient Skill load |
 | `skilld run --file` | supporting file read |
 | `skilld install` | Skill install |
+| `skilld add` | multi-skill install |
+| `skilld run gh:OWNER/REPOSITORY` | Skill index |
 | `skilld list` | installed Skills |
 | `skilld view` | Skill details |
 | `skilld remove` | Skill removal |
@@ -222,6 +227,36 @@ The Rust type for the second is `TransientSkill`, never `SkillRun`.
 
 **Casing:** `Agent target` in prose, `AgentTarget` in types.
 
+### Curator
+
+**Is:** a skilld.dev account that publishes collections at `/@LOGIN`.
+
+**Use for:** the `@LOGIN` ref and curator profile pages.
+
+**Never:** author, publisher, maintainer in this sense.
+
+**Casing:** `Curator` in headings, `curator` in sentences.
+
+### Collection
+
+**Is:** a curator's ordered, named list of Skills at `/@LOGIN/SLUG`.
+
+**Use for:** the `@LOGIN/SLUG` ref and collection pages.
+
+**Never:** pack, bundle, list, set.
+
+**Casing:** `Collection` in headings, `collection` in sentences.
+
+### Multi-skill ref
+
+**Is:** one `skilld run` or `skilld add` argument that names more than one Skill: `gh:OWNER/REPOSITORY`, `@LOGIN`, or `@LOGIN/SLUG`.
+
+**Use for:** the argument grammar and its index output.
+
+**Never:** bulk selector, group source, target.
+
+**Casing:** `multi-skill ref` in prose, `MultiSkillRef` in Rust.
+
 ### Outdated Skill report
 
 **Is:** the per Skill status produced by `skilld outdated`.

README.md

@@ -93,6 +93,14 @@ skilld run skilld:skilld-dev/skills/vue --revision <commit> --file references/ap
 # Install a Skill in the current project
 skilld install skilld:skilld-dev/skills/vue
 
+# List every Skill a Repository, curator, or collection names
+skilld run gh:anthropics/skills
+skilld run @harlan-zw
+skilld run @harlan-zw/agent-workflow-stack
+
+# Install every Skill one of those refs names
+skilld add @harlan-zw/agent-workflow-stack
+
 # Inspect installed Skills
 skilld list
 skilld view vue
@@ -114,6 +122,10 @@ Use `--mode copy` or `--mode symlink` to control target writes.
 
 Run `skilld install` without a source to restore the lockfile state.
 
+`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 every Skill the same ref names. It accepts the `skilld install` flags.
+
 ## Artifact delivery
 
 The skilld CLI resolves remote Skills through the skilld.dev API.