CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

data-dictionary

Automate update and maintenance of data dictionaries in Treasure Data - generates 80-90% of column descriptions automatically, allowing users to review results, make changes, and fill in gaps. Orchestrates schema extraction, AI-powered description generation, human review, and write-back as single workflow.

61

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./semantic-layer/data-dictionary-helper/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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, well-gated workflow document with strong validation, rollback, and resume semantics for a destructive batch operation. Its weaknesses are token efficiency (heavy duplication of error/resume/progress information across sections, a truncated final example) and the absence of progressive disclosure — everything lives in one large inline file.

Suggestions

Remove redundant sections: the "Error Recovery Summary" table, "Progress Tracking" section, and "Resume Detection (Overall)" restate information already given per-stage; consolidating them would cut 100+ lines.

Move Stage 6's API details (endpoint, schema format, auth/EU-endpoint detection) and the full workflow example into a references/ file (e.g. references/writeback-api.md), keeping SKILL.md as a lean overview.

Complete or delete the truncated "Example: Full Workflow Execution" section — it currently ends mid-code-fence after a single line, leaving an unterminated block in the file.

DimensionReasoningScore

Conciseness

The body is dense with concrete commands and avoids explaining concepts Claude already knows, but it is 490 lines with clear redundancy: per-stage error handling is restated in the "Error Recovery Summary" table, resume detection appears both per-stage and in a separate "Resume Detection (Overall)" section, "Progress Tracking" repeats the stage output blocks, and the final "Example: Full Workflow Execution" section is truncated mid-block. This fits "mostly efficient but includes some unnecessary... padded sections"; it is not a 2 because the padding is duplication of real guidance rather than fluffy explanation, and not a 4 because multiple entire sections could be deleted without losing information.

3 / 5

Actionability

Every stage provides copy-paste-ready commands ("node src/index.js extract $SEGMENT --sample", "node src/index.js writeback $SEGMENT --dry-run", "node src/index.js rollback $SEGMENT") with concrete artifact paths, a fully specified CSV format ("table, column, type, source, description, is_pii"), exact API endpoint and 4-element schema format details, and explicit environment variables (TD_API_KEY, TDX_API_KEY__*). This matches the anchor for fully executable, copy-paste-ready commands covering the common cases.

5 / 5

Workflow Clarity

The 6-stage sequence is clearly numbered and gated by explicit validation checkpoints: Stage 5 validates the edited CSV with an error log and retry loop, Stage 6 requires a dry-run preview plus y/n confirmation before write-back, snapshots enable rollback, and resume detection maps artifacts to stages. Feedback loops (validate → fix → retry, retry failed tables only, rollback) are present for the destructive write-back operations, matching the top anchor; the destructive/batch cap at 3 does not apply since validation is thorough.

5 / 5

Progressive Disclosure

There are no bundle files at all (no references/, scripts/, or assets/ exist), and the 490-line monolithic body inlines content that belongs in separate reference files — Stage 6's full API endpoint details, the artifact state table, and long mock output transcripts. Section structure is good (clear stage headers, tables), so it is above anchor 2's "minimal structure"; but it is below anchor 4 because substantial detail content is not split out and there are no one-level-deep references to navigate.

3 / 5

Total

16

/

20

Passed

Description

70%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, specific description that clearly communicates what the skill does within a distinct Treasure Data niche, with good natural keyword coverage. Its main weakness is the complete absence of any "Use when..." trigger guidance, which caps completeness and limits its ability to be surfaced at the right moment.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user mentions data dictionaries, Treasure Data column descriptions, schema documentation, or wants to bulk-generate/update column descriptions in Treasure Data."

Include natural synonyms users might say — "metadata", "data catalog", "document columns", "table descriptions" — to broaden trigger term coverage from good to comprehensive.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Orchestrates schema extraction, AI-powered description generation, human review, and write-back" — which matches the anchor for several specific actions with minor gaps. It is not a 5 because capabilities like PII detection and CSV review export are not mentioned, and not a 3 because more than 1-2 actions are explicitly named.

4 / 5

Completeness

The "what" is clearly answered ("generates 80-90% of column descriptions automatically... orchestrates schema extraction, AI-powered description generation, human review, and write-back"), but there is no "Use when..." clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

Natural terms users would say are present: "data dictionaries", "Treasure Data", "column descriptions", "schema extraction", "write-back" — good keyword coverage. It is not a 5 because common synonyms and variations such as "metadata", "data catalog", "document columns", or "table descriptions" are missing; not a 3 because coverage goes beyond merely relevant keywords.

4 / 5

Distinctiveness Conflict Risk

"data dictionaries in Treasure Data" carves out a clear niche with distinct domain-specific triggers, and the described pipeline (schema extraction → description generation → write-back) is unlikely to fire for unrelated skills. The Treasure Data anchor makes conflict risk minimal, matching the anchor for a clear niche with distinct triggers; it is not a 4 because no closely related generic skill would plausibly collide with this description.

5 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

treasure-data/td-skills

Path

semantic-layer/data-dictionary-helper/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.