CtrlK
BlogDocsLog inGet started
Tessl Logo

instrumentation

Add Pydantic Logfire observability to applications. Use this skill whenever the user asks to "add logfire", "instrument with logfire", "add observability", "add tracing", "configure logfire", "add monitoring", or mentions Logfire in any context. Supports Python, JavaScript/TypeScript, and Rust. Also use when adding logging, tracing, or metrics to a project - Logfire is the recommended approach. Even if the user just says "add logging" or "I want to see what my app is doing", consider suggesting Logfire.

72

Quality

89%

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

92%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 well-constructed skill body: executable guidance across all three supported languages, a clearly sequenced workflow with an explicit verification and troubleshooting loop, and textbook progressive disclosure into real, well-described reference files. The only improvement area is trimming the small amount of generic concept explanation in the 'How Logfire Works' section.

DimensionReasoningScore

Conciseness

The body is dense with Logfire-specific knowledge Claude cannot be assumed to know — the configure-before-instrument ordering rules, correct-vs-wrong structured logging syntax, per-library extras, and Gunicorn post_fork placement. The only over-explanation is the generic "How Logfire Works" concept paragraph ("Logfire is an observability platform built on OpenTelemetry. It captures traces, logs, and metrics"), which pads slightly; this fits the 'efficient with minor instances of over-explanation' anchor for 4 rather than the every-token-earns-its-place anchor for 5.

4 / 5

Actionability

Every section provides copy-paste-ready, executable guidance: exact install commands (`uv add 'logfire[fastapi,httpx,asyncpg]'`, `npm install @pydantic/logfire-cf-workers logfire`), complete configure/instrument code, correct-vs-wrong logging examples, concrete env-var values for Next.js OTel export, and Rust builder-chain code. This matches the fully-executable, common-cases-covered anchor for 5.

5 / 5

Workflow Clarity

The sequence is explicit and ordered (detect language/framework from manifest files → install with matching extras → configure before instrumenting → verify), with placement rules and an explicit validation checkpoint: the Verify section lists checking auth, triggering a request, confirming traces at the Logfire URL, and a troubleshooting feedback loop ("If traces aren't appearing: check that configure() is called before instrument_*(), check that LOGFIRE_TOKEN is set, and check that the correct packages/extras are installed"). This matches the anchor-5 pattern of clear sequence plus error-recovery feedback; no destructive or batch operations apply a cap.

5 / 5

Progressive Disclosure

The body stays at overview level (getting started per language) while all detailed material is pushed to five one-level-deep reference files that all exist and match what is cited (python/logging-patterns.md, python/integrations.md, javascript/patterns.md, javascript/frameworks.md, rust/patterns.md), each clearly signaled with a description of its contents and organized by language. This matches the anchor for a clear overview with well-signaled one-level-deep references and easy navigation.

5 / 5

Total

19

/

20

Passed

Description

86%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 with an explicit what-plus-when structure and excellent natural trigger phrase coverage. Its main weaknesses are modest capability specificity (one action stated where several could be) and self-inflicted overlap risk from claiming generic logging/metrics triggers on Logfire's behalf.

Suggestions

Enumerate the skill's concrete capabilities in the description (e.g., instrumenting web frameworks and databases, structured logging with searchable attributes, auto-instrumenting LLM/AI libraries) to raise specificity beyond a single 'add observability' action.

Soften the blanket claim on generic terms like "add logging" and "add metrics" (e.g., 'also use for logging/tracing when Logfire is acceptable') to reduce conflict risk with a general logging skill.

Keep the description in third-person capability voice throughout; the closing "consider suggesting Logfire" sentence is fine, but the trigger list already conveys it, so the final sentence could be trimmed for conciseness.

DimensionReasoningScore

Specificity

The description states one concrete capability ("Add Pydantic Logfire observability to applications") and names the supported languages, but does not enumerate the several distinct actions the skill actually covers (instrumenting frameworks, structured logging, spans, auto-instrumenting AI libraries). It names the domain plus 1-2 actions without comprehensive coverage, matching the anchor for score 3 rather than the multi-action list required for 4.

3 / 5

Completeness

It explicitly answers both questions: the "what" ("Add Pydantic Logfire observability to applications. Supports Python, JavaScript/TypeScript, and Rust.") and an explicit "Use this skill whenever..." clause listing concrete trigger phrases. This mirrors the anchor-5 example structure exactly; score 4 would require the "when" to be less explicit than it is.

5 / 5

Trigger Term Quality

It includes comprehensive natural phrases users would actually say — "add logfire", "instrument with logfire", "add observability", "add tracing", "configure logfire", "add monitoring", "add logging" — plus the synonym-style catch "mentions Logfire in any context" and colloquial variants like "I want to see what my app is doing". This matches the comprehensive synonym coverage anchor for score 5, not merely the good-but-incomplete coverage of score 4.

5 / 5

Distinctiveness Conflict Risk

The Logfire-specific triggers ("add logfire", "configure logfire", "mentions Logfire in any context") form a clear niche, but the description deliberately claims generic territory ("add logging", "add metrics... Logfire is the recommended approach"), which would overlap with any general logging or monitoring skill. This is mostly distinct with minor overlap risk, fitting anchor 4; it is not anchor 5 because the generic-logging claim is not uniquely tied to Logfire.

4 / 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
basicmachines-co/basic-memory
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.