Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 35 additions & 0 deletions GLOSSARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down Expand Up @@ -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`.
Expand Down
12 changes: 12 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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.
Expand Down
Loading