syncable-entity-cache-and-transform

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

80%

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

Fix and improve this skill with Tessl

tessl review fix ./.cursor/skills/syncable-entity-cache-and-transform/SKILL.md

Quality

Content

75%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 well-structured, actionable skill body built around executable TypeScript templates for a clear multi-step process, with a closing checklist for verification. Its main gaps are minor redundancy between code and prose, a slightly less polished update-transform pattern, and no explicit validate/retry feedback loop.

Suggestions

Collapse the 'Key steps' recap lists that merely restate the preceding code, or replace them with only the non-obvious gotchas not visible in the code.

Tighten the update-transform pattern (remove the `as any` cast, show the import) so it matches the executability of Steps 1-3.

Add an explicit verification step in the workflow (e.g. 'typecheck the new module' or 'confirm the cache service resolves in a consumer') with a fix-and-retry loop before the Checklist.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient TypeScript with brief, domain-specific critical callouts ('CRITICAL: Include soft-deleted entities', 'universalIdentifier must be a new UUID') rather than generic concept explanations, but the 'Key steps' lists restate what the adjacent code already shows and could be trimmed, fitting the 'efficient; minor over-explanation' anchor.	4 / 5
Actionability	Each step ships concrete, copy-paste-ready TypeScript with explicit file paths, covering the common cases well; minor gaps like the update-transform pattern's `as any` cast and the per-entity template substitution keep it just below fully executable.	4 / 5
Workflow Clarity	A clear four-step sequence with a final Checklist acting as a verification checkpoint; it lacks an explicit validate-then-fix feedback loop, but the operations are code creation rather than destructive/batch runs, so it fits the 'clear sequence with most checkpoints present' anchor.	4 / 5
Progressive Disclosure	Well-organized sections (Quick Start, Steps 1-4, Common Patterns, Checklist, Next Step) with clearly signaled one-level-deep pointers to the next-step SKILL.md and the @creating-syncable-entity rule; no bundle files exist, and the inlined Common Patterns section is reasonable supplementary material, fitting the 'good structure; minor organization gaps' anchor.	4 / 5
	Total	16 / 20 Passed

Description

85%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, third-person description that clearly states what the skill does and when to use it, with a distinctive narrow niche. Its only weakness is jargon-heavy trigger terms lacking synonyms or common variations a user might naturally phrase differently.

Suggestions

Add a couple of natural-language synonyms or looser phrasings alongside the technical trigger terms (e.g. 'flat entity mapping', 'DTO to flat entity') so users who phrase the need differently still match.

Consider mentioning the broader workflow context (Step 2 of 6) in the description so users searching for the overall syncable-entity flow can locate this skill.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'cache services', 'transformation utilities', 'entity-to-flat conversions', 'input DTO transpilation to universal flat entities', and 'cache recomputation' — giving comprehensive coverage of the skill's capabilities, matching the top anchor.	5 / 5
Completeness	Explicitly answers both what ('Create cache services and transformation utilities for syncable entities in Twenty') and when ('Use when implementing entity-to-flat conversions, input DTO transpilation..., or cache recomputation') with concrete trigger phrases, matching the top anchor.	5 / 5
Trigger Term Quality	The trigger phrases ('entity-to-flat conversions', 'input DTO transpilation', 'cache recomputation') are the natural terms within the Twenty domain, but they are technical jargon with no synonyms or common variations, fitting the 'some relevant keywords but missing variations' anchor rather than the comprehensive anchor above.	3 / 5
Distinctiveness Conflict Risk	The narrow niche of 'syncable entities in Twenty' with its distinct, domain-specific trigger phrases gives it a clear niche with minimal overlap risk against other skills.	5 / 5
	Total	18 / 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-cache-and-transform/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.