new-command

SkillDev tools

Scaffold a new Cobra CLI command following the project's patterns.

Available today. Use it from your connected AI after setup.

No other account needed.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the new-command skill

What this skill tells your AI

The instructions your AI receives, as published by flowexec/flow in .claude/skills/new-command/SKILL.md and read by ahel’s review.

Scaffold a new Cobra CLI command for: $ARGUMENTS

Before writing any code, read a similar existing command to match the exact style:

Simple verb commands: cmd/internal/exec.go
Noun/verb subcommands: cmd/internal/workspace.go or cmd/internal/vault.go — each groups its subcommands in a single file rather than a directory

Then follow these patterns:

File location: cmd/internal/<noun>.go. Only root.go lives directly in cmd/; every command handler is under cmd/internal/. Shared helpers go in cmd/internal/helpers.go, flags in cmd/internal/flags/, output shaping in cmd/internal/response/.
Command registration: register on the parent command, or add to rootCmd in cmd/root.go
Error handling:
- Runtime errors → errhandler.HandleFatal(ctx, cmd, err)
- Flag/arg misuse → errhandler.HandleUsage(ctx, cmd, "message", args...)
- Never use log.Fatal, os.Exit, or logger.Log().FatalErr() in cmd/
Context: resolve workspace context via pkg/context before delegating to internal/services
Output: respect --output flag (text/json/yaml) for structured responses

After scaffolding, verify it builds — prefer mcp__flow__execute with ref build binary and argument ./bin/flow over a raw shell call.

Advanced