[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EMAC0GV7J2P2BGZKBWB3D0":3,"skill-same:01M7EMAC0GV7J2P2BGZKBWB3D0":45},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7EMAC0GV7J2P2BGZKBWB3D0","ams-api-integration-specialist",null,"TanNhatCMS\u002Fjarvis","TanNhatCMS","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F113796420?v=4","01M753MV17KG5CD3152G3WQEQY","KietNT","01M7EKEDYVYQ6PWVJJMZ911VMX",0,"MIT","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-api-integration-specialist\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: api-integration-specialist\ndescription: Integrate third-party APIs reliably: auth, pagination, retries, webhooks, rate limits, and contract testing. Use when connecting to external REST\u002FGraphQL APIs or building resilient API clients.\ncategory: development\n---\n\n# API Integration Specialist\n\n## Overview\n\nIntegrating a third-party API looks easy in the docs and gets hard in production: auth token\nexpiry, rate limits, flaky endpoints, silently changing schemas, and webhooks that arrive twice —\nor never. This skill is the discipline of **treating external APIs as hostile dependencies**:\nwrap them in a client layer with retries, timeouts, and observability; verify webhooks; version\nyour assumptions; and degrade gracefully when the provider has a bad day.\n\nThe through-line: their uptime is not your uptime. Design for their failure.\n\n## When to use\n\n- Integrating a new third-party REST or GraphQL API (payments, CRM, email, maps, etc.).\n- Building webhook receivers (signature verification, idempotency, ordering).\n- Debugging flaky integrations, rate-limit errors, or auth failures.\n- Reviewing integration code for resilience gaps.\n- Planning for a provider outage or migration between providers.\n\n## Core concepts\n\n- **Client wrapper, not scattered calls.** All interaction with a provider lives in one module:\n  auth, base URL, headers, serialization, error mapping. Scattered `fetch` calls to a provider\n  across the codebase guarantee inconsistent handling.\n- **Auth lifecycle.** Tokens expire — handle refresh proactively (refresh before expiry, single\n  refresh under concurrency via lock), store secrets in a secret manager, and never log tokens.\n  Prefer OAuth with refresh tokens or API keys with rotation over long-lived static secrets.\n- **Resilience primitives.** Every outbound call gets: timeout (connect + total), retries with\n  exponential backoff + jitter (only for idempotent\u002Fsafe operations), and a circuit breaker for\n  sustained failure. Map provider errors to your domain errors (`RateLimited`, `AuthFailed`,\n  `NotFound`, `ProviderDown`).\n- **Rate limits as a budget.** Track quota usage (headers like `X-RateLimit-Remaining`), queue\n  and pace non-urgent calls, and prioritize: user-facing sync calls first, background sync last.\n  Hitting 429s in production means you didn't plan the budget.\n- **Webhooks: verify, dedupe, acknowledge fast.** Verify signatures with the provider's secret\n  (constant-time compare); handle duplicates via idempotency keys (providers retry); respond 200\n  *before* doing slow work (queue it); tolerate out-of-order delivery.\n- **Contract vigilance.** Providers change schemas without telling you. Validate responses against\n  expected shapes (fail loudly on unexpected changes in staging), pin API versions via headers\n  when supported, and monitor for new error codes or deprecated fields.\n\n## Practical workflow\n\n1. **Read the docs skeptically.** Note: auth flow, rate limits (per key? per endpoint?), pagination\n   style, webhook guarantees (ordering? retries? signing?), error code catalog, and versioning policy.\n2. **Build the client layer.** One module: configured HTTP client with timeouts, auth injection +\n   refresh, retry policy, error mapping, request\u002Fresponse logging (redacted), and metrics\n   (latency, error rate per endpoint).\n3. **Implement pagination correctly.** Follow cursors, not page numbers, when available; handle\n   empty pages and duplicates; back off when approaching rate limits; make full syncs resumable.\n4. **Build the webhook receiver.** Signature verification → idempotency check → 200 OK → enqueue\n   work. Test with the provider's replay\u002Ffixture tools; simulate duplicates and out-of-order events.\n5. **Add contract tests.** Record real (sanitized) responses as fixtures; run them in CI to catch\n   drift. Alert on unexpected response shapes in production (sampled validation).\n6. **Plan the outage.** Feature-flag the integration; define degraded behavior (queue work, show\n   cached data, disable the feature cleanly); document the runbook: how to detect provider issues,\n   who to contact, how to fail over.\n\nResilient client sketch (pseudocode):\n\n```text\nclient = HttpClient(timeout=10s, retries=3 with jittered backoff on 429\u002F5xx GETs)\nclient.on_auth_expired -> refresh_token(singleflight) -> retry once\nevery call:\n  - inject auth header (from secret manager, never logged)\n  - map status -> domain error (401 AuthFailed, 429 RateLimited(retry_after), 5xx ProviderDown)\n  - emit metrics: provider.latency, provider.errors{endpoint, code}\n  - circuit breaker: open after N failures in window, probe with single request\n```\n\n## Common pitfalls\n\n- **No timeouts.** A hung provider call holding your request thread is how one slow dependency\n  takes down your whole service. Every call gets a deadline.\n- **Retrying non-idempotent operations.** Retrying a `POST \u002Fcharges` without an idempotency key\n  double-charges customers. Retry only safe methods, or send idempotency keys on mutating calls.\n- **Trusting webhook payloads.** Processing webhooks without signature verification lets anyone\n  forge events. Verify first, always — and still treat the payload as untrusted input.\n- **Synchronous dependence on slow providers.** Doing a 2-second provider call inside your\n  request path. If the user doesn't need the result now, queue it.\n- **Hardcoding provider specifics everywhere.** Provider field names and error codes scattered\n  through business logic make migration hell. The wrapper translates; the app speaks domain language.\n- **Ignoring pagination edge cases.** Assuming page numbers are stable, or that \"last page\" means\n  what you think during concurrent writes. Cursors + dedup by ID.\n- **No plan for provider downtime.** Discovering during their outage that your checkout hard-fails\n  when the address-validation API is down. Every integration needs a degraded mode, decided in\n  advance — not invented during the incident.\n","# API Integration Specialist\n\n## Overview\n\nIntegrating a third-party API looks easy in the docs and gets hard in production: auth token\nexpiry, rate limits, flaky endpoints, silently changing schemas, and webhooks that arrive twice —\nor never. This skill is the discipline of **treating external APIs as hostile dependencies**:\nwrap them in a client layer with retries, timeouts, and observability; verify webhooks; version\nyour assumptions; and degrade gracefully when the provider has a bad day.\n\nThe through-line: their uptime is not your uptime. Design for their failure.\n\n## When to use\n\n- Integrating a new third-party REST or GraphQL API (payments, CRM, email, maps, etc.).\n- Building webhook receivers (signature verification, idempotency, ordering).\n- Debugging flaky integrations, rate-limit errors, or auth failures.\n- Reviewing integration code for resilience gaps.\n- Planning for a provider outage or migration between providers.\n\n## Core concepts\n\n- **Client wrapper, not scattered calls.** All interaction with a provider lives in one module:\n  auth, base URL, headers, serialization, error mapping. Scattered `fetch` calls to a provider\n  across the codebase guarantee inconsistent handling.\n- **Auth lifecycle.** Tokens expire — handle refresh proactively (refresh before expiry, single\n  refresh under concurrency via lock), store secrets in a secret manager, and never log tokens.\n  Prefer OAuth with refresh tokens or API keys with rotation over long-lived static secrets.\n- **Resilience primitives.** Every outbound call gets: timeout (connect + total), retries with\n  exponential backoff + jitter (only for idempotent\u002Fsafe operations), and a circuit breaker for\n  sustained failure. Map provider errors to your domain errors (`RateLimited`, `AuthFailed`,\n  `NotFound`, `ProviderDown`).\n- **Rate limits as a budget.** Track quota usage (headers like `X-RateLimit-Remaining`), queue\n  and pace non-urgent calls, and prioritize: user-facing sync calls first, background sync last.\n  Hitting 429s in production means you didn't plan the budget.\n- **Webhooks: verify, dedupe, acknowledge fast.** Verify signatures with the provider's secret\n  (constant-time compare); handle duplicates via idempotency keys (providers retry); respond 200\n  *before* doing slow work (queue it); tolerate out-of-order delivery.\n- **Contract vigilance.** Providers change schemas without telling you. Validate responses against\n  expected shapes (fail loudly on unexpected changes in staging), pin API versions via headers\n  when supported, and monitor for new error codes or deprecated fields.\n\n## Practical workflow\n\n1. **Read the docs skeptically.** Note: auth flow, rate limits (per key? per endpoint?), pagination\n   style, webhook guarantees (ordering? retries? signing?), error code catalog, and versioning policy.\n2. **Build the client layer.** One module: configured HTTP client with timeouts, auth injection +\n   refresh, retry policy, error mapping, request\u002Fresponse logging (redacted), and metrics\n   (latency, error rate per endpoint).\n3. **Implement pagination correctly.** Follow cursors, not page numbers, when available; handle\n   empty pages and duplicates; back off when approaching rate limits; make full syncs resumable.\n4. **Build the webhook receiver.** Signature verification → idempotency check → 200 OK → enqueue\n   work. Test with the provider's replay\u002Ffixture tools; simulate duplicates and out-of-order events.\n5. **Add contract tests.** Record real (sanitized) responses as fixtures; run them in CI to catch\n   drift. Alert on unexpected response shapes in production (sampled validation).\n6. **Plan the outage.** Feature-flag the integration; define degraded behavior (queue work, show\n   cached data, disable the feature cleanly); document the runbook: how to detect provider issues,\n   who to contact, how to fail over.\n\nResilient client sketch (pseudocode):\n\n```text\nclient = HttpClient(timeout=10s, retries=3 with jittered backoff on 429\u002F5xx GETs)\nclient.on_auth_expired -> refresh_token(singleflight) -> retry once\nevery call:\n  - inject auth header (from secret manager, never logged)\n  - map status -> domain error (401 AuthFailed, 429 RateLimited(retry_after), 5xx ProviderDown)\n  - emit metrics: provider.latency, provider.errors{endpoint, code}\n  - circuit breaker: open after N failures in window, probe with single request\n```\n\n## Common pitfalls\n\n- **No timeouts.** A hung provider call holding your request thread is how one slow dependency\n  takes down your whole service. Every call gets a deadline.\n- **Retrying non-idempotent operations.** Retrying a `POST \u002Fcharges` without an idempotency key\n  double-charges customers. Retry only safe methods, or send idempotency keys on mutating calls.\n- **Trusting webhook payloads.** Processing webhooks without signature verification lets anyone\n  forge events. Verify first, always — and still treat the payload as untrusted input.\n- **Synchronous dependence on slow providers.** Doing a 2-second provider call inside your\n  request path. If the user doesn't need the result now, queue it.\n- **Hardcoding provider specifics everywhere.** Provider field names and error codes scattered\n  through business logic make migration hell. The wrapper translates; the app speaks domain language.\n- **Ignoring pagination edge cases.** Assuming page numbers are stable, or that \"last page\" means\n  what you think during concurrent writes. Cursors + dedup by ID.\n- **No plan for provider downtime.** Discovering during their outage that your checkout hard-fails\n  when the address-validation API is down. Every integration needs a degraded mode, decided in\n  advance — not invented during the incident.\n",{},"main","af388a77c2fe5e0b4fd879cca4300a0ffa9a6579","skills\u002Fams-api-integration-specialist",1,"https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis","https:\u002F\u002Fgithub.com\u002FTanNhatCMS","https:\u002F\u002Fmrkiet.name.vn","2026-11-07 14:23:08",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add TanNhatCMS\u002Fjarvis --skill ams-api-integration-specialist",{"tool":37,"command":38},"bunx","bunx skills add TanNhatCMS\u002Fjarvis --skill ams-api-integration-specialist",{"tool":40,"command":41},"pnpm","pnpm dlx skills add TanNhatCMS\u002Fjarvis --skill ams-api-integration-specialist","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fams-api-integration-specialist\u002FSKILL.md",true,[],[46,53,61,68,75,82],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":18},"01M7EWYJR0J8DARY7E59Z6Y9MV","web-scrape","Turn web pages into LLM-ready markdown via the Firecrawl API (renders JS, anti-bot handling). Use when browser_open\u002Ffetch fails on JS-heavy pages, or when you need clean markdown\u002Fstructured extraction from a site. Requires FIRECRAWL_API_KEY.","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fweb-scrape\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":57,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":18},"01M7EWYBN5P6F2AJG3FR24T9BP","design-taste-frontend","tasteskill v2, the anti-slop frontend skill. Art direction for websites, distilled from a study of 247 curated gallery sites (One Page Love, Awwwards Sites of the Day). Deals researched directions (idea, composition, type, palette, photographs, section blueprints) from a library, enforces a strict no-slop house style with a real-browser inspector, and runs a look-and-fix loop on screenshots. Use this whenever you build, design, redesign, restyle, polish or review a landing page, marketing site, portfolio, product page, one-pager, hero or any public-facing web page, in any stack (HTML\u002FCSS, React, Next.js, Vue, Svelte, Astro, Tailwind) — also when the user says a page looks generic, templated, \"AI-made\", sloppy, or asks to make it look designed, premium, award-level or less like every other site. Not for dashboards or app screens.","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Ftaste-design\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Ftaste-design\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7EWY8FQFNQ2GB7NZZWGSSDX","test-driven-development","Use when implementing any feature or bugfix, before writing implementation code","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-tdd\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M7EWY5SHBFRH1HDHVWM9K7TV","systematic-debugging","Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-debugging\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M7EWY3NM0Z0JAKS7HDZ24K66","requesting-code-review","Use when completing tasks, implementing major features, or before merging to verify work meets requirements","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-code-review\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M7EWY0WRMWX4M9ZFY0WKC593","brainstorming","You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).","https:\u002F\u002Fgithub.com\u002FTanNhatCMS\u002Fjarvis\u002Fblob\u002Fmain\u002Fskills\u002Fsuperpowers-brainstorming\u002FSKILL.md",[],[]]