platform-cli

Design and implementation patterns for building command-line tools with modern UX. Use when designing a CLI, reviewing CLI UX, defining commands and flags, or implementing error handling and signal handling.

1.15x

Quality

81%

Does it follow best practices?

Impact

96%

1.15x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Evaluation results

94%

Container Workload Manager CLI Design

Command and flag naming conventions

Criteria

Without context

With context

Lowercase binary name

100%

Short binary name

100%

Dashes for multi-word

100%

Consistent subcommand pattern

100%

Help flag present

100%

Version flag capital V

100%

Standard verbose/quiet names

100%

Standard force/dry-run names

100%

Short flags limited

100%

25%

Short flag consistency

100%

Non-interactive flag

100%

Design rationale documented

100%

94%

Log Aggregator CLI Tool

Error handling and output stream separation

Criteria

Without context

With context

Data to stdout only

100%

Progress to stderr

100%

Errors to stderr

100%

Error explains what

100%

Error explains why

100%

Error provides fix

75%

100%

Specific error details

100%

No stack traces by default

100%

Debug flag for traces

75%

87%

Pipe usage documented

100%

Important info last

60%

50%

100%

33%

Data Sync CLI Tool

Config precedence, secrets handling, and signal management

Criteria

Without context

With context

Flags beat env vars

100%

Env vars beat config file

100%

Project config location

50%

100%

User config XDG path

100%

No secret from env var

100%

Secret via file flag

100%

Secret via stdin flag

100%

Non-secret via env var OK

100%

SIGINT immediate acknowledgment

100%

Cleanup timeout bounded

62%

100%

Double Ctrl-C force exit

100%

Exit code 130

100%

Crash-only safe state

37%

100%

Repository: ravnhq/ai-toolkit
Commit: 7b466be

Evaluated: about 1 month ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Container Workload Manager CLI Design Log Aggregator CLI Tool Data Sync CLI Tool

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.