Effect V4

Write, review, or upgrade Effect v4 code in the Composio CLI, cli-keyring, and json-schema-to-effect-schema packages, all using the matching range effect@^4.1.0 — Context.Service and explicit layers, Schema.TaggedError and typed recovery, the effect/cli command surface, and the vendored effect source oracle. Use when writing or reviewing Effect v4 code, answering a v4 API question, working in effect/cli, defining a Context.Service service, modeling an error with Schema.TaggedError, bumping the Effect pins, or verifying an unfamiliar API against ts/vendor/effect. Do not use for CLI command UX/w

31,162 stars 4,960 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add ComposioHQ/composio --skill effect-v4
Manual install
git clone --depth 1 https://github.com/ComposioHQ/composio.git /tmp/composio
mkdir -p ~/.claude/skills
cp -r /tmp/composio/.agents/skills/effect-v4 ~/.claude/skills/effect-v4

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Effect v4

The CLI, `@composio/cli-keyring`, and `@composio/json-schema-to-effect-schema` run on
Effect v4. Every claim below is grounded in the migrated source, not memory of v3.

## Version matrix

`effect`, `@effect/platform-bun`, and `@effect/vitest`
use the **same range** `^4.1.0`; keep their lockfile resolutions aligned. Do not use
`@next` or mismatched versions across packages. `@effect/cli` and `@effect/platform` no longer exist as
dependencies; their surfaces are consolidated into `effect` and `effect/*`.
See [versions.json](versions.json) for the exact example-check matrix (also `typescript`, `vitest`).

## Read next

- [references/core-patterns.md](references/core-patterns.md) — services, layers, typed
  errors, Schema, choosing between `Effect.gen` and `Effect.fn`, `Option` combinators in
  place of `isSome` ternaries, driving time in tests with
  `TestClock` (fork, adjust until the fiber settles, join) instead of `it.live`, and the v3→v4 rename table
  (labeled historical, for recognizing stale patterns).
- [references/cli-surface.md](references/cli-surface.md) — `effect/cli`:
  `Command`, `Flag`, `Argument`, `GlobalFlag`, `CliConfig`, the custom
  `CliOutput.Formatter`, and the runner's double-print rule.
- [references/upgrade-workflow.md](references/upgrade-workflow.md) — procedure for
  bumping to a newer release.

References label source excerpts and standalone framework examples separately. Repo-linked
Read the full skill on GitHub

Details

Skill name
effect-v4
Path
.agents/skills/effect-v4/SKILL.md
License
MIT
Repo updated
18 November 2026

FAQ

What does the Effect V4 skill do?

Write, review, or upgrade Effect v4 code in the Composio CLI, cli-keyring, and json-schema-to-effect-schema packages, all using the matching range effect@^4.1.0 — Context.Service and explicit layers, Schema.TaggedError and typed recovery, the effect/cli command surface, and the vendored effect source oracle. Use when writing or reviewing Effect v4 code, answering a v4 API question, working in effect/cli, defining a Context.Service service, modeling an error with Schema.TaggedError, bumping the Effect pins, or verifying an unfamiliar API against ts/vendor/effect. Do not use for CLI command UX/w

How do I install the Effect V4 skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add ComposioHQ/composio --skill effect-v4. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Effect V4 popular?

It lives in ComposioHQ/composio, which has 31,162 GitHub stars and 4,960 forks, and is included in 1 curated skill list.

Related skills

Bug Fixing

31k

ComposioHQ/composio

Fix defects in the Composio SDK repository with focused reproduction, root-cause analysis, regression tests, and narrow verification. Use when the user reports a bug, failing test, CI regression, runtime defect, or incorrect SDK behavior. Do not use for new feature design or broad refactors.

Software DevelopmentIn 1 list5k

CLI Command

31k

ComposioHQ/composio

Design, implement, or review Composio CLI commands under ts/packages/cli using Effect, effect/cli, services, output conventions, configuration and environment variables, and local vendor references. Use for CLI command UX, command wiring, service changes, or CLI source edits. Do not use for CLI E2E-only work; use cli-e2e there.

Software DevelopmentIn 1 list5k

CLI E2E

31k

ComposioHQ/composio

Write, modify, or debug Docker-based Composio CLI end-to-end tests under ts/e2e-tests/cli, including binary invocation, fixture isolation, output assertions, and package manifests. Use for CLI E2E test suites only; use cli-command for CLI source implementation.

Testing & QAIn 1 list5k

Python Providers

31k

ComposioHQ/composio

Create, modify, test, or package Python provider adapters under python/providers, including framework-specific dependencies, public imports, type inference, and provider metadata. Use for Python provider work only; use python-sdk for core SDK changes.

Software DevelopmentIn 1 list5k

Cross SDK Parity

31k

ComposioHQ/composio

Keep TypeScript and Python SDK behavior, generated client usage, public API naming, and docs examples aligned. Use when a change affects both SDKs, when generated client pins move, when comparing TS/Python behavior, or when a backend API contract changed. Do not use for single-language internal-only changes.

Software DevelopmentIn 1 list5k

Python Release

31k

ComposioHQ/composio

Handle Python SDK release, build, bump, packaging metadata, PyPI client pin, uv.lock, nox/build workflow, and publish verification changes. Use for Python release process work or dependency pin bumps; do not use for ordinary Python feature implementation.

Software DevelopmentIn 1 list5k

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.