SkillFoxx
Telegram

AutoSDK — скилл

Навык generating-dotnet-sdks учит Claude Code создавать .NET-клиенты по спецификациям OpenAPI и AsyncAPI через CLI AutoSDK.

  • 93 ★ репозитория
  • Последний коммит
Скилл

Расширенный доступ

Почему такой уровень

  • Агент запускает CLI, который пишет сгенерированный код в выбранную папку проекта.
  • Установка инструмента и вызовы `dotnet` выполняют код из пакета NuGet.
Все причины и проверки

tryagi/autosdkАвтор:tryAGI

Установка

Работает в

Ручная установка

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

Команда из раздела Claude Code Skill. Сам генератор: `dotnet tool install --global autosdk.cli --prerelease`.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Агент запускает CLI, который пишет сгенерированный код в выбранную папку проекта.
  • Установка инструмента и вызовы `dotnet` выполняют код из пакета NuGet.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

AutoSDK — генератор .NET-клиентов по спецификациям OpenAPI и AsyncAPI: консольный инструмент `autosdk` и генератор исходников Roslyn. Навык `generating-dotnet-sdks` из папки `skills/` описывает агенту команды CLI (`generate`, `init`, `http`, `docs`, `convert`, `simplify`, `trim`) и структуру проекта. По навыку агент создает SDK с типизированными клиентами, `CancellationToken`, System.Text.Json и поддержкой OneOf, AnyOf и AllOf. Он умеет запускать повторную генерацию скриптом `generate.sh`, строить клиентов для WebSocket по AsyncAPI, настраивать SSE-потоки и дополнять сгенерированный код через partial-классы и хуки клиента.

Для кого. Разработчикам на C#, которые выпускают клиентские библиотеки к чужим API и хотят доверить Claude Code генерацию и доработку.

Подходит, если

  • Есть файл `openapi.yaml`, и нужен типизированный клиент на C# с отменой запросов.
  • Готовый SDK надо перегенерировать после обновления спецификации.
  • Для сервиса с WebSocket нужен клиент по описанию AsyncAPI.
  • Сгенерированный клиент требует доработки через partial-классы без правки исходников.

Не подходит, если

  • Проект не на .NET: генератор выдает только код на C#.
  • У сервиса нет спецификации OpenAPI или AsyncAPI.
  • Нужен клиент для TypeScript или Python.

Пример запроса к агенту

Сгенерируй C# SDK по файлу openapi.yaml в пространстве имен Acme.Client, цель net8.0, вывод в папку Generated.

Ограничения

Навык описывает работу с `autosdk.cli`, который ставится как глобальный dotnet-инструмент с флагом `--prerelease`. Результат — код на C# для net6.0 и новее, а также .NET Framework и .NET Standard. Качество клиента зависит от спецификации: поддержка OpenAPI 3.1 идет через нормализацию совместимости. Команды в навыке запускают генерацию в выбранную папку, поэтому проверяйте путь вывода перед перезаписью.

Как отключить. Удалите папку навыка из каталога агента и инструмент командой `dotnet tool uninstall --global autosdk.cli`.

Частые вопросы

Как поставить навык?

Выполните `npx skills add tryAGI/AutoSDK@generating-dotnet-sdks`. Исходники навыка лежат в `skills/generating-dotnet-sdks/`.

Как поставить сам генератор?

Командой `dotnet tool install --global autosdk.cli --prerelease`. Затем `autosdk generate openapi.yaml --namespace Namespace --clientClassName YourApi --targetFramework net8.0 --output Generated`.

Поддерживается ли OpenAPI 3.1?

Да, через нормализацию совместимости: обрабатываются nullability, examples, `const` и другие особенности. Поддерживаются OneOf, AnyOf, AllOf и Not.

Можно ли сгенерировать клиент для WebSocket?

Да, по спецификации AsyncAPI: методы отправки и приема сообщений и перекрестные ссылки между пространствами имен.

Что с потоковыми ответами?

SSE поддерживается через тип содержимого `application/x-ndjson`.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

CLI превращает спецификацию OpenAPI в Agent Skill из markdown-файлов, которые агент читает по частям и экономит контекст.

CLIМинимальный доступ342

Установщик каталога скиллов для .NET: сам подбирает их по файлам проекта и ставит в Claude Code, Codex, Copilot и Gemini CLI

CLIРасширенный доступ513
Официальный

Официальный скилл Orval: агент настраивает генерацию TypeScript-клиентов, хуков Query, схем Zod и моков MSW из спецификации OpenAPI

СкиллРасширенный доступ6,6 тыс.

CLI проверяет описание OpenAPI и создает клиентские библиотеки, MCP-серверы и другие интерфейсы для вашего API.

CLIРасширенный доступ461

Команда /skill-creator превращает ссылку на OpenAPI, GraphQL или MCP-сервер в готовый скилл с обертками и справочными файлами.

CLIШирокий доступ610
Официальный

Официальные скиллы DevExpress для Copilot, Claude Code, Cursor и Codex: DevExtreme, Blazor, WPF, WinForms, Reports, XAF и VCL

ПлагинМинимальный доступ70

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
AutoSDK (эта карточка)нет93
Openapi Skills — API-маркетплейс для агентада16навыки по работе со спецификациями OpenAPI; AutoSDK целится в генерацию клиентов на C#
openapi-to-skillsнет342превращает OpenAPI в навыки агента; AutoSDK превращает OpenAPI в библиотеку на C#

Коротко о README

Проект поддерживает больше двухсот репозиториев с SDK, которые сгенерированы этим инструментом, поэтому доработки идут на реальных формах API. Лицензия MIT, зависимостей у современных версий dotnet нет.

Бейдж для README

Исходный 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

Сообщить о проблеме