Why use NamedRoutes instead of the standard : combinator?

NamedRoutes using record types provides better readability, allows for easier refactoring, and eliminates the positional argument confusion common in large Servant APIs.

Does it support custom error handling?

The skill encourages defining domain-specific error types and converting them to ServerErrors at the API boundary to avoid leaking internal implementation details.

How does this skill handle API handlers?

It enforces a pattern where handler records mirror API records exactly using the 'AsServer' type, keeping the web layer thin and delegating logic to services.

Can I use this skill for authentication in Haskell?

Yes, it provides specific guidance on applying AuthProtect or Servant-Auth at the record field level for granular security.

Haskell Servant Developer

Name: Haskell Servant Developer
Author: birdgg

bybirdgg

0•

API開発

Streamlines Haskell web development using the Servant framework with a focus on type-safe NamedRoutes record patterns.

This skill optimizes Claude's ability to build and maintain RESTful APIs in Haskell using the Servant framework. It enforces the highly maintainable NamedRoutes record pattern instead of traditional combinators, ensuring cleaner codebases through Generic derivation, resource-based route organization, and the strict separation of handlers from business logic. Whether you are defining complex API trees, implementing type-safe error handling, or configuring authentication, this skill provides the specific patterns and best practices required for production-grade Haskell backends.

主な機能

01Implements field-level authentication patterns using Servant-Auth

020 GitHub stars

03Promotes thin handler patterns with service layer delegation

04Provides templates for Generic record derivation and resource organization

05Guides domain-specific error handling and ServerError conversion

06Enforces NamedRoutes record patterns for modular API definitions

ユースケース

01Refactoring legacy Servant combinator code into record-based structures

02Designing modular REST APIs with deeply nested resource routes

03Implementing type-safe error handling at the API boundary

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add birdgg/haskell-claude haskell-servant

For use in Claude.ai and ChatGPT

Download Skill