CtrlK
BlogDocsLog inGet started
Tessl Logo

finding-data-lake-assets

Resolve data lake and lakehouse asset references across Glue Data Catalog, S3, S3 Tables, and Redshift. Triggers on: find the table, where is our data, which table has, locate dataset, find data for, search catalog, what tables match, Redshift table, lakehouse table, data lake table, warehouse table, reverse lookup S3 path. Do NOT use for: full catalog audits (use exploring-data-catalog), running queries (use querying-data-lake), creating tables (use creating-data-lake-table).

64

Quality

76%

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/aws-data-analytics/skills/finding-data-lake-assets/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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-sequenced, highly actionable resolver skill with concrete commands, a runnable fallback script, explicit gates, and prompt-injection defenses around untrusted catalog content. Its main costs are token weight — the experimental Discovery API material and duplicated search guidance live inline rather than in bundle files — and a couple of execution gaps such as how to run the Redshift query.

Suggestions

Move Step 2's Glue Discovery operation table, JSON-casing conventions, and embedded-Content parsing notes into a dedicated reference file (e.g., references/catalog-context.md), keeping only the availability check, opt-in prompt, and short-circuit criteria inline — this would improve both conciseness and progressive_disclosure.

Add the concrete command for executing the Layer 3 Redshift query (e.g., aws redshift-data execute-statement with cluster/database parameters) so that step is copy-paste executable like the Glue and S3 steps.

De-duplicate the layered-search guidance and the S3 Tables hierarchy between SKILL.md and references/search-strategy.md — keep the summary and stop conditions in the body and defer patterns/examples to the reference.

DimensionReasoningScore

Conciseness

The body is mostly operational and avoids explaining concepts Claude already knows, but Step 2 spends ~90 lines on experimental Glue Discovery API details (operation tables, JSON casing conventions, flag names) that could be tightened or moved out, and the layered-search guidance duplicates material in references/search-strategy.md. Fits the 3-anchor 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the 4-anchor, where over-explanation would be only minor.

3 / 5

Actionability

Mostly executable: concrete CLI commands ('aws glue search-tables --search-text "orders"', 'aws glue get-asset --identifier <ARN>'), a complete runnable boto3 paginator script, output templates, and a troubleshooting table. Falls short of the 5-anchor because Layer 3 provides a SQL query with no command for executing it against Redshift (e.g., an aws redshift-data invocation), and the MCP path names a tool ('aws___call_aws') without a usage example.

4 / 5

Workflow Clarity

Steps 1-7 are clearly sequenced with early-stop conditions, a confidence gate, an availability precheck with exit-code interpretation, and a troubleshooting table for error recovery. Below the 5-anchor because recovery from mid-workflow failures is handled in a table rather than as inline feedback loops, and a couple of checkpoints (e.g., how to actually run the Redshift query) are implicit.

4 / 5

Progressive Disclosure

There is exactly one one-level-deep reference (references/search-strategy.md), signaled twice with clear link text, but the 17KB body inlines large chunks that belong in reference files — notably Step 2's full operation reference table and CLI schema conventions, plus S3 Tables hierarchy detail that duplicates the reference file. Matches the 3-anchor 'content that should be separate is inline' more than the 4-anchor, where placement gaps would be minor.

3 / 5

Total

14

/

20

Passed

Description

90%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 third-person capability statement, an unusually thorough natural-language trigger list, and explicit routing boundaries against sibling skills. The only weakness is that it states a single umbrella action rather than enumerating several specific capabilities.

DimensionReasoningScore

Specificity

The description gives one concrete action — 'Resolve data lake and lakehouse asset references across Glue Data Catalog, S3, S3 Tables, and Redshift' — with a clearly named domain, but does not enumerate multiple distinct actions the way the 5-anchor does (compare 'Extract text and tables, fill forms, merge documents'). It sits above the 2-anchor ('names the domain but actions minimal') because resolving references plus implied reverse lookup is concrete, but below the 4-anchor because only one primary action is stated.

3 / 5

Completeness

Both questions are answered explicitly: 'what' via 'Resolve data lake and lakehouse asset references across Glue Data Catalog, S3, S3 Tables, and Redshift' and 'when' via the concrete 'Triggers on:' phrase list, plus explicit 'Do NOT use for' exclusions. This matches the 5-anchor's pattern of concrete what + explicit when with trigger phrases; the 4-anchor's 'when could be more specific' does not apply.

5 / 5

Trigger Term Quality

'Triggers on: find the table, where is our data, which table has, locate dataset, find data for, search catalog, what tables match, Redshift table, lakehouse table, data lake table, warehouse table, reverse lookup S3 path' provides comprehensive natural-phrase coverage including synonyms (lakehouse/data lake/warehouse) that users would actually say. Not below the 4-anchor since no commonly used variant is obviously missing.

5 / 5

Distinctiveness Conflict Risk

The 'Do NOT use for: full catalog audits (use exploring-data-catalog), running queries (use querying-data-lake), creating tables (use creating-data-lake-table)' clause actively deconflicts against sibling skills, and the resolver niche is clear. Minimal conflict risk; matches the 5-anchor's 'clear niche with distinct triggers'.

5 / 5

Total

18

/

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.