{"slug":"openapi-operation-conventions","source_name":"openapi-operation-conventions","name":"OpenAPI operation conventions","description":"Use when authoring or reviewing the operations of an OpenAPI (Swagger) 3.x description: give every operation a unique camelCase verbNoun operationId, declare each {path} parameter as in: path with required: true, group operations with tags, document responses for both a success and an error status code, and define reusable objects once under components/schemas (PascalCase) referenced by $ref — which cheaper models skip by default. Do NOT use for choosing REST URL versioning schemes, for generic resource-and-collection URL naming, or for generating client SDK code from an existing spec.","version":1,"lift":{"pass_rate_delta_pts":4.35,"pass_rate_pct":8.7,"total_cases":23,"passed_cases":2,"tokens_delta_pct":63.2,"turns_delta_pct":0,"verdict":"mixed","benchmark_model":"gemini-3.6-flash","grading_method":"judged","completed_at":"2026-07-29T03:14:41.096811+00:00"},"skill_score":0.5093,"benchmark_models":[{"model":"gemini-3.6-flash","headline":true,"delta_pts":4.35,"with_pass_pct":8.7,"without_pass_pct":4.3,"tokens_delta_pct":63.2,"turns_delta_pct":0,"total_cases":23,"cases_aggregated":23,"verdict":"mixed","never_hurt":true,"completed_at":"2026-07-29T03:14:41.096811+00:00","run_id":"a718f004-f845-492e-ae9f-9d8adaedefa0","version_number":1,"is_latest_version":true,"gate":null},{"model":"gemini-3.5-flash","headline":false,"delta_pts":null,"with_pass_pct":null,"without_pass_pct":null,"tokens_delta_pct":526.8,"turns_delta_pct":0,"total_cases":22,"cases_aggregated":22,"verdict":"mixed","never_hurt":true,"completed_at":"2026-07-10T11:27:04.071298+00:00","run_id":"7c79bf79-3af9-4bb9-836a-b768df02c3ad","version_number":1,"is_latest_version":true,"gate":"not_comparable"}],"trust":{"skill_safety":"passed","safety_status":"clean","intent_verdict":"safe","content_status":"clean","indexable":true},"license":null,"install_count":2,"manifest_hash":"8c3c79aecf194834785fba256e7976249a85c01496701d5fe219cfdd1ad6a530","raw_url":"https://app.decimal.ai/s/openapi-operation-conventions/SKILL.md","scorecard_url":"https://app.decimal.ai/skills/openapi-operation-conventions"}