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 Design Skill
> Design APIs that developers love to use.
## Core Principle
A good API is intuitive, consistent, and hard to misuse. Design for the consumer, not the implementation.
## REST Fundamentals
### Resource Naming
| Good | Bad | Why |
|------|-----|-----|
| `/users` | `/getUsers` | Nouns, not verbs |
| `/users/123` | `/user?id=123` | Path params for identity |
| `/users/123/orders` | `/getUserOrders` | Hierarchical resources |
| `/search?q=term` | `/search/term` | Query params for filters |
### HTTP Methods
| Method | Purpose | Idempotent | Safe |
|--------|---------|------------|------|
| GET | Read resource | Yes | Yes |
| POST | Create resource | No | No |
| PUT | Replace resource | Yes | No |
| PATCH | Partial update | No* | No |
| DELETE | Remove resource | Yes | No |
### Status Codes
| Code | Meaning | When to Use |
|------|---------|-------------|
| 200 | OK | Successful GET, PUT, PATCH |
| 201 | Created | Successful POST |
| 204 | No Content | Successful DELETE |
| 400 | Bad Request | Validation error |
| 401 | Unauthorized | Missing authentication |
| 403 | Forbidden | Authenticated but not allowed |
| 404 | Not Found | Resource doesn't exist |
…
The line at the top of this page pins the label git:20260728.80a7ab6, 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.
GET https://markdownregistry.com/api/v1/artifacts/art_el36sukzhspp6qgc
GET https://markdownregistry.com/api/v1/resolve?ref=fabioc-aloha/alex_skill_mall/api-design
GET https://markdownregistry.com/api/v1/blob/ba4e93014eea5afe7eb56b7ede89dd994f81a073aea90beab3f9870b378a205a
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.
fabioc-aloha/alex_skill_mall · .github/skills/source-inventory/SKILL.md · Maintain the source registry in sources/supported-stores.json — add a new third-party plugin store, retire one, refresh…
fabioc-aloha/alex_skill_mall · .github/skills/staleness-discipline/SKILL.md · Detect, classify, and prune stale source stores in the Mall — define what stale means and how to remove gracefully…
fabioc-aloha/alex_skill_mall · .github/skills/store-evaluation/SKILL.md · Evaluate a proposed store for inclusion in Alex_ACT_Plugin_Mall using a quality scorecard
fabioc-aloha/alex_skill_mall · plugins/3d-graphics/spline-3d-integration/skills/spline-3d-integration/SKILL.md · Use when adding interactive 3D scenes from Spline.design to web projects, including React embedding and runtime control…
fabioc-aloha/alex_skill_mall · plugins/academic-research/academic-paper-drafting/skills/academic-paper-drafting/SKILL.md · End-to-end academic paper drafting for CHI, HBR, journals, and conferences with venue-specific templates, drafting…
fabioc-aloha/alex_skill_mall · plugins/academic-research/academic-research/skills/academic-research/SKILL.md · Research project scaffolding, thesis/dissertation writing, literature reviews, publication workflows, and the AI…
affaan-m/ecc · docs/es/skills/api-design/SKILL.md · Patrones de diseño REST API incluyendo nomenclatura de recursos, códigos de estado, paginación, filtrado, respuestas de…
ericrisco/rsc-harness · skills/api-design/SKILL.md · Use when settling the contract of an API you expose, before implementation: resources/URLs, REST vs GraphQL…
yonatangross/orchestkit · plugins/ork/skills/api-design/SKILL.md · API wire contracts for REST and GraphQL: resource shape, versioning and deprecation, RFC 9457 errors, OpenAPI. Use when…
