← ClaudeAtlas

uselink-share-speclisted

Publish a planning spec or plan to uselink so stakeholders can read it without repo access. Use when the user says 'share spec', 'publish the plan', 'send this spec to PM', or wants a shareable link for a .planning artifact.
compilet-dev/agent-skill-uselink · ★ 2 · Testing & QA · score 76
Install: claude install-skill compilet-dev/agent-skill-uselink
# Share Spec via Uselink Publish specs and plans from `.planning/` to uselink so PMs, stakeholders, and business people can read them without cloning the repo. ## When to Use - User wants to share a spec or plan with someone outside the repo - User says "share the versioning spec" or "publish the analytics plan" - User wants a link to send a stakeholder for review ## Prerequisites Check CLI installed and configured before anything else: ```bash which uselink || echo "MISSING" test -f ~/.uselink/config.json && echo "OK" || echo "NO_CONFIG" ``` If `uselink` is missing, tell the user to install it. If config is missing, tell them to run `uselink login`. ## Workflow ### 1. Find the artifact Scan both directories: ```bash ls .planning/specs/*.md .planning/plans/*.md 2>/dev/null ``` If the user gave a name (e.g. "versioning"), fuzzy-match against filenames. If multiple files match, list them and ask which one. If zero match, ask for the path. ### 2. Clean the title Strip prefixes and convert to human-readable Title Case: | Filename | Title | |----------|-------| | `done_04_publishing.md` | Publishing | | `10_versioning.md` | Versioning | | `billing-hardening.md` | Billing Hardening | | `spec-11-polish-v2.md` | Polish V2 | Rules: drop `done_` prefix, drop leading number + underscore (`04_`), drop `spec-NN-` prefix, convert kebab/snake to spaces, Title Case the result. ### 3. Publish ```bash uselink publish <file> --title "<clean title>" ``` Capture the URL from st