CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

storing-and-querying-vectors

Store and query vector embeddings using Amazon S3 Vectors, a cost-effective long-term vector storage service with its own API namespace (s3vectors). Triggers on: create S3 vector bucket, vector index, store embeddings, semantic search, RAG vector storage, similarity search, vector database, migrate from other vector databases. Do NOT use for: querying tabular data (use querying-data-lake), S3 object storage, or hundreds/thousands of sustained QPS (use OpenSearch).

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is storing-and-querying-vectors in aws/agent-toolkit-for-aws

SKILL.md
Quality
Evals
Security

Quality

Content

80%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 dense, highly actionable body with copy-paste commands, immutable-parameter warnings, and a well-structured one-level-deep reference bundle. The main weakness is the capped workflow clarity: batch vector ingestion (500 vectors/call) lacks an explicit verification step to confirm stored data before proceeding, and the Overview slightly duplicates reference content.

Suggestions

Add an explicit post-ingestion verification step after put-vectors (e.g., query or get-vectors on one stored key to confirm vectors landed before declaring success), which would lift workflow_clarity past the batch-operation cap.

Trim the Overview's latency/cost sentences ("subsecond latency for cold queries, as low as 100ms for warm queries") since references/limits-and-patterns.md already restates them, removing redundancy from the token budget.

Include a short failure-recovery loop for batch ingestion (check partial success, re-put failed keys, then re-verify) so the 429 backoff guidance becomes a full validate -> fix -> retry feedback loop.

DimensionReasoningScore

Conciseness

Efficient overall: terse MUST/SHOULD constraint lists, complete CLI commands, and a compact troubleshooting table with no padding of concepts Claude already knows. Not a 5 because the Overview duplicates latency/cost points ("subsecond latency... as low as 100ms") that are restated in references/limits-and-patterns.md, and a few constraint lines could be tightened.

4 / 5

Actionability

Fully executable copy-paste CLI commands for every step (create-vector-bucket, create-index, put-vectors, query-vectors, bedrock-runtime invoke-model) with required flags, realistic JSON payloads for metadata configuration and filters, an example response body, and model-specific parsing guidance ("For Titan, parse with json.load(...)['embedding']"). Common cases including filtering and error recovery are covered by the troubleshooting table.

5 / 5

Workflow Clarity

The 6-step sequence is clear with request classification, a pre-flight checklist for immutable parameters, and user-confirmation checkpoints ("confirm bucket name with user", "confirm with user -- destroys all vectors"). However, the batch put-vectors operation (up to 500 vectors per call) has no post-ingestion verification step (e.g., query or get-vectors to confirm stored data), and the rubric's hard cap for batch operations without validation/verification caps this at 3. Not a 2 because sequence and several checkpoints are clearly present.

3 / 5

Progressive Disclosure

SKILL.md is a well-organized overview with two clearly signaled, one-level-deep references (limits-and-patterns.md, metadata-filtering.md), both of which exist and cover exactly what is claimed. Advanced content (multi-tenant patterns, batch ingestion, SSE-KMS command, filter operator tables) is appropriately split out, references are linked inline at the point of need and again in an annotated Additional Resources section, and the reference files point only to external AWS docs rather than nesting further files.

5 / 5

Total

17

/

20

Passed

Description

87%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 that explicitly states what the skill does, when to trigger it, and when not to use it, with concrete disambiguation against neighboring skills. Trigger terms are natural and varied, with only minor synonym gaps (e.g., "vector search", "nearest neighbor").

DimensionReasoningScore

Specificity

Names the domain and several concrete actions ("Store and query vector embeddings", "create S3 vector bucket", "migrate from other vector databases") with minor gaps such as metadata filtering and index management not being mentioned. Not a 3 because the action list goes beyond 1-2 generic actions; not a 5 because coverage of capabilities (e.g., filtering, Bedrock integration) is incomplete.

4 / 5

Completeness

Explicitly answers both what ("Store and query vector embeddings using Amazon S3 Vectors, a cost-effective long-term vector storage service with its own API namespace") and when ("Triggers on: create S3 vector bucket, vector index, store embeddings, semantic search...") with concrete trigger phrases, plus explicit negative triggers ("Do NOT use for: querying tabular data..."). Clearly matches the 5 anchor.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "semantic search", "similarity search", "RAG vector storage", "vector database", "store embeddings", "migrate from other vector databases" — terms users would actually say. Not a 5 because a few natural variations are missing (e.g., "vector search", "nearest neighbor", "kNN", bare "embeddings").

4 / 5

Distinctiveness Conflict Risk

Clear niche (S3 Vectors with its own s3vectors API namespace) and explicit disambiguation against adjacent skills ("use querying-data-lake", "S3 object storage", "use OpenSearch" for sustained QPS) minimizes wrong-skill triggering. Clearly matches the 5 anchor with distinct triggers.

5 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

mreferre/aws-agent-toolkit-skills

Path

.kiro/skills/storing-and-querying-vectors/SKILL.md

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.