dotnet-format
Use the free first-party `dotnet format` CLI for .NET formatting and analyzer fixes. Use when a .NET repo needs formatting commands, `--verify-no-changes` CI checks, or `.editorconfig`-driven code style enforcement.
Install
npx skills add https://github.com/Postpartum-genushyacinthus29/dotnet-skills/tree/main/skills/dotnet-format
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install postpartum-genushyacinthus29-dotnet-skills@llmmart
git clone https://github.com/Postpartum-genushyacinthus29/dotnet-skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole postpartum-genushyacinthus29/dotnet-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
dotnet format
Trigger On
- the repo uses
dotnet format - you need a CI-safe formatting check for .NET
- the repo wants
.editorconfig-driven style enforcement
Value
- produce a concrete project delta: code, docs, config, tests, CI, or review artifact
- reduce ambiguity through explicit planning, verification, and final validation skills
- leave reusable project context so future tasks are faster and safer
Do Not Use For
- repositories that intentionally use
CSharpieras the only formatter - analyzer strategy with no formatting command change
Inputs
- the nearest
AGENTS.md - the solution or project path
- the current
.editorconfig
Quick Start
- Read the nearest
AGENTS.mdand confirm scope and constraints. - Run this skill's
Workflowthrough theRalph Loopuntil outcomes are acceptable. - Return the
Required Result Formatwith concrete artifacts and verification evidence.
Workflow
- Prefer the SDK-provided
dotnet formatcommand instead of inventing custom format scripts. - Start with verify mode in CI:
dotnet format TARGET --verify-no-changes. - Use narrower subcommands only when the repo needs them:
whitespacestyleanalyzers
- Keep
.editorconfigas the source of truth for style preferences. - If the repo also uses
CSharpier, document which tool owns which file types or rules.
Bootstrap When Missing
If dotnet format is requested but not available yet:
- Detect current state:
dotnet --infodotnet format --version
- Treat
dotnet formatas SDK-provided, not as a separate repo-local tool by default. - If the command is missing, install or upgrade to a supported .NET SDK, then recheck
dotnet format --version. - Add explicit local and CI commands to
AGENTS.md, usually:dotnet format TARGET --verify-no-changes
- Run the chosen command once and return
status: configuredorstatus: improved. - If the repo intentionally uses only
CSharpierfor formatting ownership, returnstatus: not_applicable.
Deliver
- explicit
dotnet formatcommands for local and CI runs - formatting that follows
.editorconfig
Validate
- formatting is reproducible on CI
- no overlapping formatter ownership is left ambiguous
Ralph Loop
Use the Ralph Loop for every task, including docs, architecture, testing, and tooling work.
- Plan first (mandatory):
- analyze current state
- define target outcome, constraints, and risks
- write a detailed execution plan
- list final validation skills to run at the end, with order and reason
- Execute one planned step and produce a concrete delta.
- Review the result and capture findings with actionable next fixes.
- Apply fixes in small batches and rerun the relevant checks or review steps.
- Update the plan after each iteration.
- Repeat until outcomes are acceptable or only explicit exceptions remain.
- If a dependency is missing, bootstrap it or return
status: not_applicablewith explicit reason and fallback path.
Required Result Format
status:complete|clean|improved|configured|not_applicable|blockedplan: concise plan and current iteration stepactions_taken: concrete changes madevalidation_skills: final skills run, or skipped with reasonsverification: commands, checks, or review evidence summaryremaining: top unresolved items ornone
For setup-only requests with no execution, return status: configured and exact next commands.
Load References
references/dotnet-format.mdreferences/commands.mdreferences/config.md
Example Requests
- "Add
dotnet formatto this repo." - "Make formatting fail CI if files drift."
- "Explain when to use
dotnet formatversusCSharpier."
Files (dotnet-skills)
-
references
-
commands.md 3.9 KB
Loading… -
config.md 8.8 KB
Loading… -
dotnet-format.md 1.2 KB
Loading…
-
-
SKILL.md 4.1 KB
--- name: dotnet-format version: "1.0.0" category: "Code Quality" description: "Use the free first-party `dotnet format` CLI for .NET formatting and analyzer fixes. Use when a .NET repo needs formatting commands, `--verify-no-changes` CI checks, or `.editorconfig`-driven code style enforcement." compatibility: "Requires a .NET SDK-based repository; respects the repo's `AGENTS.md` commands first." --- # dotnet format ## Trigger On - the repo uses `dotnet format` - you need a CI-safe formatting check for .NET - the repo wants `.editorconfig`-driven style enforcement ## Value - produce a concrete project delta: code, docs, config, tests, CI, or review artifact - reduce ambiguity through explicit planning, verification, and final validation skills - leave reusable project context so future tasks are faster and safer ## Do Not Use For - repositories that intentionally use `CSharpier` as the only formatter - analyzer strategy with no formatting command change ## Inputs - the nearest `AGENTS.md` - the solution or project path - the current `.editorconfig` ## Quick Start 1. Read the nearest `AGENTS.md` and confirm scope and constraints. 2. Run this skill's `Workflow` through the `Ralph Loop` until outcomes are acceptable. 3. Return the `Required Result Format` with concrete artifacts and verification evidence. ## Workflow 1. Prefer the SDK-provided `dotnet format` command instead of inventing custom format scripts. 2. Start with verify mode in CI: `dotnet format TARGET --verify-no-changes`. 3. Use narrower subcommands only when the repo needs them: - `whitespace` - `style` - `analyzers` 4. Keep `.editorconfig` as the source of truth for style preferences. 5. If the repo also uses `CSharpier`, document which tool owns which file types or rules. ## Bootstrap When Missing If `dotnet format` is requested but not available yet: 1. Detect current state: - `dotnet --info` - `dotnet format --version` 2. Treat `dotnet format` as SDK-provided, not as a separate repo-local tool by default. 3. If the command is missing, install or upgrade to a supported .NET SDK, then recheck `dotnet format --version`. 4. Add explicit local and CI commands to `AGENTS.md`, usually: - `dotnet format TARGET --verify-no-changes` 5. Run the chosen command once and return `status: configured` or `status: improved`. 6. If the repo intentionally uses only `CSharpier` for formatting ownership, return `status: not_applicable`. ## Deliver - explicit `dotnet format` commands for local and CI runs - formatting that follows `.editorconfig` ## Validate - formatting is reproducible on CI - no overlapping formatter ownership is left ambiguous ## Ralph Loop Use the Ralph Loop for every task, including docs, architecture, testing, and tooling work. 1. Plan first (mandatory): - analyze current state - define target outcome, constraints, and risks - write a detailed execution plan - list final validation skills to run at the end, with order and reason 2. Execute one planned step and produce a concrete delta. 3. Review the result and capture findings with actionable next fixes. 4. Apply fixes in small batches and rerun the relevant checks or review steps. 5. Update the plan after each iteration. 6. Repeat until outcomes are acceptable or only explicit exceptions remain. 7. If a dependency is missing, bootstrap it or return `status: not_applicable` with explicit reason and fallback path. ### Required Result Format - `status`: `complete` | `clean` | `improved` | `configured` | `not_applicable` | `blocked` - `plan`: concise plan and current iteration step - `actions_taken`: concrete changes made - `validation_skills`: final skills run, or skipped with reasons - `verification`: commands, checks, or review evidence summary - `remaining`: top unresolved items or `none` For setup-only requests with no execution, return `status: configured` and exact next commands. ## Load References - `references/dotnet-format.md` - `references/commands.md` - `references/config.md` ## Example Requests - "Add `dotnet format` to this repo." - "Make formatting fail CI if files drift." - "Explain when to use `dotnet format` versus `CSharpier`."
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.