CtrlK
BlogDocsLog inGet started
Tessl Logo

exploring-data-catalog

Full inventory and audit of AWS Glue Data Catalog assets across S3 Tables, Redshift-federated, and remote Iceberg catalogs. Triggers on: inventory the catalog, audit databases, list all tables, catalog overview, data landscape, enumerate catalogs, data inventory, search the catalog. Do NOT use for finding specific data (use finding-data-lake-assets), running queries (use querying-data-lake), or creating tables (use creating-data-lake-table).

70

Quality

85%

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.

A highly actionable, well-sequenced inventory skill: executable AWS CLI commands throughout, explicit validation and gating steps, and a troubleshooting feedback loop. The only real improvement areas are moving the experimental Discovery operations reference table into a bundle file and trimming boilerplate constraint bullets.

DimensionReasoningScore

Conciseness

The body is dense and command-driven with almost no explanation of concepts Claude already knows, but a few sections could be trimmed — e.g. boilerplate constraint bullets ("You MUST respect the user's decision to abort at any step") and the lengthy experimental Glue Discovery section. It fits the 'efficient; minor instances of over-explanation that could be trimmed' anchor rather than the fully lean anchor at 5, and is clearly above the 'some unnecessary explanation' of 3.

4 / 5

Actionability

Commands are copy-paste ready and cover the common cases: "aws glue get-catalogs --recursive --include-root", "aws sts get-caller-identity", a complete search-assets example with a --filter-clause JSON payload, S3 Tables enumeration commands, and an availability probe ("aws glue get-asset help > /dev/null 2>&1") with exit-code interpretation. Placeholders like <catalog-id> are appropriate parameterization, not pseudocode, so this fully matches the top anchor.

5 / 5

Workflow Clarity

A clear five-step sequence (Verify Dependencies → Consult Catalog Context → Discover Catalogs → Enumerate → Capture Details) with explicit validation checkpoints (credential check, CLI-model availability gating with decision branches, scope confirmation before API calls), a resolved argument-routing order, fall-through conditions on error, and a Troubleshooting table with error/cause/fix feedback loops. The read-only scope means no destructive-operation cap applies; this matches the top anchor with its explicit validation and error-recovery guidance.

5 / 5

Progressive Disclosure

The single reference file (references/discovery-checklist.md, 65 lines) exists, is one level deep, and is clearly signaled twice ("See [discovery-checklist.md](references/discovery-checklist.md) for analysis framework" and in Additional Resources). However, the detailed experimental SearchAssets/GetAsset operations table in Step 2 is inline reference-grade API detail that could live in a bundle file, keeping it at 'good structure; minor organization gaps' rather than the cleanly split top anchor.

4 / 5

Total

18

/

20

Passed

Description

82%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 an explicit two-part what/when structure, natural trigger phrases, and unusually good negative-boundary disambiguation against sibling skills. The main gap is that the capability statement uses only two verbs (inventory, audit), leaving the breadth of the workflow undersold in the opening sentence.

Suggestions

Expand the opening capability sentence with a few more concrete actions, e.g. "Enumerate catalogs, databases, and tables, classify catalog types (S3 Tables, Redshift-federated, remote Iceberg), and capture schemas, formats, and partitioning".

Add one or two more colloquial trigger phrases users would naturally say, such as "what tables exist" or "map my data", to round out trigger coverage.

DimensionReasoningScore

Specificity

"Full inventory and audit of AWS Glue Data Catalog assets across S3 Tables, Redshift-federated, and remote Iceberg catalogs" names the domain precisely but offers only two concrete actions (inventory, audit), matching the anchor for 1-2 concrete actions without comprehensive action coverage. It does not reach 4 because it lacks a list of several distinct specific actions, and it is well above 2 since the domain and actions are concrete rather than generic.

3 / 5

Completeness

Both "what" ("Full inventory and audit of AWS Glue Data Catalog assets across S3 Tables, Redshift-federated, and remote Iceberg catalogs") and "when" (the explicit "Triggers on:" clause with concrete trigger phrases) are clearly and explicitly answered. It fully matches the top anchor and exceeds 4, which only requires an implicit or less-explicit 'when'.

5 / 5

Trigger Term Quality

Eight natural trigger phrases are provided ("inventory the catalog", "audit databases", "list all tables", "catalog overview", "data landscape", "enumerate catalogs", "data inventory", "search the catalog") giving good keyword coverage across inventory, audit, and search intents. It falls short of 5 because common user phrasings like "what tables exist" or "map my data" are missing.

4 / 5

Distinctiveness Conflict Risk

"Do NOT use for finding specific data (use finding-data-lake-assets), running queries (use querying-data-lake), or creating tables (use creating-data-lake-table)" carves out a clear niche with explicit negative boundaries against named sibling skills. Conflict risk is minimal; this clearly fits the top anchor rather than the 'minor overlap risk' of 4.

5 / 5

Total

17

/

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