syncable-entity-types-and-constants

Define types, entities, and central constant registrations for syncable entities in Twenty's workspace migration system. Use when creating new syncable entities, defining TypeORM entities, flat entity types, or registering in central constants (ALL_ENTITY_PROPERTIES_CONFIGURATION_BY_METADATA_NAME, ALL_ONE_TO_MANY_METADATA_RELATIONS, ALL_MANY_TO_ONE_METADATA_FOREIGN_KEY, ALL_MANY_TO_ONE_METADATA_RELATIONS).

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

85%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 content is highly actionable and well-sequenced with code examples, rules, a derivation graph, and a validation-gated checklist. Its main weakness is progressive disclosure: a large single-file body with no reference bundle, where some constant-registration detail could be externalized.

Suggestions

Move the detailed 6a-6e central-constant registration examples into a references file and summarize the registration rules inline to reduce SKILL.md length and improve progressive disclosure.

Add an explicit validation command or step beyond 'TypeScript compiles without errors' (e.g., a tsc invocation) so the feedback loop is concrete rather than implied.

Add a brief pointer at the top to where the full @creating-syncable-entity workflow and sibling steps live, so navigation across the 6-step series is discoverable from this single file.

Dimension	Reasoning	Score
Conciseness	The body is largely efficient with code-focused steps and minimal concept explanation, but the inline constant examples (especially 6a-6e) and the derivation dependency graph add length that could be trimmed or offloaded to references.	4 / 5
Actionability	Provides concrete, copy-paste-ready TypeScript code for each step with exact file paths, named constants, and explicit rules, fully covering the common cases for creating a syncable entity.	5 / 5
Workflow Clarity	Six clearly sequenced steps with a derivation dependency graph, explicit key rules per step, and a checklist ending in a validation checkpoint ('TypeScript compiles without errors') that gates progression to the next step.	5 / 5
Progressive Disclosure	Structure is well sectioned and a next-step pointer exists, but there are no bundle files and all detail is inlined in a single SKILL.md; the bulk constant registration reference material (6a-6e) could be split into a referenced file rather than fully inlined.	3 / 5
	Total	17 / 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.

The description is highly specific, complete, and distinct: it states concrete capabilities, names the exact constants involved, and provides an explicit 'Use when' trigger clause. Its only minor weakness is reliance on project-specific jargon rather than broadly natural user phrasing.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions (define types, define TypeORM entities, define flat entity types, register in central constants) and names the exact constants involved, giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both 'what' (define types, entities, and central constant registrations for syncable entities) and 'when' ('Use when creating new syncable entities, defining TypeORM entities, flat entity types, or registering in central constants') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Includes natural trigger phrases ('Use when creating new syncable entities, defining TypeORM entities, flat entity types, or registering in central constants') with good coverage, though it leans on project-specific jargon and lacks common synonymous phrasings a user might naturally say.	4 / 5
Distinctiveness Conflict Risk	Targets a very specific niche (Twenty's workspace migration syncable entity types/constants) with named constants, making it clearly distinguishable from other skills with minimal conflict risk.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
relative_links	Relative link issues: 1 suspicious	Warning

	Total	15 / 16 Passed

Repository: twentyhq/twenty
Path: .cursor/skills/syncable-entity-types-and-constants/SKILL.md
Commit: cbd58da

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.