swift-openapi-client-workflow

swift-openapi-client-workflow is a skill for Claude Code, Codex from gaelic-ghost/socket. It costs 73 tokens per session (2,041 once invoked), scanned A, original, Apache-2.0.

A guide to generating Swift clients from OpenAPI files, which describe the endpoints and data formats of an HTTP API. It covers generated code, URL-session transport, integration, authentication, cancellation, and errors.

In plain words
What is it for?
Use it to configure Swift OpenAPI Generator, connect an openapi.yaml or openapi.json file, integrate generated clients, and test requests and responses.
Why use it?
It helps connect Apple apps or Swift packages to documented web APIs without confusing client-side networking with server implementation.

Skill for Claude CodeCodex

Written for Claude Code and Codex: allowed-tools in frontmatter, but also agents/openai.yaml present.

Part of the apple-dev-skills plugin — 65 skills, 2 MCP servers shipped together

Good fit Use it to configure Swift OpenAPI Generator, connect an openapi.yaml or openapi.json file, integrate generated clients, and test requests and responses.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/gaelic-ghost/socket/swift-openapi-client-workflow
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add gaelic-ghost/socket --skill swift-openapi-client-workflow
Clone the repo
git clone --depth 1 https://github.com/gaelic-ghost/socket

Made for: Claude Code, Codex.

Or install apple-dev-skills, the plugin that ships this one along with the rest of its 65 skills, 2 MCP servers.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for swift-openapi-client-workflow

README.md
[![agentmods](https://agentmods.dev/badge/skills/gaelic-ghost/socket/swift-openapi-client-workflow/github.svg)](https://agentmods.dev/skills/gaelic-ghost/socket/swift-openapi-client-workflow)
Your own site
<a href="https://agentmods.dev/skills/gaelic-ghost/socket/swift-openapi-client-workflow"><img src="https://agentmods.dev/badge/skills/gaelic-ghost/socket/swift-openapi-client-workflow/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for swift-openapi-client-workflow

Your own site · 80×15
<a href="https://agentmods.dev/skills/gaelic-ghost/socket/swift-openapi-client-workflow"><img src="https://agentmods.dev/badge/skills/gaelic-ghost/socket/swift-openapi-client-workflow.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 73 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,041 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00073 $0.02041
Opus 5.5 $0.00029 $0.00816
Sonnet 5.5 $0.00015 $0.00408
Haiku 4.5 $0.00007 $0.00204

Measured 1mo ago against content hash 3664790df465, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

swift-openapi-client-workflow scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

allowed-tools: Read Bash(rg:*) Bash(git:*) Bash(swift:*) Bash(find:*) Bash(sqlite3:*) Bash(curl:*)
plugins/apple-dev-skills/skills/swift-openapi-client-workflow/SKILL.md · 131 lines

How it starts

The opening of the file, as written. The whole thing — 131 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Swift OpenAPI Client Workflow

Purpose

Add or diagnose generated Swift OpenAPI clients in Apple-platform code without confusing app-side networking with server-side transport work.

The practical decision is where the OpenAPI document lives, which app or package target runs Swift OpenAPI Generator, how the generated Client is configured with OpenAPIURLSession, how calls are isolated from UI state, and which tests prove request, response, auth, cancellation, and error behavior.

When To Use

  • Use this skill when an iOS, macOS, watchOS, tvOS, visionOS, or Swift package client should call an HTTP API from an OpenAPI description.
  • Use this skill when adding or changing swift-openapi-generator, swift-openapi-runtime, or swift-openapi-urlsession dependencies for client generation.
  • Use this skill when wiring openapi.yaml, openapi.json, or openapi-generator-config.yaml into an app-supporting package or target.
  • Use this skill when diagnosing generated client symbols such as Client, APIProtocol, Operations, Components, response enums, content-type cases, undocumented responses, or transport errors.
  • Use this skill when integrating generated calls into SwiftUI, AppKit, UIKit, Observation, async tasks, app services, or test doubles.
  • Do not use this skill for generated server handlers, Vapor transport, Hummingbird transport, JSON-RPC, gRPC, or MCP-style service contracts. Hand that to server-side-swift:openapi-rpc-workflow when available.
  • Do not use this skill for ordinary URLSession networking with no OpenAPI contract.

Source Check

Start with the Apple and Swift docs gate:

  • Use explore-apple-swift-docs for Apple framework behavior, URLSession, Foundation networking, Xcode package integration, Swift concurrency, Observation, SwiftUI, UIKit, AppKit, or platform lifecycle behavior.
  • Use local Dash or official docs before claiming current Apple or Swift API behavior.
  • Look in Dash Swift docsets for appleswiftopenapigenerator, appleswiftopenapiruntime, appleswiftopenapiurlsession, swiftlangswiftpackagemanager, and Apple Foundation or platform docs when available.
  • Use Introducing Swift OpenAPI Generator for the official client/server overview, generated Client, APIProtocol, ClientTransport, and URLSessionTransport shape.
  • Use apple/swift-openapi-generator for current generator behavior, plugin setup, examples, and supported OpenAPI features.
  • Use apple/swift-openapi-runtime for generated runtime types, middleware concepts, and shared abstractions.
  • Use apple/swift-openapi-urlsession for the OpenAPIURLSession transport and platform support.
  • Use Swift Package Manager documentation for package plugin, target, dependency, and build behavior.

Read the full file on GitHub · 131 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 131 lines · 73 tokens per session scan A 3664790df465

Subscribe to this mod's changes

swift-openapi-client-workflow is a skill published in the GitHub repository gaelic-ghost/socket (7 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 73 tokens to every session and 2,041 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

data-engineering

Builds and operates data pipelines — ingestion, transformation, orchestration, quality testing, and reliability of data delivery. Use this to design or debug a pipeline, decide batch versus streaming, add data quality checks, handle late or duplicate data, or work out why a dashboard's numbers changed without anyone…

cbrock84/headcount · 67 tokens

app-store-optimization

Improves visibility and conversion in the App Store and Google Play — metadata, keywords, screenshots, ratings, and the listing experience that turns an impression into an install. Use this to audit or optimize an app listing, plan a launch listing, diagnose poor install conversion, or improve store search visibility.

cbrock84/headcount · 64 tokens

api-design

Designs interfaces that survive their consumers — resource modeling, errors, versioning, pagination, and compatibility. Use this to design a new API, review one before it ships, decide how to version or deprecate, fix an interface consumers keep misusing, or work out whether a change is breaking.

cbrock84/headcount · 64 tokens

flutter-screenshots

Automate App Store & Google Play screenshot generation for Flutter apps. Scans routing and screens, scores high-value marketing screens, generates self-contained mock harness, runs native simulator captures (iPhone 6.9", iPad 13", Android Phone/Tablet), strips alpha channels, and validates exact store resolutions.

datit309/supergraph · 68 tokens

flutter-ui

Build Flutter UI from Figma MCP or image input. Scans src for design tokens (colors, sizes, text styles), existing components, and naming conventions before writing a single line of code. Never hard-codes values.

datit309/supergraph · 48 tokens

architecture

Proactive architecture review — explore codebase structure, generate a self-contained HTML report with Mermaid diagrams and candidate improvements, then grill the findings. Use when planning a large refactor, onboarding to an unfamiliar codebase, or before a major architectural change.

datit309/supergraph · 52 tokens