CtrlK
BlogDocsLog inGet started
Tessl Logo

amazon-keyspaces

Provides authoritative compatibility checks, pricing estimates, connection troubleshooting, pre-warming guidance, and infrastructure mutations for Amazon Keyspaces (for Apache Cassandra). Covers LWT/batch operations, secondary indexes, materialized views, capacity modes, TTL, PITR, CDC, auto-scaling, multi-region keyspaces, UDTs, nodetool diagnostics parsing, SQL-to-Cassandra migration, and Cassandra-to-Keyspaces migration scenarios. Agents frequently produce incomplete or incorrect answers about Keyspaces feature support without this skill loaded.

62

Quality

75%

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 ./skills/specialized-skills/database-skills/amazon-keyspaces/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 operational skill with exhaustive concrete commands, explicit safety gates (confirm/warn/refuse lists), and strong error-recovery guidance. Progressive disclosure is solid — every reference link resolves to a real bundled file at one level deep — though the main file carries duplicated JSON templates and inline worked examples that inflate it. The chief cost of the ~400-line body is token efficiency: meaningful deduplication could cut a third of it without losing any executable guidance.

Suggestions

Deduplicate the pricing JSON output shape: keep it once (Mode 1's "Required output shape") and have the Script execution model section reference it, saving ~25 lines.

Move the Mode 2 compatibility worked example (~40 lines of JSON) into references/mode-2-cassandra-diagnostics.md, keeping only the has_issues/schema-shape rules inline.

Condense the CDC view-type option bullets into a compact table (or move to a reference) and merge the two redundant statements of the tagging mandate into one.

DimensionReasoningScore

Conciseness

The body is mostly dense operational guidance rather than explanations of known concepts, but it is noticeably redundant for a ~400-line SKILL.md: the full pricing JSON output shape appears twice verbatim ("Script execution model" example and Mode 1's "Required output shape"), the mandatory tagging rule is stated twice ("A create operation without these tags is INCOMPLETE and INCORRECT" then "Never omit these tags — they are required on every create operation"), and the Mode 2 worked-example JSON is ~40 lines of inline detail that belongs in the mode-2 reference. This fits anchor 3 — could be meaningfully tightened — better than anchor 4's "minor instances that could be trimmed".

3 / 5

Actionability

Fully executable throughout: complete AWS CLI commands with resolved flags (e.g., "aws keyspaces create-keyspace --replication-specification replicationStrategy=MULTI_REGION,regionList=[{region=us-east-1},{region=eu-west-1}]"), copy-paste bash blocks per mode ("cd scripts && npx ts-node --project tsconfig.scripts.json calculate.ts us-east-1 2000 800 1024 500 0 true"), exact JSON output shapes, per-feature UNSUPPORTED statuses with migration recommendations, and IAM permission scoping down to ARN patterns. Matches the anchor-5 example of copy-paste-ready commands covering common cases.

5 / 5

Workflow Clarity

Multi-step workflows are explicitly sequenced with validation checkpoints and error-recovery loops: dependency verification before any workflow, mandatory user confirmation before mutations ("Do NOT execute any create or modify operation without explicit user confirmation"), a refuse-list with a scripted refusal message for destructive ops, a Troubleshooting section mapping specific error messages to fixes ("parse-cassandra.ts exits with 'Usage: …' → --tablestats or --info missing. Recapture or use Mode 1"), and an anti-loop rule. This matches anchor 5's clear sequence with explicit validation and feedback loops.

5 / 5

Progressive Disclosure

Good structure with well-signaled, one-level-deep references: each task points to its specific reference file by path ("Load mode-1-manual-inputs.md ... for the pricing rate table"), all ten referenced files in references/ actually exist, and scripts/assets are cleanly separated. Below anchor 5 because the body inlines substantial content that would fit better in the references it already points to — the ~40-line Mode 2 worked example, the duplicated full JSON output shape, and the CDC view-type option descriptions — making the overview heavier than a lean dispatch document.

4 / 5

Total

17

/

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, information-dense description that clearly delineates a distinct niche and enumerates broad, concrete coverage of the Keyspaces domain. Its main weakness is the absence of an explicit "Use when..." trigger clause — the closing meta-sentence about agent failure modes explains why the skill exists rather than when to load it. Minor buzzword padding ("authoritative") and abstract phrasing ("infrastructure mutations") slightly blunt specificity.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user asks about Amazon Keyspaces pricing, compatibility, migration from Cassandra or SQL, connection errors, or capacity planning, or when they want to create or modify Keyspaces keyspaces/tables."

Replace the meta-claim "Agents frequently produce incomplete or incorrect answers about Keyspaces feature support without this skill loaded" with concrete invocation triggers, since trigger guidance is what the description is missing.

Swap abstract phrasing like "infrastructure mutations" for concrete operations ("create keyspaces and tables, configure TTL/PITR/auto-scaling") and drop "authoritative", which is a buzzword rather than a capability.

DimensionReasoningScore

Specificity

Lists several concrete capability areas — "compatibility checks, pricing estimates, connection troubleshooting, pre-warming guidance, and infrastructure mutations" — plus an enumerated feature-coverage list (LWT/batch, secondary indexes, materialized views, TTL, PITR, CDC, auto-scaling). It sits between anchor 4 and 5: the action verbs are specific but "infrastructure mutations" is abstract and "authoritative" is mild buzzword padding, keeping it below the fully comprehensive anchor 5.

4 / 5

Completeness

The "what" is clear and detailed, but there is no "Use when..." clause or equivalent explicit trigger guidance — the closing sentence "Agents frequently produce incomplete or incorrect answers about Keyspaces feature support without this skill loaded" is a rationale for the skill's existence, not guidance on when to invoke it. Per the rubric, a missing explicit trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would say: "Amazon Keyspaces", "Cassandra", "pricing", "migration", "compatibility", "troubleshooting", plus specific technical terms (PITR, CDC, UDTs, nodetool). Not anchor 5 because it lacks common user-phrase variations (e.g., "migrate my Cassandra cluster to AWS", "Keyspaces cost") and contains no use-when trigger phrasing; clearly above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers: the description is scoped to "Amazon Keyspaces (for Apache Cassandra)" with product-specific terminology (LWT, PITR, CDC, multi-region keyspaces) that no other skill would claim. Minimal conflict risk — it would not plausibly trigger for a non-Keyspaces request.

5 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 3 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 6 missing, 6 deeper-than-1-level

Warning

Total

13

/

16

Passed

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.