discover-api

Discover and load API design skill modules via CLI commands.

126|7|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/rand/cc-experiments --skill discover-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: discover-api
Source: https://github.com/rand/cc-experiments/tree/main/skills/discover-api
Command: npx skills add https://github.com/rand/cc-experiments --skill discover-api

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often struggle with the vast and complex landscape of API design, security, and performance. This skill eliminates the need to manually search for best practices, authentication methods, or error handling strategies, providing instant, expert guidance.

Core Features & Use Cases

  • Comprehensive API Guidance: Access specialized knowledge on REST, GraphQL, authentication (OAuth, JWT), authorization, rate limiting, versioning, and error handling.
  • Automated Skill Discovery: Activates intelligently when you're working on backend API development tasks, bringing relevant expertise to your fingertips.
  • Use Case: When designing a new REST API, this skill can guide you through resource modeling, HTTP semantics, and then automatically suggest authentication and authorization best practices, ensuring a robust and secure API from the start.

Quick Start

Help me design a secure REST API for a new e-commerce platform, including authentication and rate limiting.

Frequently Asked Questions about discover-api

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

FAQPage Schema
How do I design a secure REST API with proper authentication?

REST API design requires layering authentication mechanisms like OAuth or JWT alongside authorization controls. This skill guides resource modeling, HTTP semantics, and security implementation to build robust APIs from the start, covering authentication setup, token validation, and access control patterns.

What's the best way to implement rate limiting in backend APIs?

Rate limiting protects APIs from abuse by restricting request frequency per client. This skill covers rate-limiting strategies, quota management, and performance optimization techniques to prevent server overload while maintaining service availability for legitimate users.

How do I structure a GraphQL schema for scalability and security?

GraphQL schema design requires thoughtful field organization, resolver patterns, and authentication/authorization hooks to prevent data exposure. This skill provides guidance on schema modeling, query complexity limits, and security best practices specific to GraphQL development.

What are the key differences between REST and GraphQL API design?

REST uses resource-based endpoints with fixed data shapes; GraphQL uses flexible query language for precise data fetching. This skill compares both approaches, covering versioning strategies, error handling, authentication differences, and when each architecture suits your backend requirements.

How do I handle errors and versioning in production APIs?

Error handling and versioning prevent client breakage and improve debugging. This skill covers error response standards, status codes, version migration patterns, and deprecation strategies to maintain API stability across backend development lifecycle.

Do I need OAuth, JWT, or API keys for my authentication layer?

Authentication method choice depends on user type and security requirements. This skill compares OAuth for delegated access, JWT for stateless authentication, and API keys for service-to-service communication, helping you select the right approach for your API security model.