Skip to content
cccskills
FreePublished on GitHubEnglish overview

api-design-principles

Apply REST and GraphQL design principles when planning or reviewing APIs. Get guidance on resource and schema design, pagination, versioning, error handling, and common pitfalls, with examples and reusable templates.

OriginalShow the original description

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.

LeoYeAI/agent-master-skills2,193 stars(GitHub 2,193 + cccskills 0)

Run score Not tested

See how to install

Good for

  • Plan a new REST or GraphQL API
  • Review an API specification before implementation
  • Set API design conventions for a team
  • Improve pagination and error response patterns

Overview

What it does

Apply design principles for REST and GraphQL APIs when planning or reviewing a specification. For REST, consider how to represent resources and use HTTP methods. For GraphQL, work through schema and query structure. The skill also covers pagination, filtering, error responses, and version management, along with common design problems. For GraphQL, it includes examples of types, mutations, and resolvers, as well as the DataLoader approach to keeping related data retrieval efficient. Checklists and templates for API review and team standards are included, along with a script that generates an OpenAPI specification.

When it helps

Use it to settle a new API specification before implementation or reconsider the usability of an existing API. It can also help when comparing REST and GraphQL, considering a migration between them, or aligning design rules across a team.

Example requests

  • “Review the endpoint design for this REST API.”
  • “Draft a GraphQL schema for users and orders.”
  • “Compare approaches to API versioning.”

Notes

特記事項はありません。

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Document check

AI checked the SKILL.md for operations that need care and for setup requirements. The score comes only from actually running the skill (hands-on test).

SafetyAre sending data, deleting files, and running commands disclosed?
AGoodIt shows DELETE design examples but gives no instructions to execute external actions.
Easy setupDoes it need few tools or API keys, and are they documented?
AGoodNo API key or external service prerequisites are stated.

Not counted in the score. Rated by AI (OpenAI Codex) as of Nov 15, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (5)

  • SKILL.md13.4 KB
  • assets/api-design-checklist.md3.8 KB
  • assets/rest-api-template.py5.2 KB
  • references/graphql-schema-design.md8.8 KB
  • references/rest-best-practices.md7.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

0codekit

FreeSummary

Connect an agent to 0codekit workspace data through the Membrane CLI. The supplied guide lists many data types across spreadsheets, databases, documents, tasks, calendars, email, and other services, while noting that the exact request may need clarification.

  • Working with spreadsheet rows and columns
  • Accessing workspace tasks or calendar events
  • Handling records across listed data sources
LeoYeAI/agent-master-skills2.2KUpdated Nov 1, 2026

0xarchive

FreeSummary

Query historical and current crypto market data for Hyperliquid, Lighter.xyz, and HIP-3, including prices, candles, order books, trades, funding rates, open interest, and liquidations. Check data freshness and coverage to understand what records are available.

  • Looking up historical prices or candles for a supported exchange
  • Reviewing order book or trade history
  • Checking funding rates and open interest over time
LeoYeAI/agent-master-skills2.2KUpdated Nov 1, 2026

12-factor-apps

FreeSummary

Review a codebase against the 12-Factor App principles for SaaS architecture. Get a factor-by-factor Strong, Partial, or Weak assessment, evidence and gaps, plus prioritized recommendations for improving portability, deployment, and scaling.

  • Auditing a SaaS application's architecture
  • Reviewing a cloud-native application
  • Planning a cloud migration
LeoYeAI/agent-master-skills2.2KUpdated Nov 1, 2026

Plan personal or team projects in repeating 13-day cycles inspired by the Maya calendar. Each of 13 daily tones suggests a focus, from setting a goal and taking action to sharing results, cleaning up, and reflecting.

  • Planning a focused 13-day personal project
  • Giving a team sprint a daily focus
  • Checking the suggested focus for today
LeoYeAI/agent-master-skills2.2KUpdated Nov 1, 2026

Estimate intracellular reaction rates from steady-state carbon-13 tracing measurements. Validate carbon atom mappings and measurement inputs, simulate labeling, fit constrained fluxes, and diagnose which pathway rates the data can meaningfully constrain.

  • Estimate metabolic fluxes from carbon-13 labeling
  • Validate atom mappings and measurement inputs
  • Simulate labeling for proposed reaction rates
LeoYeAI/agent-master-skills2.2KUpdated Nov 1, 2026

Learn how to source products through 1688.com with guided steps for choosing products, checking suppliers, requesting samples, negotiating prices, and comparing shipping options. The skill also highlights common listing and payment risks and explains when an order may call for help from a sourcing expert.

  • Checking a 1688 supplier before placing an order
  • Planning product selection for a target market and budget
  • Drafting a supplier message to negotiate price or samples
LeoYeAI/agent-master-skills2.2KUpdated Nov 1, 2026

See all skills by LeoYeAI

Report a problem with this skill