AterDev/Perigon.CLI / .agents/skills/cli
cli
VerifiedUse for .NET command-line tool development with Spectre.Console/Spectre.Console.Cli, Microsoft.Extensions.Hosting, dependency injection, localized help text, command settings, aliases, examples, terminal output, exit codes, and stdio-safe command paths.
CLI Development
Workflow
- Identify the command surface under
src/Apps/CommandLine. - Read command registration in
src/Apps/CommandLine/Program.cs. - Read the invoked service before changing command behavior.
- Keep command classes thin: parse settings, validate input, set context, call services, and format output.
Conventions
- Inherit from
AsyncCommand<TSettings>orAsyncCommand. - Put reusable behavior in CoreMod services, CodeGenerator, or Share instead of command classes.
- Use
CommandSolutionHelper.TrySetSolutionAsyncwhen the command needs a current solution. - Use
OutputHelperorAnsiConsoleconsistently with nearby commands. - Escape dynamic Spectre markup with
Markup.Escape. - Return
0for success and1for expected validation or operation failures. - Register new commands in DI and
CommandApp.Configure, including aliases, examples, and localized descriptions. - Preserve raw MCP/stdio command paths. Do not add logos, logs, or human-readable output that can break protocol clients.
Localization And Tests
- Add user-facing command text to both
src/Share/Localizer.zh-CN.resxandsrc/Share/Localizer.en-US.resx. - Add focused tests under
tests/StudioMod.Tests/Commandsfor command behavior, config output, or error handling.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |