CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

maple-agent-tracing-genkit

Trace Genkit (TypeScript/Node.js) agents with Maple: export Genkit's OpenTelemetry spans to Maple, map its genkit:* attributes to the GenAI conventions with a span processor, and stamp a conversation id so each chat is one Agent Session with transcript, tool calls and tokens. Covers flows, ai.generate, generateStream and beta defineAgent chats. Triggers on 'trace my genkit agent', 'add Maple to genkit', 'agent sessions for genkit', 'OpenTelemetry for genkit', 'firebase genkit tracing'.

76

Quality

95%

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.

This is a high-quality integration skill: an ordered, well-verified workflow with complete executable code, deep version-specific gotchas Claude could not know, and a genuine verification step including a no-Maple-access fallback. Its only weaknesses are mild redundancy (the mapping table duplicating the code) and a large always-loaded body with optional material (gaps, local checks) that could live in reference files. Both are minor relative to the skill's overall strength.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, version-specific knowledge (genkit >= 1.22 requirement, the enableTelemetry/sdk-node 0.52 exporter crash, GENKIT_ENV=dev behavior) and assumes Claude's competence, never explaining OTel basics. It falls short of 5 mainly because the 'It maps:' table restates what the inline processor code already shows verbatim, and a few note paragraphs (e.g., provider label mapping, sub-agents) could be trimmed; it is well above the 3 anchor's 'some unnecessary explanation'.

4 / 5

Actionability

Guidance is fully executable: exact npm install command, two complete verbatim source files, exact env vars, an inline-exporter alternative with the required '/v1/traces' path detail, and per-deployment variants (Express startFlowServer, Next.js @vercel/otel, Cloud Functions onCallGenkit, Cloud Run flush handling). Copy-paste ready code covers the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

Steps 0-7 are clearly sequenced with an explicit validation checkpoint (Step 7: session shape, framework label, turns, tokens, failed tools, no leaked keys, clean exit) and a fallback verification loop (local OTLP HTTP server, 'Silence alone proves nothing'). Error-recovery feedback is present throughout (401 -> try the other region, missing key -> warn and skip exporter, flush failure -> .catch), matching the 5 anchor's explicit validation with feedback loops.

5 / 5

Progressive Disclosure

No bundle files exist and all content is inline, but section headers are clear and the sequencing makes everything discoverable; the verbatim code and install steps belong inline since every invocation needs them. It does not reach 5 because optional material (known gaps, the local-verification recipe, optional cache/reasoning token mappings, the Do-not list) could have been split into reference files to shrink the always-loaded body; it is clearly above the 3 anchor's buried-references/should-be-separate state.

4 / 5

Total

18

/

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.

The description is exemplary: third-person, concrete, and comprehensive on what the skill does, with an explicit 'Triggers on' clause containing five natural user phrasings. It clearly delimits scope (TypeScript/Node.js, Genkit flows/agents) and includes coverage details (transcript, tool calls, tokens) without padding. No changes needed.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'export Genkit's OpenTelemetry spans to Maple', 'map its genkit:* attributes to the GenAI conventions with a span processor', 'stamp a conversation id so each chat is one Agent Session with transcript, tool calls and tokens' — and states coverage scope ('flows, ai.generate, generateStream and beta defineAgent chats'). This matches the comprehensive-coverage anchor; there is no gap that would pull it to 4.

5 / 5

Completeness

It explicitly answers both 'what' (span export, attribute mapping to GenAI conventions, conversation id stamping for Agent Sessions) and 'when' ('Triggers on ...' with five concrete trigger phrases). The 'when' clause is fully explicit rather than weakly implied, matching the 5 anchor and exceeding the 4 anchor's 'could be more explicit' bar.

5 / 5

Trigger Term Quality

Trigger phrases are natural user utterances with good synonym coverage: 'trace my genkit agent', 'add Maple to genkit', 'agent sessions for genkit', 'OpenTelemetry for genkit', 'firebase genkit tracing'. They span casual ('add Maple to genkit') and technical phrasings, matching the comprehensive-coverage anchor rather than the 'a few natural terms missing' level of 4.

5 / 5

Distinctiveness Conflict Risk

The niche is precise (Maple tracing for Genkit TypeScript agents) and every trigger names Genkit or Maple explicitly, so it is unlikely to fire for a generic OTel or Genkit debugging skill. Only 'firebase genkit tracing' carries slight adjacency to Google Cloud tracing skills, which is a minor risk consistent with the 5 anchor's 'minimal conflict risk'.

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