CLI Spec to Goal
Convert a Node.js CLI tool specification (even a vague one) into a Codex /goal-ready bundle — GOAL.md, VERIFY.md, PROGRESS.md inside goals/<slug>/ — with AI-agent-friendly patterns (--json, stdout/stderr separation, exit codes, structured errors, TTY detection, --dry-run) baked into every goal. Asks clarifying questions in focused batches (each with options + recommendation + reasoning), reaches 95% confidence, optionally scaffolds a missing CLI project (bin/, src/, package.json, AGENTS.md, CLAUDE.md behavioral snippet), and emits a tailored /goal command. Handles both new CLIs and adding comm
Install
/plugin marketplace add nathanonn/agent-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add nathanonn/agent-skills --skill cli-spec-to-goalgit clone --depth 1 https://github.com/nathanonn/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/plugins/cli-spec-to-goal/skills/cli-spec-to-goal ~/.claude/skills/cli-spec-to-goalPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# cli-spec-to-goal — Vague CLI Idea → Codex /goal Bundle Turn a rough Node.js CLI tool idea into the three files Codex `/goal` needs to drive autonomous implementation: ``` goals/<slug>/ GOAL.md what done looks like (full CLI tool template with AI-agent patterns) VERIFY.md how /goal proves it's done (host-native verification) PROGRESS.md the audit trail /goal will populate ``` The skill optionally scaffolds a missing CLI project (`bin/`, `src/`, `package.json`, `AGENTS.md`, `CLAUDE.md`) and prints a tailored `/goal` command at the end. ## Why this skill exists A full multi-prompt workflow kit is overkill for CLI tools that fit in one or two goal slices. This skill collapses the "spec → goal trio" hop into a single guided conversation that: - batches clarifying questions (so the user makes 2-3 decisions per round, not 20) - recommends a default for every choice (so they can move fast when the recommendation looks right) - bakes in six AI-agent patterns that make every CLI tool machine-friendly from the start - writes the same template shapes already validated by the Codex /goal operator pattern It does **not** replace the multi-prompt kit for complex CLI suites with 10+ commands. Use the kit for big builds; use this skill for the small-to-medium ones. ## The six AI-agent patterns Every GOAL.md, VERIFY.md, and scaffold generated by this skill includes these patterns. They make CLI tools safe and useful for AI agents to invoke — not just humans.
Details
- Skill name
cli-spec-to-goal- Repository
- nathanonn/agent-skills
- Path
plugins/cli-spec-to-goal/skills/cli-spec-to-goal/SKILL.md- License
- MIT
- Repo updated
- 11 November 2026
FAQ
What does the CLI Spec to Goal skill do?
Convert a Node.js CLI tool specification (even a vague one) into a Codex /goal-ready bundle — GOAL.md, VERIFY.md, PROGRESS.md inside goals/<slug>/ — with AI-agent-friendly patterns (--json, stdout/stderr separation, exit codes, structured errors, TTY detection, --dry-run) baked into every goal. Asks clarifying questions in focused batches (each with options + recommendation + reasoning), reaches 95% confidence, optionally scaffolds a missing CLI project (bin/, src/, package.json, AGENTS.md, CLAUDE.md behavioral snippet), and emits a tailored /goal command. Handles both new CLIs and adding comm
How do I install the CLI Spec to Goal skill?
Claude Code plugin: /plugin marketplace add nathanonn/agent-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is CLI Spec to Goal popular?
It lives in nathanonn/agent-skills, which has 23 GitHub stars and 4 forks.
Related skills
Ask First
23nathanonn/agent-skills
Ask clarifying questions before executing tasks. Use this skill whenever the user says "ask me questions first", "clarify before doing", "ask before you start", invokes /ask-first, or wants Claude to gather requirements through Q&A before taking action. Also trigger when the user provides a task prefixed with "ask:" or says things like "I need help figuring out how to..." or "help me think through...". This skill ensures nothing is assumed — Claude asks until 95% confident, then executes.
Codex Imagegen
23nathanonn/agent-skills
Generate images such as featured images, illustrations, diagrams, thumbnails, and blog visuals with the Codex CLI built-in $imagegen skill, save them into the current project, and safely clean this run's generated-images cache. Use when the user asks to generate, create, or make an image, picture, illustration, featured image, thumbnail, visual asset, image variants, AI artwork, or explicitly asks to use Codex image generation. Do not use for screenshots, charts rendered from data, ASCII diagrams, or editing existing images.
Design System to Skill
23nathanonn/agent-skills
Convert an extract-design-system output bundle (a .design_systems/<domain>-YYYYMMDD/ folder with DESIGN.md, AGENTS.md, COMPONENTS.md and DTCG tokens) into a self-contained, auto-triggering per-brand Claude Code agent skill that later agents use to build pages native to that brand. Use whenever the user has run extract-design-system or points at a .design_systems/ bundle and wants to reuse it — "turn this design system into a skill", "make a skill from the extracted design system", "convert .design_systems/<x> into an agent skill", "package this bundle as a skill", "generate a <brand> design-sy
Sim
8chrisjacksonn/interview-sim
Run a timed coding assessment simulation in the terminal. Use for OA practice, GCA or ICA mocks, mock interviews, pairing rounds, take-homes, and pasted job postings.
Webgpu Webgl Rendering
45j4flmao/agent-skills
Use when the user asks about WebGPU, WGSL, WebGL2, GLSL shaders, bind groups, render pipelines, GPU buffers or compute shaders in the browser. Produces low-level browser GPU pipeline setup, buffer alignment, WebGL2 fallback and per-frame performance rules. Not for Three.js or React Three Fiber scenes (use web3d-webgl).
Webg Spec to Goal
23nathanonn/agent-skills
Convert a web game idea (even a vague one like "build a Raiden-type game" or "make a card game") into a complete Codex /goal-ready Phaser 3 project — runnable scaffold, goals-plan.md, and all goal folders (GOAL.md + VERIFY.md + PROGRESS.md) generated at once. Auto-detects genre (shoot-em-up, card game, platformer, tower defense, puzzle), asks clarifying questions in focused batches, scaffolds a runnable TypeScript + Vite + Phaser 3 skeleton with state bridge for automated verification via Playwright, decomposes into 5-7 goals following a universal build order, and emits tailored /goal commands
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.