effect-best-practices

Provides design patterns for Effect.js TSL, including TSL. Correcting to adhere to TS syntax:

78|2|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/Makisuo/skills --skill effect-best-practices
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: effect-best-practices
Source: https://github.com/Makisuo/skills/tree/main/effect-best-practices
Command: npx skills add https://github.com/Makisuo/skills --skill effect-best-practices

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Enforces Effect-TS patterns for services, errors, layers, and atoms. Use when writing code with Effect.Service, Schema.TaggedError, Layer composition, or effect-atom React components.

Core Features & Use Cases

  • Establishes a consistent architecture for Effect-TS codebases, improving type safety, testability, observability, and maintainability.
  • Provides concrete patterns for Service definitions, Error definitions, Layer composition, Schema/Branded types, and Observability patterns, with references for deeper guidance.
  • Includes a language server setup, quick refactors, and anti-pattern guidance to prevent common pitfalls in large codebases.

Quick Start

Choose a consistent pattern for new Effect-TS services and errors in your project, integrate the language server, and align layers and atoms with the recommended patterns.

Frequently Asked Questions about effect-best-practices

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

FAQPage Schema
What are the best practices for defining services in Effect-TS?

Effect-TS service best practices involve using Effect.Service to establish a consistent architecture, improving type safety, testability, observability, and maintainability. Concrete patterns provide structural guidance for robust service definitions.

How do I handle errors in Effect-TS using Schema.TaggedError?

Schema.TaggedError handles errors in Effect-TS by defining structured, branded error types. Following established error patterns ensures type-safe error management and improves codebase observability by making failures predictable.

What is the correct way to compose layers in an Effect-TS application?

Layer composition in an Effect-TS application follows structured layer patterns to build dependency graphs. Applying these patterns prevents common anti-patterns and ensures testability and maintainability across the codebase architecture.

Can I use Effect-TS patterns with React components?

Effect-TS patterns integrate with React components using effect-atom. Aligning layers and atoms with recommended patterns maintains type safety and observability when managing state and side effects in React.

How do I avoid common anti-patterns when writing Effect-TS code?

Avoiding anti-patterns in Effect-TS code requires applying blueprint guidance for services, errors, and layers. Integrating the Effect language server provides quick refactors and highlights common pitfalls to maintain codebase quality.

Does the Effect language server support quick refactors for services and layers?

The Effect language server supports quick refactors for services and layers. Setting it up helps enforce Effect-TS patterns, provides observability guidance, and prevents common architectural pitfalls during development.