effect-ts · pedronauck — skill for Claude Code: functional programming on TypeScript
Skill for working with Effect-TS, a functional programming library for TypeScript. Guides you through type-safe code with error handling, async operations, and resource management using Effect, Schema, Pattern Matching, and Context.Tag.
no license 264 installs ★ 655 updated 2026-10-20
npx skills add pedronauck/skills --skill effect-ts -a claude-codeWhat effect-ts does
The skill includes reference guides on Effect fundamentals (Effect.gen, pipe, Effect.fn), data modeling via Schema, error handling with Data.TaggedError, mandatory Pattern Matching for tagged unions, data types (Option, Either, Duration, DateTime, BigDecimal, Chunk, HashSet, Redacted), and the Context.Tag service pattern. Contains testing rules with @effect/vitest and a list of forbidden patterns (try-catch inside Effect.gen, type assertions, switch on _tag instead of Match).
References include concrete code examples for each topic: building Effects, working with streams (Stream, Sink, batching, caching), concurrency and finalizers, logging and tracing via HttpApi, test isolation. The skill assumes you already know TypeScript and async; it applies Effect to your project rather than teaching the library from scratch.
What it helps with
- Write type-safe async code without try-catch and undefined
- Model and validate data using Schema
- Handle errors while preserving type information across operations
- Branch on tagged unions without losing exhaustiveness checking
- Manage services and dependencies through Context.Tag and Layer
Example prompts for the agent
- Write a function to fetch a user with error types via Effect, using the Context.Tag pattern
- Show how to apply Schema.transform and Schema.filter for JSON validation in a request handler
- Help refactor existing code from try-catch to Effect.gen with proper error handling
How to install effect-ts
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill effect-ts -a claude-code2Manually: put the files in place
~/.claude/skills/effect-ts/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/effect-ts/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill effect-ts -a codex2Manually: put the files in place
.agents/skills/effect-ts/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill effect-ts -a cursor2Manually: put the files in place
.cursor/skills/effect-ts/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills skills/curated/effect-ts2Manually: put the files in place
.github/skills/effect-ts/SKILL.md1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill effect-ts -a gemini-cli2Platform CLI
gemini skills install https://github.com/pedronauck/skills --path skills/curated/effect-tsManually: put the files in place
.devin/skills/effect-ts/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pedronauck/skills --skill effect-ts -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about effect-ts
How do I install effect-ts in Claude Code?
Run npx skills add pedronauck/skills --skill effect-ts -a claude-code, then open ~/.claude/skills/effect-ts/SKILL.md for skill reference.
What does the effect-ts skill do?
The skill provides reference guides and patterns for writing Effect-TS code: type-safe Effects instead of promises and try-catch, Schema for data modeling, mandatory Pattern Matching for union types, and Context.Tag for service management.
Do I need to know Effect before using this skill?
The skill assumes familiarity with TypeScript and async patterns; it does not teach Effect from the start but applies it to your code through examples and forbidden patterns to avoid.
Similar skills
All skills for Backend and APIs →effect-ts by other authors comes first.