Reviewing Cli Command

https-deeplearning-ai/sc-agent-skills-files

This walks Claude through a structured checklist for reviewing Typer CLI commands, covering everything from file structure and the Annotated syntax to exit codes and destructive action patterns. You'd use it when you want feedback on a CLI implementation or need to verify it follows conventions. The checklist format is thorough, hitting common mistakes like using print() instead of a display module, wrong exit codes, and confirmation prompts that default to yes. The output format gives you a clear breakdown of what passes and what needs fixing. It's opinionated about structure, which is good if you're working in a codebase with established patterns, less useful if you're just exploring Typer basics.

GitHub stars: 1.3K
last updated: Jun 8, 2026

View on GitHub

Install

$ npx -y skills add https-deeplearning-ai/sc-agent-skills-files --skill reviewing-cli-command --agent claude-code

Installs into .claude/skills of the current project.

Files

Reviewing CLI Commands

Checklist for reviewing Typer CLI command implementations.

Review Process

Read the command file
Check each section below
Report findings using output format at bottom

Structure

File in src/<cli_app>/commands/
Has app = typer.Typer() and @app.command()
Command groups use @app.command() for each subcommand
Registered in commands/__init__.py with add_typer()
Single commands: add_typer(app) without name
Command groups: add_typer(app, name="group")

Arguments & Options

Uses Annotated syntax
Arguments for required positional input
Options for optional named parameters
Short flags where appropriate (-f, -q)
Help text: lowercase, no period, brief

# GOOD:
name: Annotated[str, typer.Argument(help="item name")]
force: Annotated[bool, typer.Option("--force", "-f", help="skip confirmation")] = False

# BAD:
name: str = typer.Argument(..., help="The name of the item.")