uselink-share-speclisted
Install: claude install-skill spartan-hieuvo/claude-skills
# 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