Agent skill

Twenty Syncable Entity Validation

by twentyhq in twentyhq/twenty

Contributor guide for step three of adding a syncable entity to the Twenty server: write the validator, the migration action builder and the orchestrator wiring.

Custom licenceAuto-check passedBackend & APIs

Install Twenty Syncable Entity Validation

skills CLI
$ npx skills add twentyhq/twenty --skill syncable-entity-builder-and-validation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install twentyhq/twenty syncable-entity-builder-and-validation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/twentyhq/twenty.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/syncable-entity-builder-and-validation .claude/skills/syncable-entity-builder-and-validation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
syncable-entity-builder-and-validation
GitHub stars
58k
Token cost
~3.3k tokens
SKILL.md length
232 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
Custom licence

At a glance

Contributor guide for step three of adding a syncable entity to the Twenty server: write the validator, the migration action builder and the orchestrator wiring.

  • Works in 3 steps: Create Validator Service → Create Builder Service → Wire into Orchestrator (CRITICAL)
  • Implementing business rule validation for a syncable entity in Twenty
  • SKILL.md covers Quick Start, Step 1: Create Validator Service, Step 2: Create Builder Service and Step 3: Wire into Orchestrator…, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This is step 3 of 6 in the workflow for adding a syncable entity to the Twenty server; it is for contributing to Twenty itself, not for building apps on top of it. After the types, cache and transform steps, it creates a validator service for business rules, a builder service that produces workspace migration actions, and the wiring of that builder into the build orchestrator, which the skill flags as the step most often forgotten, since the entity will not sync without it.

Validators follow two rules: they never throw, returning arrays of errors instead, and they never mutate, working on optimistic entity maps. Uniqueness and foreign-key checks use indexed lookups rather than scanning with `Object.values().find()`, which is O(n). The excerpt shows file paths under `src/engine/workspace-manager/workspace-migration/`, NestJS injectable services and validation patterns for required fields and uniqueness, then is cut off.

When your agent uses it

  • Implementing business rule validation for a syncable entity in Twenty
  • Adding uniqueness or foreign key checks that return errors instead of throwing
  • Building workspace migration action builders for a new entity
  • Wiring a new builder into the migration build orchestrator

Example prompts

  • “Add a validator for the new view-group entity that rejects duplicate names.”
  • “Create the migration actions builder for my entity and wire it into the orchestrator.”
  • “Review this validator: it throws on duplicates and scans with Object.values().find().”

Requirements

  • A checkout of the twentyhq/twenty repository with the earlier steps (types, cache, transform) done

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Create Validator Service
  2. Create Builder Service
  3. Wire into Orchestrator (CRITICAL)

What it can do on your machine

Read from SKILL.md and the folder at commit 0d66dd1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Twenty Syncable Entity Validation loads about 3.3k tokens when it runs. Until then it costs about 110 tokens; SKILL.md has 232 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~110
When it runs · the whole SKILL.md, loaded when a task matches
~3.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 232 words (~3,322 tokens).

“Purpose: Implement business rule validation and create migration action builders.”

— opening of SKILL.md by twentyhq, Custom licence
name
syncable-entity-builder-and-validation

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/syncable-entity-builder-and-validation of twentyhq/twenty.

Open the folder on GitHubat commit 0d66dd1

Compare with similar skills

Twenty Syncable Entity Validation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Twenty Syncable Entity Validation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Twenty Syncable Entity Validation this skilltwentyhq/twenty58k—~3.3kAutomated safety check: PassCustom licence
Nodejsblencorp/claude-code-kit106—~2.6kAutomated safety check: PassMIT
Server Feature Devscragnog/HOT-Step-CPP170—~6.5kAutomated safety check: NotesMIT
Developing Softwaretelagod/code-abyss244—~410Automated safety check: PassMIT
Nestjs Code Auditaiskillstore/marketplace430—~2.5kAutomated safety check: PassMIT
Node Backend Development Guidelinesdiet103/claude-code-infrastructure-showcase10k2 repos~2kAutomated safety check: PassMIT

