[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6GZP7R68KQ7GDBB0XZPXGWC":3,"skill-same:01M6GZP7R68KQ7GDBB0XZPXGWC":90},{"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":16,"sourceHtmlUrl":17,"categories":18,"keywords":29,"publishedAt":48,"linkOnly":49,"markdownContent":50,"markdownBody":51,"frontMatter":52,"refName":53,"commitSha":54,"skillDirectory":55,"forksCount":56,"repositoryHtmlUrl":57,"repositoryHomepageUrl":6,"ownerHtmlUrl":58,"ownerBlogUrl":59,"ownerDescription":60,"updatedAt":61,"install":62,"resources":75},"01M6GZP7R68KQ7GDBB0XZPXGWC","read-api-docs-before-implementing",null,"Use when integrating an unfamiliar API. Read the reference for auth, pagination, rate limits, error taxonomy, and deprecations before writing the first request.","jiayaoqijia\u002Fcryptoskill","jiayaoqijia","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1453879?v=4","01M6GMYTX7Q7S504VC6E756ENR","YQ","01M6GMYV1QKJ1CC75MTTGT9PR0",80,"MIT","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fpayments\u002F0xklen-read-api-docs-before-implementing\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fpayments\u002F0xklen-read-api-docs-before-implementing\u002FSKILL.md",[19,24],{"categoryNo":20,"categoryName":21,"taxonomyType":22,"taxonomyTypeDesc":23},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":25,"categoryName":26,"taxonomyType":27,"taxonomyTypeDesc":28},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47],"docs","api","read","read api docs before implementing","implementing","when","writing","limits","request","rate","for","error","pagination","reference","use","taxonomy","first","auth","2026-11-10 10:12:30",false,"---\nname: read-api-docs-before-implementing\ndescription: Use when integrating an unfamiliar API. Read the reference for auth, pagination, rate limits, error taxonomy, and deprecations before writing the first request.\n---\n\n# Read the API docs before implementing\n\nGuessing an API's shape from one sample response produces code that breaks on page two, the\nfirst 429, or the first nullable field. Extract the contract from the reference first.\n\n## Procedure\n\n1. Pull the machine-readable spec, not just the HTML page. OpenAPI is the contract:\n   ```bash\n   curl -s \"$BASE\u002Fopenapi.json\" -o \u002Ftmp\u002Fapi.json\n   jq '.paths | keys' \u002Ftmp\u002Fapi.json\n   ```\n2. Read six sections in order and write each down: auth scheme, base URL per environment, pagination style, rate limits, error format, deprecation policy.\n3. Read pagination literally. Record cursor (`next_cursor`, opaque), offset\u002Flimit, or link-header. You cannot design the loop without this.\n4. Note the stated quota and the headers that report it (`X-RateLimit-Remaining`, `Retry-After`).\n5. Run one real example request against the sandbox before writing code:\n   ```bash\n   curl -s -H \"Authorization: Bearer $TOKEN\" \"$SANDBOX_BASE\u002Fv1\u002Fping\" | jq .\n   ```\n6. Grep the spec for `deprecated` and versioned paths (`\u002Fv1\u002F`, `\u002Fv2\u002F`) so you build on the current version.\n7. List every field not in `required` and every `nullable: true` field — those crash naive parsers.\n8. Record the docs URL and spec hash in the module docstring so the next reader knows the target contract.\n\n## Pitfalls\n\n- SDK README examples are often the oldest, not the newest; the spec is authoritative on fields.\n- \"1000\u002Fhour\" without a burst number misleads — the burst is what trips the first 429.\n- Cursor tokens are opaque: never parse, sort, or construct them. Treat as `str` only.\n- A field you saw in one response is not contract; it can vanish without a major bump.\n- A docs URL saying v2 and a spec `version: 1.0.0` can disagree; trust the spec `version`.\n\n## Verification\n\n    jq -e '.paths and .components.securitySchemes' \u002Ftmp\u002Fapi.json >\u002Fdev\u002Fnull && echo \"spec parsed\"\n\nReport the base URLs per environment, the pagination style, the stated quota, and the docs URL\u002Fhash you built against.\n","# Read the API docs before implementing\n\nGuessing an API's shape from one sample response produces code that breaks on page two, the\nfirst 429, or the first nullable field. Extract the contract from the reference first.\n\n## Procedure\n\n1. Pull the machine-readable spec, not just the HTML page. OpenAPI is the contract:\n   ```bash\n   curl -s \"$BASE\u002Fopenapi.json\" -o \u002Ftmp\u002Fapi.json\n   jq '.paths | keys' \u002Ftmp\u002Fapi.json\n   ```\n2. Read six sections in order and write each down: auth scheme, base URL per environment, pagination style, rate limits, error format, deprecation policy.\n3. Read pagination literally. Record cursor (`next_cursor`, opaque), offset\u002Flimit, or link-header. You cannot design the loop without this.\n4. Note the stated quota and the headers that report it (`X-RateLimit-Remaining`, `Retry-After`).\n5. Run one real example request against the sandbox before writing code:\n   ```bash\n   curl -s -H \"Authorization: Bearer $TOKEN\" \"$SANDBOX_BASE\u002Fv1\u002Fping\" | jq .\n   ```\n6. Grep the spec for `deprecated` and versioned paths (`\u002Fv1\u002F`, `\u002Fv2\u002F`) so you build on the current version.\n7. List every field not in `required` and every `nullable: true` field — those crash naive parsers.\n8. Record the docs URL and spec hash in the module docstring so the next reader knows the target contract.\n\n## Pitfalls\n\n- SDK README examples are often the oldest, not the newest; the spec is authoritative on fields.\n- \"1000\u002Fhour\" without a burst number misleads — the burst is what trips the first 429.\n- Cursor tokens are opaque: never parse, sort, or construct them. Treat as `str` only.\n- A field you saw in one response is not contract; it can vanish without a major bump.\n- A docs URL saying v2 and a spec `version: 1.0.0` can disagree; trust the spec `version`.\n\n## Verification\n\n    jq -e '.paths and .components.securitySchemes' \u002Ftmp\u002Fapi.json >\u002Fdev\u002Fnull && echo \"spec parsed\"\n\nReport the base URLs per environment, the pagination style, the stated quota, and the docs URL\u002Fhash you built against.\n",{"name":5,"description":7},"main","3df1d0d67b30ff15236561f8c0f9f06d33f42dfd","skills\u002Fpayments\u002F0xklen-read-api-docs-before-implementing",17,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia","https:\u002F\u002Feth2030.com","Hardcore infra. Building @alt-research and applied cryptography.","2026-11-11 08:47:40",{"source":8,"skillName":5,"commands":63,"prompt":73,"zipAvailable":74},[64,67,70],{"tool":65,"command":66},"npx","npx skills add jiayaoqijia\u002Fcryptoskill --skill read-api-docs-before-implementing",{"tool":68,"command":69},"bunx","bunx skills add jiayaoqijia\u002Fcryptoskill --skill read-api-docs-before-implementing",{"tool":71,"command":72},"pnpm","pnpm dlx skills add jiayaoqijia\u002Fcryptoskill --skill read-api-docs-before-implementing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fpayments\u002F0xklen-read-api-docs-before-implementing\u002FSKILL.md",true,[76,80,86],{"path":77,"resourceType":77,"resourceTypeDesc":78,"sizeBytes":79,"sourceHtmlUrl":16},"LICENSE","许可证",1063,{"path":81,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":84,"sourceHtmlUrl":85},"SOURCE.md","REFERENCE","参考文档",359,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fpayments\u002F0xklen-read-api-docs-before-implementing\u002FSOURCE.md",{"path":87,"resourceType":82,"resourceTypeDesc":83,"sizeBytes":88,"sourceHtmlUrl":89},"TRUST.auto.yaml",2217,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fpayments\u002F0xklen-read-api-docs-before-implementing\u002FTRUST.auto.yaml",[91,119,140,158,171,181],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":95,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":48},"01M712C436EQYE43342Q4E7GG1","recipe-performance","Diagnose a specific MetaMask user flow's real-app performance and Sentry critical-user-flow telemetry with deterministic mm-harness recipes. Use for CUF boundaries, cold\u002Fwarm\u002Fbackground-resume behavior, latency regressions, lifecycle tags, duplicate or blocking network requests, long tasks, layout\u002Fpaint cost, screen redraws, React rerenders, or browser trace analysis where tests alone cannot prove the real app.","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fwallets\u002Fmetamask-official-recipe-performance\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fwallets\u002Fmetamask-official-recipe-performance\u002FSKILL.md",[],[99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118],"performance","recipe performance","recipe","mm","sentry","harness","app","deterministic","recipes","flow","cold","critical","analysis","tasks","react","browser","layout","screen","network","metamask",{"skillNo":120,"name":121,"nameZh":6,"description":122,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":123,"licenseFileUrl":124,"sourceHtmlUrl":125,"categories":126,"keywords":127,"publishedAt":48},"01M70XT2F8A5CQZ81JBP98KSW3","mexc-spot-websocket","MEXC Spot WebSocket workflows for public streams, protobuf handling, depth maintenance, listen keys, and private streams without exposing API keys.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fexchanges\u002Fmncrftfrcnm-mexc-spot-websocket\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fexchanges\u002Fmncrftfrcnm-mexc-spot-websocket\u002FSKILL.md",[],[128,129,130,31,131,132,133,134,135,136,40,137,138,139],"mexc spot websocket","spot","websocket","workflows","public","listen","streams","depth","keys","api keys","maintenance","protobuf",{"skillNo":141,"name":142,"nameZh":6,"description":143,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":123,"licenseFileUrl":144,"sourceHtmlUrl":145,"categories":146,"keywords":147,"publishedAt":48},"01M70XT0MBXN3WZY1BKN0CPNKR","mexc-spot-rest","MEXC Spot REST workflows for public data, signed account requests, orders, wallet\u002Fadmin actions, and secure signing without exposing API keys.","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fexchanges\u002Fmncrftfrcnm-mexc-spot-rest\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fexchanges\u002Fmncrftfrcnm-mexc-spot-rest\u002FSKILL.md",[],[148,129,149,150,151,152,153,137,40,136,154,155,156,132,157,131,31],"mexc spot rest","REST","admin","signing","Wallet","requests","actions","secure","data","orders",{"skillNo":159,"name":160,"nameZh":6,"description":161,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":123,"licenseFileUrl":162,"sourceHtmlUrl":163,"categories":164,"keywords":165,"publishedAt":48},"01M70XSYSVZ2N0N91XCAR2CAK0","mexc-futures-websocket","MEXC Futures WebSocket workflows for public streams, private account\u002Forder\u002Fposition streams, ping\u002Fpong, subscriptions, and depth maintenance.","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fexchanges\u002Fmncrftfrcnm-mexc-futures-websocket\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fexchanges\u002Fmncrftfrcnm-mexc-futures-websocket\u002FSKILL.md",[],[166,167,130,168,169,138,40,170,135,134,132,131],"mexc futures websocket","futures","position","ping","subscriptions",{"skillNo":172,"name":173,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":174,"sourceHtmlUrl":175,"categories":176,"keywords":177,"publishedAt":48},"01M6H0ZWHVE5W04WG2DKQE2SQC","0xklen-version-and-refresh-sanctions-lists","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fpayments\u002F0xklen-version-and-refresh-sanctions-lists\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fpayments\u002F0xklen-version-and-refresh-sanctions-lists\u002FSKILL.md",[],[178,179,180],"refresh","0xklen version and refresh sanctions lists","version",{"skillNo":182,"name":183,"nameZh":6,"description":184,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":185,"sourceHtmlUrl":186,"categories":187,"keywords":188,"publishedAt":48},"01M6H0Z28Q3R8J0S799GJQWXM3","verify-tests-cover-changed-lines","Use when a PR adds code that the existing suite may not exercise. Measures patch coverage — the share of newly changed lines hit by tests — before approving.","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fpayments\u002F0xklen-verify-tests-cover-changed-lines\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fpayments\u002F0xklen-verify-tests-cover-changed-lines\u002FSKILL.md",[],[189,190,191,192,193,194,195,44,196,197,198],"tests","cover","verify tests cover changed lines","verify","coverage","pr","exercise","patch","code","share"]