CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

datachain-core

Use ONLY for abstract DataChain SDK questions — API usage, method signatures, or code patterns — when no specific dataset or bucket is referenced. If the request mentions creating, saving, listing, exploring datasets or buckets, use datachain-knowledge instead.

Quality

86%

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

78%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 tight, instruction-only router skill with concrete paths, a runnable detection command, and an explicit failure checkpoint. Its weaknesses are minor: redundant restatement of SDK.md's scope between the intro and the Scope section, and no guidance for the authenticated-bucket branch after the status check.

Suggestions

Cut the duplicated scope sentence ('SDK.md owns how DataChain code is written — API usage, UDF signatures...') and 'It is self-sufficient on its own'; the intro already tells the reader to read SDK.md in full and what it contains.

Add one line for the success branch of the bucket check, e.g. what to do when `anon: false` or when `datachain bucket status` succeeds (which credentials/settings to check before writing pipeline code).

DimensionReasoningScore

Conciseness

The body is lean with no concept over-explanation, but the intro paragraph and the 'Scope of this skill' section state nearly the same thing twice ("It holds the SDK rules: API usage, UDF signatures..." vs "`SDK.md` owns how DataChain code is written — API usage, UDF signatures...") and "It is self-sufficient on its own" is filler — a small trim, matching the 'minor instances that could be trimmed' anchor rather than the fully lean anchor.

4 / 5

Actionability

Concrete, executable guidance throughout: named paths (`dc-knowledge/index.md`, `dc-knowledge/datasets/`, `dc-knowledge/buckets/`), a concrete check (`anon: true/false` in frontmatter), and a runnable command (`datachain bucket status <uri>`) with an explicit failure action. It falls short of fully executable because the authenticated-bucket path after detection is unspecified — no command or next step for the non-anon case.

4 / 5

Workflow Clarity

The 'Before writing any pipeline code' sequence is clearly numbered with an explicit error checkpoint ("If `denied` or `not found`, stop and ask the user") and a hard safety rule ("Never create or modify files under `dc-knowledge/`"). Anchor 5 is not met because the checkpoint only covers the failure branch — there is no validation of the success branch (what to do differently when `anon` is true vs false), leaving a minor validation gap.

4 / 5

Progressive Disclosure

A short, well-sectioned overview that delegates all SDK detail to a single one-level-deep, clearly signaled reference ("Read `{skill_dir}/SDK.md` in full") with an accurate scope summary of its contents, and clearly partitions responsibility with the sibling knowledge skill. No bundle files are present to inline incorrectly; navigation is unambiguous.

5 / 5

Total

17

/

20

Passed

Description

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

An excellent routing description: it states a precise niche, concrete trigger categories, an explicit 'Use ONLY ... when' clause, and explicit disambiguation against the sibling datachain-knowledge skill. The only improvement space is naming the actual actions (answering questions / generating code) and a few more natural trigger synonyms.

DimensionReasoningScore

Specificity

Names the domain (DataChain SDK) and several concrete capability categories — "API usage, method signatures, or code patterns" — matching 'lists several specific actions; minor gaps'. It stays at 4 rather than 5 because it enumerates what kinds of questions qualify but never states the concrete actions the skill performs with them (answering questions, generating code).

4 / 5

Completeness

Explicitly answers both halves with concrete triggers: what/when via "Use ONLY for abstract DataChain SDK questions — API usage, method signatures, or code patterns — when no specific dataset or bucket is referenced", plus a negative boundary clause routing dataset/bucket work elsewhere. This is the 'clearly and explicitly answers both what AND when' anchor; anchor 4 would require the 'when' to be less explicit than the 'Use ONLY ... when no specific dataset or bucket is referenced' phrasing here.

5 / 5

Trigger Term Quality

Good natural keyword coverage — "DataChain SDK questions", "API usage", "method signatures", "code patterns", "dataset", "bucket" — phrases a user would plausibly say. Missing a few natural variants (e.g. 'how to use', 'UDF', 'Python library'), so it fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

Clear niche with minimal conflict risk: it carves out abstract SDK questions and explicitly disambiguates against the sibling skill ("If the request mentions creating, saving, listing, exploring datasets or buckets, use datachain-knowledge instead"), which is stronger than the 'mostly distinct; minor overlap risk' anchor 4 — the boundary is stated in both directions of the trigger.

5 / 5

Total

18

/

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

datachain-ai/datachain

Path

src/datachain/skill/core/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.