effect-ts
Use for Effect-TS code and patterns including services, layers, errors, Schema/JSONSchema, @effect/ai tools, code importing from `effect`, or @prb/effect-next.
Security Assessment
Detected risks:
About effect-ts
The Effect-TS skill provides expert guidance for functional programming with the Effect library, a powerful TypeScript framework for building robust, composable applications. This skill helps developers leverage Effect's sophisticated error handling, dependency injection, and composability patterns to write maintainable, type-safe code. It ensures developers follow best practices by checking against upstream Effect source code and adapting to version changes.
The skill covers core Effect concepts including Services and Layers for dependency injection, error handling with typed error channels, Schema and JSONSchema for validation, resource management with scoped effects, concurrent operations, and testing patterns. It integrates with Effect ecosystem packages like @effect/ai, @effect/platform, @effect/rpc, and @effect/cluster. The skill emphasizes research-driven development by spawning task agents to investigate complex patterns and verify approaches against the canonical Effect source code.
This skill is designed for TypeScript developers building applications with Effect-TS, whether migrating from imperative code or implementing new features using functional patterns. It's particularly valuable for teams working on complex applications requiring sophisticated error handling, dependency management, or reactive programming. The skill maintains consistency by discovering and following existing codebase patterns while ensuring alignment with Effect library best practices and current versions.
FAQ
What is the Effect source code requirement?
Before starting any Effect work, you must have the Effect-TS source code cloned at ~/.effect. The skill verifies this exists and will stop if missing. This allows the skill to research patterns, check implementation details, and resolve type errors by examining the canonical source.
Which Effect versions are supported?
The skill supports effect 3.x and @effect/* packages on their current major/minor versions (e.g., @effect/ai 0.36.x). Minor version drift is acceptable as long as major versions match. The skill can adapt to newer versions by checking changelogs in your local ~/.effect checkout.
When should I use this skill versus researching manually?
Use this skill for any Effect-TS code or patterns. The skill automatically determines when to spawn research agents for complex scenarios like Services/Layers, error handling hierarchies, streams, resource management, or testing. It prioritizes existing codebase patterns for consistency before consulting Effect source code.
How does the skill handle codebase consistency?
The skill first searches for existing Effect patterns in your project by looking for Effect imports, service structures, and error handling conventions. If patterns exist, it follows them for consistency. If no patterns exist, it consults Effect source code and changelogs to provide canonical, idiomatic solutions.
Can I use this skill with @prb/effect-next projects?
Yes, the skill explicitly supports @prb/effect-next for Next.js integrations with Effect. It handles Effect patterns in Next.js contexts including server components, API routes, and framework-specific patterns alongside standard Effect-TS capabilities.
All Files
17 filesInstall effect-ts
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
paulrberg/agent-skills