Name: syncable-entity-cache-and-transform
Rating: 67.2 (1 reviews)
Author: twentyhq

syncable-entity-cache-and-transform

Contributing to the Twenty codebase itself (twentyhq/twenty server internals), not for building apps on top of Twenty. Create cache services and transformation utilities for syncable entities in Twenty. Use when implementing entity-to-flat conversions, input DTO transpilation to universal flat entities, or cache recomputation for syncable entities.

Quality

81%

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

The canonical home for this skill is syncable-entity-cache-and-transform in twentyhq/twenty

Quality

Content

82%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 is a highly actionable, well-sequenced guide with complete executable TypeScript for each step and a verification checklist. It is slightly verbose in spots where pattern snippets duplicate inline code and lacks a runtime validation step, but otherwise strong.

Suggestions

Collapse the 'Key steps' enumeration under Step 3 since the annotated code already conveys the same sequence, or replace it with only the non-obvious ordering rationale (extract foreign keys before sanitization).

Add a brief validation cue (e.g., compile/typecheck or a smoke check that getFlatMyEntityMaps returns expected keys) so the workflow has an explicit checkpoint beyond the manual checklist.

Consider moving the Update Transform and JSONB patterns into a references file so SKILL.md stays a tighter overview pointing one level deep.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean code with purposeful callouts ('CRITICAL: Include soft-deleted entities'), but the 'Key steps' list restates what Step 3's code already shows and the Common Patterns section repeats the foreign-key-resolution snippet already inlined, so minor trimming is possible.	4 / 5
Actionability	Every step ships complete, copy-paste-ready TypeScript with real import paths and exact file locations, covering cache service, entity-to-flat conversion, input transform, and module wiring, plus reusable update-transform and JSONB patterns.	5 / 5
Workflow Clarity	Steps 1-4 are clearly sequenced with a closing checklist acting as a verification gate before Step 3 of the broader workflow, though there is no explicit run/validate step within the steps themselves for the cache/transform outputs.	4 / 5
Progressive Disclosure	No bundle files exist; content is well-sectioned (Quick Start, numbered steps, Common Patterns, Checklist, Next Step) with a clear pointer to the next step skill and the @creating-syncable-entity rule, though the Common Patterns block could be externalized for a leaner overview.	4 / 5
	Total	17 / 20 Passed

Description

80%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 complete and distinctive, clearly stating both purpose and explicit use-when triggers for a well-scoped internal Twenty contribution task. Its main weakness is trigger-term quality: the keywords are accurate but jargon-heavy rather than natural user phrasing.

Suggestions

Soften jargon in trigger terms by pairing technical phrases with more natural equivalents users might actually say (e.g., 'syncing entities', 'flattening entity data', 'resolving entity relations').

Add common synonyms or file/extension-style anchors alongside 'DTO transpilation' so the skill surfaces for varied phrasings of the same intent.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions ('Create cache services and transformation utilities', 'entity-to-flat conversions', 'input DTO transpilation to universal flat entities', 'cache recomputation'), though verbs like 'create'/'transformation utilities' are slightly generic, keeping it just below the comprehensive 5 anchor.	4 / 5
Completeness	Explicitly answers both what ('Create cache services and transformation utilities for syncable entities') and when ('Use when implementing entity-to-flat conversions, input DTO transpilation to universal flat entities, or cache recomputation') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Relevant domain keywords are present ('syncable entities', 'entity-to-flat conversions', 'DTO transpilation', 'cache recomputation') but they lean heavily toward internal jargon rather than phrases a user would naturally say, missing common variations or synonyms.	3 / 5
Distinctiveness Conflict Risk	Targets a clear niche (Twenty server internals for syncable entities) and explicitly disambiguates ('not for building apps on top of Twenty'), minimizing conflict with adjacent skills.	5 / 5
	Total	17 / 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: .claude/skills/syncable-entity-cache-and-transform/SKILL.md
Commit: 710f163

Reviewed: 1 day 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.