CtrlK
BlogDocsLog inGet started
Tessl Logo

maple-effect-style

Effect-TS OpenTelemetry style for Maple via @maple-dev/effect-sdk: Maple.layer() bootstrap, Effect.withSpan / Effect.annotateCurrentSpan call sites, Effect.log for trace-correlated logging, server / browser / Cloudflare entry points.

66

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/maple-effect-style/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a strong, highly actionable reference: executable examples for every supported runtime, precise lifecycle guidance, and valuable edge-case knowledge (Cloudflare flush, exporter coexistence) that Claude could not infer. Weaknesses are minor — one duplicated instruction, pinned version detail in the wrong place, and no post-setup verification step.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious detail (env-var fallback chains, waitUntil lifecycle, coexistence rules) and assumes Claude's competence, but the 'do not use the raw @opentelemetry/api tracer' guidance is stated twice (Custom spans section, lines 98 and 113), and the pinned version 'effect >= 4.0.0-rc.113' is time-sensitive information outside a deprecation/old-patterns section. This is 'efficient with minor instances that could be trimmed' rather than 'every token earns its place'.

4 / 5

Actionability

Fully executable, copy-paste-ready code blocks for all three runtimes (server, Cloudflare Workers, browser) plus custom-span and log patterns, with concrete commands ('npm install @maple-dev/effect-sdk effect'), exact env-var names, and specific option values — the common cases are covered.

5 / 5

Workflow Clarity

Sections sequence the work clearly (install → pick entry point per runtime → bootstrap → instrument with spans/logs) and include a troubleshooting checkpoint ('A missing waitUntil is the most common reason Worker traces never arrive'). It falls short of 5 because there is no explicit validation step (e.g., verifying spans arrive in the Maple dashboard after setup); it is not a destructive or batch workflow, so the 3-cap does not apply.

4 / 5

Progressive Disclosure

The body is well organized with clear per-runtime sections and no nested or buried references, and there are no bundle files to navigate (references/scripts/assets absent). It does not reach 5 because it exceeds the simple under-50-lines case, and deep per-runtime detail (vcs attribute auto-fill, env-var fallback chains) is inlined where a reference file could carry it — but structure and placement are otherwise good.

4 / 5

Total

17

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific and highly distinctive, accurately enumerating the skill's concrete capabilities with no vague fluff. Its main weakness is the absence of any 'Use when...' trigger clause and of common natural trigger words like 'tracing' or 'spans', which limits when-clarity and keyword coverage.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when instrumenting an Effect-TS app with OpenTelemetry/tracing, or when setting up telemetry, spans, or trace-correlated logging for Maple.'

Include common natural trigger words users would say — 'tracing', 'spans', 'observability', 'instrumentation' — alongside 'OpenTelemetry'.

Keep the existing capability list intact; it is the strongest part of the description and needs no trimming.

DimensionReasoningScore

Specificity

The description names multiple concrete capabilities ('Maple.layer() bootstrap', 'Effect.withSpan / Effect.annotateCurrentSpan call sites', 'Effect.log for trace-correlated logging', 'server / browser / Cloudflare entry points') that comprehensively cover the skill's scope, matching the top anchor rather than the 'minor gaps' anchor at 4.

5 / 5

Completeness

The 'what' is clearly and concretely answered, but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3.

3 / 5

Trigger Term Quality

'Effect-TS' and 'OpenTelemetry' are strong natural keywords users would say, but common phrasings like 'tracing', 'spans', 'instrumentation', or 'observability' are absent. This sits between 'some relevant keywords missing variations' (3) and 'comprehensive coverage including synonyms' (5), and noticeably above the midpoint.

4 / 5

Distinctiveness Conflict Risk

The scope is pinned to a specific stack ('Effect-TS OpenTelemetry style for Maple via @maple-dev/effect-sdk') with distinct triggers and minimal overlap risk with generic OpenTelemetry or logging skills, matching the 'clear niche' anchor.

5 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
MapleTechLabs/maple
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.