CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

datachain-knowledge

Use whenever datasets, cloud storage buckets, or data pipelines are mentioned — creating, saving, querying, listing, exploring, deleting, or processing data in S3, GCS, Azure Blob, or local storage. Also use when running any script that may create datasets as a side effect. Maintains a knowledge base at dc-knowledge/ (JSON + markdown). ALWAYS use this skill when the user creates a dataset, saves pipeline output, runs a data script, or references any storage bucket.

Quality

88%

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 exceptionally actionable and well-checkpointed operational skill: every step carries exact commands, thresholds, and error-recovery rules, and batch operations are guarded by explicit validation. The only notable gaps are duplicated guidance across sections (conciseness) and two referenced prompt files missing from the bundle (progressive disclosure).

DimensionReasoningScore

Conciseness

The body is dense and skill-specific with no concept padding (cost table, gotchas like "No `from __future__ import annotations` in UDF modules"), but guidance is repeated across sections — the access-check rule appears in Critical Rule 5, Step 1.3, and Mode B; reuse-before-building appears in both its own section and Mode B's precondition — which is trimmable duplication, matching 'efficient; minor instances that could be trimmed' rather than the every-token-earns-its-place 5 anchor.

4 / 5

Actionability

Commands are copy-paste ready with exact flags verified against the bundle ("python3 {skill_dir}/scripts/bucket_scan.py {root_uri} --output ... --timeout 60"; "datachain bucket status {root_uri}"), alongside a concrete estimation formula ("wall ≈ files × per-row × 1.5 / parallel"), a per-row cost table, and specific decision thresholds ("below ~0.5× → kill it"; "run 3-5 items with .persist() (never .save()), budget 60 s") — fully executable with the common cases covered.

5 / 5

Workflow Clarity

Steps 1–7 are clearly sequenced with explicit validation checkpoints and error-recovery loops throughout: pre-flight access check ("If denied / not found, stop and ask"), timeout fallback ("Handle timeout (exit code 124). Run the hierarchical fallback"), throughput monitoring with kill/revise rules ("at or above ~0.66× the expected rate → carry on; below ~0.5× → kill it"), and an early-exit ("If up_to_date: true... stop") — this batch-operation skill has the feedback loops the 5 anchor requires.

5 / 5

Progressive Disclosure

Good structure: the heavy lifting is properly externalized into 13 bundled scripts and all script references in the body (bucket_scan.py, plan.py, dataset_all.py, render_index.py, cleanup_json.py, bucket_overview.py) resolve to real files; however Step 4 references {skill_dir}/prompts/enrich.md and prompts/enrich_bucket.md, and no prompts/ directory exists in the bundle — real but bounded organization gaps, so 4 rather than the well-signaled-and-complete 5 anchor.

4 / 5

Total

18

/

20

Passed

Description

85%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 that explicitly and comprehensively answers both what the skill does and when to use it, with concrete operations and named storage systems. Its main weaknesses are over-broad trigger claims that raise conflict risk with generic data skills, and the absence of the URI-scheme terms (s3://, gs://) that users naturally type.

Suggestions

Narrow the "ALWAYS use this skill when the user... runs a data script" claim to scripts that use DataChain or write to the datasets this skill tracks, reducing conflict with generic data-processing skills.

Fold the URI-scheme triggers ("s3://", "gs://", "az://", "read_storage") from the triggers field into the description text so the extension-form terms users actually type appear there.

Trim the redundant closing sentence ("ALWAYS use this skill when...") which restates the opening trigger clause, cutting padding without losing coverage.

DimensionReasoningScore

Specificity

"creating, saving, querying, listing, exploring, deleting, or processing data in S3, GCS, Azure Blob, or local storage" enumerates seven concrete operations bound to four named storage systems, plus a concrete artifact ("Maintains a knowledge base at dc-knowledge/ (JSON + markdown)") — comprehensive coverage matching the 5 anchor, with no minor gaps that would place it at 4.

5 / 5

Completeness

Both questions are answered explicitly: 'what' via the enumerated operations and knowledge-base maintenance, and 'when' via three explicit trigger statements ("Use whenever datasets, cloud storage buckets, or data pipelines are mentioned", "Also use when running any script that may create datasets as a side effect", "ALWAYS use this skill when the user creates a dataset...") — clearly the 5 anchor, not 4 where 'when' is only adequate.

5 / 5

Trigger Term Quality

Good natural-term coverage including provider synonyms ("S3, GCS, Azure Blob") and natural phrases ("creates a dataset", "saves pipeline output", "runs a data script"), but the extension-form triggers users actually type ("s3://", "gs://", "az://", "read_storage") appear only in the separate triggers field, not in the description text itself — a few natural terms missing, so 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The DataChain/dc-knowledge niche and storage-URI anchors are distinctive, but the deliberate breadth of "ALWAYS use this skill when the user... runs a data script" and "data pipelines are mentioned" claims territory that overlaps generic data-processing and ETL skills — "somewhat specific but could still overlap with similar skills" (3), not the minor-overlap 4 anchor.

3 / 5

Total

17

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

datachain-ai/datachain

Path

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