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.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

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

Quality

Content

85%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-structured skill with clear sequenced workflows, strong safety/validation checkpoints, and clean progressive disclosure to real reference files. The only weakness is length and some redundant repetition of the JSON output shape, which costs tokens.

Dimension	Reasoning	Score
Conciseness	Mostly efficient dense guidance, but the document is long (~400 lines) and repeats the same JSON output shape in three places (script-execution model, Mode 1, and the worked example), which could be consolidated to trim tokens.	3 / 5
Actionability	Provides fully executable AWS CLI and npx ts-node commands with concrete flag values, plus exact JSON output shapes; copy-paste ready across all four modes and the PDF task.	5 / 5
Workflow Clarity	Each mode is a clearly sequenced workflow with mandatory steps, validation constraints (region validation, required params, schema-parsing rules), and an allow/warn/refuse safety section with explicit user-confirmation checkpoints for destructive operations.	5 / 5
Progressive Disclosure	SKILL.md is an overview that points to real, one-level-deep references (all referenced files in references/ exist), plus scripts/ and assets/data; navigation is clearly signaled with labeled 'Load ...' pointers per workflow.	5 / 5
	Total	18 / 20 Passed

Description

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

The description is specific and well-scoped to Amazon Keyspaces but lacks an explicit 'Use when...' trigger clause, capping completeness at 3. It is also somewhat jargon-heavy rather than phrased in natural user language. Adding a concrete trigger phrase would lift the two weaker dimensions.

Suggestions

Append an explicit trigger clause such as 'Use when the user asks about Amazon Keyspaces pricing, Cassandra-to-Keyspaces compatibility, SQL-to-CQL migration, or Keyspaces connection/throttling problems.'

Soften jargon with natural synonyms users actually say (e.g., 'CQL', 'keyspace', 'Cassandra table pricing') alongside the technical terms.

Lead with the capability summary before the long feature enumeration so the 'what' is immediately scannable.

Dimension	Reasoning	Score
Specificity	Lists many concrete actions such as 'compatibility checks, pricing estimates, connection troubleshooting, pre-warming guidance, and infrastructure mutations', plus specific feature areas (LWT/batch, secondary indexes, materialized views, CDC, PITR, UDTs), giving comprehensive coverage.	5 / 5
Completeness	Has a clear 'what' but no explicit 'when'/'Use when...' clause; the only 'when' is a meta-claim about agent errors, not a usage trigger, which per the rubric caps completeness at 3.	3 / 5
Trigger Term Quality	Includes relevant terms (Amazon Keyspaces, Apache Cassandra, nodetool, LWT, CDC) but leans technical-jargon-heavy and omits the natural phrases a user would say; synonyms/extensions like 'CQL' or 'keyspace' as user-facing triggers are thin.	3 / 5
Distinctiveness Conflict Risk	Tightly scoped to Amazon Keyspaces (for Apache Cassandra) with a distinct niche and very specific trigger surface, so minimal conflict risk with other skills.	5 / 5
	Total	16 / 20 Passed

Validation

81%

Warnings & errors only

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

Criteria	Description	Result
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
Path: skills/specialized-skills/database-skills/amazon-keyspaces/SKILL.md
Commit: 68d9e85

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.