cli-command-wrapper

Authors command provenance files and thin skill wrappers that shell out to deterministic CLI scripts.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/NarenKarthikBM/specseyal --skill cli-command-wrapper-narenkarthikbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cli-command-wrapper
Source: https://github.com/NarenKarthikBM/specseyal/tree/main/.claude/skills/cli-command-wrapper
Command: npx skills add https://github.com/NarenKarthikBM/specseyal --skill cli-command-wrapper-narenkarthikbm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When extending a CLI with deterministic, model-free commands, the command documentation, the skill wrapper, and the underlying script can drift apart — signatures mismatch, exit codes go undocumented, and parsing logic leaks into the wrong layer. This Skill enforces the authoring discipline that keeps the provenance file, the wrapper, and the script consistent. ## Core Features & Use Cases - Provenance file authoring: Records the exact invocation signature — every argument, flag, and default — matching the script character-for-character. - Thin wrapper discipline: Keeps all parsing, validation, and rendering logic in the invoked script while the wrapper only resolves context (feature directory, target script) and shells out. - Exit-code contract mapping: Maps every documented exit code to a real script path and every script failure to a documented code, including fail-loudly-on-unsupported-input behavior and explicit hook registration statements. - Use Case: When adding a new /speckit-git-cleanup-style command to a Spec Kit extension, use this Skill to produce the speckit.<name>.md provenance file and the paired SKILL.md wrapper with a complete, verifiable exit-code table. ## Quick Start Author the command provenance file and thin skill wrapper for a new deterministic CLI command that resolves the feature directory and shells out to its script.

Frequently Asked Questions about cli-command-wrapper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a CLI command that shells out to a script from a skill?

Create a command provenance file documenting the exact invocation signature, then write a thin SKILL.md wrapper that resolves the feature directory and target script before shelling out. Keep all parsing, validation, and rendering logic inside the script, not the wrapper.

What should a command provenance file document for a CLI extension?

It should record every argument, flag, and default exactly as implemented, map each exit code to a real script path, state fail-loudly-on-unsupported-input behavior, and explicitly say whether the command registers any hook.

Why must exit codes in the command file match the script behavior?

A documented exit code with no matching script path, or a script failure with no documented code, is a defect that breaks the contract between documentation and implementation. Both directions must be mapped before either file is considered done.

Can the skill wrapper contain parsing or validation logic?

No. The wrapper's job is limited to resolving context and making the call. All parsing, validation, and rendering rules live in the invoked script, keeping the wrapper model-free and deterministic.

When should I use a thin wrapper instead of putting logic in the skill?

Use a thin wrapper when the command is deterministic and model-free — no model participates in the transform. If the task requires reasoning over content, a wrapper that only shells out is the wrong pattern.