effect-ts

Effect-TS Plugin for Claude Code

A comprehensive Claude Code plugin for Effect-TS development. Provides skills, commands, and agents to help you write idiomatic Effect-TS code.

Installation

/plugin marketplace add andrueandersoncs/claude-skill-effect-ts
/plugin install effect-ts@effect-ts

Features

Skills (22 domains)

The plugin includes skills covering all major Effect-TS domains:

Skill	Description
effect-core	Core Effect types and operations
error-management	Typed errors, error handling patterns
resource-management	Scope, acquireRelease, resource safety
requirements-management	Services, Layers, dependency injection
configuration	ConfigProvider, environment variables
concurrency	Fibers, concurrent operations
scheduling	Schedule combinators, retry policies
schema	Schema definition, validation, encoding/decoding
data-types	Option, Either, Chunk, HashMap, etc.
batching-caching	Request batching, caching strategies
observability	Logging, metrics, tracing
streams	Stream processing, transformations
sinks	Stream consumers and collectors
pattern-matching	Match API for exhaustive matching
runtime	Runtime configuration and execution
platform	Platform-specific APIs (Node, Browser, Bun)
testing	TestClock, TestRandom, test utilities
code-style	Idiomatic Effect-TS style guidelines
state-management	Ref, SynchronizedRef, state patterns
traits	Equal, Hash, Order, and other traits
effect-ai	AI/LLM integration with Effect
api-docs	Look up Effect API documentation via WebFetch

Commands

Command	Description
/effect-check <file>	Run parallel compliance checks across all rule categories
/effect-review [path]	Review code for Effect-TS violations (spawns reviewer agent)
/docs <API>	Look up Effect API documentation
/with-style	Enforce idiomatic Effect code style

Agents

Agent	Description
effect-reviewer	Review ALL TypeScript code for Effect compliance violations
effect-migrator	Migrate existing code to Effect-TS patterns
category-checker	Check code against a single rule category (used by /effect-check)

Rule Categories (effect-agent/)

The plugin bundles structured rule categories for systematic compliance checking:

Builtin Categories:

• async - Async & Promises (no async/await mixing)
• conditionals - Conditional Statements (use Match, not if/else)
• discriminated-unions - Tagged union patterns
• errors - Error Handling (typed errors, Effect.fail)
• imperative - Imperative code patterns to avoid
• native-apis - Native API replacements
• schema - Schema-first data modeling
• services - Services & Layers for testability
• testing - Testing best practices

Custom Categories:

• code-style - Code style & hygiene rules

Usage

Parallel Compliance Checking

Run all rule categories as checks in parallel against a file:

/effect-check src/services/UserService.ts

This spawns one agent per category (10 categories = 10 parallel checks), then aggregates results into a unified report.

Code Review

Review code for Effect compliance violations:

/effect-review src/services/
/effect-review src/handlers/api.ts

API Documentation

Look up Effect API documentation:

/docs Effect.retry
/docs Stream.map
/docs Schema.Class

License

MIT License - see LICENSE for details.

Author

Andrue Anderson (@andrueandersoncs)