Agent skill

Create a Twenty App

by twentyhq in twentyhq/twenty

Starts a new Twenty app project, first settling which Twenty instance it will sync to: an existing server you point at, or a disposable local one run through Docker.

Custom licenceAuto-check passedDevelopment

Install Create a Twenty App

skills CLI
$ npx skills add twentyhq/twenty --skill create-app -a claude-code

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

GitHub CLI
$ gh skill install twentyhq/twenty create-app --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/packages/twenty-agent-skills/skills/create-app .claude/skills/create-app && 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
create-app
GitHub stars
58k
Token cost
~1.6k tokens
SKILL.md length
917 words
Files
2
Skills in repo
13
Repo updated
First seen
Licence
Custom licence

At a glance

Starts a new Twenty app project, first settling which Twenty instance it will sync to: an existing server you point at, or a disposable local one run through Docker.

  • Works in 2 steps: Existing Twenty instance (default) — the… → Local instance with Docker (fallback) —…
  • Starting a Twenty app, plugin or extension from scratch
  • SKILL.md covers Why A Twenty Instance Is Needed, Choose A Twenty Instance, Scaffolding and After Scaffolding, plus 1 more section
  • Calls yarn and npx; reaches docker.com

What it does

Use this when someone wants to begin a brand-new app, plugin, extension or integration for Twenty, an open-source CRM. Before scaffolding, the agent explains that a Twenty app is a package that extends a running Twenty instance, so its objects, views, front components and logic functions are synced to that instance to be registered, rendered and tested.

The default path asks for the URL of an existing instance, cloud or self-hosted, and the scaffolder signs in through OAuth there. Only when you have no instance does it start a disposable local server on port 2020 through Docker, which needs Docker Desktop installed and running. Other Twenty skills (develop-app, manage-app, publish-app, use-twenty-mcp) handle apps that already exist.

When your agent uses it

  • Starting a Twenty app, plugin or extension from scratch
  • Bootstrapping a CRM integration project for Twenty
  • Choosing between an existing Twenty instance and a local Docker one

Example prompts

  • “Scaffold a new Twenty app called invoice-sync.”
  • “I want to build a CRM extension for our self-hosted Twenty; set up the project.”
  • “Bootstrap a Twenty app for me. I don't have an instance yet, so use Docker.”

Requirements

  • A Twenty instance URL, or Docker Desktop to run one locally
  • OAuth sign-in to the Twenty instance

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Existing Twenty instance (default) — the user provides the URL of a running Twenty server (self-hosted or cloud, e.g…
  2. Local instance with Docker (fallback) — only when the user has no Twenty instance available. The scaffolder starts a disposable local…

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

    Shell commands in SKILL.md call:

    • yarn
    • npx

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • docker.com

    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

Create a Twenty App loads about 1.6k tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 917 words of instructions outside code blocks.

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

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 917 words (~1,624 tokens).

“Pick this skill when the user wants to start a brand-new Twenty app from scratch. Representative triggers:”

— opening of SKILL.md by twentyhq, Custom licence
name
create-app

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in packages/twenty-agent-skills/skills/create-app of twentyhq/twenty.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 0d66dd1

Compare with similar skills

Create a Twenty App 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.

Create a Twenty App compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Create a Twenty App this skilltwentyhq/twenty58k—~1.6kAutomated safety check: PassCustom licence
Template Devlbedner/aegis-stack143—~2.9kAutomated safety check: PassMIT
AzureML Project ScaffoldingKilo-Org/kilo-marketplace189—~3.1kAutomated safety check: NotesMIT
Superset Project Setupsuperset-sh/superset15k—~577Automated safety check: NotesCustom licence
Dx Harnesspproenca/dot-skills214—~1.5kAutomated safety check: PassMIT
Start Tempsgotempsh/temps822—~5.4kAutomated safety check: PassApache-2.0

Similar skills

  • Template Dev

    lbedner/aegis-stack

    A skill your agent uses when developing or modifying Copier templates in aegis/templates, or backporting a change from a generated project (e.g.

    143 GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed
  • AzureML Project Scaffolding

    Kilo-Org/kilo-marketplace

    Sets up and maintains AzureML-ready Python projects as uv workspaces with devcontainers, a Makefile and job YAML, so local runs match cloud jobs and experiments stay reproducible.

    189 GitHub stars~3.1k tokensUpdated 8 days ago
    DevelopmentAuto-check: notes
  • Superset Project Setup

    superset-sh/superset

    Makes a repository Superset-ready by writing .superset/config.json with setup, teardown and run scripts, then proving it with a real throwaway workspace.

    15k GitHub stars~577 tokensUpdated today
    DevelopmentAuto-check: notes
  • Dx Harness

    pproenca/dot-skills

    Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.

    214 GitHub stars~1.5k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Start Temps

    gotempsh/temps

    Start (or restart) a local Temps control plane built from this checkout, and the web dev server (bun dev) in <checkout/web.

    822 GitHub stars~5.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Guides classifying, gap-analyzing and scaffolding support for a new SQL database in pREST, from Postgres-compatible variants to entirely new dialects.

    4.6k GitHub stars~1.6k tokensUpdated yesterday
    DatabasesAuto-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
  • 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.

    58k GitHub stars~3.3k 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

Works with

Categories

Questions about Create a Twenty App

What does Create a Twenty App do?

Starts a new Twenty app project, first settling which Twenty instance it will sync to: an existing server you point at, or a disposable local one run through Docker. Use this when someone wants to begin a brand-new app, plugin, extension or integration for Twenty, an open-source CRM. Before scaffolding, the agent explains that a Twenty app is a package that extends a running Twenty instance, so its objects, views, front components and logic functions are synced to that instance to be registered, rendered and tested.

When should I use Create a Twenty App?

Create a Twenty App fits situations like: starting a Twenty app, plugin or extension from scratch; bootstrapping a CRM integration project for Twenty; choosing between an existing Twenty instance and a local Docker one.

How do I install Create a Twenty App in Claude Code?

Run `npx skills add twentyhq/twenty --skill create-app -a claude-code`. Or copy the skill folder (packages/twenty-agent-skills/skills/create-app in twentyhq/twenty) into .claude/skills/create-app in your project. Claude Code loads it when a task matches its description.

How do I install Create a Twenty App in Codex?

Run `npx skills add twentyhq/twenty --skill create-app -a codex`. Or copy the skill folder (packages/twenty-agent-skills/skills/create-app in twentyhq/twenty) into .agents/skills/create-app in your project. Codex loads it when a task matches its description.

Can I use Create a Twenty App 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 create-app -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/create-app, .gemini/skills/create-app, .github/skills/create-app and .opencode/skills/create-app in your project.

What does Create a Twenty App need to run?

Going by SKILL.md and its folder, Create a Twenty App needs the command-line tools its instructions call (yarn and npx). Our summary lists: A Twenty instance URL, or Docker Desktop to run one locally; OAuth sign-in to the Twenty instance.

Does Create a Twenty App access the network?

SKILL.md names 1 domain. In commands or code: docker.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Create a Twenty App 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 Create a Twenty App use?

Create a Twenty App 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 Create a Twenty App use?

About 1.6k tokens (SKILL.md is roughly 6.5k 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 Create a Twenty App?

Skills that share tags, products or a category with Create a Twenty App: Template Dev (lbedner/aegis-stack, 143 stars), AzureML Project Scaffolding (Kilo-Org/kilo-marketplace, 189 stars), Superset Project Setup (superset-sh/superset, 15k stars) and Dx Harness (pproenca/dot-skills, 214 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Create a Twenty App?

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.