go-authcrunch: Skill for Codex

.codex/skills/openapi-generation/SKILL.md

openapi-generation is a skill for Codex from greenpau/go-authcrunch. It costs 43 tokens per session (4,488 once invoked), scanned A, original, Apache-2.0.

A process for maintaining an OpenAPI description of an HTTP interface. OpenAPI is a standard, machine-readable document that records available requests, responses, authentication, and related rules.

In plain words
What is it for?
Use it after changes to HTTP-facing source code or configuration, API authentication rules, or API reference tooling.
Why use it?
Changes to an HTTP service can make its reference document inaccurate. This process keeps the authored YAML specification, generated JSON, version checks, and local reference server aligned.

Skill for Codex

Written for Codex: agents/openai.yaml present.

This is greenpau/go-authcrunch's own configuration. It tells Codex how to work on go-authcrunch itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything go-authcrunch configures →

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is go run -mod=readonly ./cmd/openapi sources > tmp/openapi/reviewed-sources.yaml.

Reuse

Borrowing it

Nothing to install: this file belongs to greenpau/go-authcrunch. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/greenpau/go-authcrunch/main/.codex/skills/openapi-generation/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/greenpau/go-authcrunch

Made for: Codex.

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 openapi-generation

README.md
[![agentmods](https://agentmods.dev/badge/skills/greenpau/go-authcrunch/openapi-generation/github.svg)](https://agentmods.dev/skills/greenpau/go-authcrunch/openapi-generation)
Your own site
<a href="https://agentmods.dev/skills/greenpau/go-authcrunch/openapi-generation"><img src="https://agentmods.dev/badge/skills/greenpau/go-authcrunch/openapi-generation/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 openapi-generation

Your own site · 80×15
<a href="https://agentmods.dev/skills/greenpau/go-authcrunch/openapi-generation"><img src="https://agentmods.dev/badge/skills/greenpau/go-authcrunch/openapi-generation.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 43 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,488 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.00043 $0.04488
Opus 5.5 $0.00017 $0.01795
Sonnet 5.5 $0.00009 $0.00898
Haiku 4.5 $0.00004 $0.00449

Measured 12d ago against content hash 4e9d4b11672d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

openapi-generation 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 12d 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.

disabled. Clients are Shell/curl (default), PowerShell Invoke-RestMethod and
.codex/skills/openapi-generation/SKILL.md · 365 lines

How it starts

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

OpenAPI Generation

Own the HTTP reference

Keep canonical OpenAPI 3.1.1 YAML in assets/openapi/content/openapi.yaml, with local references into paths/ and components/. make openapi validates and bundles it into ignored assets/openapi/generated/openapi.json. Never hand-edit JSON or reverse-generate authored YAML. Preserve its Git ignore and VS Code files/search/watcher exclusions.

The contract describes this checkout's authentication portals and authorization policies, regardless of embedding HTTP server. It creates no runtime routes. Host configuration/management, arbitrary protected application resources, static assets and unfinished placeholders are outside its scope. Trace the native dispatchers and runtime; do not resolve AuthCrunch as its own dependency or assume a sibling consumer's wrapper behavior.

VERSION owns info.version. make version-check rejects drift; make version-sync updates the YAML and existing Go metadata projections. Retain the single LF-delimited info: block and plain two-space version: 1.<minor>.<patch> line expected by assets/scripts/version.py. Generation/serving/checks never synchronize source implicitly. Checked and fast patch/minor release workflows synchronize and commit YAML; JSON stays generated. A documentation change does not authorize a version bump or release.

Read source review to trace operations, route ownership, credential boundaries, availability and validation evidence. Read field contracts to enrich units, normalization, validators, encodings, state-dependent checks and returned records.

Evaluate every HTTP-facing change

Before completing changes to handlers, dispatch, configuration gates, identity payloads, cookies, token/session lifecycle, OAuth/OIDC/SAML, serialization or HTTP host integration, compare resulting behavior with the YAML. Update paths, methods, payloads, media types, statuses, headers, security, examples and feature availability in the same change, together with owning skills and tests. Review ordering, revocation, expiry and consent even when the JSON shape stays stable.

Read the full file on GitHub · 365 lines

Files

What ships with it

3 files 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. 12d ago Changed · +24 lines 4e9d4b11672d
  2. 17d ago Changed · +1 lines f758606daab5
  3. 25d ago Changed · +51 lines 4db3e64aaab4
  4. 26d ago Changed · +10 lines 101176649fa4
  5. 28d ago First seen · 279 lines · 43 tokens per session scan A 6d88725bee8e

Subscribe to this mod's changes

openapi-generation is a skill published in the GitHub repository greenpau/go-authcrunch (60 stars, last pushed 10d ago), licensed Apache-2.0. It adds 43 tokens to every session and 4,488 once invoked, about $0.0002 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-10-09.

Related

openapi-generation compared with skills from other repositories

openapi-generation next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
openapi-generationgreenpau/go-authcrunchSkill6010d agoApache-2.0A43Codex
mem0-oss-to-platformmem0ai/mem0Skill68k2d agoApache-2.0A217Claude Code, Codex
azure-mgmt-botservice-dotnetmicrosoft/skillsSkill3.2kyesterdayMITA78Claude Code
fastapi-router-pymicrosoft/skillsSkill3.2kyesterdayMITA46Claude Code
dev-runtimelangwatch/langwatchSkill5.0kyesterdayApache-2.0A172Claude Code
api-designericrisco/rsc-harnessSkill5032d agoMITA105Claude Code, Codex
migrate-segw-to-raparc-mcp/arc-1Skill252yesterdayMITA106Claude Code