dotnet-artisan AGENTS.md

dotnet-artisan -- Plugin Instructions

This repository contains one dotnet-artisan plugin under plugins/dotnet-artisan. The plugin provides 9 skills (process + domain) and 14 specialist agents for .NET development. It follows the Agent Skills open standard.

Key Conventions

SKILL.md Frontmatter

Every skill requires name, description, and license frontmatter fields. Additional optional fields control skill visibility and execution:

---
name: dotnet-example-skill
description: One-line summary under 600 characters
license: MIT
user-invocable: false
---

Required fields:

• name (string) -- must match the directory name
• description (string) -- target under 600 characters (WARN at 12,000 total, FAIL at 15,600)
• license (string) -- must be MIT; required by Copilot CLI

Required by repo policy:

• user-invocable (boolean) -- must be explicitly set on every skill (true or false); required for cross-provider predictability

Optional fields:

• disable-model-invocation (boolean) -- set to true to prevent Claude from loading the skill
• context (string) -- set to fork for isolated execution without conversation history
• model (string) -- model override, e.g. haiku for lightweight detection tasks

Cross-Reference Syntax

Reference skills and agents using machine-parseable syntax:

See [skill:dotnet-csharp] for C# language patterns and async/await guidance.
Route to [skill:dotnet-security-reviewer] for security audit.

Use [skill:name] for ALL routable references (skills and agents) -- bare text names are not machine-parseable. The validator resolves references against the union of skill directory names and agent file stems.

Routing Language Rules

Descriptions must follow the Action + Domain + Differentiator formula using third-person declarative style. No WHEN prefix, no filler phrases. Every skill must have ## Scope and ## Out of scope sections. See docs/skill-routing-style-guide.md for the full canonical rules.