skills.rest
MapleTechLabs
MapleTechLabsOFFICIAL
Explore all skills by this author →
WebsiteGitHub

maple-effect-style

Standardize OpenTelemetry instrumentation for Effect-TS applications in the Maple ecosystem.

1.6k|107|Updated Feb 15, 2026
Search Tags:#observability#effect-ts#tracing#opentelemetry#cloudflare-workers#maple#effect-sdk
One-click install
npx skills add https://github.com/MapleTechLabs/maple --skill maple-effect-style-mapletechlabs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maple-effect-style
Source: https://github.com/MapleTechLabs/maple/tree/main/skills/maple-effect-style
Command: npx skills add https://github.com/MapleTechLabs/maple --skill maple-effect-style-mapletechlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the inconsistent, boilerplate-heavy process of instrumenting Effect-TS applications in the Maple ecosystem with OpenTelemetry, ensuring reliable trace and log correlation out of the box.

Core Features & Use Cases

  • Effect-Native Observability Primitives: Provides preconfigured Maple.layer() bootstrap patterns and Effect.withSpan / Effect.annotateCurrentSpan call sites for seamless trace instrumentation without raw OpenTelemetry API usage.
  • Runtime-Specific Entry Points: Includes tailored setup guides for Node.js/Bun/Deno servers, browser clients, and Cloudflare Workers, each handling unique lifecycle requirements like graceful shutdown and isolate buffering.
  • Use Case: A developer building an Effect-based orders API can add full distributed tracing and trace-correlated structured logging in minutes, with automatic population of resource attributes like commit SHA and service name, no manual OTLP exporter configuration required.

Quick Start

Use the maple-effect-style skill to implement trace-correlated logging and custom spans for your Effect-TS Maple application following the official SDK best practices.

Frequently Asked Questions about maple-effect-style

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

FAQPage Schema
How do I add OpenTelemetry tracing to an Effect-TS application?▼

You can add OpenTelemetry tracing to an Effect-TS application by applying preconfigured Maple.layer() bootstrap patterns and Effect.withSpan call sites, enabling trace-correlated logging without interacting with the raw OpenTelemetry API directly.

Does OpenTelemetry instrumentation work with Effect-TS on Cloudflare Workers?▼

Yes, OpenTelemetry instrumentation works with Effect-TS on Cloudflare Workers by utilizing runtime-specific entry points that handle isolate buffering and unique edge lifecycle requirements to maintain telemetry data flow.

What is the best way to set up trace-correlated logging in a Maple backend?▼

The best way to set up trace-correlated logging in a Maple backend is using the maple-effect-style SDK, which standardizes instrumentation and automatically populates resource attributes like service name and commit SHA without manual OTLP exporter configuration.

Can I create custom spans in Effect-TS without using the raw OpenTelemetry API?▼

Yes, you can create custom spans in Effect-TS without the raw OpenTelemetry API by using provided Effect.withSpan and Effect.annotateCurrentSpan call sites for seamless trace instrumentation within your application logic.

Why do I need runtime-specific setup for OpenTelemetry in Node.js versus browsers?▼

You need runtime-specific setup for OpenTelemetry because Node.js, browsers, and Cloudflare Workers have unique lifecycle requirements, such as handling graceful shutdowns and isolate buffering, which require tailored SDK entry points to ensure reliable telemetry export.

Related Skills

Explore More Software Engineering Skills→
fyndxfyndx
1

effect-ts

Implement typed asynchronous operations and error handling with effect-ts for backend services.

Official
Advanced
FernanSuozaFernanSuoza

obs-open-telemetry-instrumentation

Implement OpenTelemetry SDK instrumentation and collector pipelines with OTLP export.

Community
Advanced
cosmixcosmix
53

logging-observability

Implement structured JSON logging and distributed tracing with OpenTelemetry.

Community
Advanced
zach-sourcezach-source

otel-python

Instruments Python applications with OpenTelemetry for distributed tracing, metrics, and logging.

Community
Intermediate