# Publish App

Use when the user wants to prepare or verify a Twenty app for npm or marketplace...

- Repository: https://github.com/twentyhq/twenty (60258 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add twentyhq/twenty --skill publish-app -g -a claude-code -y`
Codex: `npx skills add twentyhq/twenty --skill publish-app -g -a codex -y`
Cursor: `npx skills add twentyhq/twenty --skill publish-app -g -a cursor -y`
Gemini CLI: `npx skills add twentyhq/twenty --skill publish-app -g -a gemini-cli -y`

## Description

Use when the user wants to prepare or verify a Twenty app for npm or marketplace publication, including README/About copy, package metadata, defineApplication marketplace metadata, logos, screenshots, and public assets.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# When To Use

Pick this skill when the user wants to make an existing Twenty app _presentable_, listing copy, branding, public assets, and publication. Representative triggers:

- "prepare my Twenty app for the marketplace"
- "write the README for my Twenty app"
- "publish my app to npm"
- "add a logo / screenshots / marketplace metadata"
- "set up `defineApplication` marketplace fields"
- "review my app listing before going live"
- "ship a new version of my published app"

Do not use this skill to scaffold (use `create-app`), to change app entities (use `develop-app`), to deploy a private build to a specific Twenty server (use `manage-app`), or to query workspace records (use `use-twenty-mcp`).

# Publishing Checklist

For background on how Twenty apps work, the SDK packages, remotes, sync lifecycle, and rendering model, read `../../references/concepts/how-apps-work.md`. Cross-skill operating rules that apply to every Twenty app task are in `../../references/concepts/operating-rules.md`; they are authoritative and not restated per skill.

Use `../../references/publish-app/prepare-for-app-store.md` for detailed README, marketplace copy, logo, screenshot, and public asset guidance.

Keep the skill workflow concise:

The rest: https://github.com/twentyhq/twenty/blob/HEAD/packages/twenty-agent-skills/skills/publish-app/SKILL.md