ai-provider-openai-sdk SKILL.md skillA
ai-provider-openai-sdk from agents-inc/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add agents-inc/skills/ai-provider-openai-sdk@git:20261016.afd0e14Pins git:20261016.afd0e14 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- agents-inc/skills
- Path
src/skills/ai-provider-openai-sdk/SKILL.md- Versions recorded
- 3
- Latest version
- git:20261016.afd0e14, committed Oct 16, 2026
- First version recorded
- Mar 23, 2026
- Size
- 20,864 bytes
- Repository stars
- 26
- License
- MIT
Official OpenAI SDK patterns for TypeScript/Node.js — client setup, Chat Completions, Responses API, streaming, structured outputs, function calling, embeddings, vision, audio, and production best practices.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# OpenAI SDK Patterns > **Quick Guide:** Use the official `openai` npm package (v6+) to interact with OpenAI's API directly. Use `client.responses.create()` (Responses API) for new projects with built-in tools and server-side state, or `client.chat.completions.create()` (Chat Completions) for stateless chat flows. Use `zodResponseFormat` and `client.chat.completions.parse()` for structured outputs. Use `.stream()` or `stream: true` for streaming. Supports GPT-5.x family, GPT-4o, o4-mini, embeddings, vision, audio, and batch processing. --- <critical_requirements> ## CRITICAL: Before Using This Skill **(You MUST use the Responses API (`client.responses.create()`) for new projects -- it provides better performance, built-in tools, and server-side conversation state)** **(You MUST use `zodResponseFormat()` from `openai/helpers/zod` for structured outputs -- do NOT manually construct JSON schemas)** **(You MUST handle errors using `OpenAI.APIError` and its subclasses -- never use bare catch blocks without error type checking)** **(You MUST configure appropriate retries and timeouts for production use -- the SDK retries 2 times by default on 429/5xx errors)** …
Read the whole file at its exact version.
How to install
mdr add agents-inc/skills/ai-provider-openai-sdk@sha256:a39adcb0782f504dThe line at the top of this page pins the label git:20261016.afd0e14, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_dusotu4m7cdmqb7h)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Mar 23, 2026 and Oct 16, 2026, about one every 104 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261016.afd0e14 latest | 2026-10-16 | afd0e14 | 20,864 B | A | view · diff |
| git:20260328.19e48cb | 2026-03-28 | 19e48cb | 21,140 B | A | view · diff |
| git:20260323.1cb6727 | 2026-03-23 | 1cb6727 | 21,023 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (20864 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
agents-inc/skills · 26 stars · license MIT · pushed 2026-10-27 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_dusotu4m7cdmqb7h GET https://markdownregistry.com/api/v1/resolve?ref=agents-inc/skills/ai-provider-openai-sdk GET https://markdownregistry.com/api/v1/blob/a39adcb0782f504db54c44e8f9923abb9db1c20b654b84300e59b3ef881c08f5
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.