effect-collections

Guide TypeScript developers in selecting Effect Array, Chunk, Record, and HashMap primitives.

5|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/agentxm/axm --skill effect-collections
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: effect-collections
Source: https://github.com/agentxm/axm/tree/main/.axm/extensions/%40axm/skills/effect-collections/src
Command: npx skills add https://github.com/agentxm/axm --skill effect-collections

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing data collections in TypeScript and JavaScript often forces you to choose a single structure and accept performance or immutability tradeoffs. This Skill guides when to use Effect's Array, Chunk, Record, and HashMap modules to select the right tool for the job and keep transformations safe and predictable.

Core Features & Use Cases

  • Native-collection guidance: when to use Array for standard transformations and how to leverage Array utilities like filterMap and getSomes.
  • Performance-focused choices: replace repeated concatenations with Chunk and use HashMap for value-based keys.
  • Immutability and type-safety: immutable APIs and type-safe transforms for robust data pipelines.
  • Use cases: data shaping, configuration management, and complex-key mappings in TypeScript projects.

Quick Start

Start by importing Effect's Array utilities and run a simple transformation that filters and maps an array using safe Option-based patterns.

Frequently Asked Questions about effect-collections

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
When should I use Chunk instead of Array for TypeScript data transformations?

Use Chunk instead of Array in TypeScript when handling repeated concatenations in performance-sensitive data pipelines. Chunk optimizes these operations by avoiding the costly array copies that standard Array concatenation triggers, ensuring efficient immutable transformations.

How does HashMap handle complex keys in Effect?

HashMap in Effect handles complex keys by using value-based equality rather than reference equality. This allows you to safely map and retrieve data using object or structural keys in TypeScript without relying on shared object references.

What is the best way to safely filter and map arrays in TypeScript?

The best way to safely filter and map arrays in TypeScript is using Effect's Array utilities like filterMap and getSomes. These modules apply Option-based patterns to perform safe, immutable data transformations without runtime errors.

Can I use Effect Record modules for immutable configuration management?

Yes, you can use Effect Record modules for immutable configuration management. They provide type-safe transforms and immutable APIs that ensure predictable data shaping and robust handling of key-value configuration structures.

Why does using standard JavaScript arrays cause immutability tradeoffs in data pipelines?

Standard JavaScript arrays cause immutability tradeoffs because native mutation methods break predictable data flows. Effect solves this by providing immutable Array and Chunk APIs that enforce safe transformations in scalable TypeScript pipelines.