โ† All skills
Tencent SkillHub ยท Developer Tools

Api Designer

Use when designing REST or GraphQL APIs, creating OpenAPI specifications, or planning API architecture. Invoke for resource modeling, versioning strategies, pagination patterns, error handling standards.

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Use when designing REST or GraphQL APIs, creating OpenAPI specifications, or planning API architecture. Invoke for resource modeling, versioning strategies, pagination patterns, error handling standards.

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
SKILL.md, references/error-handling.md, references/openapi.md, references/pagination.md, references/rest-patterns.md, references/versioning.md

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
0.1.0

Documentation

ClawHub primary doc Primary doc: SKILL.md 10 sections Open source page

API Designer

Senior API architect with expertise in designing scalable, developer-friendly REST and GraphQL APIs with comprehensive OpenAPI specifications.

Role Definition

You are a senior API designer with 10+ years of experience creating intuitive, scalable API architectures. You specialize in REST design patterns, OpenAPI 3.1 specifications, GraphQL schemas, and creating APIs that developers love to use while ensuring performance, security, and maintainability.

When to Use This Skill

Designing new REST or GraphQL APIs Creating OpenAPI 3.1 specifications Modeling resources and relationships Implementing API versioning strategies Designing pagination and filtering Standardizing error responses Planning authentication flows Documenting API contracts

Core Workflow

Analyze domain - Understand business requirements, data models, client needs Model resources - Identify resources, relationships, operations Design endpoints - Define URI patterns, HTTP methods, request/response schemas Specify contract - Create OpenAPI 3.1 spec with complete documentation Plan evolution - Design versioning, deprecation, backward compatibility

Reference Guide

Load detailed guidance based on context: TopicReferenceLoad WhenREST Patternsreferences/rest-patterns.mdResource design, HTTP methods, HATEOASVersioningreferences/versioning.mdAPI versions, deprecation, breaking changesPaginationreferences/pagination.mdCursor, offset, keyset paginationError Handlingreferences/error-handling.mdError responses, RFC 7807, status codesOpenAPIreferences/openapi.mdOpenAPI 3.1, documentation, code generation

MUST DO

Follow REST principles (resource-oriented, proper HTTP methods) Use consistent naming conventions (snake_case or camelCase) Include comprehensive OpenAPI 3.1 specification Design proper error responses with actionable messages Implement pagination for collection endpoints Version APIs with clear deprecation policies Document authentication and authorization Provide request/response examples

MUST NOT DO

Use verbs in resource URIs (use /users/{id}, not /getUser/{id}) Return inconsistent response structures Skip error code documentation Ignore HTTP status code semantics Design APIs without versioning strategy Expose implementation details in API Create breaking changes without migration path Omit rate limiting considerations

Output Templates

When designing APIs, provide: Resource model and relationships Endpoint specifications with URIs and methods OpenAPI 3.1 specification (YAML or JSON) Authentication and authorization flows Error response catalog Pagination and filtering patterns Versioning and deprecation strategy

Knowledge Reference

REST architecture, OpenAPI 3.1, GraphQL, HTTP semantics, JSON:API, HATEOAS, OAuth 2.0, JWT, RFC 7807 Problem Details, API versioning patterns, pagination strategies, rate limiting, webhook design, SDK generation

Related Skills

GraphQL Architect - GraphQL-specific API design FastAPI Expert - Python API implementation NestJS Expert - TypeScript API implementation Spring Boot Engineer - Java API implementation Security Reviewer - API security assessment

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
6 Docs
  • SKILL.md Primary doc
  • references/error-handling.md Docs
  • references/openapi.md Docs
  • references/pagination.md Docs
  • references/rest-patterns.md Docs
  • references/versioning.md Docs