How does this skill handle API response envelopes?

It uses a ResponseJSON newtype with a custom FromJSON instance that checks for success flags (like an 'ok' field) and automatically branches between error and payload parsing.

What is the benefit of two-layer error handling in Haskell?

It prevents network-level HTTP errors (like 404s or connection timeouts) from being confused with domain-level logic errors (like an invalid API key or business rule violation), leading to more predictable code and better debugging.

Does this skill support the effectful library?

Yes, it provides specific guidance on defining dynamic effects (GADTs) for client operations and implementing interpreters that properly catch IO exceptions and convert them to effectful errors.

What is the 'Three-Tier API Organization'?

It is a structure that separates raw Servant clients (internal), public IO wrapper functions, and finally an effect-based interface, allowing for maximum flexibility across different monadic contexts.

Haskell Servant Client Conventions

Name: Haskell Servant Client Conventions
Author: birdgg

bybirdgg

0•

Desarrollo de API

Streamlines Haskell API client development using the Servant library with robust two-layer error handling and effectful patterns.

This skill equips Claude with specialized knowledge for architecting production-grade Haskell API wrappers using the servant-client ecosystem. It enforces a best-practice architecture that distinguishes network-level HTTP errors from domain-specific API errors, ensuring robust error recovery and debugging. The skill guides the implementation of a clean three-tier API structure—comprising raw internal clients, public IO wrappers, and effect-based interfaces—while providing patterns for authentication, cursor-based pagination, and seamless integration with the effectful effect system.

Características Principales

01Standardized three-tier organization for API modules

02Two-layer error handling separating ClientError from domain logic

03Centralized API envelope parsing via ResponseJSON newtypes

040 GitHub stars

05Reusable cursor-based pagination typeclasses and combinators

06Dynamic effect (GADT) patterns for effectful library integration

Casos de Uso

01Integrating servant-client into applications using the effectful library

02Refactoring existing Haskell API clients to follow standardized error and pagination patterns

03Building type-safe Haskell wrappers for external services like Slack or Stripe

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add birdgg/haskell-claude haskell-servant-client

For use in Claude.ai and ChatGPT

Download Skill