---
name: share-a-library
description: Use when a managed library is ready to publish to GitHub and hand to teammates as an install command. Run the GitHub publishing steps, then return the exact shareable install command.
category: workflow
version: 4.1.0
---
# Share A Library
## Goal
Turn a finished local library into a real shared artifact with a repo URL and an install command another agent can use.
## Preconditions
- You are already inside a managed library workspace.
- The library has been sanity-checked.
- `npx ai-agent-skills build-docs` has already run, or you run it now before publishing.
## Workflow
1. Regenerate docs if needed.
```bash
npx ai-agent-skills build-docs
```
2. Publish the workspace to GitHub.
```bash
git init
git add .
git commit -m "Initialize skills library"
gh repo create <owner>/<repo> --public --source=. --remote=origin --push
```
3. Return the exact shareable install command.
If the library has a `starter-pack` collection:
```bash
npx ai-agent-skills install <owner>/<repo> --collection starter-pack -p
```
Otherwise:
```bash
npx ai-agent-skills install <owner>/<repo> -p
```
## Guardrails
- Do not stop at `git init`. A shared library is not shared until the repo exists and the install command is ready.
- If the repo already exists, connect the existing remote and push instead of creating a duplicate.
- Prefer the collection install command when a curated starter pack exists.
- Return the actual repo coordinates you used, not placeholders.
## Done
Return:
- the repo URL
- whether you shared a collection or the whole library
- the exact install command to hand to teammates