CtrlK
BlogDocsLog inGet started
Tessl Logo

giuseppe-trisciuoglio/developer-kit

Comprehensive developer toolkit providing reusable skills for Java/Spring Boot, TypeScript/NestJS/React/Next.js, Python, PHP, AWS CloudFormation, AI/RAG, DevOps, and more.

89

Quality

89%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Overview
Quality
Evals
Security
Files

Quality

Discovery

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.

This is an excellent skill description that clearly articulates specific capabilities around AWS SAM bootstrapping, migration, and local testing. It includes a comprehensive 'Use when...' clause with natural trigger terms that users would actually say. The description is concise yet thorough, with distinct technical identifiers that minimize conflict risk with other skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: generates template.yaml and samconfig.toml, creates SAM templates for migration, validates build/package/deploy workflows, and configures local testing with sam local invoke.

3 / 3

Completeness

Clearly answers both what (generates template.yaml, creates SAM templates for migration, validates workflows, configures local testing) and when (explicit 'Use when...' clause with specific trigger scenarios).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'SAM projects', 'sam init', 'sam deploy', 'serverless deployments', 'bootstrap', 'migrate Lambda functions', 'SAM templates', 'template.yaml', 'samconfig.toml', 'sam local invoke'.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche focused specifically on AWS SAM bootstrapping and migration. The specific tool names (sam init, sam deploy, sam local invoke) and file references (template.yaml, samconfig.toml) make it very unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

57%

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

The skill is well-organized with clear scenario classification and good progressive disclosure to reference files. However, it falls short on actionability by not including actual template.yaml or samconfig.toml content — the core artifacts a user would need. The validation workflow lists checks but lacks explicit error recovery steps.

Suggestions

Add a minimal but complete template.yaml example (with AWS::Serverless::Function resource) and samconfig.toml example that can be copy-pasted, rather than just describing what they should contain.

Add a feedback loop to the validation checklist: specify what to do when `sam validate` or `sam build` fails (e.g., common error patterns and fixes).

Remove or trim the 'Constraints and Warnings' section — most items (SAM CLI must be installed, Docker needed for containers, CAPABILITY_IAM for IAM resources) are things Claude already knows.

DimensionReasoningScore

Conciseness

Generally efficient but includes some unnecessary sections like 'When to Use' which restates the description, and 'Best Practices' contains somewhat generic advice. The 'Constraints and Warnings' section explains things Claude would already know (e.g., SAM CLI must be installed, Docker required for containers).

2 / 3

Actionability

Provides concrete CLI commands (sam init, sam build, sam deploy) but lacks executable template.yaml and samconfig.toml examples — the most critical artifacts are never shown. The migration workflow is described abstractly ('Create template.yaml with Transform...') without showing actual YAML content that could be copy-pasted.

2 / 3

Workflow Clarity

Steps are clearly sequenced for both new and existing project scenarios, and there is a validation checklist. However, the validation checklist lacks a feedback loop — it lists checks but doesn't specify what to do when validation fails or how to recover from common errors.

2 / 3

Progressive Disclosure

Good structure with a concise overview, clear sections, and well-signaled one-level-deep references to examples.md and migration-checklist.md. Content is appropriately split between the main skill file and reference materials.

3 / 3

Total

9

/

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

10

/

11

Passed

Reviewed

Table of Contents