feat(cli): OpenSkills fallback when no Tier-1 client detected

[naorsabag]

Summary

• openhop init now prints a stderr line pointing the user at npx openskills install naorsabag/openhop when no Tier-1 client received the skill.
• Closes the audit's S7 part-2 / checklist item 30 from READINESS-AUDIT.md.
• Suppressed under --json so machine consumers keep clean stdout; exit-code policy unchanged.

Why

init covers Claude Code / Cursor / Windsurf / Cline / Continue. Everything else (Codex CLI, Gemini CLI, Junie, Copilot, OpenCode, Goose, Antigravity, …) routes through OpenSkills per the launch plan — but a user running init on a machine without any Tier-1 client got no signal that OpenSkills was the next step. Same trigger fires when only an advisory client like Continue.dev was detected (no real skill placement).

Test plan

• npm test in packages/cli — 83/83 pass (init suite is 20/20).
• Smoke: HOME=$(mktemp -d) node packages/cli/dist/index.js init → fallback line on stderr, exit 4 (EXIT_NOT_FOUND).
• Smoke: HOME=$(mktemp -d) node packages/cli/dist/index.js init --json → clean JSON on stdout, no stderr line.
• CI on this PR is green.

🤖 Generated with Claude Code

Summary by CodeRabbit

• Bug Fixes
  • Improved error messaging in the openhop init command to provide clearer feedback when a skill is not installed to any client, including a suggested command for installation.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: a25bb4d0-10fe-4464-a99e-9b4a21bd7f5c

📥 Commits

Reviewing files that changed from the base of the PR and between c502a9e and 0225a39.

📒 Files selected for processing (1)

• packages/cli/src/init.ts

---

Walkthrough

The init command now emits a stderr message when openhop init does not install the skill into any Tier-1 client, guiding users to run npx openskills install naorsabag/openhop as a fallback. The message is suppressed for JSON-mode runs and does not affect exit-code behavior.

Changes

CLI User Messaging for Uninstalled Skills

Layer / File(s)	Summary
User-Facing Messaging packages/cli/src/init.ts	A conditional stderr message advises users to manually install the skill when installed.length === 0 and wouldInstall.length === 0, suppressed in --json mode.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and specifically summarizes the main change: adding an OpenSkills fallback message when no Tier-1 client is detected during openhop init.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/init-openskills-fallback

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}