refactor(cli): require skill install path in oclif

[cv]

Summary

Move missing skill install <path> validation into the oclif adapter while keeping plugin-shape detection in the skill install action. This also adds help examples for the parent skill command and direct install command.

Stack Navigation

• Position: 17 of 60
• Previous PR: #2908 — refactor(cli): improve snapshot command metadata
• Next PR: #2910 — refactor(cli): add lifecycle confirmation flag aliases

Changes

• Added examples for skill and skill install command metadata.
• Made sandbox:skill:install require a skill directory or SKILL.md path before dispatch.
• Kept filesystem and OpenClaw plugin detection in the action layer for friendly remediation text.
• Updated CLI/unit coverage for missing install paths.

Type of Change

• Code change (feature, bug fix, or refactor)
• Code change with doc updates
• Doc only (prose changes, no code sample modifications)
• Doc only (includes code sample changes)

Verification

• npx prek run --all-files passes
• npm test passes
• Tests added or updated for new or changed behavior
• No secrets, API keys, or credentials committed
• Docs updated for user-facing behavior changes
• make docs builds without warnings (doc changes only)
• Doc pages follow the style guide (doc changes only)
• New doc pages include SPDX header and frontmatter (new pages only)

---

Signed-off-by: Carlos Villela cvillela@nvidia.com

Summary by CodeRabbit

• Documentation

  • Added usage examples for the skill install command, showing how to install a skill package from a directory or SKILL.md file.

• Bug Fixes

  • The skill install command now enforces the requirement for a path argument. The command previously allowed invocation without specifying a path.

[copy-pr-bot]

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: c4681afe-6e18-46ca-a895-ce926327c35f

📥 Commits

Reviewing files that changed from the base of the PR and between 0d14dca and 1daea70.

📒 Files selected for processing (3)

• src/lib/skill-install-cli-command.test.ts
• src/lib/skill-install-cli-command.ts
• test/cli.test.ts

---

📝 Walkthrough

Walkthrough

The SkillInstallCliCommand now requires the path argument (previously optional), rejects execution when omitted, and always passes the path to the underlying install function. Tests and CLI integration verify this requirement is enforced.

Changes

Skill Install Path Requirement

Layer / File(s)	Summary
Argument Requirement src/lib/skill-install-cli-command.ts	The path argument in SkillInstallCliCommand is changed from required: false to required: true, ensuring validation rejects missing paths.
Core Implementation src/lib/skill-install-cli-command.ts	The run() method now unconditionally passes ["install", args.skillPath] to sandboxSkillInstall() instead of conditionally passing ["install"] when the path was absent.
Command Examples src/lib/skill-install-cli-command.ts	SkillCliCommand and SkillInstallCliCommand add static examples entries demonstrating sandbox:skill install usage with required paths (./my-skill and ./my-skill/SKILL.md).
Unit Tests src/lib/skill-install-cli-command.test.ts	Test updated to assert that run(["alpha"], rootDir) rejects with a path-related error and does not invoke sandboxSkillInstall.
CLI Integration Tests test/cli.test.ts	New test case verifies alpha skill install (without a path) exits with a non-zero code and error output mentioning "path".

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 A path now stands required, no longer a choice,
Where skills once installed without voice,
Now firmly demand their destination be clear—
No more silent skipping, the validation is here! ✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately reflects the main change: making the skill install path argument required within the oclif framework.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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 refactor/oclif-ux-skill-install

---

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

[prekshivyas]

LGTM. Tiny, well-tested tightening — 3 files / +20 / -8.

SkillInstallCliCommand.skillPath flips to required: true; oclif now rejects <name> skill install (no path) at parse time before the action runs. run() simplifies accordingly. The PR description explicitly preserves filesystem + OpenClaw-plugin-shape detection in the action layer for the path-provided-but-invalid case — the friendly remediation text stays.

Tests: unit test renamed and rewritten to assert the rejection (/path/i thrown, action not called); new CLI integration test in test/cli.test.ts:797-805 asserts non-zero exit + "path" in output. Examples added to parent SkillCliCommand and SkillInstallCliCommand.

CI: pr.yaml mostly green (lint/dco/check-hash/legacy-path-guard/changes PASS); pr-self-hosted builds and macos/wsl-e2e + checks still in flight at review time. No failures.

Scope hygiene clean — no drive-by drift this round. src/nemoclaw.ts untouched.