Agent skill

API Design

by margelo in margelo/react-native-skills

Design and review predictable public APIs for TypeScript, JavaScript, React, and React Native libraries.

No licenceAuto-check passedMobile

Install API Design

skills CLI
$ npx skills add margelo/react-native-skills --skill api-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install margelo/react-native-skills api-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/margelo/react-native-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/api-design .claude/skills/api-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
api-design
GitHub stars
175
Token cost
~7.2k tokens
SKILL.md length
3,961 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
None found

At a glance

Design and review predictable public APIs for TypeScript, JavaScript, React, and React Native libraries.

  • Works in 5 steps: Sketch the user-facing TypeScript API… → Write 2-3 realistic call-site examples,… → Check the surface against the rules below. → …
  • Shaping exported functions
  • SKILL.md covers Workflow, API Freshness, API Shape Rules and Public API Organization, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

API Design is an agent skill from margelo/react-native-skills. Design and review predictable public APIs for TypeScript, JavaScript, React, and React Native libraries. Use when shaping exported functions, classes, hooks, options objects, event and listener APIs, error behavior, naming, cross-platform abstractions, or JS-only packages. Pair with build-nitro-modules when the library is backed by Nitro.

Its SKILL.md is about 7.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering Cross-platform mobile apps and API design. It works with React, React Native, TypeScript and JavaScript. The repository describes itself as: The best react-native Agent Skills. Forget 10x, this is 100x.

When your agent uses it

  • Shaping exported functions
  • Options objects
  • Event and listener APIs
  • Cross-platform abstractions

Example prompts

  • “/api-design”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Sketch the user-facing TypeScript API before implementing internals.
  2. Write 2-3 realistic call-site examples, including error and cleanup paths.
  3. Check the surface against the rules below.
  4. Verify the exported TypeScript with the repo's typecheck/lint/docs tooling before treating the API as done.
  5. Implement only after the public shape is coherent and verified.

What it can do on your machine

Read from SKILL.md and the folder at commit 1e9e17b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

API Design loads about 7.2k tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 3,961 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~88
When it runs · the whole SKILL.md, loaded when a task matches
~7.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 3,961 words (~7,207 tokens).

“Use this skill before implementation or when reviewing a public API surface. Target explicit types, stable semantics, and no irrelevant internals in the public contract.”

— opening of SKILL.md by margelo
name
api-design

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/api-design of margelo/react-native-skills.

Open the folder on GitHubat commit 1e9e17b

Compare with similar skills

API Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

API Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
API Design this skillmargelo/react-native-skills175—~7.2kAutomated safety check: PassNone
Jazz UI Developmentgarden-co/classic-jazz2.5k—~1.7kAutomated safety check: PassMIT
Upgrade Rn Versionbrandingbrand/flagship165—~3.7kAutomated safety check: PassMIT
Diagnosing Stacktrace SymbolicationPostHog/posthog-foss721—~2.2kAutomated safety check: PassMIT
React Coding StyleCherryHQ/cherry-studio-app4k—~2.5kAutomated safety check: PassAGPL-3.0
React Native Experttech-leads-club/agent-skills7k—~3.2kAutomated safety check: PassCC-BY-4.0

