effect-conventions

Enforce Effect-TS design patterns and conventions for the Maslow codebase.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/twlines/maslow --skill effect-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: effect-conventions
Source: https://github.com/twlines/maslow/tree/main/skills/effect-conventions
Command: npx skills add https://github.com/twlines/maslow --skill effect-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides clear guidelines and examples for adhering to Effect-TS patterns and avoiding anti-patterns within the Maslow codebase, ensuring consistency and maintainability.

Core Features & Use Cases

  • Service Pattern Definition: Demonstrates the standard structure for defining services using Context.Tag and Layer.effect.
  • Resource Management: Outlines the correct use of Layer.scoped with Effect.addFinalizer for managing resources like databases and HTTP clients.
  • Error Handling: Emphasizes specifying error channels in Effect.Effect and avoiding any types.
  • Use Case: A new developer joining the Maslow project can use this Skill to quickly understand and implement Effect-TS code according to established project standards, preventing common mistakes.

Quick Start

Consult the effect-conventions skill for guidance on structuring a new Effect-TS service.

Frequently Asked Questions about effect-conventions

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

FAQPage Schema
How do I structure Effect-TS services using Context.Tag and Layer.effect?

Effect-TS services should be structured using Context.Tag for tagging and Layer.effect for initialization. This standard pattern ensures proper dependency injection and maintainability within the codebase.

What is the best way to manage resources with Layer.scoped in Effect-TS?

Layer.scoped manages resources safely in Effect-TS by pairing acquisition with Effect.addFinalizer. This pattern guarantees proper cleanup for databases and HTTP clients when the application scope terminates.

How do you handle error channels in Effect.Effect without using any types?

Error handling in Effect.Effect requires explicitly specifying the error channel type instead of relying on any. This strict typing prevents runtime failures and ensures all potential errors are managed predictably.

What are common Effect-TS anti-patterns to avoid for code quality?

Common Effect-TS anti-patterns include improper service structuring, ignoring Layer.scoped for resource cleanup, and using any types in error channels. Avoiding these ensures codebase consistency and maintainability.

Does the Maslow codebase require specific Effect-TS conventions for new developers?

Yes, the Maslow codebase requires specific Effect-TS conventions. New developers must follow established patterns for service structuring, resource management with Layer.scoped, and strict error typing to maintain code quality.