Specialized skill for building production-ready serverless applications on AWS. Covers Lambda functions, API Gateway, DynamoDB, SQS/SNS event-driven patterns, SAM/CDK deployment, and cold start optimization.
56
Quality
52%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.agent/skills/aws-serverless/SKILL.mdQuality
Discovery
82%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong description with excellent specificity and trigger term coverage for AWS serverless development. The main weakness is the absence of an explicit 'Use when...' clause, which would help Claude know exactly when to select this skill over others. The technical depth is appropriate and the scope is well-defined.
Suggestions
Add a 'Use when...' clause with explicit triggers like 'Use when building serverless applications on AWS, deploying Lambda functions, or optimizing serverless architecture'
Consider adding user-facing trigger phrases like 'serverless API', 'Lambda deployment', or 'event-driven AWS architecture' to capture more natural user requests
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and technologies: Lambda functions, API Gateway, DynamoDB, SQS/SNS event-driven patterns, SAM/CDK deployment, and cold start optimization. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers 'what does this do' with specific AWS serverless capabilities, but lacks an explicit 'Use when...' clause or equivalent trigger guidance. The when is only implied through the technology names. | 2 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'serverless', 'AWS', 'Lambda', 'API Gateway', 'DynamoDB', 'SQS', 'SNS', 'SAM', 'CDK', 'cold start'. Good coverage of terms developers naturally use when working with AWS serverless. | 3 / 3 |
Distinctiveness Conflict Risk | Very distinct niche focusing specifically on AWS serverless architecture. The combination of Lambda, API Gateway, DynamoDB, and deployment tools creates a clear, non-conflicting scope that wouldn't overlap with general coding or other cloud skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
22%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill body is essentially an empty shell - a table of contents with no actual content. While it references sub-skills appropriately, the main SKILL.md provides zero actionable guidance, no overview of AWS serverless concepts, no quick-start examples, and no workflow for building serverless applications. The description promises coverage of Lambda, API Gateway, DynamoDB, SAM/CDK deployment, and cold start optimization, but the body delivers none of this.
Suggestions
Add a Quick Start section with a minimal executable Lambda + API Gateway example that Claude can immediately use
Include a brief workflow showing the typical sequence for building a serverless app (e.g., 1. Define handler → 2. Configure API Gateway → 3. Deploy with SAM → 4. Validate)
Add context for each sub-skill link explaining when to use each pattern (e.g., 'Use Lambda Handler Pattern for: REST APIs, scheduled tasks')
Include at least one concrete SAM or CDK deployment command with validation steps as promised in the description
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is brief but perhaps too sparse - it's essentially just a table of contents with no actual instructional content. While not verbose, it provides no value beyond navigation. | 2 / 3 |
Actionability | No concrete guidance, code, commands, or examples are provided. The skill body contains only links to sub-skills with no executable or instructional content whatsoever. | 1 / 3 |
Workflow Clarity | No workflow is defined. There's no sequence, no steps, no validation checkpoints - just a list of links without any guidance on how to use them or in what order. | 1 / 3 |
Progressive Disclosure | References to sub-skills are present and one-level deep, but the overview provides no context about when to use each pattern, no quick-start content, and no guidance on navigation. It's just a bare list. | 2 / 3 |
Total | 6 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
3395991
Table of Contents
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.