template-validation

Analyzes template.json files for correctness, completeness and CLI compatibility of dotnet new templates.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/1k-off/umbraco-observability-playground --skill template-validation-1k-off
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: template-validation
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/template-validation
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill template-validation-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents broken or invisible custom dotnet new templates by validating template.json correctness before you publish or test them.

Core Features & Use Cases

  • Template authoring validation: Checks required fields, symbol definitions, sources conditions, tags, constraints, and post-action configuration so templates fail loudly instead of silently.
  • Discoverability & CLI safety: Detects shortName conflicts with reserved dotnet CLI commands and missing/weak metadata that affects dotnet new list visibility.
  • Parameter correctness: Verifies parameter datatypes, defaults, choice options, computed/generator requirements, and common authoring pitfalls like parameter-prefix collisions.

Quick Start

Ask the AI to validate the template directory at path "./my-template" by checking its .template.config/template.json for errors, warnings, and suggestions.

Frequently Asked Questions about template-validation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a dotnet template.json file before publishing?

To validate a dotnet template.json file, you can analyze its required fields, symbol definitions, and CLI compatibility to catch authoring errors before publishing. This ensures custom templates install correctly and appear in dotnet new list.

Why is my custom dotnet new template not showing up after installation?

Custom dotnet new templates may not appear due to missing metadata, weak tags, or shortName conflicts with reserved CLI commands. Validating template.json systematically checks discoverability fields and CLI safety to resolve invisibility issues.

What are common dotnet template authoring mistakes in template.json?

Common dotnet template authoring mistakes include incorrect parameter datatypes, invalid condition formatting, parameter-prefix collisions, and misconfigured post-actions. Checking template.json systematically verifies symbol generators, choice options, and constraints to prevent these errors.

How do I check dotnet template parameters for correctness?

To check dotnet template parameters for correctness, verify datatypes, defaults, choice options, and computed generator requirements within template.json. This validation process identifies parameter-prefix collisions and ensures all symbol definitions are properly configured.

Does dotnet template validation check for CLI compatibility issues?

Yes, dotnet template validation checks for CLI compatibility by detecting shortName conflicts with reserved dotnet CLI commands. It ensures your template metadata complies with dotnet new list visibility requirements and CLI safety standards before publishing.

What fields are required in a dotnet template.json file?

A dotnet template.json file requires specific identity and shortName fields, along with correct symbol definitions and configuration metadata. Systematic validation checks these required fields, tags, classifications, and post-action configurations to ensure templates function properly.