share-a-library

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.

npx ai-agent-skills build-docs

2. Publish the workspace to GitHub.

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:

npx ai-agent-skills install <owner>/<repo> --collection starter-pack -p

Otherwise:

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