CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

syncable-entity-testing

Contributing to the Twenty codebase itself (twentyhq/twenty server internals), not for building apps on top of Twenty. Create comprehensive integration tests for syncable entities in Twenty. Use when writing integration tests for metadata entities, covering validator exceptions, input transpilation errors, and CRUD operations. Tests are MANDATORY for all syncable entities.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

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

A highly actionable, well-sequenced testing guide whose strength is complete, executable code for the creation workflow. Its main weaknesses are redundant checklist sections with celebratory padding, absent code for the update/delete spec files, and no error-recovery guidance when tests fail.

Suggestions

Consolidate the three overlapping checklists ("Test coverage requirements", "Complete Test Checklist", "Success Criteria") into a single verification checklist to remove repetition and reduce token cost.

Remove celebratory padding such as the "Congratulations!" paragraph and the "Final Step" section, which add no actionable information.

Add a brief error-recovery step (e.g. what to do when a test or snapshot fails, referencing the "--updateSnapshot" command) to close the validate→fix→retry feedback loop, and include minimal code skeletons for the update/delete spec files rather than only filenames.

DimensionReasoningScore

Conciseness

The bulk is lean, executable TypeScript with no over-explanation of known concepts, but the coverage requirements are repeated across three overlapping checklists ("Test coverage requirements", "Complete Test Checklist", "Success Criteria") and sections like "Congratulations!" and "Final Step" are padding, matching anchor 3 (mostly efficient, could be tightened). It is not anchor 2 because there is no concept over-teaching, and not anchor 4 because the triple-redundant checklists are a noticeable inefficiency.

3 / 5

Actionability

Fully copy-paste-ready code for the query factory, wrapper utility, and both creation spec files, with exact file paths and runnable jest commands (anchor 5 territory), but the four required update/delete spec files are only listed by name with "Create similar test files" and no code, which is a minor-to-moderate gap placing it at anchor 4.

4 / 5

Workflow Clarity

Steps 1-4 are clearly sequenced (utilities → failing tests → successful tests → update/delete) with verification commands ("Running Tests" section) and checklists as checkpoints, but there is no explicit validate→fix→retry feedback loop for when tests fail, so it matches anchor 4 (clear sequence, minor validation gaps) rather than 5.

4 / 5

Progressive Disclosure

Good section structure with a Quick Start up front and a clearly signaled one-level reference ("see @creating-syncable-entity rule"); no bundle files exist, and the ~490 lines of inline code templates are cohesive within a single SKILL.md, but the full spec templates are borderline content that could live in reference files, matching anchor 4 (good structure, minor organization gaps) rather than 5.

4 / 5

Total

15

/

20

Passed

Description

87%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 with explicit what/when structure, concrete coverage areas, and an explicit scope boundary that sharply reduces conflict risk. Its only weaknesses are the single-action framing (test writing only) and slightly narrow trigger vocabulary.

DimensionReasoningScore

Specificity

"Create comprehensive integration tests for syncable entities" plus "covering validator exceptions, input transpilation errors, and CRUD operations" names several concrete coverage areas, but they are all facets of a single action (writing tests) rather than multiple distinct actions, matching anchor 4 rather than 5.

4 / 5

Completeness

It explicitly answers both what ("Create comprehensive integration tests for syncable entities… covering validator exceptions, input transpilation errors, and CRUD operations") and when ("Use when writing integration tests for metadata entities"), with a concrete trigger phrase, matching anchor 5; it is not anchor 4 because the when-clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Natural domain phrases like "integration tests", "syncable entities", "metadata entities", and "validator exceptions" give good keyword coverage, but common variations a user might say (e.g. "test suite", "testing") are absent, so it falls between anchors 4 and 5 but closer to 4.

4 / 5

Distinctiveness Conflict Risk

The niche is highly specific ("Twenty codebase itself (twentyhq/twenty server internals)") and explicitly disambiguated from adjacent uses ("not for building apps on top of Twenty"), giving a clear distinct trigger with minimal conflict risk, matching anchor 5.

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

twentyhq/twenty

Path

.claude/skills/syncable-entity-testing/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.