Similar skills

  • Jazz UI Development

    garden-co/classic-jazz

    A skill your agent uses when building, debugging, or optimizing Jazz applications.

    2.5k GitHub stars~1.7k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Upgrade Rn Version

    brandingbrand/flagship

    Adopt a new stable React Native minor into Flagship Code. An agent skill from brandingbrand/flagship.

    165 GitHub stars~3.7k tokensUpdated 6 days ago
    MobileAuto-check passed
  • Official

    Help users debug PostHog Error Tracking stack-trace symbolication for any supported platform — JavaScript/TypeScript web, React Native (Hermes), Android (Proguard / R8), or iOS / macOS (dSYM).

    721 GitHub stars~2.2k tokensUpdated today
    MobileAuto-check passed
  • React Coding Style

    CherryHQ/cherry-studio-app

    Implement and review React, React Native, and TypeScript UI for maximum practical render performance through leaf-local updates, stable identities, honest Hook semantics, and minimal effects.

    4k GitHub stars~2.5k tokensUpdated 4 days ago
    MobileAuto-check passed
  • React Native Expert

    tech-leads-club/agent-skills

    Guides React Native and Expo work for cross-platform apps: Expo Router navigation, fast lists, Reanimated animation, platform-specific code and project structure.

    7k GitHub stars~3.2k tokensUpdated 17 days ago
    MobileAuto-check passed
  • Local TanStack Form documentation reference (latest, v1.33.5).

    103 GitHub stars~1.1k tokensUpdated yesterday
    MobileAuto-check passed

More from margelo/react-native-skills

All 9 skills in this repo
  • Build Nitro Modules

    margelo/react-native-skills

    Builds and designs React Native Nitro Modules with Nitrogen, HybridObject TypeScript specs, Nitro View components, generated native implementations, zero-copy and native-state APIs, Swift/Kotlin/C++…

    175 GitHub stars~9.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Kotlin

    margelo/react-native-skills

    Design, implement, and review Kotlin and Android APIs. An agent skill from margelo/react-native-skills.

    175 GitHub stars~3k tokensUpdated 1 mo ago
    Auto-check passed
  • Swift

    margelo/react-native-skills

    Design, implement, and review Swift APIs and Apple-platform code.

    175 GitHub stars~3.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Nitro Fetch

    margelo/react-native-skills

    Fast native networking primitives for React Native built on Nitro Modules — react-native-nitro-fetch, react-native-nitro-websockets, and react-native-nitro-text-decoder.

    175 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • React Native Mmkv

    margelo/react-native-skills

    Fast synchronous key-value storage for React Native via react-native-mmkv (Nitro-backed).

    175 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • React Native Vision Camera Realtime

    margelo/react-native-skills

    Design and review production-grade low-latency VisionCamera v5 pipelines.

    175 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed

Questions about API Design

What does API Design do?

Design and review predictable public APIs for TypeScript, JavaScript, React, and React Native libraries. API Design is an agent skill from margelo/react-native-skills. Design and review predictable public APIs for TypeScript, JavaScript, React, and React Native libraries.

When should I use API Design?

API Design fits situations like: shaping exported functions; options objects; event and listener APIs; cross-platform abstractions.

How do I install API Design in Claude Code?

Run `npx skills add margelo/react-native-skills --skill api-design -a claude-code`. Or copy the skill folder (skills/api-design in margelo/react-native-skills) into .claude/skills/api-design in your project. Claude Code loads it when a task matches its description.

How do I install API Design in Codex?

Run `npx skills add margelo/react-native-skills --skill api-design -a codex`. Or copy the skill folder (skills/api-design in margelo/react-native-skills) into .agents/skills/api-design in your project. Codex loads it when a task matches its description.

Can I use API Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add margelo/react-native-skills --skill api-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/api-design, .gemini/skills/api-design, .github/skills/api-design and .opencode/skills/api-design in your project.

What does API Design need to run?

SKILL.md names no scripts, command-line tools or credentials: API Design is instructions for the agent only.

Does API Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is API Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does API Design use?

No licence was found for API Design or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does API Design use?

About 7.2k tokens (SKILL.md is roughly 29k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to API Design?

Skills that share tags, products or a category with API Design: Jazz UI Development (garden-co/classic-jazz, 2.5k stars), Upgrade Rn Version (brandingbrand/flagship, 165 stars), Diagnosing Stacktrace Symbolication (PostHog/posthog-foss, 721 stars) and React Coding Style (CherryHQ/cherry-studio-app, 4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains API Design?

margelo (a GitHub organization) maintains it in margelo/react-native-skills, which has 175 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on August 21, 2026.

Source: margelo/react-native-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.