Content
92%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An excellent operational skill body: verified executable commands with correct flags, a crisp numbered workflow with up-front validation and error-recovery guidance, and a clean one-level-deep reference split. The only weakness is mild duplication between the Principles section and the discovery checklist, which slightly inflates token cost without adding new information.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no padding about concepts Claude already knows — every section carries commands, classification rules, or routing logic. Minor trimming opportunities exist: the "Principles" bullets ("Flag stale tables and missing descriptions", "Suggest partitioning for large unpartitioned tables") duplicate content already in references/discovery-checklist.md's "What to Flag", and the `--include-root` guidance appears both in step 2 constraints and the troubleshooting table. This is anchor 4 (efficient with minor over-explanation) rather than 5. | 4 / 5 |
Actionability | Commands are copy-paste ready and verified real: `aws glue get-catalogs --recursive --include-root`, `aws glue get-databases --catalog-id <catalog-id>`, `aws s3tables list-tables --table-bucket-arn <arn> --namespace <ns>`, with pagination via `--next-token`. Concrete detail extends to exact field names in the classification table ("FederatedCatalog.ConnectionName = aws:s3tables"), an ordered six-case argument routing table, and a troubleshooting table mapping specific errors to specific fixes. Common cases are covered. | 5 / 5 |
Workflow Clarity | A clear four-step sequence (verify dependencies → discover catalogs → enumerate databases/tables → capture details) with explicit validation up front (credential check via `aws sts get-caller-identity`, tool availability confirmation), an error-recovery feedback loop in the troubleshooting table (error → cause → fix, e.g., "Only sub-catalogs returned... Re-run get-catalogs with --include-root"), and a checklist reference for the complex capture/analysis phase. The workflow is read-only, so the destructive-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a well-organized overview (~120 lines of workflow) with the detailed analysis framework (column classification, quality scoring, profiling heuristics, SerDe-to-format mapping) correctly split into references/discovery-checklist.md, which exists and is exactly one level deep. The reference is clearly signaled twice — inline in step 4 ("See [discovery-checklist.md](references/discovery-checklist.md) for analysis framework") and in the Additional Resources section — plus curated external AWS doc links. | 5 / 5 |
Total | 19 / 20 Passed |