v1.8.0 — Install-shippable shared references + interaction rules across interview skills

Two changes land together. The headline is a structural fix to the pack's install output so skills stop pointing the agent at files the CLI never ships. The second is an extension of the per-skill "One question per turn" blockquote — queued unreleased since the shape-skills block first landed — that adds single-select / multi-select / platform-tool guidance across nine interview-driven skills. The through-line: make the pack's behavior the same on the author's machine and on a user's a month after install.

Changes

• Install-shippable shared references — the skills npm CLI only copies per-skill directories on install, so repo-root SYSTEM-OVERVIEW.md and docs/*.md never reach ~/.claude/skills/<skill>/. Eight skills referenced those paths (/help, /correct-course, /setup-ralph-loop, /improve-pipeline, /pre-merge, /triage-issue, /prd-to-issues, /qa) and were telling the agent to open files the install hadn't shipped. Each consuming skill now carries a <skill>/references/ subdirectory mirrored from the repo-root canonical originals by a new scripts/sync-skill-references.sh off scripts/skill-references.manifest. SKILL.md paths updated to point at the bundled copies. /help and /correct-course also gained GitHub URLs in their user-facing prose, since human readers browse github.com, not ~/.claude/skills/. docs/solutions/ is intentionally out of scope — it's a downstream-project artifact written by /compound.
• Guards around the fix — scripts/test-sync-references.sh fences the sync script (21 assertions across nine cases). scripts/verify-install.sh confirms post-install that every manifest entry landed, written test-first against its own 11-case suite. lefthook.yml wires both suites plus shellcheck into local pre-commit and pre-push hooks. .github/workflows/validate-skills.yml grew matching check-skill-references, shellcheck, and script-tests jobs so CI enforces the same invariants. New "Shared reference files", "Local dev setup", and "Post-merge install verification" sections in CLAUDE.md document the pattern. Biome was deliberately skipped — no JS/TS in the repo, shellcheck is the right linter for the bash the PR adds.
• Interaction rules for shaping / requirements / research skills — extends each shaping-and-research skill's > **One question per turn.** blockquote with three new rules: prefer single-select multiple choice for direction/priority/next-step questions; use multi-select rarely and intentionally for compatible sets; and use the platform's question tool when available (AskUserQuestion in Claude Code, request_user_input in Codex, ask_user in Gemini, falling back to numbered options in chat). Added to /shape, /research, /write-a-prd, /correct-course, /create-milestone, /improve-pipeline, and fresh blocks added to /qa, /triage-issue, /ubiquitous-language. CLAUDE.md §Conversational Principles unchanged — the global rule stays single-sentence; expanded guidance lives per-skill at the point of use.

Upgrading

npx skills@latest update
scripts/verify-install.sh ~/.claude/skills   # optional: confirms all 11 bundled references landed

Related

• PR #26 — #26