How do I refresh the ARK Dashboard types?

The workflow involves generating a new openapi.json from the API service, copying it to the dashboard directory, and running the generate:api script.

What are ARK SDK overlays?

Overlays are custom Python modules located in the gen_sdk/overlay directory that allow you to add manual functionality like clients and executors on top of generated code.

Why do my TypeScript types have __models__ in their names?

This indicates a naming collision between Pydantic models in the API. This skill provides specific naming conventions, such as prefixing classes with their domain, to ensure unique schema names.

How does this skill handle Kubernetes CRD changes?

It guides you through the make ark-sdk-build process, which converts CRD YAML files to OpenAPI schemas and generates corresponding Python types automatically.

Ark SDK & Type Development

Name: Ark SDK & Type Development
Author: remiverdiesen

byremiverdiesen

•

API開発

Synchronizes and debugs the end-to-end type generation pipeline from Kubernetes CRDs to TypeScript across the ARK stack.

This skill streamlines development for the ARK framework by managing the complex synchronization of types between Kubernetes Custom Resource Definitions (CRDs), Python SDKs, Pydantic API models, and TypeScript frontend types. It provides specialized guidance for regenerating types, implementing custom SDK overlays, resolving non-deterministic naming collisions in OpenAPI schemas, and ensuring full-stack type safety across the SDK, API, and Dashboard components. Ideal for developers building agentic resources who need to maintain a consistent data contract across a multi-language microservice environment.

主な機能

01Enforcement of unique Pydantic naming patterns for deterministic OpenAPI schemas

02Automated CRD-to-Python SDK type generation and overlay management

03Standardized build workflows for SDK, API, and Dashboard components

04End-to-end type synchronization from backend YAML to frontend TypeScript

056 GitHub stars

06Intelligent debugging for schema errors and 'Property does not exist' warnings

ユースケース

01Resolving schema name collisions caused by duplicate Pydantic model names

02Adding custom Python functionality to the generated ARK SDK via overlays

03Updating the ARK Dashboard types after modifying Kubernetes CRD schemas

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

Download Skill