CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

maple-agent-tracing-cloudflare-agents

Trace Cloudflare Agents SDK agents (AIChatAgent, Agent on Durable Objects, npm `agents` / `@cloudflare/ai-chat`) with Maple: export the Vercel AI SDK's OpenTelemetry spans from a Worker/Durable Object over fetch, flush per turn, and pass the agent instance name as the conversation id so each chat is one Agent Session with transcript, tool calls, sub-agents and tokens. Triggers on 'trace my cloudflare agent', 'add Maple to cloudflare agents', 'agent sessions for AIChatAgent', 'OpenTelemetry in a durable object agent', 'trace agents sdk on workers'.

78

Quality

98%

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

SKILL.md
Quality
Evals
Security

Quality

Content

96%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.

An exceptionally well-crafted operational skill: lean, fully executable, and clearly sequenced with real verification loops and hard-won edge-case knowledge. Its only structural weakness is that everything is inline in SKILL.md — the verification tooling and WebSocket-driving detail would fit better in a reference or script file.

Suggestions

Move the Step 6 browser-less WebSocket driving protocol (the cf_agent_use_chat_request frame format, turn-2 history replay rules, and trigger:"submit-message" details) into a references/ file (e.g. references/verify-without-browser.md), keeping a short pointer plus the span checklist in SKILL.md.

Provide the verification driver as a scripts/ file (the throwaway OTLP receiver + the 2-turn tool-calling conversation script) so Step 6 can reference it instead of describing how to build it inline.

Consider moving the MockLanguageModelV4 doStream recipe into the same reference file as the receiver, since it is only needed for the verification step and is fully self-contained.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious operational detail and zero concept padding — no explanations of what OpenTelemetry or Durable Objects are; instead it carries exactly the kind of knowledge Claude cannot infer (e.g. why the native tracer never exports AI SDK spans, why the 5s batch timer is unreliable in hibernatable DOs, why flush-on-onFinish is too early). Every token earns its place, matching the lean anchor; it is not the level-4 case of trimmable over-explanation.

5 / 5

Actionability

Fully executable throughout: a complete install command, a copy-paste-ready telemetry.ts, concrete AIChatAgent code with the exact runtimeContext/telemetry options, per-method flush patterns, and a verification recipe including a local throwaway OTLP receiver and a MockLanguageModelV4. This matches the anchor for copy-paste-ready code covering the common cases, including edge-case handling for existing providers and wrong-region 401s.

5 / 5

Workflow Clarity

Steps 0–6 are clearly sequenced with explicit validation checkpoints: detection/version prerequisites in Step 0, and Step 6 verifies span-by-span (conversationId stability, tool-call spans, usage attributes, flush arrival) both locally and against Maple, with error-recovery guidance (401 → try other region, unset-secret diagnosis, "silence proves nothing"). This matches the anchor with explicit validation steps, feedback loops, and checklists.

5 / 5

Progressive Disclosure

Structure is good — clear step sections, no buried or nested references — but all ~170 lines live inline in SKILL.md with no bundle files, and some self-contained material (notably the Step 6 WebSocket-driving protocol and mock-model recipe) could sit in a reference or scripts file. This matches the "good structure, minor organization gaps" anchor rather than the level-5 anchor of appropriately split content with one-level-deep references.

4 / 5

Total

19

/

20

Passed

Description

100%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.

Excellent description: concrete, third-person, comprehensive in both capabilities and explicit trigger phrases, with a clearly delimited niche. It follows the strong-example pattern (actions first, explicit triggers last) without padding.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "export the Vercel AI SDK's OpenTelemetry spans from a Worker/Durable Object over fetch, flush per turn, and pass the agent instance name as the conversation id" — covering the full task comprehensively with named frameworks and packages. It matches the anchor for multiple specific concrete actions with comprehensive coverage, not the level below (which requires minor gaps).

5 / 5

Completeness

It explicitly answers "what" (export spans over fetch, flush per turn, pass instance name as conversation id so each chat is one Agent Session with transcript/tool calls/sub-agents/tokens) and "when" ("Triggers on ..."). Both are explicit and concrete, matching the top anchor rather than the level-4 anchor where the "when" is only present but less specific.

5 / 5

Trigger Term Quality

Five natural trigger phrases users would actually say: "trace my cloudflare agent", "add Maple to cloudflare agents", "agent sessions for AIChatAgent", "OpenTelemetry in a durable object agent", "trace agents sdk on workers" — covering product, framework, and class-name variations. Comprehensive natural-term coverage; not merely "good coverage with a few missing".

5 / 5

Distinctiveness Conflict Risk

A clear niche — tracing Cloudflare Agents SDK agents with Maple — with distinct, product-specific triggers (Cloudflare, AIChatAgent, Agents SDK, Maple) unlikely to fire for unrelated skills. It is not the level-4 case of minor overlap risk with closely related skills, since every trigger phrase names this specific stack.

5 / 5

Total

20

/

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

Path

skills/maple-agent-tracing-cloudflare-agents/SKILL.md

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.