Agent skill

Effect V4

by backpine in backpine/effect-worker-mono

A skill your agent uses when writing, debugging, or reviewing Effect-TS v4 (4.0.0-beta) code in this repo — resolving an Effect API, verifying a signature/error shape, or finding idiomatic usage.

MITAuto-check passedDevelopment

Install Effect V4

skills CLI
$ npx skills add backpine/effect-worker-mono --skill effect-v4 -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install backpine/effect-worker-mono effect-v4 --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/backpine/effect-worker-mono.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/effect-v4 .claude/skills/effect-v4 && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
effect-v4
GitHub stars
132
Token cost
~937 tokens
SKILL.md length
368 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when writing, debugging, or reviewing Effect-TS v4 (4.0.0-beta) code in this repo — resolving an Effect API, verifying a signature/error shape, or finding idiomatic usage.

  • Reviewing Effect-TS v4 (4.0.0-beta) code in this repo — resolving an Effect API
  • SKILL.md covers Golden rule, Where things live, How to use it and Hard rules, plus 1 more section
  • Calls git and rg; reaches github.com
  • Verifying a signature/error shape

What it does

Effect V4 is an agent skill from backpine/effect-worker-mono. Use when writing, debugging, or reviewing Effect-TS v4 (4.0.0-beta) code in this repo — resolving an Effect API, verifying a signature/error shape, or finding idiomatic usage. v4 is a fast-moving beta whose web docs are outdated; this skill points you at the vendored Effect source (repos/effect) so you read real implementations instead of guessing or applying stale v3 patterns. Trigger on any uncertainty about an effect import, module, type, or effect/unstable/ API.

Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with SQL. The licence is MIT.

When your agent uses it

  • Reviewing Effect-TS v4 (4.0.0-beta) code in this repo — resolving an Effect API
  • Verifying a signature/error shape
  • Finding idiomatic usage
  • Any uncertainty about an effect import

Example prompts

  • “/effect-v4”

What it can do on your machine

Read from SKILL.md and the folder at commit c1a6559. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • rg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Effect V4 loads about 937 tokens when it runs. Until then it costs about 121 tokens; SKILL.md has 368 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~121
When it runs · the whole SKILL.md, loaded when a task matches
~937

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from backpine/effect-worker-mono at commit c1a6559, republished under its MIT licence (© backpine). 368 words, ~937 tokens.

Download SKILL.mdSave it as .claude/skills/effect-v4/SKILL.md (or your agent's skills folder).
name
effect-v4
description
Use when writing, debugging, or reviewing Effect-TS v4 (4.0.0-beta) code in this repo — resolving an Effect API, verifying a signature/error shape, or finding idiomatic usage. v4 is a fast-moving beta whose web docs are outdated; this skill points you at the vendored Effect source (repos/effect) so you read real implementations instead of guessing or applying stale v3 patterns. Trigger on any uncertainty about an `effect` import, module, type, or `effect/unstable/*` API.

Effect v4 source reference

This repo runs Effect v4 (4.0.0-beta.70). Public docs lag the real APIs, and v3 patterns frequently do not apply. The complete Effect v4 source is vendored at repos/effect (a git subtree of Effect-TS/effect-smol, the v4 dev repo, pinned to the effect@4.0.0-beta.70 tag — it matches the installed version exactly). v4 lives in effect-smol, NOT Effect-TS/effect (still v3). Treat it as the authoritative reference — read it instead of guessing or trusting web search.

Golden rule

Don't assume — read the source. If you are about to write an Effect v4 API call and you are not 100% certain of its current shape, look it up in repos/effect first. The cost of a grep is far lower than the cost of a wrong v3-flavored guess.

Where things live

All under repos/effect/packages/effect/src/. Module name maps 1:1 to the import:

ImportSource
effect (e.g. Context, Effect, Layer, Schema, Data, DateTime)src/<Module>.ts
effect/unstable/httpsrc/unstable/http/
effect/unstable/httpapisrc/unstable/httpapi/
effect/unstable/rpcsrc/unstable/rpc/
effect/unstable/sqlsrc/unstable/sql/
effect/unstable/reactivity (Atom)src/unstable/reactivity/

@effect/sql-pg and @effect/atom-react live under repos/effect/packages/.

How to use it

  • Resolve / verify an API: open repos/effect/packages/effect/src/<Module>.ts and read the exported declare const / class / interface. Grep for the symbol: rg "export (declare const|class|interface) <Name>" repos/effect/packages/effect/src
  • Find idiomatic usage: search tests and examples — rg "<api>" repos/effect/packages/effect/test repos/effect/packages/effect/examples
  • Confirm an error/option shape before constructing it (constructors changed a lot between betas).
Show full SKILL.md (150 more words)Show less

Hard rules

  • repos/effect is read-only reference material. Never edit it, never import from it, never copy its files into packages/ or apps/.
  • App/package code depends on the published effect package via the pnpm-workspace.yaml catalog — not the vendored tree.
  • It's excluded from search/auto-import/watching (.vscode/settings.json) and from the pnpm / tsc / vitest workspaces, so it won't interfere with builds.
  • To refresh it: git subtree pull --prefix=repos/effect https://github.com/Effect-TS/effect-smol.git effect@4.0.0-beta.70 --squash (re-pin the tag to whatever version the catalog uses; use main for the latest)

Known v4 deltas (verify against source if in doubt)

  • ServiceMap → Context: the module was renamed back to Context. Use Context.Service<Self, Shape>()("Id"), Context.Reference<T>("Id", { defaultValue }), Context.make(key, value), Context.add, Context.get.
  • SqlError wraps a structured reason: new SqlError.SqlError({ reason: new SqlError.UnknownError({ cause }) }) (the cause field is now derived, not a constructor arg).
  • Service keys are yieldable directly: const db = yield* Database (no FiberRef.get).
  • See CLAUDE.md → "Effect v4 — Vendored Source Reference" for the project-level summary.

© backpine, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/effect-v4 of backpine/effect-worker-mono.

Open the folder on GitHubat commit c1a6559

Compare with similar skills

Effect V4 next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Effect V4 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Effect V4 this skillbackpine/effect-worker-mono132—~937Automated safety check: PassMIT
Review PRapache/shardingsphere21k—~6.4kAutomated safety check: PassApache-2.0
Coding Standardsapache/shardingsphere21k—~2.2kAutomated safety check: PassApache-2.0
SeekDB Code Reviewoceanbase/seekdb3.1k—~2.1kAutomated safety check: PassApache-2.0
Code Nest Project Specxiaou61/Code-Nest770—~1.3kAutomated safety check: PassMIT
Mariadb Operator Commentmariadb-operator/mariadb-operator1k—~2.2kAutomated safety check: PassApache-2.0

Similar skills

  • Review PR

    apache/shardingsphere

    Review Apache ShardingSphere or user-authorized downstream pull requests and PR discussions from public or authorized repository evidence.

    21k GitHub stars~6.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Coding Standards

    apache/shardingsphere

    Apply Apache ShardingSphere's written coding standards when explicitly requested, or when code-implementation routes task-changed production, test, script, build, generated, or Maven POM artifacts…

    21k GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed
  • SeekDB Code Review

    oceanbase/seekdb

    Reviews seekdb pull requests and diffs for real defects in correctness, resources, concurrency, security and tests, reporting only Blocker or Major findings.

    3.1k GitHub stars~2.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Code Nest Project Spec

    xiaou61/Code-Nest

    Code-Nest 多模块全栈项目协作规范与落点导航。Use when modifying this repository for feature development, bug fixing, refactor, API change, SQL migration, or frontend-backend联调 so changes land in the correct module…

    770 GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Mariadb Operator Comment

    mariadb-operator/mariadb-operator

    Post a comment (or a formal PR review) to a GitHub issue or pull request in mariadb-operator/mariadb-operator.

    1k GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Smt E2E Dataflow Debugging

    GoogleCloudPlatform/DataflowTemplates

    Debugs logical errors and data discrepancies in Dataflow templates by launching jobs via Terraform and comparing source (e.g.

    1.3k GitHub stars~1.8k tokensUpdated today
    DevelopmentAuto-check passed

More from backpine/effect-worker-mono

  • Standard Jsdoc

    backpine/effect-worker-mono

    Write, insert, or update Effect public API JSDoc so it satisfies the standard-jsdoc oxlint rule.

    132 GitHub stars~1.3k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Effect V4

What does Effect V4 do?

A skill your agent uses when writing, debugging, or reviewing Effect-TS v4 (4.0.0-beta) code in this repo — resolving an Effect API, verifying a signature/error shape, or finding idiomatic usage. Effect V4 is an agent skill from backpine/effect-worker-mono.0-beta) code in this repo — resolving an Effect API, verifying a signature/error shape, or finding idiomatic usage.

When should I use Effect V4?

Effect V4 fits situations like: reviewing Effect-TS v4 (4.0.0-beta) code in this repo — resolving an Effect API; verifying a signature/error shape; finding idiomatic usage; any uncertainty about an effect import.

How do I install Effect V4 in Claude Code?

Run `npx skills add backpine/effect-worker-mono --skill effect-v4 -a claude-code`. Or copy the skill folder (.claude/skills/effect-v4 in backpine/effect-worker-mono) into .claude/skills/effect-v4 in your project. Claude Code loads it when a task matches its description.

How do I install Effect V4 in Codex?

Run `npx skills add backpine/effect-worker-mono --skill effect-v4 -a codex`. Or copy the skill folder (.claude/skills/effect-v4 in backpine/effect-worker-mono) into .agents/skills/effect-v4 in your project. Codex loads it when a task matches its description.

Can I use Effect V4 in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add backpine/effect-worker-mono --skill effect-v4 -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/effect-v4, .gemini/skills/effect-v4, .github/skills/effect-v4 and .opencode/skills/effect-v4 in your project.

What does Effect V4 need to run?

Going by SKILL.md and its folder, Effect V4 needs the command-line tools its instructions call (git and rg).

Does Effect V4 access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Effect V4 safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Effect V4 use?

Effect V4 is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Effect V4 use?

About 937 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Effect V4?

Skills that share tags, products or a category with Effect V4: Review PR (apache/shardingsphere, 21k stars), Coding Standards (apache/shardingsphere, 21k stars), SeekDB Code Review (oceanbase/seekdb, 3.1k stars) and Code Nest Project Spec (xiaou61/Code-Nest, 770 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Effect V4?

backpine (a GitHub organization) maintains it in backpine/effect-worker-mono, which has 132 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on May 26, 2026.

Source: backpine/effect-worker-mono on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.