Dotnet / AGENT SKILL

cli

0 installs 54 GitHub stars

Develop .NET command-line tools with Spectre.Console, hosting, dependency injection, and robust terminal behavior.
Use 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.

One new superpower.

Run this command in your project to choose an agent and install the skill.

npx skillycli add https://github.com/AterDev/Perigon.CLI --skill cliView original source

BEFORE YOU INSTALL

Understand the trade-offs.

SECURITY REVIEW

Not yet assessed

Review the original instructions and requested permissions before installing.

No security review is available for this catalog entry yet.

SKILL QUALITY

Not yet assessed

How clearly the skill guides your agent, how complete its workflow is, and how you can check the outcome.

No quality assessment is available for this catalog entry yet.

The full skill.

Original instructions from the publisher’s SKILL.md

# CLI Development

## Workflow

1. Identify the command surface under `src/Apps/CommandLine`.
2. Read command registration in `src/Apps/CommandLine/Program.cs`.
3. Read the invoked service before changing command behavior.
4. Keep command classes thin: parse settings, validate input, set context, call services, and format output.

## Conventions

- Inherit from `AsyncCommand<TSettings>` or `AsyncCommand`.
- Put reusable behavior in CoreMod services, CodeGenerator, or Share instead of command classes.
- Use `CommandSolutionHelper.TrySetSolutionAsync` when the command needs a current solution.
- Use `OutputHelper` or `AnsiConsole` consistently with nearby commands.
- Escape dynamic Spectre markup with `Markup.Escape`.
- Return `0` for success and `1` for 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.resx` and `src/Share/Localizer.en-US.resx`.
- Add focused tests under `tests/StudioMod.Tests/Commands` for command behavior, config output, or error handling.