К основному содержанию
скилл CX Codex

effect-ts · pproenca — скилл для Claude Code: что делает и как установить

Скилл с рекомендациями и шаблонами по библиотеке Effect-TS в TypeScript: типизированные ошибки, сервисы через Layer и генераторы Effect.gen.

MIT 263 установок ★ 227 обновлён 2026-08-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pproenca/dot-skills --skill effect-ts -a claude-code
Открыть на GitHub

Что делает effect-ts

Скилл подключает справочники по библиотеке Effect для TypeScript. Ассистент обращается к ним при написании сервисов, пайплайнов Effect.pipe, генераторов Effect.gen, валидации через @effect/schema и объявлении ошибок Data.TaggedError.

Внутри собраны разделы по внедрению зависимостей через Context.Tag и Layer, параллелизму на файберах (Queue, Deferred, PubSub), управлению ресурсами через Scope и симуляции времени с TestClock. Предусмотрены также руководства по миграции кода с Promise, fp-ts, neverthrow и ZIO.

Скилл настроен срабатывать на импорты из effect или пакетов группы @effect/*. При этом хук useEffect из React и побочные эффекты Redux инструкция намеренно отсекает.

Какие задачи решает

  • описать сервис с типизированными ошибками через Data.TaggedError
  • настроить внедрение зависимостей через Context.Tag и Layer
  • переписать асинхронный код с Promise или fp-ts на Effect.gen
  • организовать конкурентную работу через Queue, Ref и Deferred

Примеры запросов агенту

  • Перепиши эту функцию с Promise на Effect.gen с типизированными ошибками через Data.TaggedError
  • Собери сервис UserRepo с Context.Tag и подготовь для него рабочий Layer
  • Как правильно валидировать входящие данные через @effect/schema?

Как установить effect-ts

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill effect-ts -a claude-code

2Вручную: положить файлы

~/.claude/skills/effect-ts/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/effect-ts/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об effect-ts

Как установить effect-ts в Claude Code?

Выполните в терминале команду npx skills add pproenca/dot-skills --skill effect-ts -a claude-code. Файл навыка запишется в ~/.claude/skills/effect-ts/SKILL.md.

Для чего нужен скилл effect-ts?

Он помогает агенту писать идиоматичный код на Effect-TS: формировать генераторы Effect.gen, строить слои зависимостей через Layer и управлять каналами ошибок.

Сработает ли скилл на React useEffect?

Нет. В описании явно прописан запрет срабатывать на useEffect в React или побочные эффекты Redux, если контекст не связан с библиотекой Effect-TS.

Исходный текст

SKILL.md · MIT
---
name: effect-ts
description: Effect-TS library usage in TypeScript — Effect.gen generators, Schema.Struct/Schema.Class definitions, Layer/Context.Tag/Service patterns, Effect.pipe pipelines, Data.TaggedError/Data.Class error types, Ref/Queue/PubSub/Deferred concurrency primitives, Match module, Config providers, Scope/Exit/Cause/Runtime patterns, or any code using Effect's typed error channel (E parameter). Trigger when writing, reviewing, debugging, or refactoring TypeScript code that uses Effect — when you see imports from `effect`, `effect/*`, or any `@effect/*` scoped package (schema, platform, sql, opentelemetry, cli, cluster, rpc, vitest). Also trigger when the user asks about Effect patterns, migration from Promises/fp-ts/neverthrow to Effect, or how to structure an Effect application. Do NOT trigger for React's useEffect, Redux side effects, or general English usage of "effect" unless the context clearly involves the Effect-TS library.
---
# Effect TypeScript Best Practices

Effect is a TypeScript library for building complex, type-safe applications with structured
error handling, dependency injection via services/layers, fiber-based concurrency, and
resource safety.

## When to Apply

- Writing or reviewing TypeScript code that imports from `effect`, `@effect/schema`, or `@effect/platform`
- Implementing typed error handling with `Effect<Success, Error, Requirements>`
- Building services and layers for dependency injection
- Working with Schema for data validation, decoding, and transformation
- Using fiber-based concurrency (queues, semaphores, PubSub, deferred)
- Processing data with Stream and Sink
- Migrating from Promises, fp-ts, neverthrow, or ZIO to Effect

## How to Use

This skill is organized by domain. Read the relevant reference file for the area you're working in.

### Read First: The Paradigm

**Always read this before diving into API references**, especially when refactoring existing
code to use Effect or writing new Effect services:

| Reference | When to Read |
|-----------|-------------|
| [**Think in Effect: The Paradigm Shift**](references/getting-paradigm.md) | **Before any other reference.** Mental model shifts, refactoring recipes, anti-patterns, application architecture. Read this to understand HOW to think in Effect — the other files teach WHAT to type. |

### Core Foundations

| Reference | When to Read |
|-----------|-------------|
| [Getting Started](references/getting-started.md) | Creating the Effect type, pipelines, generators, running effects |
| [Error Management](references/error-management.md) | Typed errors, recovery, retrying, timeouts, sandboxing |
| [Core Concepts](references/core-concepts.md) | Request batching, configuration management, runtime system |

### Data & Validation

| Reference | When to Read |
|-----------|-------------|
| [Data Types](references/data-types.md) | Option, Either, Cause, Chunk, DateTime, Duration, Exit, Data |
| [Schema Basics](references/schema-basics.md) | Schema intro, basic usage, classes, constructors, effect data types |
| [Schema Advanced](references/schema-advanced.md) | Transformations, filters, annotations, error formatting, JSON Schema output |

### Architecture & Dependencies

| Reference | When to Read |
|-----------|-------------|
| [Requirements Management](references/req-management.md) | Services, Layers, dependency injection, layer memoization |
| [Resource Management](references/resource-management.md) | Scope, safe resource acquisition/release, caching |
| [State Management](references/state-management.md) | Ref, SubscriptionRef, SynchronizedRef for concurrent state |

### Concurrency & Streaming

| Reference | When to Read |
|-----------|-------------|
| [Concurrency](references/conc-concurrency.md) | Fibers, Deferred, Latch, PubSub, Queue, Semaphore |
| [Streams and Sinks](references/streams-and-sinks.md) | Creating, consuming, transforming streams; sink operations |
| [Scheduling](references/sched-scheduling.md) | Built-in schedules, cron, combinators, repetition |

### Platform & Observability

| Reference | When to Read |
|-----------|-------------|
| [Platform](references/plat-platform.md) | FileSystem, Command, Terminal, KeyValueStore, Path |
| [Observability](references/obs-observability.md) | Logging, metrics, tracing, Supervisor |
| [Testing](references/test-testing.md) | TestClock for time simulation; for service mocking and layer testing, see [Requirements Management](references/req-management.md) |

### Style, AI & Migration

| Reference | When to Read |
|-----------|-------------|
| [Code Style](references/code-style.md) | Branded types, pattern matching, dual APIs, guidelines, traits |
| [AI Integration](references/ai-integration.md) | Effect AI packages for LLM tool use and execution planning |
| [Micro](references/micro-module.md) | Lightweight Effect alternative for smaller bundles |
| [Migration Guides](references/migration-guides.md) | Coming from Promises, fp-ts, neverthrow, or ZIO |

## Quick Reference — Common Patterns

### The Effect Type
```ts
//         ┌─── Success type
//         │        ┌─── Error type
//         │        │      ┌─── Required dependencies
//         ▼        ▼      ▼
Effect<Success, Error, Requirements>
```

### Creating Effects
```ts
import { Effect } from "effect"

// From sync values
const succeed = Effect.succeed(42)
const fail = Effect.fail(new Error("oops"))

// From sync code that may throw
const sync = Effect.try(() => JSON.parse(data))

// From promises
const async = Effect.tryPromise(() => fetch(url))

// From generators (recommended for complex flows)
const program = Effect.gen(function* () {
  const user = yield* getUser(id)
  const todos = yield* getTodos(user.id)
  return { user, todos }
})
```

### Running Effects
```ts
// Async (returns Promise)
Effect.runPromise(program)

// With full Exit information
Effect.runPromiseExit(program)

// Sync (throws on async)
Effect.runSync(program)
```

### Typed Errors
```ts
import { Data, Effect } from "effect"

class NotFound extends Data.TaggedError("NotFound")<{
  readonly id: string
}> {}

class Unauthorized extends Data.TaggedError("Unauthorized")<{}> {}

// Error type is tracked: Effect<User, NotFound | Unauthorized>
const getUser = (id: string) =>
  Effect.gen(function* () {
    // ...
  })
```

### Services and Layers
```ts
import { Context, Effect, Layer } from "effect"

// Define a service
class UserRepo extends Context.Tag("UserRepo")<
  UserRepo,
  { readonly findById: (id: string) => Effect.Effect<User, NotFound> }
>() {}

// Use in effects — adds to Requirements channel
const program = Effect.gen(function* () {
  const repo = yield* UserRepo
  return yield* repo.findById("1")
})

// Implement with a Layer
const UserRepoLive = Layer.succeed(UserRepo, {
  findById: (id) => Effect.succeed({ id, name: "Alice" })
})

// Provide and run
program.pipe(Effect.provide(UserRepoLive), Effect.runPromise)
```

### Schema Validation
```ts
import { Schema } from "effect"

const User = Schema.Struct({
  id: Schema.Number,
  name: Schema.String,
  email: Schema.String.pipe(Schema.pattern(/@/))
})

type User = typeof User.Type

// Decode (parse + validate)
const decode = Schema.decodeUnknownSync(User)
const user = decode({ id: 1, name: "Alice", email: "[email protected]" })
```

### Pipelines
```ts
import { Effect, pipe } from "effect"

// Data-last (pipe style)
const result = pipe(
  getTodos,
  Effect.map((todos) => todos.filter((t) => !t.done)),
  Effect.flatMap((active) => sendNotification(active.length)),
  Effect.catchTag("NetworkError", () => Effect.succeed("offline"))
)

// Fluent (method style)
const result2 = getTodos.pipe(
  Effect.map((todos) => todos.filter((t) => !t.done)),
  Effect.flatMap((active) => sendNotification(active.length))
)
```

## Gotchas

See [gotchas.md](gotchas.md) for known failure points.

© pproenca · MIT · pproenca/dot-skills

Похожие скиллы

Все скиллы по теме «Языки программирования» →

Сначала — effect-ts от других авторов.

effect-ts Effect-TS Скилл effect-ts для Claude Code помогает настроить репозиторий с библиотекой Effect TypeScript. Он включается при подготовке такого проекта к работе. CX Codex +1 8 700установок effect-ts PaulRBerg Скилл effect-ts для нетривиальной работы с Effect 4: сервисы, слои, типизированные ошибки, Schema, Config и рантайм. Помогает агенту не путать API v3 и v4. CX Codex +1 3 100установок effect-ts joelhooks Скилл effect-ts для Claude Code: учит агента писать код на Effect v4 по официальным практикам — сервисы, слои, ошибки и схемы. Держит проект на актуальном API вместо устаревших сигнатур. CX Codex +1 1 100установок effect-ts pedronauck Скилл для работы с Effect-TS, библиотекой функционального программирования на TypeScript. Помогает писать типобезопасный код с обработкой ошибок, асинхронностью и управлением ресурсами через Effect, Schema, Pattern Matching и Context.Tag. CX Codex +1 264установок effect-best-practices Makisuo Скилл effect-best-practices для Claude Code задаёт правила написания кода на Effect-TS: для сервисов, ошибок, слоёв и атомов. Описывает стиль для проектов на Effect. CX Codex +1 844установок effect kitlangton Скилл подсказывает, как строить TypeScript-приложения на Effect v4: сервисы, схемы, конфигурацию, HTTP-клиенты и тесты. CX Codex +1 2 900установок error-handling affaan-m Скилл error-handling задаёт единые правила обработки ошибок в TypeScript, Python и Go: типизированные исключения, ретраи, circuit breaker, тексты для пользователя. CX Codex +1 6 600установок effect-v3-to-v4 Effect-TS Скилл effect-v3-to-v4 для Claude Code и других агентов. Переносит кодовую базу с Effect v3 на v4 по сгенерированному справочнику миграции, обновляя effect и пакеты @effect/* через границу версий. CX Codex +1 772установок ax-add-ingest-stage Necmttn Скилл ax-add-ingest-stage помогает добавить новую стадию обработки данных или таблицу SurrealDB в проект ax. Предотвращает ошибки в тестах и пайплайнах CI. CX Codex +1 ★ 124звёзд репо functional citypaul Скилл functional для Claude Code подсказывает, как писать преобразования данных без утечки мутаций и применять чистые функции. Помогает менять логику, списки и объекты, в том числе в проектах на Effect. CX Codex +1 1установок

Из того же набора139

Весь набор →
ios-chaos-monkey Скилл ios-chaos-monkey для Claude Code содержит правила и TDD-сценарии для выявления крашей и гонок данных в iOS на Swift 6.2. CX Codex +1 274установок nginx-c-module-perf Скилл nginx-c-module-perf даёт рекомендации по производительности и отказоустойчивости модулей nginx на C. Пригодится при настройке буферов, соединений, кэша и обработки ошибок. CX Codex +1 267установок react-native-elements Скилл подсказывает, как применять React Native Elements: настраивать темы, выбирать компоненты и собирать производительные списки. Пригодится при разработке и проверке React Native-приложений. CX Codex +1 265установок bug-review Скилл bug-review для Claude Code выполняет пять параллельных проходов по диффу PR, отбирает находки большинством голосов и проверяет их отдельным валидатором на Opus. Баги выявляются до мержа. CX Codex +1 264установок nginx-c-module-debug Скилл nginx-c-module-debug для Claude Code помогает разбирать падения nginx C-модулей, ошибки памяти и сбои в потоке запросов. Для диагностики используются GDB, core dump и трассировка. CX Codex +1 260установок rust-write-tests Скилл rust-write-tests направляет агента при написании надёжных тестов на Rust: проверяет инварианты, выносит тесты в отдельные файлы и устраняет флакующие проверки. CX Codex +1 257установок rails-application-ui-blocks Скилл rails-application-ui-blocks собирает страницы Ruby on Rails и обновляет ERB-шаблоны готовыми блоками UI без потери Stimulus и Turbo. CX Codex +1 257установок rust-implement Скилл rust-implement организует написание Rust-кода в четыре прохода: от проектирования типов и сигнатур до чистки и запуска скрипта проверки. CX Codex +1 254установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой