โ† 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

Known item issue.

This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.

Quick setup
  1. Open the source page and confirm the package flow manually.
  2. Review SKILL.md if you can obtain the files.
  3. Treat this source as manual setup until the download is verified.

Requirements

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

Package facts

Download mode
Manual review
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

  • Open the source listing and confirm there is a real package or setup artifact available.
  • Review SKILL.md before asking your agent to continue.
  • Treat this source as manual setup until the upstream download flow is fixed.

Install with your agent

Agent handoff

Use the source page and any available docs to guide the install because the item currently does not return a direct package file.

  1. Open the source page via Open source listing.
  2. If you can obtain the package, extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the source page and extracted files.
New install

I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.

Upgrade existing

I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.

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