Why am I seeing __models__ in my generated schema names?

This indicates a Pydantic naming collision. To fix it, ensure your model class names are unique across the entire project by prefixing them with their domain context, such as AgentHeader or EvaluatorParameter.

How do I add custom functionality to the generated SDK?

You can add custom Python modules to the overlay directory in lib/ark-sdk/gen_sdk/overlay/. These files are copied onto the generated code during the build process.

What is the ARK type pipeline?

It is a multi-step process: Kubernetes CRDs generate Python SDK types, which inform Pydantic models in the API. These models produce an OpenAPI spec used to generate TypeScript types for the dashboard.

When should I run make ark-api-build?

Run this command whenever you update Pydantic models or FastAPI routes to regenerate the openapi.json file required for dashboard type synchronization.

ARK SDK & Type Development

Name: ARK SDK & Type Development
Author: mckinsey

bymckinsey

•

305

•

API Development

Manages the end-to-end type generation pipeline from Kubernetes CRDs to TypeScript for the ARK agentic framework.

This skill automates and debugs the multi-stage type synchronization process within the McKinsey ARK stack, ensuring consistency across Kubernetes CRDs, Python SDKs, FastAPI services, and TypeScript dashboards. It provides specialized guidance for resolving Pydantic model naming collisions, regenerating OpenAPI specifications, and implementing custom SDK functionality through Python overlays, making it an essential tool for developers building or maintaining agentic resources at scale.

Key Features

01OpenAPI specification generation from FastAPI/Pydantic models

02Automated CRD-to-Python SDK type generation

03TypeScript type synchronization for frontend dashboard integration

04Conflict resolution for global Pydantic model naming collisions

05SDK customization via Python overlay management

06305 GitHub stars

Use Cases

01Updating the dashboard when Kubernetes CRD schemas change

02Exposing new agentic resource fields through the ARK API

03Fixing 'Property does not exist on type' errors in TypeScript

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mckinsey/agents-at-scale-ark ark-sdk-development

For use in Claude.ai and ChatGPT

Download Skill