CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

typeorm

Use when defining TypeORM entities, writing migrations, or building repository/query-builder code in TypeScript. Covers entity and relation decorators, the Data Mapper pattern, migrations, the query builder, transactions, and multi-database configuration.

65

Quality

82%

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

65%Weight 40%Scale 1-5

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

The body delivers excellent executable code for the common cases and keeps the overview lean, but it is dragged down by a padded Core Principles section, a missing migration workflow with validation for schema changes, and — most seriously — a referenced reference.md that does not exist in the bundle, breaking the disclosure chain for all advanced detail.

Suggestions

Add a short migration workflow with a validation checkpoint, e.g. generate (scripts/new-migration.sh), review the generated SQL, run via DataSource migration API, then verify with migration:show or a query against the migrations table.

Ship the referenced reference.md (or fix the links) — the body delegates primary-key options, relation types, repository methods, query builder, transactions, and framework integration to a file absent from the bundle.

Cut the role-statement line and the Core Principles platform list ('Works in Node.js, Browser, Ionic, Cordova, React Native, NativeScript, Expo, and Electron'); neither changes what Claude should do.

DimensionReasoningScore

Conciseness

The body is mostly efficient (tight tsconfig block, one representative entity, one DataSource config, bullet Quick Guidance), but the 'You are an expert...' role line and the Core Principles section — 'Works in Node.js, Browser, Ionic, Cordova, React Native, NativeScript, Expo, and Electron', 'First-class support for database migrations' — are brochure filler Claude does not need. This is a distinct padded section beyond anchor 4's 'minor instances of over-explanation', matching anchor 3.

3 / 5

Actionability

Everything instructs with runnable artifacts: a complete tsconfig JSON, a fully imported executable entity example, a copy-paste DataSource configuration with env handling, concrete repository method names ('find, findOne, create, save, update, delete, and softDelete'), and two scaffold scripts with usage lines. Matches the score-5 anchor: copy-paste ready and covering the common cases.

5 / 5

Workflow Clarity

Prescriptive rules are clear ('Always release() a QueryRunner in a finally block', 'Never use synchronize: true in production'), but the skill covers migrations and schema changes — database operations the rubric's feedback-loop note flags — without any generate → review → run → verify sequence or validation checkpoint. Per the cap guidance for database operations without validation, this cannot exceed 3; it is not 2 because the guidance that exists is coherent and specific.

3 / 5

Progressive Disclosure

The split is well intentioned (lean overview delegating detail to reference.md and two scripts), but the central reference file is missing from the bundle: 'see [reference.md](reference.md)' is promised three times as the home for relation types, the query builder, transactions, and framework integration, yet no reference.md exists — only scripts/new-entity.sh and scripts/new-migration.sh. The main navigation target is broken, which exceeds anchor 4's 'minor organization gaps' and fits anchor 3's structure-with-breakdown.

3 / 5

Total

14

/

20

Passed

Description

92%Weight 40%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.

A strong description: it explicitly answers both what the skill covers and when to use it, with concrete, natural trigger phrases tied to a specific library. The only gap is minor — a few natural synonyms (e.g. 'ORM', 'DataSource') that users might use instead.

DimensionReasoningScore

Specificity

The 'Covers' clause lists six concrete capability areas — 'entity and relation decorators, the Data Mapper pattern, migrations, the query builder, transactions, and multi-database configuration' — comprehensive coverage of the library's feature surface, matching the score-5 anchor's breadth. Not 4: no meaningful coverage gaps remain for the domain.

5 / 5

Completeness

Both what ('Covers entity and relation decorators, the Data Mapper pattern, migrations, the query builder, transactions, and multi-database configuration') and when ('Use when defining TypeORM entities, writing migrations, or building repository/query-builder code in TypeScript') are explicit with concrete trigger phrases, mirroring the score-5 anchor example. Not 4: the 'when' is not merely present but lists three specific triggering tasks.

5 / 5

Trigger Term Quality

Natural phrases a TypeORM user would actually say are present ('defining TypeORM entities', 'writing migrations', 'repository/query-builder code'), matching the anchor-4 example's coverage level. Not 5: common variations like 'ORM', 'DataSource', or 'database schema' are missing; not 3: all core natural trigger phrases are explicit.

4 / 5

Distinctiveness Conflict Risk

Names a specific library (TypeORM) with distinct, niche-specific triggers (entities, migrations, query builder), so it is clearly distinguishable from generic TypeScript or database skills. Not 4: even minor overlap risk is low because the library is named and the triggers are its native vocabulary.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

whimzyLive/nightshift-ai

Path

skills/typeorm/SKILL.md

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.