tsp-model

Generate TypeSpec domain models following project naming and structure conventions.

241|51|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/shep-ai/cli --skill tsp-model
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tsp-model
Source: https://github.com/shep-ai/cli/tree/main/.claude/skills/tsp-model
Command: npx skills add https://github.com/shep-ai/cli --skill tsp-model

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically generate TypeSpec domain models for entities, value objects, and enums following project conventions, reducing boilerplate and ensuring consistency across the codebase.

Core Features & Use Cases

  • Generate single-file per model in tsp/common and tsp/domain following the project's naming and structure conventions.
  • Enforce base-entity patterns and documentation standards to accelerate onboarding and maintainability.
  • Use during domain evolution to create new models or refactor existing ones with minimal friction.

Quick Start

Create or modify a TypeSpec domain model by adding appropriately named files under tsp/domain following the conventions described in this skill.

Frequently Asked Questions about tsp-model

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

FAQPage Schema
How do I generate TypeSpec domain models for entities and value objects?

You can generate TypeSpec domain models by adding appropriately named files under tsp/domain. This automatically applies your project's conventions for naming, base types, documentation, and examples to ensure architectural consistency.

What is the best way to maintain consistency when creating new TypeSpec domain elements?

The best way to maintain consistency is to use automated generation that enforces repository conventions for base-entity patterns and documentation standards. This reduces boilerplate and aligns new models with existing architecture.

How do I reduce boilerplate when defining enums and value objects in TypeSpec?

You reduce boilerplate by generating single-file per model structures in tsp/common and tsp/domain. This enforces project naming and base-entity patterns automatically, accelerating development and onboarding.

Can I refactor existing TypeSpec domain models without breaking project conventions?

Yes, you can refactor existing models with minimal friction. Updating files in tsp/domain automatically aligns the modified elements with the repository's established base-entity patterns, naming, and documentation standards.

Does TypeSpec model generation work for both new domain creation and existing file updates?

Yes, TypeSpec model generation applies when creating new domain elements or updating files in tsp/domain. It maintains consistency and alignment with architecture across both new creation and refactoring workflows.