CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

maple-agent-tracing-agno

Trace Agno agents with Maple: installs the OpenInference Agno instrumentor with an OTLP exporter and GenAI attributes, and sets session_id per conversation so each chat is one Maple Agent Session with transcript, tool calls, team members, tokens and cost. Triggers on 'trace my agno agent', 'add Maple to agno', 'agent sessions for agno', 'OpenTelemetry for agno'.

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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.

An outstandingly actionable, well-sequenced body: executable code for every path, explicit validation with a checklist and recovery loops, and no filler. The only deductions are version/time-sensitive detail in the main flow and a single-file layout where a references/ split would make the overview leaner.

DimensionReasoningScore

Conciseness

The body is exceptionally lean — no explanations of OTel or Python basics, dense imperative lines like "the second call is a silent no-op" and "Do not mint a new id per request (every turn becomes its own session)". However, time-sensitive version detail sits in the main flow rather than a deprecated/old-patterns section ("verified 3.0.11", instrumentor "1.0.8"/"1.0.10" thresholds, issue refs agno#5573/agno#5208), which the guidelines direct to penalize — matching the score-4 anchor (efficient, minor instances that could be trimmed) rather than score 5.

4 / 5

Actionability

Guidance is fully executable: copy-paste-ready `tracing.py`, exact dependency pins, env-var block, grep patterns for existing tracing, concrete fixes for the team context leak (`contextvars.copy_context().run(...)`), human-in-the-loop code, and per-environment flush recipes — matching the score-5 anchor (copy-paste ready code covering the common cases). Score 4 would undersell it: commands, code, and expected span attributes cover essentially every case.

5 / 5

Workflow Clarity

Steps 0–7 form a clear sequence (detect → key/region → install/init → session id → content → tools/teams → flush → verify) with explicit validation: a 12-item verification checklist, plus feedback loops for error recovery (401 → try the other region's endpoint; a no-Maple-access check with a local ConsoleSpanExporter to prove spans exist rather than trusting silence). This matches the score-5 anchor (explicit validation steps, feedback loops, checklist); the operation is additive instrumentation, not destructive/batch, so no cap applies.

5 / 5

Progressive Disclosure

Structure is strong and navigable — clearly headed Step sections with ### subsections, a separated "Known behaviours" section, and a terminal "Do not" list, all in a single 185-line file with no nested or dead references. It earns score 4 (good structure, most content appropriately placed) rather than 5 because the simple-skill exception (<50 lines) doesn't apply and some deep-dive material — the long Known behaviours list, team leak internals, and verification edge cases — could be split into one-level-deep reference files to keep SKILL.md an overview.

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: concrete, comprehensive action list in third person, explicit 'Triggers on' clause with natural phrasings, and a distinct Agno+Maple niche. The only gap is a handful of missing natural synonyms (instrument/monitor/observability) that would round out trigger coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "installs the OpenInference Agno instrumentor with an OTLP exporter and GenAI attributes", "sets session_id per conversation", "each chat is one Maple Agent Session with transcript, tool calls, team members, tokens and cost" — comprehensively covering the skill's scope with no vague filler. This matches the score-5 anchor (multiple specific concrete actions, comprehensive coverage) and exceeds the score-4 anchor because coverage of the outcome (sessions, transcript, tools, tokens, cost) is complete rather than leaving minor gaps.

5 / 5

Completeness

It explicitly answers both questions: "what" (installs the instrumentor with OTLP exporter and GenAI attributes, sets session_id per conversation, yielding one Maple Agent Session per chat) and "when" (an explicit "Triggers on..." clause with four concrete trigger phrases). This is a direct match to the score-5 anchor; the 'when' clause is explicit with concrete phrases, not merely implied as at score 4.

5 / 5

Trigger Term Quality

Triggers are natural user phrasings tied to the exact framework and product: "trace my agno agent", "add Maple to agno", "agent sessions for agno", "OpenTelemetry for agno" — good coverage matching the score-4 anchor. It falls short of score 5 because common synonyms a user might naturally say are missing, e.g. "instrument agno", "monitor agno agents", "observability for agno", or "telemetry for agno".

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — tracing Agno-framework agents into the Maple product — so it would not fire for other frameworks (LangChain, CrewAI) or generic OTel skills. Every trigger names both "agno" and "Maple"/OpenTelemetry-for-agno, giving minimal conflict risk per the score-5 anchor.

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