cli-design

Design and build agent-first CLIs with HATEOAS JSON responses, context-protecting output, and self-documenting command trees. Use when creating new CLI tools, adding commands to existing CLIs (joelclaw, slog), or reviewing CLI design for agent-friendliness. Triggers on 'build a CLI', 'add a command', 'CLI design', 'agent-friendly output', or any task involving command-line tool creation.

1.64x

Quality

88%

Does it follow best practices?

Impact

94%

1.64x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Evaluation results

100%

75%

Build a Developer Notes CLI

JSON envelope and HATEOAS next_actions

Criteria

Without context

With context

Effect CLI framework

100%

Platform-node import

100%

JSON-only output

100%

ok field present

100%

command field present

100%

result field present

100%

next_actions present

100%

Template syntax in next_actions

100%

params field for templates

100%

Error envelope with fix

100%

Command naming

60%

100%

Kebab-case flags

100%

No --json flag

100%

96%

16%

Extend the `devcli` Tool with a Cache Management Command

Self-documenting command tree

Criteria

Without context

With context

cache command defined

100%

cache clear subcommand

100%

cache inspect subcommand

100%

withDescription on cache

100%

withDescription on subcommands

100%

Root commands array updated

100%

cache added to subcommands

100%

New commands return JSON envelope

100%

Contextual next_actions

100%

Existing commands preserved

100%

50%

No plain text output

100%

88%

22%

Add an Event History Command to a Workflow CLI

Context-protecting output and truncation

Criteria

Without context

With context

events command defined

100%

Default line limit

100%

Truncation detection

100%

full_output path when truncated

total count reported

100%

withDescription on events

100%

Root commands array updated

100%

JSON envelope shape

100%

next_actions with lines template

100%

No unbounded output

100%

Repository: joelhooks/joelclaw
Commit: 825972c

Evaluated: 30 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Build a Developer Notes CLI Extend the `devcli` Tool with a Cache Management Command Add an Event History Command to a Workflow CLI

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.