error-diagnosis

Diagnose and resolve common errors in Effect Layer, build, runtime, and CI pipelines.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers quickly identify and resolve common errors encountered within the Maslow codebase, reducing debugging time and improving development velocity.

Core Features & Use Cases

  • Categorized Error Solutions: Provides specific fixes for errors in the Effect Layer, Build process, Runtime, and CI.
  • Pattern Matching: Matches error messages against known failure patterns for immediate guidance.
  • Use Case: When a build fails with "Cannot find module '@maslow/shared'", this Skill will immediately guide you to run npm run build --workspace=packages/shared.

Quick Start

When encountering a "Service not found: X" error, add the missing provider to the composition chain.

Frequently Asked Questions about error-diagnosis

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

FAQPage Schema
How do I resolve a "Service not found" error in Effect.ts?

To resolve a "Service not found" error in Effect.ts, add the missing provider to the composition chain. This injects the required dependencies correctly during runtime execution.

Why does my Maslow build fail with "Cannot find module '@maslow/shared'"?

A Maslow build fails with "Cannot find module '@maslow/shared'" when workspace dependencies are uncompiled. Run `npm run build --workspace=packages/shared` to compile the required package first.

What causes port conflicts during Maslow runtime and how do I fix them?

Port conflicts during Maslow runtime occur when multiple services attempt to bind the same network port. Identify the conflicting process and update the port configuration to resolve the collision.

Do I need to understand npm workspaces to debug Maslow CI pipeline errors?

Yes, you need to understand npm workspaces to debug Maslow CI pipeline errors. The codebase uses workspaces for package management, so diagnosing module resolution failures requires knowledge of workspace dependency structures.

How to diagnose Effect Layer issues in a TypeScript project?

To diagnose Effect Layer issues in a TypeScript project, match error messages against known failure patterns. This approach provides immediate guidance for resolving missing service providers and dependency failures.