convention-learner

Detect repository conventions and generate matching .NET code.

4|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/zdanovichnick/dotnet-pilot --skill convention-learner-zdanovichnick
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convention-learner
Source: https://github.com/zdanovichnick/dotnet-pilot/tree/main/skills/convention-learner
Command: npx skills add https://github.com/zdanovichnick/dotnet-pilot --skill convention-learner-zdanovichnick

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents inconsistent naming, folder structure, DI wiring, test layout, DTO shapes, and error-handling patterns by forcing convention discovery before new code is written.

Core Features & Use Cases

  • Mandatory convention discovery to avoid naming drift and architectural mismatch when you start new files or extend features.
  • Structured detection across key codebase conventions for handler/service suffixes, src/ organization style, DI registration approach, test framework and assertions, DTO/request/response conventions, and error-handling patterns.
  • Convention-driven code generation guidance that explicitly states detected conventions and applies them, with a clear rule for when the user overrides detected conventions.

Quick Start

Use convention-learner before creating any new files by asking it to detect conventions for this repository session and then generate code that matches the detected naming, architecture layout, DI, tests, DTOs, and error-handling style.

Frequently Asked Questions about convention-learner

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

FAQPage Schema
How do I detect project conventions before generating .NET code?

To detect project conventions before generating .NET code, collect six signals: naming suffixes, src folder architecture, dependency injection patterns, test assertion styles, DTO shapes, and error-handling approaches. This prevents inconsistent naming and architectural mismatch when creating new files.

What is the best way to ensure generated code matches existing repository style?

The best way to ensure generated code matches existing repository style is to perform mandatory convention discovery before writing new code. This structured detection explicitly identifies and applies existing naming, folder structure, DI wiring, and test layout conventions to new code generation.

Why does newly generated code drift from unfamiliar codebase conventions?

Newly generated code drifts from unfamiliar codebase conventions because naming, structure, and error-handling patterns are not explicitly specified by the user. Forcing convention discovery before writing code prevents this drift by reproducing existing handler suffixes and architectural layouts.

How do I override detected conventions when generating code?

To override detected conventions when generating code, provide explicit user instructions. The convention-driven code generation guidance applies detected patterns by default, but includes a clear rule that user-specified overrides take precedence over discovered repository style.

Can I use convention detection for adding features to unfamiliar code areas?

Yes, you can use convention detection for adding features to unfamiliar code areas. It applies to first-time file creation and extending features by forcing discovery of DI registration patterns, test frameworks, and error-handling approaches before new code is written.

Do I need to specify naming and structure when creating new .NET files?

No, you do not need to specify naming and structure when creating new .NET files if convention detection is used. It automatically gathers naming suffixes and src folder architecture styles, ensuring newly generated code matches repository style without manual specification.