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

23 stars 4 forksSoftware Development Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add nathanonn/agent-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add nathanonn/agent-skills --skill cli-spec-to-goal
Manual install
git 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-goal

Personal 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.
Read the full skill on GitHub

Details

Skill name
cli-spec-to-goal
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

23

nathanonn/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.

Productivity & Notes

Codex Imagegen

23

nathanonn/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.

Images, Video & Audio

Design System to Skill

23

nathanonn/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

Frontend & Design

Sim

8

chrisjacksonn/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.

Software DevelopmentIn 1 list

Webgpu Webgl Rendering

45

j4flmao/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).

Software Development

Webg Spec to Goal

23

nathanonn/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

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.