Skip to content

aouellets/api-integration-engineering

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

API & Integration Engineering

For backend engineers: make every API you build or consume survive production. — built in-house by Skill Me.

Reach for this when an integration has to be bulletproof — payments that can't double-charge, webhooks you don't control, third-party APIs that throttle or fall over, and contracts that change under you. It turns the hard-won production patterns into skills: idempotent writes, hardened webhook receivers, correct backoff under rate limits, circuit breakers and bulkheads for flaky upstreams, cursor pagination and delta sync, typed clients from OpenAPI, and date-pinned versioning with a real deprecation path. Install it before the integration that, if it breaks, pages you at 3am.

If this is useful, star the repo — it's how we gauge what to build next.

Install

  • From the catalog: skillme.dev/pack/api-integration-engineering — install the whole pack into Claude in one step.
  • With the skills CLI: npx skills add aouellets/api-integration-engineering
  • Manually: copy any skills/<slug>/SKILL.md into your Claude skills directory.

Skills in this pack

  • Idempotency Enforcer — Adds client-supplied idempotency keys and request deduplication so at-least-once delivery and client retries return the first result instead of double-charging or double-shipping.
  • Webhook Receiver Hardener — Hardens an inbound webhook endpoint so it verifies the sender signature on the raw body, resists replays, and acknowledges fast by persisting-then-enqueueing before any processing.
  • Rate Limit Handler — Adds retry-with-backoff, Retry-After handling, and client-side throttling so a caller stays under an upstream API's rate limits instead of hammering it.
  • Circuit Breaker Builder — Wraps flaky upstream dependencies in circuit breakers, aggressive timeouts, and per-dependency bulkheads so a slow or failing service degrades gracefully instead of cascading into a full outage.
  • API Versioning Strategist — Produces an API version scheme (date-pinned header or URI), a breaking-vs-additive change policy, and a published deprecation/sunset timeline with translation shims.
  • Pagination and Sync Engineer — Build correct cursor pagination and incremental delta sync against a paginated API, handling inserts, deletes, watermarks, resumability, and idempotency.
  • API Client Generator — Generates a typed API client from an OpenAPI/Swagger spec, with a hand-controlled transport wrapper for timeouts, auth, and typed errors.
  • REST API Design — Designs RESTful APIs with consistent naming, versioning, error codes, and OpenAPI documentation.
  • OAuth & Auth Flow — Implements OAuth 2.0, JWT, and session auth correctly with security best practices. (external — see source)

License

MIT — see LICENSE. Skills are portable SKILL.md files; the canonical copies live in the Skill Me catalog.

About

Ship integrations that survive retries, rate limits, and breaking changes.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors