Agent skill

Effect TS

by pedronauck in pedronauck/skills

Expert guide for writing Effect-TS code, including project setup, core principles, data modeling with Schema, error handling, and the Context.Tag service pattern.

No licenceAuto-check passedDevelopment

Install Effect TS

skills CLI
$ npx skills add pedronauck/skills --skill effect-ts -a claude-code

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

GitHub CLI
$ gh skill install pedronauck/skills effect-ts --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/pedronauck/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/curated/effect-ts .claude/skills/effect-ts && 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-ts
GitHub stars
634
Token cost
~2.3k tokens
SKILL.md length
461 words
Files
20 (incl. references)
Skills in repo
65
Repo updated
First seen
Licence
None found

At a glance

Expert guide for writing Effect-TS code, including project setup, core principles, data modeling with Schema, error handling, and the Context.Tag service pattern.

  • Works in 7 steps: Effect is not just for async — Use… → Immutability — Use Effect's immutable… → Type Safety — Track errors in types. No… → …
  • Analyzing TypeScript code using the Effect library
  • SKILL.md covers Reference Documents, Core Principles, Quick Reference and Forbidden Patterns, plus 3 more sections
  • Calls pnpm

What it does

Effect TS is an agent skill from pedronauck/skills. Expert guide for writing Effect-TS code, including project setup, core principles, data modeling with Schema, error handling, and the Context.Tag service pattern. Use when writing, refactoring, or analyzing TypeScript code using the Effect library.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including reference files (for example `references/api-platform-observability.md`, `references/batching-and-caching.md` and `references/class-patterns.md`).

It sits in Development, covering Database schema design, Error handling and Refactoring. It works with TypeScript. The repository describes itself as: My personal favorite skills.

When your agent uses it

  • Analyzing TypeScript code using the Effect library
  • Tasks that involve Database schema design
  • Tasks that involve Error handling

Example prompts

  • “/effect-ts”

Requirements

  • Pre-approved tools (allowed-tools): Read, Grep, Glob

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Effect is not just for async — Use Effect for any fallible operation
  2. Immutability — Use Effect's immutable data structures (Data, Chunk, HashSet)
  3. Type Safety — Track errors in types. No any or unknown in error channels
  4. Composition — Build programs by composing small Effects
  5. Schema-First — Define data models using Schema with branded types
  6. Pattern Matching — Use Match for all branching over tagged unions (never switch/if-else on _tag)
  7. Effect Data Types — Use Option (not null), Either (not ad-hoc), Duration (not raw ms), DateTime (not Date), BigDecimal (not floats)…

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    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 TS loads about 2.3k tokens when it runs, and up to ~49k if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 461 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~49k

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 461 words (~2,311 tokens).

“Guidelines, patterns, and best practices for Effect-TS in this project.”

— opening of SKILL.md by pedronauck
name
effect-ts
allowed-tools
Read, Grep, Glob

Read the full SKILL.md on GitHub

Files

SKILL.md and 19 other files (references) in skills/curated/effect-ts of pedronauck/skills.

  • SKILL.md
  • references/api-platform-observability.md
  • references/batching-and-caching.md
  • references/class-patterns.md
  • references/concurrency-and-resources.md
  • references/construction-and-style.md
  • references/control-flow-and-runtime.md
  • references/core-patterns.md
  • references/data-and-testing.md
  • references/data-types.md
  • references/error-handling-patterns.md
  • references/foundations.md
  • references/library-development-patterns.md
  • references/pattern-matching.md
  • references/quality-tooling-and-resources.md
  • references/schema-errors-config.md
  • references/schema-transforms-and-filters.md
  • references/sink.md
  • references/streams-deep-dive.md
  • references/testing-patterns.md

Open the folder on GitHubat commit 0422940

Compare with similar skills

Effect TS 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 TS compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Effect TS this skillpedronauck/skills634—~2.3kAutomated safety check: PassNone
Effect TSmattiacerutti/supernova186—~2.8kAutomated safety check: PassMIT
Effect TStellahq/opensession392—~3.7kAutomated safety check: PassMIT
Databuddy Internaldatabuddy-analytics/Databuddy1.2k—~11kAutomated safety check: NotesAGPL-3.0
Rust Best Practicesfarm-fe/farm5.6k3 repos~1.1kAutomated safety check: PassMIT
Svelte5 Best PracticesSikandarJODD/cnblocks4301 repos~810Automated safety check: PassMIT

