TSpec Model

TSpec Model is an AI Engineering skill for Claude Code, published by shep-ai in shep.

247 stars53 forkson shep-ai/shepAdded 2026/09/02Repository updated 2026/08/28

agent-orchestrationagentic-aiaiai-agentsai-code-generationai-codingai-nativeautomationclaudeclaude-codeclicursordeveloper-toolsdevtoolsgeminigit-worktreesparallel-developmentsdlctypescriptworktrees

Install in seconds

Install TSpec Model

Copy TSpec Model into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/shep-ai/shep/tree/main/.claude/skills/tsp-model ~/.claude/skills/tsp-model

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/shep-ai/shep.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: .claude/skills/tsp-model/SKILL.md in shep-ai/shep
Installs to: ~/.claude/skills/tsp-model
Collection: One of 19 skills cataloged from this repository
Category: AI Engineering — 2631 skills

What TSpec Model does

TSpec Model helps create, modify, and document TypeSpec domain models for Shep's Clean Architecture conventions. Use it when adding entities, value objects, enums, or working in the tsp/ directory.

TSpec Model is cataloged under AI Engineering on DirSkills. TSpec Model comes from a repository tagged agent-orchestration, agentic-ai, ai, ai-agents and ai-code-generation.

Documentation

README

Excerpt

TypeSpec Domain Model Generation

Generate TypeSpec domain models following this project's conventions for Clean Architecture entities.

Directory Structure

tsp/
├── common/           # Base types, scalars, enums
│   ├── base.tsp      # BaseEntity, SoftDeletableEntity, AuditableEntity
│   ├── scalars.tsp   # UUID scalar type
│   ├── ask.tsp       # Askable interface pattern
│   └── enums/        # One file per enum
├── domain/           # Domain entities
│   ├── entities/     # One file per entity
│   └── value-objects/# Embedded value objects
├── agents/           # Agent system models
└── deployment/       # Deployment configuration models

File Conventions

One model per file - Each entity/enum/value-object gets its own file.

Naming:

This is the opening of the README. Read the full README on GitHub.

Frequently asked about TSpec Model

What else does shep-ai publish alongside TSpec Model?
TSpec Model is one of 19 skills that DirSkills catalogs from shep-ai/shep, the repository it ships in. Its siblings there include Architecture Reviewer, Commit PR and Cross-Validate Artifacts. Each one is a separate skill with its own page in this directory, installs the same way TSpec Model does, and is maintained by shep-ai in that same repository. The rest of the collection is listed on the shep-ai/shep page.
How does TSpec Model compare to other AI Engineering skills?
TSpec Model ranks #2349 by stars among the 2631 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of TSpec Model against them. Open each page to compare what they document and how they install.