CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

maple-agent-tracing-mastra

Trace Mastra agents and workflows with Maple: export Mastra's built-in GenAI spans through @mastra/otel-exporter so each conversation is one Maple Agent Session with transcript, tool calls, sub-agent lanes and tokens. Triggers on 'trace my mastra agent', 'add Maple to mastra', 'agent sessions for mastra', 'OpenTelemetry for mastra'.

Quality

92%

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

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

A dense, highly actionable integration runbook: complete code, exact configuration values, an explicit verification checklist, and symptom-to-fix recovery guidance, all built around product-specific gotchas Claude could not infer. Its only weaknesses are mild redundancy across sections and no use of reference files to offload peripheral detail.

Suggestions

State the @mastra package version-matching guidance once (Step 0 or Troubleshooting) instead of repeating 'update all three together' and the npm ls check in both places.

Move the Troubleshooting symptoms table and the Step 5 edge-case explanations (HITL double export, supervisor delegation lane mechanics) into a single reference file, keeping SKILL.md to the core setup procedure and verification checklist.

Merge the duplicated region-bound-401 guidance from Step 1 and the Troubleshooting section into one location.

DimensionReasoningScore

Conciseness

Nearly every line carries non-obvious, Maple/Mastra-specific facts Claude cannot know ('OtelExporter's custom provider reads NO env vars', 'keys are region-bound', 'Batch interval is 5 s', the three Mastra 1.71 export gaps), with no padding about what OpenTelemetry or Mastra is. It is 4 rather than 5 because the ~215-line body repeats a few facts ('update all three together' and the region-bound-401 guidance each appear in both the steps and Troubleshooting) and some bullets could be tightened.

4 / 5

Actionability

Fully executable end to end: an install command, a complete copy-paste `mapleSpanProcessor` implementation, a complete `new Observability`/`OtelExporter` config with exact required keys (`protocol: "http/protobuf"`, `excludeSpanTypes`), and a symptom→fix troubleshooting table. This matches the anchor 'Fully executable; copy-paste ready code or commands' and exceeds level 4, which allows minor gaps — every setup decision is given a concrete value.

5 / 5

Workflow Clarity

Steps 0–7 are clearly sequenced (detect → key/region → install/init → session id → content → tools/errors/sub-agents → flush → verify) with an explicit validation checkpoint: Step 7 is a concrete verification checklist, and Troubleshooting maps observed symptoms back to fixes (feedback loops). This matches 'Clear sequence with explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

The body is well-sectioned (numbered steps, Troubleshooting, Do not) and reads as one cohesive procedure rather than a wall of text, and no bundle files exist to reference. It is 4 rather than 5 because the skill ships everything inline at ~215 lines: the troubleshooting table and the Step 5 edge-case explanations (HITL double-export, supervisor lane mechanics) are self-contained material that could live in a one-level-deep reference file to shrink the always-loaded context.

4 / 5

Total

18

/

20

Passed

Description

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

A strong description: third-person, concrete, and complete, naming the exact package and outcome artifacts with four natural user-facing trigger phrases. The only gap is a few missing common trigger variants (telemetry/observability phrasings).

DimensionReasoningScore

Specificity

It names the exact mechanism and multiple concrete outcomes: 'export Mastra's built-in GenAI spans through @mastra/otel-exporter so each conversation is one Maple Agent Session with transcript, tool calls, sub-agent lanes and tokens'. That covers the tool, the action, and the resulting artifacts comprehensively — matching 'Lists multiple specific concrete actions' — not level 4, since there is no noticeable coverage gap in what the skill does.

5 / 5

Completeness

Both halves are explicit: the 'what' ('Trace Mastra agents and workflows with Maple: export ... spans through @mastra/otel-exporter ...') and an explicit 'when' clause ('Triggers on 'trace my mastra agent', 'add Maple to mastra', ...') with concrete trigger phrases — exactly the level-5 anchor.

5 / 5

Trigger Term Quality

The four explicit triggers ('trace my mastra agent', 'add Maple to mastra', 'agent sessions for mastra', 'OpenTelemetry for mastra') are all phrases a user would naturally say, plus body keywords like transcript, tool calls, and tokens. It is 4 rather than 5 because common variants such as 'mastra telemetry', 'mastra observability', or 'monitor my mastra agent' are absent, and 4 rather than 3 because several relevant natural keywords are present, not just one or two.

4 / 5

Distinctiveness Conflict Risk

The Mastra+Maple pairing, the named @mastra/otel-exporter package, and Mastra-specific trigger phrases form a clear niche with essentially no overlap risk against generic tracing or OpenTelemetry skills — the level-5 anchor for distinct triggers.

5 / 5

Total

19

/

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-mastra/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.