hcp-backend

Enforce FastAPI and Pydantic v2 patterns with mock server conventions.

2|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/AI-Riksarkivet/ra-hcp --skill hcp-backend
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hcp-backend
Source: https://github.com/AI-Riksarkivet/ra-hcp/tree/main/.claude/skills/hcp-backend
Command: npx skills add https://github.com/AI-Riksarkivet/ra-hcp --skill hcp-backend

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

HCP backend design patterns and mock server conventions that guide backend developers in building robust FastAPI services, ensuring consistency and reliability across the project.

Core Features & Use Cases

  • Clear guidance on choosing FastAPI with async handlers, Pydantic v2 schemas, and modern Python tooling.
  • Best practices for dependency management, linting, and project layout to support scalable backend development.
  • Use Case: When adding a new backend endpoint, follow the conventions to maintain consistency with the mock server and tests.

Quick Start

Follow the conventions to structure new backend modules, implement clean domain services, and align with mock server guidelines.

Frequently Asked Questions about hcp-backend

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

FAQPage Schema
How do I structure FastAPI endpoints with Pydantic models for consistent backend development?

FastAPI endpoint development is streamlined by enforcing consistent patterns, using async handlers and Pydantic v2 schemas. This approach ensures reliability and clean architecture across your backend project structure.

What's the best way to wire a mock server with FastAPI during backend development?

Wiring a mock server with FastAPI involves following established conventions to maintain consistency between endpoints and tests. This ensures your mock server behavior aligns correctly with clean domain services and project guidelines.

Do I need specific Python tooling and dependency management for scalable FastAPI services?

Specific modern Python tooling and dependency management are required to support scalable FastAPI services. Best practices for linting and project layout are enforced to maintain clean architecture and robust backend operations.

How does Pydantic v2 schema validation work with async FastAPI handlers?

Pydantic v2 schema validation works with async FastAPI handlers by enforcing consistent patterns for robust service design. This combination provides clear project structure and reliable domain service implementation.

When should I use mock server conventions in backend API development?

Mock server conventions should be used when adding new backend endpoints to maintain consistency with tests and domain services. They guide backend developers in building robust FastAPI services during the development phase.

Can I use these backend patterns for clean architecture and domain services in any Python project?

These backend patterns can be applied when writing FastAPI endpoints and Pydantic models to achieve clean architecture. They satisfy requirements for modern Python tooling, clear project structure, and scalable domain services.