CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-data-context

Create, update, inspect, or repair Data Analytics semantic layers. Use when the user asks to save data context or create a semantic layer that future Data Analytics work can inspect and cite.

57

Quality

72%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/data-analytics/skills/create-data-context/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is well-sectioned instruction-only guidance with a clear routing decision table, but it is held back by a redundant Output Contract section, abstract 'validate' steps that ignore the bundle's own validation script, and four bundle files never referenced from the body. It reads as a solid draft that needs tightening and wiring up to its own bundle.

Suggestions

Merge the "Output Contract" section into the return guidance at the end of "Creating Or Updating The Layer" — the two currently repeat the same list (path or installed link, source coverage, caveats, refresh offer, iteration guidance) — and drop the duplicated `index`-routing sentence.

Make validation concrete: name the command (e.g. `python scripts/validate_data_context_contract.py <skill-path>`), state what a failure means, and add an error-recovery step ('fix the contract violation and re-run') so the validate→fix→retry loop is explicit.

Reference the unreferenced bundle files from the body — `references/semantic-layer/source-intake.md`, `connector-playbook.md`, `references/automation.md`, and the three scripts — or remove them, so every bundle file is discoverable from SKILL.md.

DimensionReasoningScore

Conciseness

The prose is mostly efficient and assumes Claude's competence, but the "Output Contract" section nearly duplicates the return guidance in "Creating Or Updating The Layer" (path or installed link, source coverage, caveats, refresh offer, iteration guidance), and "For ordinary data work, return to the Data Analytics `index` workflow" appears twice. This is real tightening work, matching anchor 3 rather than anchor 4's 'minor instances that could be trimmed'.

3 / 5

Actionability

Concrete elements exist (the `$CODEX_HOME/skills/<area>-semantic-layer` destination, the destination decision table, named reference paths), but key steps stay abstract: "Build and validate the same canonical semantic-layer skill package" and "Validate the written skill and verify it is discoverable" never specify how, and the bundle's `scripts/validate_data_context_contract.py` is never invoked. That is concrete guidance with missing executable detail, i.e. anchor 3, not anchor 4's mostly-executable guidance.

3 / 5

Workflow Clarity

The sequence is coherent across sections (routing → source inventory → crawl → create → validate → offer refresh → report), but validation checkpoints are named without commands or error-recovery loops — no 'if validation fails, do X' path — and the existing validation script is unreferenced. Steps present with checkpoint gaps matches anchor 3, below anchor 4's 'most checkpoints present'.

3 / 5

Progressive Disclosure

References are one level deep and body-referenced paths (`references/semantic-layer/skill-template.md`, `references/semantic-layer/weekly-polling-automation.md`) resolve to real substantive files, but four of nine bundle files — all three scripts, `references/automation.md`, `references/semantic-layer/connector-playbook.md`, and `references/semantic-layer/source-intake.md` — are never signaled from the body, so navigation to them depends on guessing. Structure exists but references are partly buried, matching anchor 3 rather than anchor 4.

3 / 5

Total

12

/

20

Passed

Description

83%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 explicit third-person 'what' and 'when' clauses and natural trigger phrases. It is comprehensive for its niche but could name more concrete semantic-layer artifacts and a few more user-side synonyms to reach full marks.

DimensionReasoningScore

Specificity

"Create, update, inspect, or repair Data Analytics semantic layers" lists several specific lifecycle actions with comprehensive coverage of that lifecycle, but the verbs all operate on one object and never name concrete layer contents (e.g. metric definitions, source-of-truth dashboards), matching anchor 4's 'minor gaps in coverage' rather than anchor 5's multiple distinct concrete actions.

4 / 5

Completeness

The description explicitly answers both: what ("Create, update, inspect, or repair Data Analytics semantic layers") and when ("Use when the user asks to save data context or create a semantic layer that future Data Analytics work can inspect and cite") with concrete trigger phrases, matching the anchor 5 example structure exactly; it is not a 4 because the 'when' clause is fully explicit rather than merely present.

5 / 5

Trigger Term Quality

Natural user phrases like "save data context" and "create a semantic layer" are present, but common variations users would actually say — "data dictionary", "canonical metric definitions", "document data sources" — are missing, fitting anchor 4's 'good keyword coverage; a few natural terms missing' rather than anchor 5's synonym-and-extension completeness.

4 / 5

Distinctiveness Conflict Risk

"Data Analytics semantic layers" and "save data context" carve a clear niche with distinct triggers, but the broad "Data Analytics" domain term leaves minor overlap risk with general data-analysis skills, matching anchor 4 rather than anchor 5's minimal-conflict niche.

4 / 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

referenced_paths_exist

Referenced path issues: 2 missing, 2 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

openai/plugins

Path

plugins/data-analytics/skills/create-data-context/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.