TypeSpec SDK Generator Skill

SkillDev tools

Microsoft TypeSpec-based API and SDK generation

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the TypeSpec SDK Generator Skill skill

What this skill tells your AI

The instructions your AI receives, as published by a5c-ai/babysitter in library/specializations/sdk-platform-development/skills/typespec-sdk-generator/SKILL.md and read by ahel’s review.

Overview

This skill utilizes Microsoft TypeSpec (formerly Cadl) to design APIs and generate multi-language SDKs following Azure SDK guidelines. TypeSpec provides a concise, type-safe language for API definition.

Capabilities

Design APIs using TypeSpec language
Generate multi-language SDKs (TypeScript, Python, Java, C#, Go)
Emit OpenAPI and other specification formats
Apply Azure SDK style guidelines automatically
Implement decorators for rich API semantics
Support versioning and deprecation patterns
Generate strongly-typed clients

Target Processes

SDK Code Generation Pipeline
API Design Specification
Multi-Language SDK Strategy

Integration Points

TypeSpec compiler and emitters
AutoRest for SDK generation
Azure SDK code generation pipeline
OpenAPI emitters
Custom emitter development

Input Requirements

TypeSpec model files (.tsp)
Emitter configurations per target
Versioning requirements
Style guide preferences
Custom decorators (if any)

Output Artifacts

Generated SDK source code per language
OpenAPI specifications
JSON schemas
API documentation
Client library packages

Usage Example

skill:
  name: typespec-sdk-generator
  context:
    modelDirectory: ./typespec
    emitters:
      - "@azure-tools/typespec-ts"
      - "@azure-tools/typespec-python"
      - "@typespec/openapi3"
    applyAzureGuidelines: true
    apiVersion: "2024-01-01"

Best Practices

Use namespaces to organize API structure
Leverage decorators for documentation and behavior
Implement proper versioning with @versioned
Use templates for reusable patterns
Define clear model inheritance hierarchies
Apply Azure SDK guidelines for consistency

Signals

GitHub stars: 2k
Forks: 112
Last commit: Sep 2026

Advanced

Item type: skill
Key: typespec-sdk-generator
Source: github.com/a5c-ai/babysitter

github.com/a5c-ai/babysitter