connecting-lambda-to-dynamodb

Connects an AWS Lambda function to DynamoDB with IAM roles, stream event source mapping, and read/write permissions. Use when setting up Lambda-DynamoDB integration, processing DynamoDB stream events, or deploying serverless event-driven architectures.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-structured and concise, using progressive disclosure to delegate the detailed procedure to a real one-level reference. However, it scores lower on actionability and workflow clarity because nearly all executable detail lives in the reference rather than the SKILL.md body.

Suggestions

Include one minimal copy-paste-ready command or snippet (e.g. the event source mapping aws-cli call) in SKILL.md so the entry point is actionable without opening the reference.

Surface the high-level ordered step list (create role → function → table → event source mapping → test) inline so the workflow sequence is clear before delegating to the reference.

Add an explicit validation checkpoint hint in the troubleshooting flow (e.g. confirm the mapping status is 'Active' via aws lambda list-event-source-mappings before declaring success).

Dimension	Reasoning	Score
Conciseness	The body is lean — Overview, a pointer to the procedure, and a short troubleshooting section — and assumes Claude's competence without re-explaining Lambda or DynamoDB concepts.	3 / 3
Actionability	The body delegates nearly all concrete guidance to the reference file (e.g. 'See [Lambda-DynamoDB connection procedure]'), with only high-level troubleshooting hints like 'Verify the event source mapping is active'; no executable commands or code live in SKILL.md itself.	2 / 3
Workflow Clarity	It signals a multi-step procedure ('follow the procedure exactly') but the sequence and validation checkpoints live in the reference rather than the body, and the in-body troubleshooting steps are listed without explicit validation feedback loops.	2 / 3
Progressive Disclosure	A clean overview pointing to a single one-level-deep reference (references/lambda-dynamodb-connection.md, which exists) with well-signaled navigation, while keeping troubleshooting inline appropriately.	3 / 3
	Total	10 / 12 Passed

Description

100%

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 concise, third-person, and covers concrete capabilities with explicit 'Use when...' triggers. It answers both what and when with natural phrasing and a distinct niche.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'IAM roles, stream event source mapping, and read/write permissions' — naming specific AWS integration components rather than vague language.	3 / 3
Completeness	Clearly answers both what ('Connects an AWS Lambda function to DynamoDB with IAM roles, stream event source mapping, and read/write permissions') and when ('Use when setting up Lambda-DynamoDB integration...').	3 / 3
Trigger Term Quality	Good natural-phrase coverage with 'setting up Lambda-DynamoDB integration', 'processing DynamoDB stream events', and 'deploying serverless event-driven architectures', all phrasings a user would plausibly say.	3 / 3
Distinctiveness Conflict Risk	A clear niche — Lambda-DynamoDB integration with streams — unlikely to overlap with other skills; the qualified trigger context narrows it further.	3 / 3
	Total	12 / 12 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: aws/agent-toolkit-for-aws
Path: skills/specialized-skills/serverless-skills/connecting-lambda-to-dynamodb/SKILL.md
Commit: 222ce56

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.