api-patterns SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

api-patterns from francostino/opencode-skills-collection is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add francostino/opencode-skills-collection/api-patterns@git:20260906.7d37dc9

Pins git:20260906.7d37dc9 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
francostino/opencode-skills-collection
Path
bundled-skills/api-patterns/SKILL.md
Versions recorded
3
Latest version
git:20260906.7d37dc9, committed Sep 6, 2026
First version recorded
Jul 7, 2026
Size
4,225 bytes
Repository stars
87
License
MIT

API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.

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

# API Patterns

> API design decisions tied to the consumers and deployment constraints.
> **Learn to THINK, not copy fixed patterns.**

## 🎯 Selective Reading Rule

**Read ONLY files relevant to the request!** Check the content map, find what you need.

---

## 📑 Content Map

| File | Description | When to Read |
|------|-------------|--------------|
| `api-style.md` | REST vs GraphQL vs tRPC decision tree | Choosing API type |
| `rest.md` | Resource naming, HTTP methods, status codes | Designing REST API |
| `response.md` | Envelope pattern, error format, pagination | Response structure |
| `graphql.md` | Schema design, when to use, security | Considering GraphQL |
| `trpc.md` | TypeScript monorepo, type safety | TS fullstack projects |
| `versioning.md` | URI/Header/Query versioning | API evolution planning |
| `auth.md` | JWT, OAuth, Passkey, API Keys | Auth pattern selection |
| `rate-limiting.md` | Token bucket, sliding window | API protection |
| `documentation.md` | OpenAPI/Swagger best practices | Documentation |
| `security-testing.md` | OWASP API Top 10, auth/authz testing | Security audits |

---

## 🔗 Related Skills

| Need | Skill |
|------|-------|
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add francostino/opencode-skills-collection/api-patterns@sha256:e2964e6348164a3b

The line at the top of this page pins the label git:20260906.7d37dc9, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ux3744phpyu52rkk.svg)](https://markdownregistry.com/a/art_ux3744phpyu52rkk)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Jul 7, 2026 and Sep 6, 2026, about one every 30 days.

versioncommittedcommitsizeaudit
git:20260906.7d37dc9 latest2026-09-06 7d37dc9 4,225 BA view · diff
git:20260730.90257ed2026-07-30 90257ed 2,867 BA view · diff
git:20260707.168343c2026-07-07 168343c 2,870 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4225 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

GitHub

francostino/opencode-skills-collection · 87 stars · license MIT · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ux3744phpyu52rkk
GET https://markdownregistry.com/api/v1/resolve?ref=francostino/opencode-skills-collection/api-patterns
GET https://markdownregistry.com/api/v1/blob/e2964e6348164a3b94acd5a07df73e1f2f3e6a9fdb38d72fb598725301603392

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.

More from francostino/opencode-skills-collection

AGENTS.md AGENTS.md file
francostino/opencode-skills-collection · AGENTS.md
git:20260820.c2f6bd5 · audit A · 87 stars
00-andruia-consultant SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/00-andruia-consultant/SKILL.md · Usar al iniciar o mejorar un proyecto de IA: diagnostica código y restricciones, propone skills existentes y redacta…
git:20261015.fac8b7e · audit A · 87 stars
007 SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/007/SKILL.md · Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response…
git:20260906.7d37dc9 · audit A · 87 stars
10-andruia-skill-smith SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/10-andruia-skill-smith/SKILL.md · Usar para crear o mejorar una skill de Andru.ia: define entradas y resultados, redacta SKILL.md con ejemplos y límites…
git:20261015.fac8b7e · audit A · 87 stars
20-andruia-niche-intelligence SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/20-andruia-niche-intelligence/SKILL.md · Usar tras definir el sector de un proyecto: prepara un dossier en español con contexto, normas aplicables, patrones UX…
git:20261015.fac8b7e · audit A · 87 stars
2slides-ppt-generator SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/2slides-ppt-generator/SKILL.md · AI-powered presentation generation via the 2slides API — create slides from text, match a reference image style…
git:20260906.7d37dc9 · audit A · 87 stars
360-feedback-system SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/360-feedback-system/SKILL.md · 360 feedback register: reviewer, subject, review cycle, visibility, due date and score, as CSV, SQL, JSON Schema or…
git:20261001.ed2b2ec · audit A · 87 stars
3d-web-experience SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/3d-web-experience/SKILL.md · Use when building or debugging web 3D scenes, product configurators or portfolios with Three.js, React Three Fiber or…
git:20261015.fac8b7e · audit A · 87 stars
aas-compose-stack SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/aas-compose-stack/SKILL.md · Preserve the coding agent's explicit AAS skill selection as a validated stack and optional evidence.
git:20261004.4720433 · audit A · 87 stars
aas-discover SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/aas-discover/SKILL.md · Discover AAS skills for an explicit task and compare their complete instructions without installing them.
git:20261004.4720433 · audit A · 87 stars
aas-review-stack SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/aas-review-stack/SKILL.md · Review AAS stack manifests, preview plans and selection evidence in Workbench without applying changes.
git:20261004.4720433 · audit A · 87 stars
ab-test-setup SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/ab-test-setup/SKILL.md · Use when designing an A/B or split test: define the hypothesis, control and variants, estimate sample size, verify…
git:20260906.7d37dc9 · audit A · 87 stars

Every file in francostino/opencode-skills-collection

Other files named api-patterns

api-patterns SKILL.md skill
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/api-patterns/SKILL.md · API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.
git:20260905.b0bf123 · audit A · 48,329 stars
api-patterns SKILL.md skill
vodailocz/kilo-kit-mcp · skills/engineering/api-patterns/SKILL.md · API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.
git:20260502.38d5305 · audit A · 28 stars
api-patterns SKILL.md skill
aicodedecode/awesome-muse-skills · skills-imported/api-patterns/SKILL.md · API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.
git:20260927.806f3e1 · audit A · 25 stars
api-patterns SKILL.md skill
hybridlabor-api/aos · skills/global_config/api-patterns/SKILL.md · API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.
git:20260827.e9312a3 · audit A · 6 stars
api-patterns SKILL.md skill
hybridlabor-api/bdb-dev-optimized-agent-skills · skills/global_config/api-patterns/SKILL.md · API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.
git:20260827.e4036aa · audit A · 6 stars

Browse by kind, by grade A, or by owner.