[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74F5EHVP0P66X9MS9D2J0EP":3,"skill-same:01M74F5EHVP0P66X9MS9D2J0EP":52},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M74F5EHVP0P66X9MS9D2J0EP","openapi-first",null,"Generate API code, types, validators, mock servers, and client SDKs from a single OpenAPI 3.1 specification. Use whenever building or modifying an HTTP API endpoint. The OpenAPI doc is source of truth - drift between doc and code is a contract violation caught by tests. Triggers on requests involving REST endpoints, API design, or client\u002Fserver contracts.","MILTONADINA\u002FDevOPs","MILTONADINA","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F106546372?v=4","01M74F3R2PP4Z04DQMMBHSQAT1","Milton Adina","01M74F3R3CHTKPXJV4RP7RR3W8",0,"MIT","https:\u002F\u002Fgithub.com\u002FMILTONADINA\u002FDevOPs\u002Fblob\u002Fmain\u002Fskills\u002Funiversal\u002Fdevelopment\u002Fopenapi-first\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: openapi-first\ndescription: Generate API code, types, validators, mock servers, and client SDKs from a single OpenAPI 3.1 specification. Use whenever building or modifying an HTTP API endpoint. The OpenAPI doc is source of truth - drift between doc and code is a contract violation caught by tests. Triggers on requests involving REST endpoints, API design, or client\u002Fserver contracts.\n---\n\n# OpenAPI First\n\n> The API contract is the source of truth. Code derives from it, not the other\n> way around.\n\n**Tradeoff:** Adds an upfront OpenAPI authoring step. Worth it: free types,\nfree validators, free client SDKs, free mocks, and contract testing comes for\nfree.\n\n---\n\n## When to invoke\n\n- New API endpoint requested\n- Existing endpoint being modified (request\u002Fresponse shape changes)\n- Client SDK needed for an existing API\n- Migration from undocumented API to documented\n\n---\n\n## Workflow\n\n1. **Write or update the OpenAPI 3.1 spec** at `openapi\u002F\u003Cservice>.yml`.\n2. **Generate types** for both server and client.\n3. **Generate validators** so runtime requests are checked against the schema.\n4. **Implement the handler** to satisfy the spec (the test is \"the\n   schema-validator passes against real requests\u002Fresponses\").\n5. **Generate the mock server** for frontend development.\n6. **Add a contract test** that exercises every operation against the spec.\n\n---\n\n## Recommended tooling (TypeScript)\n\n- **`openapi-typescript`** — type generation\n- **`zod-openapi`** or **`@asteasolutions\u002Fzod-to-openapi`** — write schemas in\n  Zod, derive OpenAPI from them\n- **`@hono\u002Fzod-openapi`** or **`fastify-openapi-glue`** — server framework\n  integration\n- **`orval`** or **`@kubb\u002Fswagger-client`** — typed client SDK generation\n- **`@stoplight\u002Fprism`** — mock server\n- **`schemathesis`** or **`dredd`** — contract testing\n\n---\n\n## For Python (FastAPI)\n\nFastAPI generates OpenAPI from typed handlers — the spec is derived from code.\nThis works in reverse to \"OpenAPI first.\" If you have an existing FastAPI app,\ntreat its `\u002Fopenapi.json` output as authoritative and treat the docs export as\nthe canonical spec for client generation.\n\n---\n\n## For Rust\n\n- **`utoipa`** — Rust code annotations generate OpenAPI\n- **`paperclip`** — alternative annotation-based generator\n- **`progenitor`** — generate Rust client from OpenAPI\n\n---\n\n## Quality gates\n\nA change is done when all five hold:\n\n1. The OpenAPI spec validates against the OpenAPI 3.1 schema.\n2. `spectral lint openapi\u002F\u003Cservice>.yml` passes with the default ruleset\n   (extend with `.spectral.yaml` for project rules).\n3. Generated types are checked into the repo and re-generated by CI on\n   schema changes. Drift = build failure.\n4. Contract tests run on every PR.\n5. `oasdiff` detects breaking changes, and a breaking change requires a major\n   version bump.\n\n---\n\n## Anti-patterns\n\n**Hand-writing types after the schema**: defeats the purpose. Always generate.\n\n**Schema-after**: writing the handler and then describing it in OpenAPI. Don't.\nThe schema is the design artifact.\n\n**Optional everywhere**: if a field is always required in practice, mark it\nrequired. Schema laxity becomes runtime errors.\n\n**Missing error responses**: every operation should document 4xx and 5xx\nresponses with `Problem Details` (RFC 9457) bodies.\n\n**No versioning strategy**: pick header-based (`Accept: application\u002Fvnd.api+json;\nversion=2`) or path-based (`\u002Fv2\u002F`) and stick to it.\n\n---\n\n## Worked example\n\n`openapi\u002Fauth.yml`:\n```yaml\nopenapi: 3.1.0\ninfo:\n  title: Auth Service\n  version: 1.0.0\npaths:\n  \u002Fauth\u002Freset:\n    post:\n      operationId: requestPasswordReset\n      requestBody:\n        required: true\n        content:\n          application\u002Fjson:\n            schema:\n              $ref: '#\u002Fcomponents\u002Fschemas\u002FResetRequest'\n      responses:\n        '200':\n          description: Reset link sent\n        '422':\n          description: Invalid email\n          content:\n            application\u002Fproblem+json:\n              schema: { $ref: '#\u002Fcomponents\u002Fschemas\u002FProblem' }\n        '429':\n          description: Rate limited\ncomponents:\n  schemas:\n    ResetRequest:\n      type: object\n      required: [email]\n      properties:\n        email: { type: string, format: email, maxLength: 320 }\n    Problem:\n      type: object\n      properties:\n        type: { type: string, format: uri }\n        title: { type: string }\n        status: { type: integer }\n        detail: { type: string }\n```\n\nGenerated code provides:\n- Server handler type signature\n- Client SDK method `client.requestPasswordReset({ email })`\n- Mock server endpoint\n- Contract test for valid + invalid inputs\n\n---\n\n**This skill is working when:** every API endpoint in the project is described\nin OpenAPI, every type is generated (not hand-written), and contract tests run\non every PR. The intended record is\n`governance\u002Ftelemetry\u002Fopenapi-coverage.jsonl`. Nothing writes it yet, so check by hand.\n","# OpenAPI First\n\n> The API contract is the source of truth. Code derives from it, not the other\n> way around.\n\n**Tradeoff:** Adds an upfront OpenAPI authoring step. Worth it: free types,\nfree validators, free client SDKs, free mocks, and contract testing comes for\nfree.\n\n---\n\n## When to invoke\n\n- New API endpoint requested\n- Existing endpoint being modified (request\u002Fresponse shape changes)\n- Client SDK needed for an existing API\n- Migration from undocumented API to documented\n\n---\n\n## Workflow\n\n1. **Write or update the OpenAPI 3.1 spec** at `openapi\u002F\u003Cservice>.yml`.\n2. **Generate types** for both server and client.\n3. **Generate validators** so runtime requests are checked against the schema.\n4. **Implement the handler** to satisfy the spec (the test is \"the\n   schema-validator passes against real requests\u002Fresponses\").\n5. **Generate the mock server** for frontend development.\n6. **Add a contract test** that exercises every operation against the spec.\n\n---\n\n## Recommended tooling (TypeScript)\n\n- **`openapi-typescript`** — type generation\n- **`zod-openapi`** or **`@asteasolutions\u002Fzod-to-openapi`** — write schemas in\n  Zod, derive OpenAPI from them\n- **`@hono\u002Fzod-openapi`** or **`fastify-openapi-glue`** — server framework\n  integration\n- **`orval`** or **`@kubb\u002Fswagger-client`** — typed client SDK generation\n- **`@stoplight\u002Fprism`** — mock server\n- **`schemathesis`** or **`dredd`** — contract testing\n\n---\n\n## For Python (FastAPI)\n\nFastAPI generates OpenAPI from typed handlers — the spec is derived from code.\nThis works in reverse to \"OpenAPI first.\" If you have an existing FastAPI app,\ntreat its `\u002Fopenapi.json` output as authoritative and treat the docs export as\nthe canonical spec for client generation.\n\n---\n\n## For Rust\n\n- **`utoipa`** — Rust code annotations generate OpenAPI\n- **`paperclip`** — alternative annotation-based generator\n- **`progenitor`** — generate Rust client from OpenAPI\n\n---\n\n## Quality gates\n\nA change is done when all five hold:\n\n1. The OpenAPI spec validates against the OpenAPI 3.1 schema.\n2. `spectral lint openapi\u002F\u003Cservice>.yml` passes with the default ruleset\n   (extend with `.spectral.yaml` for project rules).\n3. Generated types are checked into the repo and re-generated by CI on\n   schema changes. Drift = build failure.\n4. Contract tests run on every PR.\n5. `oasdiff` detects breaking changes, and a breaking change requires a major\n   version bump.\n\n---\n\n## Anti-patterns\n\n**Hand-writing types after the schema**: defeats the purpose. Always generate.\n\n**Schema-after**: writing the handler and then describing it in OpenAPI. Don't.\nThe schema is the design artifact.\n\n**Optional everywhere**: if a field is always required in practice, mark it\nrequired. Schema laxity becomes runtime errors.\n\n**Missing error responses**: every operation should document 4xx and 5xx\nresponses with `Problem Details` (RFC 9457) bodies.\n\n**No versioning strategy**: pick header-based (`Accept: application\u002Fvnd.api+json;\nversion=2`) or path-based (`\u002Fv2\u002F`) and stick to it.\n\n---\n\n## Worked example\n\n`openapi\u002Fauth.yml`:\n```yaml\nopenapi: 3.1.0\ninfo:\n  title: Auth Service\n  version: 1.0.0\npaths:\n  \u002Fauth\u002Freset:\n    post:\n      operationId: requestPasswordReset\n      requestBody:\n        required: true\n        content:\n          application\u002Fjson:\n            schema:\n              $ref: '#\u002Fcomponents\u002Fschemas\u002FResetRequest'\n      responses:\n        '200':\n          description: Reset link sent\n        '422':\n          description: Invalid email\n          content:\n            application\u002Fproblem+json:\n              schema: { $ref: '#\u002Fcomponents\u002Fschemas\u002FProblem' }\n        '429':\n          description: Rate limited\ncomponents:\n  schemas:\n    ResetRequest:\n      type: object\n      required: [email]\n      properties:\n        email: { type: string, format: email, maxLength: 320 }\n    Problem:\n      type: object\n      properties:\n        type: { type: string, format: uri }\n        title: { type: string }\n        status: { type: integer }\n        detail: { type: string }\n```\n\nGenerated code provides:\n- Server handler type signature\n- Client SDK method `client.requestPasswordReset({ email })`\n- Mock server endpoint\n- Contract test for valid + invalid inputs\n\n---\n\n**This skill is working when:** every API endpoint in the project is described\nin OpenAPI, every type is generated (not hand-written), and contract tests run\non every PR. The intended record is\n`governance\u002Ftelemetry\u002Fopenapi-coverage.jsonl`. Nothing writes it yet, so check by hand.\n",{"name":5,"description":7},"main","5a590e92c8f62b54c96a6928215ac2145b671e03","skills\u002Funiversal\u002Fdevelopment\u002Fopenapi-first","https:\u002F\u002Fgithub.com\u002FMILTONADINA\u002FDevOPs","https:\u002F\u002Fgithub.com\u002FMILTONADINA","https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Fmiltonadina","CS\u002FCybersecurity SWE & former Epidemiologist. Building secure, test-driven full-stack & mobile apps (TS\u002FReact\u002FNode, Java\u002FSpring, Flutter).","2026-11-14 20:03:36",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add MILTONADINA\u002FDevOPs --skill openapi-first",{"tool":38,"command":39},"bunx","bunx skills add MILTONADINA\u002FDevOPs --skill openapi-first",{"tool":41,"command":42},"pnpm","pnpm dlx skills add MILTONADINA\u002FDevOPs --skill openapi-first","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMILTONADINA\u002FDevOPs\u002Fblob\u002Fmain\u002Fskills\u002Funiversal\u002Fdevelopment\u002Fopenapi-first\u002FSKILL.md",true,[46],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"SKILL.md.bundle","OTHER","其他",9647,"https:\u002F\u002Fgithub.com\u002FMILTONADINA\u002FDevOPs\u002Fblob\u002Fmain\u002Fskills\u002Funiversal\u002Fdevelopment\u002Fopenapi-first\u002FSKILL.md.bundle",[53,60,67,74,79,86],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M74F7F3HN6J7CSFHBVQAE9S5","karpathy-guidelines","Behavioral guidelines that reduce common LLM coding mistakes. Apply whenever writing, modifying, or reviewing code. Don't assume requirements, don't overcomplicate, don't refactor unrelated code, and define success criteria before implementing. Use this skill on every non-trivial coding task to avoid bloat, silent assumptions, and completion-bias.","https:\u002F\u002Fgithub.com\u002FMILTONADINA\u002FDevOPs\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fsecurity\u002Fmodified-skill\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M74F7D60N9FRWWWHCGZMMB41","unsigned-missing-sig-fixture","Test fixture (F.09) — SKILL.md without an accompanying .sig file. Default install rejects with exit 2; --allow-unsigned --rationale=\"...\" proceeds.","https:\u002F\u002Fgithub.com\u002FMILTONADINA\u002FDevOPs\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finstall\u002Fsource-skills\u002Funsigned-missing-sig\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M74F7BKGX67Q606QPKZV7TQV","unsigned-mismatched-sig-fixture","Test fixture (F.09) — SKILL.md whose accompanying .sig signs different content. NFR-F3 hash check catches this even with --allow-unsigned.","https:\u002F\u002Fgithub.com\u002FMILTONADINA\u002FDevOPs\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finstall\u002Fsource-skills\u002Funsigned-mismatched-sig\u002FSKILL.md",[],[],{"skillNo":75,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M74F793BYMX98EQC5XP4CDZK","https:\u002F\u002Fgithub.com\u002FMILTONADINA\u002FDevOPs\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finstall\u002Fsource-skills\u002Fsigned\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M74F7481EBD7G5471ZC4S9YB","webhook-idempotency","Defend against double-processing of webhook events across every provider (Stripe, GitHub, Slack, Twilio, SendGrid). Idempotency-key pattern + replay-window enforcement + dedupe-storage strategy. Triggers on any webhook handler authoring (route matching \u002Fwebhook(s)?\u002F, Stripe-Signature \u002F X-Hub-Signature-256 header references). Defense against OWASP ASI02 (Tool Misuse) -- a replayed webhook that re-triggers a destructive tool is the canonical control-flow-level replay attack. Universal across providers; stack-specific signature verification lives in stack-specific skills.","https:\u002F\u002Fgithub.com\u002FMILTONADINA\u002FDevOPs\u002Fblob\u002Fmain\u002Fskills\u002Funiversal\u002Fsecurity\u002Fwebhook-idempotency\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M74F71Q6JKRFJ66G5T98KE8H","semgrep-scan","Run Semgrep static analysis to detect insecure code patterns - SQL injection, XSS, path traversal, weak crypto, broken auth, OWASP Top 10 issues. Use on every file change touching security-sensitive code and as part of the tiered security gate. Complements gitleaks (which catches secrets) by catching insecure logic.","https:\u002F\u002Fgithub.com\u002FMILTONADINA\u002FDevOPs\u002Fblob\u002Fmain\u002Fskills\u002Funiversal\u002Fsecurity\u002Fsemgrep-scan\u002FSKILL.md",[],[]]