Agent skill

API Organization

by aiskillstore in aiskillstore/marketplace

Explains the standardized API organization pattern for this codebase.

No licenceAuto-check passedBackend & APIs

Install API Organization

skills CLI
$ npx skills add aiskillstore/marketplace --skill api-organization -a claude-code

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

GitHub CLI
$ gh skill install aiskillstore/marketplace api-organization --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/aiskillstore/marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bom-98/api-organization .claude/skills/api-organization && 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-organization
GitHub stars
430
Token cost
~3k tokens
SKILL.md length
810 words
Files
5 (incl. references)
Skills in repo
1,108
Repo updated
First seen
Licence
None found

At a glance

Explains the standardized API organization pattern for this codebase.

  • Works in 4 steps: Define Types in endpoint-types.ts → Define URLs in endpoints.ts → Add Wrapper in protected-endpoints.ts → …
  • Creating new API endpoints
  • SKILL.md covers When to Use This Skill, Core Principles, The 5-File System and Authentication System, plus 8 more sections
  • Needs NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY

What it does

API Organization is an agent skill from aiskillstore/marketplace. Explains the standardized API organization pattern for this codebase. Use when creating new API endpoints, API clients, or modifying existing API structure. Covers the 5-file system (endpoint-types, endpoints, api-client, admin-api-client, protected-endpoints), role-based access patterns (admin vs regular users), and TypeScript type safety across the API layer. All API code lives in src/lib/api/ following this exact pattern.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/endpoint-types-pattern.md`, `references/endpoints-pattern.md` and `references/supabase-auth-integration.md`).

It sits in Backend & APIs, covering REST APIs, Authorization and RBAC and Type safety. The repository describes itself as: Security-audited skills for Claude, Codex & Claude Code. One-click install, quality verified.

When your agent uses it

  • Creating new API endpoints
  • Modifying existing API structure

Example prompts

  • “Use the api-organization skill to explain the standardized API organization pattern for this codebase”
  • “/api-organization”

Requirements

  • A credential in NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Define Types in endpoint-types.ts
  2. Define URLs in endpoints.ts
  3. Add Wrapper in protected-endpoints.ts
  4. Use in Application Code

What it can do on your machine

Read from SKILL.md and the folder at commit ad8daf7. 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 these keys or tokens, usually read from environment variables:

    • NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY

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

Context cost

API Organization loads about 3k tokens when it runs, and up to ~8.4k if it reads all its reference files. Until then it costs about 111 tokens; SKILL.md has 810 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~111
When it runs · the whole SKILL.md, loaded when a task matches
~3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.4k

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 810 words (~2,972 tokens).

“This skill defines the standardized API organization pattern used throughout this codebase. All external API integrations follow the same 5-file structure for consistency, type safety, and maintainability.”

— opening of SKILL.md by aiskillstore
name
api-organization

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (references) in skills/bom-98/api-organization of aiskillstore/marketplace.

  • SKILL.md
  • references/endpoint-types-pattern.md
  • references/endpoints-pattern.md
  • references/supabase-auth-integration.md
  • skill-report.json

Open the folder on GitHubat commit ad8daf7

Compare with similar skills

API Organization 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 Organization compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
API Organization this skillaiskillstore/marketplace430—~3kAutomated safety check: PassNone
API SDK Generatormajiayu000/claude-skill-registry6662 repos~1.7kAutomated safety check: PassMIT
Maintainx SDK Patternsjeremylongshore/tons-of-skills-marketplace2.8k—~2.2kAutomated safety check: PassMIT
OmniRoute Provider Managementdiegosouzapw/OmniRoute74k—~2.4kAutomated safety check: PassMIT
Elysia API Routesbiersoeckli/QuickStack362—~1.1kAutomated safety check: PassGPL-3.0
OpenAPI CLI CallerEvilFreelancer/openapi-to-cli265—~879Automated safety check: PassMIT

Similar skills

  • API SDK Generator

    majiayu000/claude-skill-registry

    Generates client SDK code, API wrapper libraries, request/response models, and language-specific usage patterns for any REST API.

    666 GitHub starsUsed in 2 repos~1.7k tokens
    Backend & APIsAuto-check passed
  • Maintainx SDK Patterns

    jeremylongshore/tons-of-skills-marketplace

    Learn MaintainX REST API patterns, pagination, filtering, and client architecture.

    2.8k GitHub stars~2.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • OmniRoute Provider Management

    diegosouzapw/OmniRoute

    Manages AI provider connections, API keys, OAuth flows and connection tests through OmniRoute's REST API across its 327-provider catalog.

    74k GitHub stars~2.4k tokensUpdated today
    Backend & APIsAuto-check passed
  • Elysia API Routes

    biersoeckli/QuickStack

    Create and update QuickStack Elysia REST API routes using the project's established /api/v1 route conventions.

    362 GitHub stars~1.1k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • OpenAPI CLI Caller

    EvilFreelancer/openapi-to-cli

    Turns an OpenAPI, Swagger or OpenRPC spec into CLI commands the agent can search and call, with no MCP server or code generation.

    265 GitHub stars~879 tokensUpdated 16 days ago
    Backend & APIsAuto-check passed
  • Fivetran

    rocky-data/rocky

    Fivetran REST API reference for Rocky's source adapter. An agent skill from rocky-data/rocky.

    304 GitHub stars~914 tokensUpdated today
    Backend & APIsAuto-check passed

More from aiskillstore/marketplace

All 1,108 skills in this repo
  • Code Stats

    aiskillstore/marketplace

    Analyze codebase with tokei (fast line counts by language) and difft (semantic AST-aware diffs).

    430 GitHub starsUsed in 2 repos~697 tokens
    Auto-check: notes
  • File Search

    aiskillstore/marketplace

    Modern file and content search using fd, ripgrep (rg), and fzf.

    430 GitHub starsUsed in 2 repos~598 tokens
    Auto-check: notes
  • Data Processing

    aiskillstore/marketplace

    Process JSON with jq and YAML/TOML with yq. An agent skill from aiskillstore/marketplace.

    430 GitHub starsUsed in 1 repo~720 tokens
    Auto-check: notes
  • Doc Scanner

    aiskillstore/marketplace

    Scans for project documentation files (AGENTS.md, CLAUDE.md, GEMINI.md, COPILOT.md, CURSOR.md, WARP.md, and 15+ other formats) and synthesizes guidance.

    430 GitHub starsUsed in 1 repo~644 tokens
    Auto-check: notes
  • Find Replace

    aiskillstore/marketplace

    Modern find-and-replace using sd (simpler than sed) and batch replacement patterns.

    430 GitHub starsUsed in 1 repo~527 tokens
    Auto-check: notes
  • Investigating Codebases

    aiskillstore/marketplace

    Automatically activated when user asks how something works, wants to understand unfamiliar code, needs to explore a new codebase, or asks questions like "where is X implemented?", "how does Y…

    430 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check: notes

Categories

Questions about API Organization

What does API Organization do?

Explains the standardized API organization pattern for this codebase. API Organization is an agent skill from aiskillstore/marketplace. Explains the standardized API organization pattern for this codebase.

When should I use API Organization?

API Organization fits situations like: creating new API endpoints; modifying existing API structure.

How do I install API Organization in Claude Code?

Run `npx skills add aiskillstore/marketplace --skill api-organization -a claude-code`. Or copy the skill folder (skills/bom-98/api-organization in aiskillstore/marketplace) into .claude/skills/api-organization in your project. Claude Code loads it when a task matches its description.

How do I install API Organization in Codex?

Run `npx skills add aiskillstore/marketplace --skill api-organization -a codex`. Or copy the skill folder (skills/bom-98/api-organization in aiskillstore/marketplace) into .agents/skills/api-organization in your project. Codex loads it when a task matches its description.

Can I use API Organization 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 aiskillstore/marketplace --skill api-organization -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-organization, .gemini/skills/api-organization, .github/skills/api-organization and .opencode/skills/api-organization in your project.

What does API Organization need to run?

Going by SKILL.md and its folder, API Organization needs credentials named NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY. Our summary lists: A credential in NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY.

Does API Organization 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 Organization 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 Organization use?

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

How many tokens does API Organization use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.5k tokens, read only when the agent opens those files.

What are the alternatives to API Organization?

Skills that share tags, products or a category with API Organization: API SDK Generator (majiayu000/claude-skill-registry, 666 stars), Maintainx SDK Patterns (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), OmniRoute Provider Management (diegosouzapw/OmniRoute, 74k stars) and Elysia API Routes (biersoeckli/QuickStack, 362 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains API Organization?

aiskillstore (a GitHub organization) maintains it in aiskillstore/marketplace, which has 430 GitHub stars. The repository holds 1,108 skills in this directory. The repository was last updated on October 7, 2026.

Source: aiskillstore/marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.