# Client Generation

> Generate or update typed API clients from canonical contracts.

- Skill: `velcrafting/client-generation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add velcrafting/client-generation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/velcrafting/client-generation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: velcrafting (https://skillmd.com/u/velcrafting)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/velcrafting/client-generation

---


# Skill: api/client-generation

## Purpose
Produce or refresh API clients so consumers:
- use typed, validated calls
- stay aligned with contracts
- do not hand-roll request logic

---

## Inputs
- Canonical API contract source
- Target language(s) or framework(s)
- Repo profile (preferred): `<repo>/REPO_PROFILE.json`

---

## Outputs
- Generated client code OR
- Updated handwritten client wrappers (repo standard)
- Regenerated artifacts committed if repo policy allows

---

## Non-goals
- Changing API behavior
- Writing UI or domain logic
- Editing generated code manually

---

## Workflow
1) Identify contract source and generator/tooling.
2) Regenerate clients deterministically.
3) Update import paths or version pins if needed.
4) Verify consumers compile/typecheck.

---

## Checks
- Generated clients compile
- No manual edits inside generated output
- Consumers pass typecheck

---

## Failure modes
- Generator output unstable → pin version or snapshot output.
- Contract invalid → block and return to `api/contract-update`.

---

## Telemetry
Log:
- skill: `api/client-generation`
- languages
- artifacts_written
- outcome