/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