메뉴
Fixes Redocly lint errors and api-ref-structure.mdc inconsistencies on an OpenAPI JSON spec. Use when the user invokes /api-fix or asks to fix API lint or structure issues. Does not apply FFS style guide or copy fixes.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Audits an OpenAPI JSON spec (Redocly lint, OpenAPI version, FFS style guide, copy rules). Read-only — no file edits. Use when the user invokes /api-eval or asks to evaluate or audit an API spec.
Catalogs user-readable OpenAPI text in ref-numbered tables with possible issues and proposed content. Read-only unless user asks to update specific refs. Use when the user invokes /api-review or asks to review API descriptions.
Stages all working-tree changes with git add -A, then commits with a message that follows the repository user’s Git commit rules (short imperative subject, blank line, body bullets with 📖/✏️). Use when the user invokes /gc or the gc skill, asks to “gc”, or asks to stage everything and commit with the project commit-message format.
Stages all changes with git add -A, drafts a commit message per the user’s Git commit rules, prints it for review, then waits for the user to edit the message and choose (1) commit or (2) reject. Use when the user invokes /gcam or the gcam skill, asks for stage-all with review before commit, or interactive commit with approve/reject.
| name | api-fix |
| description | Fixes Redocly lint errors and api-ref-structure.mdc inconsistencies on an OpenAPI JSON spec. Use when the user invokes /api-fix or asks to fix API lint or structure issues. Does not apply FFS style guide or copy fixes. |
/api-fix — Fix lint and structureApply mechanical fixes from two sources:
npm run lint:openapi -- <path>Do not apply FFS style guide changes, copy edits, description punctuation, internal IDs, examples polish, or api-ref-schema / api-ref-copy findings unless Redocly flags them.
Resolve target spec — _shared/resolve-api-spec.md.
Run lint — Record all errors/warnings.
Structure pass — Load api-ref-structure.mdc. Fix:
openapi → info → servers → security → tags → paths → componentsinfo.license (Adobe Creative API License boilerplate)$ref, duplicate schema names (when clearly wrong)Lint pass — Fix each Redocly finding with minimal change. Cite rule/message.
Re-run lint until zero errors (warnings per reference.md).
Re-check structure — Confirm section order and license after lint edits.
Report — Separate what was fixed under Lint vs Structure. If clean but style/copy issues remain, say: Run /api-eval for style guide and documentation findings.
error_code alignment, tags, summaries, public-facing textanyOf/type-array cleanup unless Redocly flags itSee reference.md for Redocly rules and structure checklist.