Similar skills

  • Nodejs

    blencorp/claude-code-kit

    Core Node.js backend patterns for TypeScript applications including async/await error handling, middleware concepts, configuration management, testing strategies, and layered architecture principles.

    106 GitHub stars~2.6k tokensUpdated 10 mo ago
    Backend & APIsAuto-check passed
  • Server Feature Dev

    scragnog/HOT-Step-CPP

    Guides adding or modifying a feature in the HOT-Step CPP Node/TypeScript server (Express route + service pattern, better-sqlite3 schema changes, engine calls via aceClient, logging, tsx watch dev…

    170 GitHub stars~6.5k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Developing Software

    telagod/code-abyss

    Software development knowledge reference covering Python, Go, Rust, TypeScript, Java, C++, and Shell.

    244 GitHub stars~410 tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Nestjs Code Audit

    aiskillstore/marketplace

    Audits an existing NestJS repository with bundled semantic guidance and optional specialist skills and returns one prioritized, evidence-backed code-quality report.

    430 GitHub stars~2.5k tokensUpdated today
    Backend & APIsAuto-check passed
  • Node Backend Development Guidelines

    diet103/claude-code-infrastructure-showcase

    Sets layered architecture and coding rules for Node.js, Express and TypeScript microservices, covering routes, controllers, services, repositories, Prisma, Sentry and Zod.

    10k GitHub starsUsed in 2 repos~2k tokens
    Backend & APIsAuto-check passed
  • cmux Backend Rules

    manaflow-ai/cmux

    Sets the backend TypeScript and Cloud VM rules for cmux: Effect-based services, thin route handlers, Postgres as source of truth, migrations and provider secrets.

    28k GitHub starsUsed in 1 repo~682 tokens
    Backend & APIsAuto-check passed

More from twentyhq/twenty

All 13 skills in this repo
  • Guides changes to an existing Twenty app: adding or editing objects, layouts, logic functions and front components, with a plan stated before multi-entity edits.

    58k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Twenty App Operations

    twentyhq/twenty

    Operates an existing Twenty app: managing remotes, syncing, building, deploying, reading logs, running tests and setting up CI/CD, with confirmation for production.

    58k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Walks through step 2 of adding a syncable entity to the Twenty server: a cache service for flat entity maps and utilities that transform entities and DTOs into universal flat entities.

    58k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Registers a new syncable entity in three NestJS modules and adds its service and GraphQL resolver layers when contributing to the Twenty server.

    58k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Step four of adding a syncable entity in the Twenty server: write create, update and delete action handlers that run workspace migrations against the database.

    58k GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Step-by-step guide to writing the mandatory integration tests for syncable metadata entities in Twenty's server, covering failures and CRUD success cases.

    58k GitHub stars~3.4k tokensUpdated today
    Auto-check passed

Questions about Twenty Syncable Entity Validation

What does Twenty Syncable Entity Validation do?

Contributor guide for step three of adding a syncable entity to the Twenty server: write the validator, the migration action builder and the orchestrator wiring. This is step 3 of 6 in the workflow for adding a syncable entity to the Twenty server; it is for contributing to Twenty itself, not for building apps on top of it. After the types, cache and transform steps, it creates a validator service for business rules, a builder service that produces workspace migration actions, and the wiring of that builder into the build orchestrator, which the skill flags as the step most often forgotten, since the entity will not sync without it.

When should I use Twenty Syncable Entity Validation?

Twenty Syncable Entity Validation fits situations like: implementing business rule validation for a syncable entity in Twenty; adding uniqueness or foreign key checks that return errors instead of throwing; building workspace migration action builders for a new entity; wiring a new builder into the migration build orchestrator.

How do I install Twenty Syncable Entity Validation in Claude Code?

Run `npx skills add twentyhq/twenty --skill syncable-entity-builder-and-validation -a claude-code`. Or copy the skill folder (.claude/skills/syncable-entity-builder-and-validation in twentyhq/twenty) into .claude/skills/syncable-entity-builder-and-validation in your project. Claude Code loads it when a task matches its description.

How do I install Twenty Syncable Entity Validation in Codex?

Run `npx skills add twentyhq/twenty --skill syncable-entity-builder-and-validation -a codex`. Or copy the skill folder (.claude/skills/syncable-entity-builder-and-validation in twentyhq/twenty) into .agents/skills/syncable-entity-builder-and-validation in your project. Codex loads it when a task matches its description.

Can I use Twenty Syncable Entity Validation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add twentyhq/twenty --skill syncable-entity-builder-and-validation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/syncable-entity-builder-and-validation, .gemini/skills/syncable-entity-builder-and-validation, .github/skills/syncable-entity-builder-and-validation and .opencode/skills/syncable-entity-builder-and-validation in your project.

What does Twenty Syncable Entity Validation need to run?

SKILL.md names no scripts, command-line tools or credentials: Twenty Syncable Entity Validation is instructions for the agent only. Our summary lists: A checkout of the twentyhq/twenty repository with the earlier steps (types, cache, transform) done.

Does Twenty Syncable Entity Validation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Twenty Syncable Entity Validation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Twenty Syncable Entity Validation use?

Twenty Syncable Entity Validation has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Twenty Syncable Entity Validation use?

About 3.3k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Twenty Syncable Entity Validation?

Skills that share tags, products or a category with Twenty Syncable Entity Validation: Nodejs (blencorp/claude-code-kit, 106 stars), Server Feature Dev (scragnog/HOT-Step-CPP, 170 stars), Developing Software (telagod/code-abyss, 244 stars) and Nestjs Code Audit (aiskillstore/marketplace, 430 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Twenty Syncable Entity Validation?

twentyhq (a GitHub organization) maintains it in twentyhq/twenty, which has 57,999 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 7, 2026.

Source: twentyhq/twenty on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.