CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

managing-data-catalog

Writes and curates business metadata in an AWS data catalog: the Amazon SageMaker Catalog (Amazon DataZone), or the AWS Glue Data Catalog. Detects which catalog platform an account uses before writing. Triggers on: add a description to a table, document a dataset, write a README, set an owner, add column comments, tag with a glossary term, create a business glossary, create a metadata form, publish an asset, create a data product, run the data source crawl, delete a catalog asset, attach a conventions document to a table as a catalog skill asset, which assets in my project are missing descriptions or owners and what to fix first, which catalog does this account use and what can I do with it. Not for: inventorying or listing tables (use exploring-data-catalog), locating one table (use finding-data-lake-assets), counting gaps domain-wide with SQL over the exported metadata snapshot (use querying-aws-sagemaker-catalog), or granting or revoking access (use managing-data-asset-access)

Quality

91%

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

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.

A well-engineered overview for a high-stakes write-path skill: it leads with mandatory probes, hard destructive-write invariants with a snapshot/verify/restore loop, prompt-injection defenses for catalog content, and a clean router to twelve one-level-deep reference files that all exist. The main weakness is verbosity — several sections restate their tables narratively and could be tightened without losing any domain content.

Suggestions

Trim the narrative restatement after the authorisation table (the 'So: a user who says...' paragraph) — the table already encodes the rule and the paragraph adds roughly 120 tokens of repetition.

Compress the MCP-vs-local-install guardrail to a short two-branch rule plus the 'resolve against references/, never write API calls from memory' pointer; the current prose over-explains runtime variations the reader can infer.

Move the detailed CloudTrail control text (specific event names, encryption settings) from the security-considerations table row into references/catalog-safety.md, keeping only the one-line recommendation and link in the overview.

DimensionReasoningScore

Conciseness

Mostly efficient and dense with non-obvious domain knowledge (the replace-vs-merge table, per-surface authentication, verify-on-the-visible-surface), but several sections could be tightened: 'The request is the authorisation' restates its table in a follow-up narrative paragraph ('So: a user who says... gets the plan first...'), the MCP-vs-local-install guardrail over-explains runtime variations, and rhetorical flourishes ('it is a failure, and it is the most common one in this domain') pad the message. It is not 2 because none of the prose explains concepts Claude already knows — it is all domain-specific earned tokens, not generic padding.

3 / 5

Actionability

Concrete executable guidance is present: three copy-ready probe commands ('aws sts get-caller-identity', 'aws datazone list-domains --region <region>', 'aws glue list-form-types --region <region> --max-results 5'), a specific snapshot pattern ('/tmp/<asset>-before.json'), named verification commands ('glue get-table', 'glue get-table-versions'), and a router table pointing to real files. It is not 5 because the body is a router — the actual write-command blocks users would copy-paste live in the reference files rather than here — and not 3 because what is inline is fully executable rather than pseudocode.

4 / 5

Workflow Clarity

Despite destructive and batch operations, validation is explicit and central: the numbered 'snapshot, write, verify, restore' loop with a restore-on-mismatch error-recovery step, verification 'on the surface where the damage is visible' with a concrete counter-example (list-iterable-forms masking a destroyed StorageDescriptor), a mandatory platform-detection step before anything, and a read-back-before-reporting-success rule. This clears the destructive/batch cap with feedback loops and checklists matching the anchor-5 example, so it is not 4.

5 / 5

Progressive Disclosure

A router table maps twelve distinct user intents to twelve real reference files (all verified present in references/, one level deep, no nesting), each labeled with applicable platforms, while cross-cutting invariants are kept in the overview with an explicit justification for why they outrank chapters. It is not 4 because navigation is unambiguous and every reference is well-signaled with no content that clearly belongs in a separate file left inline — the overview holds only globally applicable rules.

5 / 5

Total

17

/

20

Passed

Description

100%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 exemplary description: it claims a clear write-path niche, enumerates concrete capabilities in third person, provides explicit 'Triggers on:' phrasings in natural user language including question-forms, and disambiguates four sibling skills with a 'Not for:' list. Length is substantial but every clause is a trigger or boundary, not padding.

DimensionReasoningScore

Specificity

The description lists a dozen-plus concrete actions ('add a description to a table, document a dataset, write a README, set an owner, add column comments, tag with a glossary term, create a business glossary, create a metadata form, publish an asset, create a data product, run the data source crawl, delete a catalog asset') plus diagnostic question-forms, giving comprehensive coverage of the write surface. It is not 4 because no meaningful capability is left as a gap; even platform detection ('Detects which catalog platform an account uses before writing') is stated.

5 / 5

Completeness

Both questions are answered explicitly: what ('Writes and curates business metadata in an AWS data catalog: the Amazon SageMaker Catalog (Amazon DataZone), or the AWS Glue Data Catalog. Detects which catalog platform an account uses before writing') and when ('Triggers on:' followed by a concrete trigger list, plus a 'Not for:' boundary list). It is not 4 because the 'when' is not merely present but enumerated with concrete trigger phrases, matching the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Triggers are natural user phrasings including verbs and question-forms users would actually say: 'write a README', 'set an owner', 'tag with a glossary term', 'which assets in my project are missing descriptions or owners and what to fix first', 'which catalog does this account use and what can I do with it'. It is not 4 because both imperative-form and question-form synonyms are covered comprehensively for a service-domain skill (no file extensions apply here).

5 / 5

Distinctiveness Conflict Risk

The 'Not for:' clause explicitly delegates four adjacent capabilities to named sibling skills ('use exploring-data-catalog', 'use finding-data-lake-assets', 'use querying-aws-sagemaker-catalog', 'use managing-data-asset-access'), and the write-path niche is clearly claimed. It is not 4 because the explicit routing of near-miss intents makes overlap risk minimal rather than minor.

5 / 5

Total

20

/

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

aws/agent-toolkit-for-aws

Path

plugins/aws-data-analytics/skills/managing-data-catalog/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.