CtrlK
BlogDocsLog inGet started
Tessl Logo

electrodb

Use when defining DynamoDB entities, modeling indexes, or writing queries/mutations with the ElectroDB ORM. Covers entity schema, access patterns, CRUD operations, update expressions, and single-table design patterns.

68

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

78%Scale 1-5

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

This is a strong, highly actionable ElectroDB reference skill with executable examples covering the full API surface. Its main strength is comprehensive, concrete code examples that Claude can directly use. The primary weakness is that the content is moderately long for a single file and could benefit from splitting reference material into separate files for better progressive disclosure.

Suggestions

Consider splitting the schema quick reference tables and sort key operations into a separate REFERENCE.md to reduce the main file's length and improve progressive disclosure.

Add the referenced `scripts/new-entity.sh` to the bundle or clarify that it may not exist in all projects.

DimensionReasoningScore

Conciseness

The content is efficient and avoids explaining basic DynamoDB or TypeScript concepts. Minor verbosity in the schema quick reference tables and some comments that could be trimmed (e.g., 'item type namespace', 'application namespace'), but overall respects Claude's intelligence well.

4 / 5

Actionability

Fully executable code examples throughout — entity definition, CRUD operations, queries, conditional writes, pagination, and TTL setup are all copy-paste ready with concrete values. The sort key operations table and filter examples cover common cases comprehensively.

5 / 5

Workflow Clarity

The skill is primarily a reference/API guide rather than a multi-step workflow, but it clearly sequences operations (define entity → CRUD → queries → advanced patterns). The .params() inspection method is mentioned for debugging. Minor gap: no explicit validation workflow for verifying entity definitions work correctly before deploying, though this is less critical for a non-destructive ORM skill.

4 / 5

Progressive Disclosure

The content is well-structured with clear section headers and logical progression from basics to advanced patterns. However, at ~200 lines it's somewhat long for a single file — the schema reference tables, sort key operations, and single-table design patterns could be split into separate reference files. The scaffold script reference at the end is good but no bundle files exist to support it.

3 / 5

Total

16

/

20

Passed

Description

87%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.

This is a strong skill description that clearly identifies both what the skill does and when to use it. It names a specific technology stack (DynamoDB + ElectroDB ORM) and lists concrete capabilities like entity schema definition, access patterns, CRUD operations, and single-table design. The 'Use when' clause at the beginning provides clear trigger conditions.

DimensionReasoningScore

Specificity

Lists several specific actions: defining entities, modeling indexes, writing queries/mutations, entity schema, access patterns, CRUD operations, update expressions, and single-table design patterns. Good coverage with minor gaps (e.g., doesn't mention specific methods or configuration details).

4 / 5

Completeness

Explicitly answers both 'what' (entity schema, access patterns, CRUD operations, update expressions, single-table design patterns) and 'when' (defining DynamoDB entities, modeling indexes, writing queries/mutations with ElectroDB ORM) with a clear 'Use when' clause and concrete trigger phrases.

5 / 5

Trigger Term Quality

Includes strong natural keywords like 'DynamoDB', 'ElectroDB', 'ORM', 'entity schema', 'access patterns', 'CRUD operations', 'single-table design', 'indexes', 'queries', 'mutations', and 'update expressions'. Missing some variations like 'NoSQL', 'AWS', 'dynamo', or 'electrodb' in different casings, but overall good coverage.

4 / 5

Distinctiveness Conflict Risk

Highly distinctive due to the specific combination of DynamoDB + ElectroDB ORM. This is a clear niche that would not conflict with general database skills, other ORM skills, or even generic DynamoDB skills without ElectroDB.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
whimzyLive/nightshift-ai
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.