Instruction file imported from AdobeDocs/ff-services-docs (.cursor/rules/api-ref-router.mdc). Copyright stays with the author.

API reference router

Name: api-ref-router
Author: AdobeDocs

When editing or reviewing OpenAPI JSON under static/, use the right skill. Load modular rules only when needed.

Task routing

User intent	Skill	Edits?
`/api-eval`, evaluate, audit	api-eval	No — findings only
`/api-review`, catalog descriptions	api-review	No — tables for manual review
`/api-fix`, fix lint or structure	api-fix	Yes — lint + api-ref-structure

Resolve the spec path with _shared/resolve-api-spec.md. Do not assume petstore.json.

Non-negotiable description rule

HTTP response description (status lines): Title Case, no trailing period (e.g. Internal Server Error).
All other descriptions (operations, parameters, schemas, headers): complete sentences with periods.

Modular rules (load on demand)

api-ref-structure.mdc — section order, license, JSON/$ref
api-ref-copy.mdc — summaries, punctuation, public-facing text
api-ref-schema.mdc — anyOf, type arrays, $ref/title
api-ref-examples.mdc — Redocly examples
api-ref-tags-errors.mdc — tags, errors, auth
api-ref-ffs-styleguide.mdc — Firefly Services API Style Guide (api-eval only)

Legacy monolith: eval-API-ref.mdc (deprecated stub).

{ "ocm": "1", "id": "adobedocs-ff-services-docs-api-ref-router-rule", "kind": "skill", "name": "api-ref-router", "description": "Route OpenAPI JSON work to api-eval, api-review, or api-fix skills", "publisher": "AdobeDocs", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-cursor-rules" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Route OpenAPI JSON work to api-eval, api-review, or api-fix skills" ], "primary": false, "metadata": { "source": { "provider": "github-cursor-rules", "repository": "https://github.com/AdobeDocs/ff-services-docs", "path": ".cursor/rules/api-ref-router.mdc", "ref": "ba3bcdac2c015ae306c22f0fdb02a7d0908923b0", "url": "https://github.com/AdobeDocs/ff-services-docs/blob/ba3bcdac2c015ae306c22f0fdb02a7d0908923b0/.cursor/rules/api-ref-router.mdc", "key": "AdobeDocs/ff-services-docs/.cursor/rules/api-ref-router.mdc" }, "applies_to": "static/**/*.json" }, "instructions": "# API reference router\n\nWhen editing or reviewing OpenAPI JSON under `static/`, use the right skill. Load modular rules only when needed.\n\n## Task routing\n\n| User intent | Skill | Edits? |\n|-------------|-------|--------|\n| `/api-eval`, evaluate, audit | [api-eval](../skills/api-eval/SKILL.md) | No — findings only |\n| `/api-review`, catalog descriptions | [api-review](../skills/api-review/SKILL.md) | No — tables for manual review |\n| `/api-fix`, fix lint or structure | [api-fix](../skills/api-fix/SKILL.md) | Yes — **lint + api-ref-structure** |\n\nResolve the spec path with [_shared/resolve-api-", "cost": { "context_tokens": 349 } }

api-ref-router

About

API reference router

Task routing

Non-negotiable description rule

Modular rules (load on demand)

Use it

Manifest

Reviews