skill CX Codex

effect-ts · effect-ts — Claude Code skill: what it does, how to install

Q: How do I install effect-ts in Claude Code?

Run `npx skills add Effect-TS/skills --skill effect-ts -a claude-code`, then run `npx skills add Effect-TS/skills --skill effect-ts -a claude-code` again. The skill file is at `~/.claude/skills/effect-ts/SKILL.md`.

Q: What should the agent read before writing Effect code?

It should first read `node_modules/effect/AGENTS.md` completely and follow links from that file when needed. For API details beyond the guide, it searches `node_modules/effect/src`.

This skill sets up a repository that uses the Effect Typescript library and tells the agent where to read its guidance and source.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add Effect-TS/skills --skill effect-ts -a claude-code

Open on GitHub

What effect-ts does

The skill prepares a repository built with the Effect Typescript library. It installs effect@latest with pnpm; in a monorepo, it advises adding the package as a dev dependency at the root so the source is available under node_modules/effect/src.

It also adds guidance to AGENTS.md or CLAUDE.md. Before writing Effect code, the agent must read node_modules/effect/AGENTS.md completely, follow relevant links, and search node_modules/effect/src when the guide does not cover an API or concept. Check the monorepo root first, because that is where the package is installed.

The skill is available for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.

What it helps with

set up a repository that uses Effect Typescript
install effect@latest with pnpm
add agent guidance for Effect code
search Effect APIs in the library source

Example prompts for the agent

Set up this repository for Effect Typescript and update AGENTS.md.
Before writing Effect code, read node_modules/effect/AGENTS.md completely and follow the relevant links.
If the guide does not cover the API, search for it in node_modules/effect/src.

How to install effect-ts

1Skills CLI (Vercel)

npx skills add Effect-TS/skills --skill effect-ts -a claude-code

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/effect-ts/

1Skills CLI (Vercel)

npx skills add Effect-TS/skills --skill effect-ts -a codex

2Manually: put the files in place

.agents/skills/effect-ts/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add Effect-TS/skills --skill effect-ts -a cursor

2Manually: put the files in place

.cursor/skills/effect-ts/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install Effect-TS/skills effect-ts

2Manually: put the files in place

.github/skills/effect-ts/SKILL.md

1Skills CLI (Vercel)

npx skills add Effect-TS/skills --skill effect-ts -a gemini-cli

2Platform CLI

gemini skills install https://github.com/Effect-TS/skills --path skills/effect-ts

Manually: put the files in place

.devin/skills/effect-ts/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add Effect-TS/skills --skill effect-ts -a opencode

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 Effect-TS/skills --skill effect-ts -a claude-code, then run npx skills add Effect-TS/skills --skill effect-ts -a claude-code again. The skill file is at ~/.claude/skills/effect-ts/SKILL.md.

What does effect-ts do?

The skill prepares a repository that uses the Effect Typescript library: it installs effect@latest and gives the agent rules for reading Effect guidance and source code.

What should the agent read before writing Effect code?

It should first read node_modules/effect/AGENTS.md completely and follow links from that file when needed. For API details beyond the guide, it searches node_modules/effect/src.

Source text

SKILL.md · MIT

---
name: effect-ts
description: Use this skill when setting up a repository that uses the Effect Typescript library.
---

# Step 1: Install effect

Use the users preferred package manager:

```
pnpm add effect@latest
```

If in a monorepo, install it as a dev dependency at the root, so you can access
the source code from `node_modules/effect/src`.

```
pnpm add -D effect@latest
```

# Step 2: Update AGENTS.md / CLAUDE.md

Ensure that the agent instructions contain the following:

```md
# Learning more about Effect

This repository uses the Effect Typescript library.

Before writing any Effect code, first read `node_modules/effect/AGENTS.md`
**completely**, and follow the links in the file when required.

If you need to learn more about particular Effect apis and concepts that the
guide doesn't cover, search through the source code in `node_modules/effect/src`.
```

effect-ts by other authors comes first.

effect-ts PaulRBerg A skill for nontrivial Effect 4 work: services, layers, typed errors, Schema, Config and runtime. Keeps the agent from mixing up v3 and v4 APIs. CX Codex +1 3,100installs effect-best-practices Makisuo A skill that makes the agent follow Effect-TS conventions for services, errors, layers and atoms. Useful when the codebase already runs on Effect. CX Codex +1 840installs effect kitlangton A guide for building TypeScript applications with Effect v4, covering services, schemas, configuration, HTTP clients, streams, and tests. CX Codex +1 2,500installs cause-and-effect NeoLabHQ Runs structured Ishikawa diagram investigations on development bottlenecks. Pinpoints root causes across technical and team factors. CX Codex +1 1,200installs serial-position-effect Owl-Listener A skill that applies the serial position effect: it tells the agent which items belong first and last, and what lands in the memory valley. CX Codex +1 1,000installs no-use-effect Factory-AI A skill that stops the agent from writing useEffect in React code and points to five replacements. Useful during refactors and PR review. CX Codex +1 1,000installs thinking-lindy-effect tjboudreaux A skill that turns a technology's age into an argument for the proven option. Useful when choosing a language, framework or database for the long run. CX Codex +1 553installs

From the same set2

effect-v3-to-v4 Drives an Effect v3 to v4 migration from the generated reference that ships in the Effect repo. Useful when you upgrade effect or any @effect/* package across the version boundary. CX Codex +1 704installs