CtrlK
BlogDocsLog inGet started
Tessl Logo

python-sdk

Python SDK patterns for Opik. Use when working in sdks/python, on SDK APIs, integrations, or message processing.

73

Quality

91%

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%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-organized, lean, actionable reference for the Opik Python SDK with strong code examples and a clear critical checkpoint. The main defect is progressive disclosure: the body points to three reference files that do not exist in the skill bundle, leaving the promised detail unreachable.

Suggestions

Create the referenced bundle files (testing.md, error-handling.md, good-code.md) or move them into a references/ directory so the links resolve and the promised detail is reachable.

If those files are not yet available, either remove the Reference Files section or note the references are planned, to avoid implying content that is missing.

Ensure each reference path in the body matches the actual bundle location (e.g. references/testing.md) so navigation is unambiguous.

DimensionReasoningScore

Conciseness

The body is lean: an architecture diagram, terse gotchas, and copy-paste code blocks with no explanation of concepts Claude already knows. Every section earns its place, matching the 'Lean and efficient; assumes Claude's competence' anchor. It is not level 2 because there is no padding or unnecessary explanation to tighten.

3 / 3

Actionability

Examples like 'client.flush()', 'track_anthropic(client)', 'OpikTracer()', '@opik.track', and 'client.search_spans(project_name="proj")' are concrete and executable. It is not level 2 because the guidance is specific and copy-paste ready rather than pseudocode or missing key details.

3 / 3

Workflow Clarity

This is a reference-style skill whose single critical workflow checkpoint ('Flush Before Exit') is explicitly flagged as required before exit, and the pattern-selection flow gives a clear decision tree. Per the simple-skills scoring note, clear organization of a focused skill warrants 3. It is not level 2 because the one risky operation (async flush) does have an explicit checkpoint.

3 / 3

Progressive Disclosure

A 'Reference Files' section signals one-level-deep pointers to testing.md, error-handling.md, and good-code.md with descriptions, which is the right structure. However, none of these referenced files exist in the bundle (no references/, scripts/, or assets/ directories), so the navigation is broken. This caps the score at 2 ('references present but not clearly signaled / content that should be separate is inline') rather than 3, which requires working, navigable references.

2 / 3

Total

11

/

12

Passed

Description

90%

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 concise, well-scoped description with an explicit 'Use when' trigger and clear niche definition. Its only weakness is that 'patterns' is somewhat abstract, listing domains rather than concrete actions, which caps specificity at 2.

DimensionReasoningScore

Specificity

Names the domain ('Python SDK patterns for Opik') and several areas ('SDK APIs, integrations, or message processing'), but 'patterns' is abstract rather than a concrete action like 'extract', 'fill', or 'merge'. This matches the anchor 'Names domain and some actions, but not comprehensive' rather than level 3, which requires multiple specific concrete actions.

2 / 3

Completeness

It states what the skill does ('Python SDK patterns for Opik') and gives an explicit 'Use when...' clause for when to apply it, answering both 'what' and 'when'. It is not level 2 because the trigger is explicit rather than merely implied.

3 / 3

Trigger Term Quality

The phrase 'Use when working in sdks/python, on SDK APIs, integrations, or message processing' covers the natural terms a contributor to the Opik Python SDK would actually say. It does not reach a higher level (none exists), and it is above level 2 because the trigger set is niche-appropriate and varied rather than a single generic keyword.

3 / 3

Distinctiveness Conflict Risk

'Python SDK patterns for Opik' is a clearly bounded niche tied to a specific product's SDK, making conflict with unrelated skills unlikely. It is above level 2 because the scoping to sdks/python and Opik-specific surfaces is distinct rather than a generic 'works with SDK files'.

3 / 3

Total

11

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 missing

Warning

Total

15

/

16

Passed

Repository
comet-ml/opik
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.