share-a-library

1# Share A Library
2 
3## Goal
4 
5Turn a finished local library into a real shared artifact with a repo URL and an install command another agent can use.
6 
7## Preconditions
8 
9- You are already inside a managed library workspace.
10- The library has been sanity-checked.
11- `npx ai-agent-skills build-docs` has already run, or you run it now before publishing.
12 
13## Workflow
14 
151. Regenerate docs if needed.
16 
17```bash
18npx ai-agent-skills build-docs
19```
20 
212. Publish the workspace to GitHub.
22 
23```bash
24git init
25git add .
26git commit -m "Initialize skills library"
27gh repo create <owner>/<repo> --public --source=. --remote=origin --push
28```
29 
303. Return the exact shareable install command.
31 
32If the library has a `starter-pack` collection:
33 
34```bash
35npx ai-agent-skills install <owner>/<repo> --collection starter-pack -p
36```
37 
38Otherwise:
39 
40```bash
41npx ai-agent-skills install <owner>/<repo> -p
42```
43 
44## Guardrails
45 
46- Do not stop at `git init`. A shared library is not shared until the repo exists and the install command is ready.
47- If the repo already exists, connect the existing remote and push instead of creating a duplicate.
48- Prefer the collection install command when a curated starter pack exists.
49- Return the actual repo coordinates you used, not placeholders.
50 
51## Done
52 
53Return:
54 
55- the repo URL
56- whether you shared a collection or the whole library
57- the exact install command to hand to teammates