agentsclimarketplace

Mobile api integration

Skill ahtishamshahzad/agent_dev_flow/.ai/skills/mobile/mobile-api-integration

Tool-neutral AI Engineering System: 174 reusable skills (installable as Claude Code plugins) for planning and building software with AI agents. Classify → plan → approve → build under quality gates. Works with Claude Code, Codex, Cursor, Windsurf, Copilot & Antigravity. Canonical in .ai/.

Install
npx -y skills add ahtishamshahzad/agent_dev_flow --skill mobile-api-integration

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • 21 days oldThe repository was created 21 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use to plan the HTTP transport layer — fetch vs Axios, base client, interceptors, auth headers, error mapping, and timeouts. Underpins server-state; does not itself cache.

SKILL.md

3.2 KB, 663 tokens by cl100k_base, as published. Nobody here has run it

Mobile API Integration

Purpose

Plan the API client: choose fetch or Axios, build a base client with auth headers, interceptors, timeouts, and error mapping — the transport that mobile-server-state caches over.

When to Use

  • When the app talks to a backend/API.
  • Not for caching concerns (that's mobile-server-state).

Inputs

  • API base URLs/environments (mobile-environment-config).
  • Auth token model (mobile-authentication).

Discovery Questions

  • fetch or Axios (interceptors, cancellation, ergonomics)?
  • How are auth tokens attached and refreshed?
  • What are the timeout/retry and error-mapping needs?
  • How do environments (dev/staging/prod) switch base URLs?

Responsibilities

  • Choose fetch or Axios with justification.
  • Build a base client: base URL from env, headers, timeouts.
  • Add interceptors for auth token attach/refresh and error mapping.
  • Handle cancellation and network failures; hand caching to mobile-server-state.

Required Workflow

  1. Confirm API surface + environments + auth model.
  2. Choose fetch/Axios.
  3. Build the base client + interceptors + error mapping.
  4. Wire env-based base URLs.
  5. Record the transport plan.

Decision Rules

  • Axios eases interceptors/cancellation; fetch is dependency-free — choose by need, not habit.
  • Base URLs come from env config, never hard-coded.
  • Auth token attach/refresh lives in one place (interceptor), not per call.
  • Transport maps errors to a consistent shape; caching is separate.

Rules

  • No hard-coded base URLs or secrets (mobile-environment-config).
  • Attach auth centrally; coordinate refresh with mobile-authentication.
  • Do not implement caching here — that's server-state.

Anti-Patterns

  • Per-call ad-hoc fetch with duplicated headers.
  • Hard-coded URLs/keys in client code.
  • Swallowing errors without mapping.
  • Reimplementing caching in the transport.

Validation Checklist

  • fetch/Axios chosen + justified.
  • Base client with env base URL + timeouts.
  • Auth attach/refresh centralized.
  • Consistent error mapping.
  • Cancellation/network handling planned.

Definition of Done

A recorded transport plan: chosen client, env-driven base client with centralized auth and error mapping, cancellation/network handling — leaving caching to server-state.

Related Skills

mobile-server-state, mobile-authentication, mobile-environment-config, mobile-error-handling, mobile-secure-storage

Related Knowledge

../../../knowledge/ (API contracts).

Related References

../../../references/mobile/state/ when populated.

Context Loading Guidance

  • Requires: API base URLs/environments, auth token model.
  • Does not require: the whole app source, unrelated references, every mobile skill.
  • May load: mobile-authentication, mobile-environment-config.
  • Stop when: the transport plan is recorded.

Token Efficiency Guidance

Plan the client and interceptors only; delegate caching and env detail to their skills.

Gives 0 of the 12 instructions most apis services skills give in 663 tokens

Counted across 424 of the 426 authors here whose files we hold, read 2026-08-06

  • use plural nouns for resource namesin 41 of 424, across 32 files
  • use cursor-based pagination for large datasetsin 35 of 424, across 20 files
  • include rate limit headers in responsesin 25 of 424, across 13 files
  • Use kebab-case for multi-word resourcesin 23 of 424, across 13 files
  • version APIs in the URL pathin 19 of 424, across 9 files
  • use semantic HTTP status codesin 18 of 424, across 8 files
  • verify webhook signaturesin 18 of 424, across 11 files
  • use query parameters for filteringin 17 of 424, across 6 files
  • use async database operationsin 14 of 424, across 7 files
  • wrap successful responses in a data fieldin 13 of 424, across 3 files
  • prefix sorting parameters with a hyphen for descending orderin 13 of 424, across 3 files
  • set appropriate HTTP status codesin 13 of 424, across 6 files

Said here and by no other author read

  • choose fetch or Axios with justification
  • build a base client with base URL, headers, and timeouts
  • add interceptors for auth token attach and refresh
  • map API errors to a consistent shape
  • handle request cancellation and network failures
  • source base URLs from environment configuration

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.