api-and-namespace-design

Manage API design conventions, namespace coordination, RBAC roles, and OpenAPI contract synchronization.

4.9k|780|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/iflytek/skillhub --skill api-and-namespace-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-and-namespace-design
Source: https://github.com/iflytek/skillhub/tree/main/.agents/skills/api-and-namespace-design
Command: npx skills add https://github.com/iflytek/skillhub --skill api-and-namespace-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the design and management of API and namespace configurations, ensuring consistent and secure access control across your organization.

Core Features & Use Cases

  • API Design Conventions: Follows best practices for API design, including controller responsibilities and request/response patterns.
  • Namespace Coordination: Manages namespace coordinate systems, roles, and status, with support for ClawHub compatibility.
  • RBAC Roles: Implements Role-Based Access Control (RBAC) for namespace and platform-level access.
  • OpenAPI Contract Sync: Ensures backend API contracts are up-to-date with generated types.
  • Versioning and Tags: Manages semantic versioning and custom tags for skill packages.
  • Key API Endpoints: Provides access to essential endpoints for user info, authentication, namespace management, and health checks.
  • Use Case: For a software engineer tasked with updating API endpoints and managing namespace configurations, this Skill offers a comprehensive toolkit to maintain consistency and security.

Quick Start

Use the 'api-and-namespace-design' skill to define a new API endpoint for user authentication.

Frequently Asked Questions about api-and-namespace-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design API endpoints with proper RBAC and namespace management?

Design API endpoints with RBAC and namespace management by applying controller responsibilities, request/response patterns, and role-based access control to ensure secure and consistent configurations across your organization.

How do I synchronize OpenAPI contracts with generated types?

Synchronize OpenAPI contracts with generated types by validating backend API contracts against the generated type definitions, ensuring your API specifications remain up-to-date and accurately reflect the backend implementation.

What is the best way to manage semantic versioning for API packages?

Manage semantic versioning for API packages by applying standardized versioning conventions and custom tags to skill packages, ensuring consistent release tracking and dependency coordination across your software engineering lifecycle.

Can I coordinate namespace systems and roles for ClawHub compatibility?

Coordinate namespace systems and roles for ClawHub compatibility by managing namespace coordinate systems, statuses, and platform-level access roles to maintain consistent namespace configurations across your infrastructure.

What are the standard conventions for API design and controller responsibilities?

Standard conventions for API design and controller responsibilities involve following best practices for request and response patterns, ensuring backend implementations adhere to consistent and secure API architectural guidelines.

How do I configure access control for platform-level and namespace-level APIs?

Configure access control for platform-level and namespace-level APIs by implementing Role-Based Access Control (RBAC) roles, defining specific permissions for authentication, user info, and health check endpoints.