SkillFoxx

AutoSDK skill

The generating-dotnet-sdks skill teaches Claude Code to build .NET clients from OpenAPI and AsyncAPI specs with the AutoSDK CLI.

  • 93 ★ on the repository
  • Last commit
Skill

Extended access

Why this level

  • The agent runs a CLI that writes generated code into a chosen project folder.
  • Installing the tool and calling `dotnet` runs code from a NuGet package.
All reasons and checks

tryagi/autosdkAuthor:tryAGI

Install

Manual install

npx skills add tryAGI/AutoSDK@generating-dotnet-sdks

Command from the Claude Code Skill section. The generator itself: `dotnet tool install --global autosdk.cli --prerelease`.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The agent runs a CLI that writes generated code into a chosen project folder.
  • Installing the tool and calling `dotnet` runs code from a NuGet package.

This is third-party code. Review the repository files before installing.

What it does

AutoSDK is a .NET client generator for OpenAPI and AsyncAPI specs: an `autosdk` command-line tool and a Roslyn source generator. The `generating-dotnet-sdks` skill in the `skills/` folder tells the agent the CLI commands (`generate`, `init`, `http`, `docs`, `convert`, `simplify`, `trim`) and the project layout. From the skill the agent creates SDKs with typed clients, `CancellationToken`, System.Text.Json and OneOf, AnyOf and AllOf support. It can rerun generation through the `generate.sh` script, build WebSocket clients from AsyncAPI, set up SSE streams and extend generated code through partial classes and client hooks.

Who it is for. C# developers who ship client libraries for third-party APIs and want to trust Claude Code with generation and tuning.

Good fit when

  • There is an `openapi.yaml` file and a typed C# client with cancellation is needed.
  • A ready SDK must be regenerated after a spec update.
  • A WebSocket service needs a client from an AsyncAPI description.
  • A generated client needs tuning through partial classes without editing the output.

Not a fit when

  • The project is not on .NET: the generator outputs only C# code.
  • The service has no OpenAPI or AsyncAPI spec.
  • A TypeScript or Python client is needed.

Example request

Generate a C# SDK from openapi.yaml in the Acme.Client namespace, target net8.0, output into the Generated folder.

Limitations

The skill covers working with `autosdk.cli`, which installs as a global dotnet tool with the `--prerelease` flag. The result is C# code for net6.0 and newer, plus .NET Framework and .NET Standard. Client quality depends on the spec: OpenAPI 3.1 support goes through a compatibility normalization. Commands in the skill generate into a chosen folder, so check the output path before overwriting.

How to disable. Delete the skill folder from the agent directory and the tool with `dotnet tool uninstall --global autosdk.cli`.

FAQ

How do I install the skill?

Run `npx skills add tryAGI/AutoSDK@generating-dotnet-sdks`. The skill source lives in `skills/generating-dotnet-sdks/`.

How do I install the generator itself?

With `dotnet tool install --global autosdk.cli --prerelease`. Then `autosdk generate openapi.yaml --namespace Namespace --clientClassName YourApi --targetFramework net8.0 --output Generated`.

Is OpenAPI 3.1 supported?

Yes, through a compatibility normalization that handles nullability, examples, `const` and other features. OneOf, AnyOf, AllOf and Not are supported.

Can it generate a WebSocket client?

Yes, from an AsyncAPI spec: send and receive methods and cross-namespace references.

What about streaming responses?

SSE is supported through the `application/x-ndjson` content type.

Discussion

No questions or reviews yet.

Skills

CLI that turns an OpenAPI spec into an Agent Skill of markdown files an agent reads piece by piece, saving context.

CLIMinimal access342

An installer for a .NET skill catalog that picks skills from project files for Claude Code, Codex, Copilot and Gemini CLI

CLIExtended access514
Official

The official Orval skill: the agent sets up generation of TypeScript clients, Query hooks, Zod schemas and MSW mocks from an OpenAPI spec

SkillExtended access6.6K

The CLI validates OpenAPI descriptions and generates client libraries, MCP servers and other interfaces for your API.

CLIExtended access461
Official

Official DevExpress skills for Copilot, Claude Code, Cursor and Codex: DevExtreme, Blazor, WPF, WinForms, Reports, XAF and VCL

PluginMinimal access70

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialRepository starsMain difference
AutoSDK (this card)no93
Openapi Skills: API marketplace for agentsyes16skills for working with OpenAPI specs; AutoSDK targets C# client generation
openapi-to-skillsno342turns OpenAPI into agent skills; AutoSDK turns OpenAPI into a C# library

README in short

The project maintains more than two hundred SDK repositories generated with this tool, so improvements follow real API shapes. MIT license, with no dependencies on modern dotnet versions.

README badge

Original SKILL.md

---
name: generating-dotnet-sdks
description: >-
  Generates .NET/C# SDKs from OpenAPI specifications using the AutoSDK CLI tool
  (autosdk.cli). Use when the user wants to create a C# client library from an
  OpenAPI/Swagger spec, scaffold a new SDK project, regenerate existing SDK code,
  or customize generated .NET API clients.
---

# Generating .NET SDKs from OpenAPI Specs with AutoSDK

## Overview

AutoSDK is a .NET CLI tool and Roslyn source generator that produces production-quality C# SDKs from OpenAPI specifications. Generated SDKs include:

- Fully typed C# clients with async methods and CancellationToken support
- System.Text.Json serialization (no reflection, NativeAOT/trimming compatible)
- Nullable reference types enabled
- Support for OneOf/AnyOf/AllOf schemas
- Server-Sent Events (SSE) streaming via `application/x-ndjson`
- Enum serialization for System.Text.Json
- Polyfills for .NET Framework / .NET Standard targets
- Strong-named assemblies

AutoSDK is used in 30+ real SDKs (OpenAI, Anthropic, Ollama, HuggingFace, etc.) and tested against OpenAPI specs up to 220k lines.

## Quick Start Workflow

### Step 1: Install the CLI tool

```bash
dotnet tool install --global autosdk.cli --prerelease
```

### Step 2: Obtain the OpenAPI specification

Either download it or point to a local file:

```bash
# Download from URL
curl -o openapi.yaml https://example.com/api/openapi.yaml

# Or use a local file
ls openapi.yaml
```

AutoSDK accepts both YAML and JSON formats. It supports OpenAPI 3.0 and 3.1 specs (3.1 is internally converted to 3.0).

### Step 3: Generate the SDK

Report a problem