api-development

Guide REST and GraphQL API development with Python, FastAPI, and Pydantic.

Updated Oct 6, 2025
One-click install
npx skills add https://github.com/andisab/casdk-harness --skill api-development-andisab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-development
Source: https://github.com/andisab/casdk-harness/tree/main/src/harness/skills/api-development
Command: npx skills add https://github.com/andisab/casdk-harness --skill api-development-andisab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fastapi, pydantic, sqlmodel, sqlalchemy, passlib, jose, httpx, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill simplifies the process of API development, from design and implementation to documentation, saving developers time and reducing errors.

Core Features & Use Cases

  • API Design: Offers guidelines and best practices for REST and GraphQL API design.
  • Implementation: Provides code examples and templates for both REST and GraphQL APIs.
  • Documentation: Offers tips on API versioning, error handling, and documentation formats.
  • Use Case: Let's say you need to build a RESTful API to manage user accounts. Use this Skill to guide you through the entire process, from defining endpoints to writing the code and documenting the API.

Quick Start

Run the following command to create a new REST API endpoint:

make api create /api/v1/users

Frequently Asked Questions about api-development

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

FAQPage Schema
How do I build a REST API with FastAPI and Python?

To build a REST API with FastAPI, use this Skill to generate code templates, define endpoints with Pydantic, and apply best practices for design and data validation. It provides commands to quickly create and structure new endpoints.

What's the best way to document and version a GraphQL API?

The best way to document and version a GraphQL API is by following the structured guidelines in this Skill, which offers tips on versioning strategies, error handling, and documentation formats to ensure clear API communication and maintenance.

Do I need SQLAlchemy and SQLModel to manage API databases?

You need SQLAlchemy and SQLModel to manage database operations within your API implementation. This Skill integrates these libraries alongside FastAPI and Pydantic to handle data modeling and database interactions seamlessly.

Can I use this for both REST and GraphQL API design?

Yes, you can use this for both REST and GraphQL API design. It provides specific guidelines, implementation examples, and templates for both architectural styles, allowing you to choose and execute the appropriate protocol for your project.

How does Pydantic handle data validation in FastAPI endpoints?

Pydantic handles data validation in FastAPI endpoints by enforcing strict type checking and data schemas. This Skill leverages Pydantic models to ensure incoming requests and outgoing responses conform to predefined structures, reducing errors.

What are the guidelines for API error handling and authentication?

Guidelines for API error handling and authentication involve using libraries like passlib and jose for secure token management. This Skill provides templates to implement robust authentication flows and consistent error responses across your endpoints.