sam-template-builder
Sam Template Builder - Auto-activating skill for AWS Skills. Triggers on: sam template builder, sam template builder Part of the AWS Skills skill category.
42
14%
Does it follow best practices?
Impact
94%
1.01xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./planned-skills/generated/13-aws-skills/sam-template-builder/SKILL.mdQuality
Discovery
22%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 description is severely lacking in substance. It provides no information about what the skill actually does with SAM templates (create, validate, deploy, modify?) and relies entirely on the skill name for context. The description reads more like metadata than actionable guidance for skill selection.
Suggestions
Add specific capabilities: describe what actions this skill performs (e.g., 'Creates AWS SAM templates, configures Lambda functions, defines API Gateway resources, sets up DynamoDB tables').
Add an explicit 'Use when...' clause with trigger scenarios (e.g., 'Use when building serverless applications, creating Lambda deployments, or when the user mentions SAM, serverless, or AWS infrastructure templates').
Include natural keyword variations users would say: 'SAM', 'serverless', 'Lambda template', 'AWS infrastructure', 'CloudFormation', 'serverless.yaml'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description contains no concrete actions whatsoever. 'Auto-activating skill for AWS Skills' is completely abstract and doesn't describe what the skill actually does with SAM templates. | 1 / 3 |
Completeness | The description fails to answer 'what does this do' (no capabilities listed) and 'when should Claude use it' is only implied through trigger terms. There is no explicit 'Use when...' clause or equivalent guidance. | 1 / 3 |
Trigger Term Quality | Contains 'sam template builder' as a trigger term which is relevant, but it's duplicated and lacks natural variations users might say like 'SAM', 'serverless template', 'AWS SAM', 'serverless application model', or 'infrastructure as code'. | 2 / 3 |
Distinctiveness Conflict Risk | While 'SAM template builder' is somewhat specific to AWS SAM, the lack of concrete actions means it could overlap with other AWS-related skills. The mention of 'AWS Skills skill category' suggests potential conflicts within that category. | 2 / 3 |
Total | 6 / 12 Passed |
Implementation
7%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is essentially a placeholder with no actionable content. It describes what a SAM template builder skill would do but provides zero actual guidance on building SAM templates - no YAML examples, no sam CLI commands, no template structure, no resource definitions. Claude would gain nothing from this skill that it doesn't already know.
Suggestions
Add concrete SAM template YAML examples showing common patterns (API Gateway + Lambda, S3 triggers, DynamoDB tables)
Include executable sam CLI commands for init, build, deploy, and local testing workflows
Provide a step-by-step workflow for creating and deploying a SAM application with validation checkpoints
Remove all generic boilerplate ('provides automated assistance', 'follows best practices') and replace with specific SAM-related guidance
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is padded with generic boilerplate that provides no actual value. Phrases like 'provides automated assistance' and 'follows industry best practices' are vague filler that Claude doesn't need. | 1 / 3 |
Actionability | No concrete code, commands, or executable guidance is provided. The skill describes what it does abstractly but never shows how to actually build a SAM template - no YAML examples, no CLI commands, no specific patterns. | 1 / 3 |
Workflow Clarity | No workflow or steps are defined. The content lists vague 'capabilities' but provides no sequence for building SAM templates, no validation steps, and no actual process to follow. | 1 / 3 |
Progressive Disclosure | The content is organized into sections with headers, but there are no references to detailed materials, no links to examples or advanced topics, and the structure serves no purpose since there's no substantive content to organize. | 2 / 3 |
Total | 5 / 12 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 — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
- Commit
0c08951
- 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.