Similar skills

  • Effect TS

    mattiacerutti/supernova

    Write idiomatic Effect v4 TypeScript following official best practices from effect-solutions and the Effect source.

    186 GitHub stars~2.8k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Effect TS

    tellahq/opensession

    Write idiomatic Effect v4 TypeScript verified against the pinned effect@4.0.0-rc.112 source.

    392 GitHub stars~3.7k tokensUpdated today
    Testing & QAAuto-check passed
  • Databuddy Internal

    databuddy-analytics/Databuddy

    Work inside the Databuddy monorepo for internal implementation, debugging, review, and refactoring.

    1.2k GitHub stars~11k tokensUpdated today
    DevelopmentAuto-check: notes
  • Guide for writing idiomatic Rust code based on Apollo GraphQL's best practices handbook.

    5.6k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Svelte5 Best Practices

    SikandarJODD/cnblocks

    Svelte 5 runes, snippets, SvelteKit patterns, and modern best practices for TypeScript and component development.

    430 GitHub starsUsed in 1 repo~810 tokens
    DevelopmentAuto-check passed
  • Dinero Best Practices

    dinerojs/dinero.js

    Core best practices for the Dinero.js money library. An agent skill from dinerojs/dinero.js.

    6.8k GitHub stars~756 tokensUpdated 3 days ago
    DevelopmentAuto-check passed

More from pedronauck/skills

All 65 skills in this repo
  • Deep Review

    pedronauck/skills

    Review branch diffs, working trees, or PRs in depth with defect, polish and cross-contract coverage.

    634 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Yc Apply

    pedronauck/skills

    Prepare, review, and package Y Combinator application answers and founder-video notes using the live form and verified founder facts.

    634 GitHub stars~1.3k tokensUpdated 24 days ago
    Auto-check passed
  • Guide technical communication for software developers. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 3 repos~2.3k tokens
    Auto-check passed
  • Tauri V2

    pedronauck/skills

    Tauri v2+ cross-platform app development with Rust backend. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 2 repos~4.1k tokens
    Auto-check passed
  • Hormozi Ad Factory

    pedronauck/skills

    Generates 150-750+ ad variations using Alex Hormozi's combinatorial Hook x Meat x CTA framework.

    634 GitHub stars~2.1k tokensUpdated 24 days ago
    Auto-check passed
  • Yt Master

    pedronauck/skills

    Plans and improves YouTube ideas, titles, thumbnail concepts, scripts, retention, channel strategy, and metric-based diagnosis.

    634 GitHub stars~736 tokensUpdated 24 days ago
    Auto-check passed

Works with

Questions about Effect TS

What does Effect TS do?

Expert guide for writing Effect-TS code, including project setup, core principles, data modeling with Schema, error handling, and the Context.Tag service pattern. Effect TS is an agent skill from pedronauck/skills.Tag service pattern.

When should I use Effect TS?

Effect TS fits situations like: analyzing TypeScript code using the Effect library; tasks that involve Database schema design; tasks that involve Error handling.

How do I install Effect TS in Claude Code?

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

How do I install Effect TS in Codex?

Run `npx skills add pedronauck/skills --skill effect-ts -a codex`. Or copy the skill folder (skills/curated/effect-ts in pedronauck/skills) into .agents/skills/effect-ts in your project. Codex loads it when a task matches its description.

Can I use Effect TS 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 pedronauck/skills --skill effect-ts -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-ts, .gemini/skills/effect-ts, .github/skills/effect-ts and .opencode/skills/effect-ts in your project.

What does Effect TS need to run?

Going by SKILL.md and its folder, Effect TS needs the command-line tools its instructions call (pnpm). Its frontmatter pre-approves these tools: Read, Grep, Glob.

Does Effect TS access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Effect TS 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 TS use?

No licence was found for Effect TS or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Effect TS use?

About 2.3k tokens (SKILL.md is roughly 9.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 47k tokens, read only when the agent opens those files.

What are the alternatives to Effect TS?

Skills that share tags, products or a category with Effect TS: Effect TS (mattiacerutti/supernova, 186 stars), Effect TS (tellahq/opensession, 392 stars), Databuddy Internal (databuddy-analytics/Databuddy, 1.2k stars) and Rust Best Practices (farm-fe/farm, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Effect TS?

pedronauck (a GitHub user) maintains it in pedronauck/skills, which has 634 GitHub stars. The repository holds 65 skills in this directory. The repository was last updated on September 14, 2026.

Source: pedronauck/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.