Skills
.Work. You
Rest

typed-service-contracts

Community

Type-safe service contracts for robust TS apps.

Software Engineering#typescript#testing#architecture#validation#contract-driven#spec-and-handler
Authoryopitek
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Architecture standard for building robust, type-safe TypeScript services by applying the Spec and Handler pattern, enabling clear boundaries between input parsing, business logic, and error handling.

Core Features & Use Cases

  • Vertical Slice Architecture with Design by Contract (DbC) principles that treat each user request as a unit of work.
  • The Spec (spec.ts) defines input parsing, output contracts, error schemas, a Result type, and the capability interface.
  • The Handler (handler.ts) implements the contract, performs side effects, and maps errors into the Result pattern for deterministic behavior.

Quick Start

Define the Contract (spec.ts), implement the Handler (handler.ts), and write contract and logic tests to verify behavior.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: typed-service-contracts
Download link: https://github.com/yopitek/Obsidian/archive/main.zip#typed-service-contracts

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.