Skip to content
cccskills
FreePublished on GitHub

publish-app

Prepare an existing Twenty app for npm or marketplace publication by reviewing its README, listing details, package metadata, logos, and screenshots. The workflow includes checking publication settings, validating the build, and running the publishing command.

OriginalShow the original 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.

See how to install

Good for

  • Prepare a Twenty app marketplace listing
  • Write or review README and About text
  • Check logos, screenshots, and public assets
  • Publish a new app version to npm

Files included (2)

  • SKILL.md2.9 KB
  • agents/openai.yaml221 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

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:

  • Inspect package.json, README.md, src/application-config.ts, and public/.
  • For npm marketplace publication, ensure package.json has a valid bumped version and the twenty-app keyword.
  • In defineApplication(), verify marketplace-facing fields such as displayName, description, author, category, logo, galleryImages, aboutDescription, websiteUrl, termsUrl, emailSupport, and issueReportUrl.
  • Keep logo and galleryImages pointed at files in public/. Public assets must not contain secrets, private data, customer records, real tokens, or unreleased confidential material.
  • Remember that if aboutDescription is omitted, the marketplace uses the package README.md from npm for the About content. The About tab renders markdown text only: images and raw HTML are not rendered.
  • Validate with yarn twenty dev:build; publish with yarn twenty app:publish or yarn twenty app:publish --tag <tag>.

Boundaries

Use $manage-app for remotes, deploys to a specific server, logs, troubleshooting, and CI/CD operations.

Use $develop-app when the app entities themselves need to change before the listing can be accurate.

Docs

If the needed publishing detail is unclear, search the official Twenty docs at https://docs.twenty.com before guessing. When a Twenty docs MCP server is configured (https://docs.twenty.com/mcp), prefer searching through it. That server is an optional enhancement, not a requirement for this skill.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

create-app

FreeSummary

Create a new app that extends a running Twenty instance. Guide project naming and instance selection, then use the scaffolder to install dependencies, authenticate, initialize Git, and complete the initial sync and installation.

  • Start a new Twenty app project
  • Scaffold a CRM extension or integration
  • Create an app connected to an existing Twenty instance
twentyhq/twenty59.5KUpdated Oct 21, 2026

develop-app

FreeSummary

Extend an existing Twenty app with data fields, layouts, custom screens, automated logic, workflows, and permissions. The skill guides code organization, entity creation, type checking, linting, and syncing definitions to the active remote.

  • Add custom fields and objects to an existing Twenty app
  • Build custom screens and standalone pages
  • Run logic when records are created
twentyhq/twenty59.5KUpdated Oct 21, 2026

manage-app

FreeSummary

Operate an existing Twenty app by syncing changes, managing server connections, building and deploying releases, and inspecting function logs. It also guides troubleshooting and CI/CD, the workflows used to automate testing and deployment.

  • Sync app changes to a Twenty server
  • Prepare and deploy an app update
  • Investigate failed builds or deployments
twentyhq/twenty59.5KUpdated Oct 21, 2026

qa-scout

FreeSummary

Check a Twenty pull request through real browser scenarios derived from its changes. Verify database effects and server logs alongside visible results, then produce screenshots, a structured verdict, and a report of any failures or uncertainty.

  • Validate user flows before or after merging a Twenty pull request
  • Check database writes and timeline activity after saving records
  • Investigate backend errors hidden behind a successful screen
twentyhq/twenty59.5KUpdated Oct 21, 2026

Implement validation and migration action builders for syncable entities, data types handled by Twenty's synchronization system. This skill covers required fields, uniqueness, reference checks, and orchestration wiring, with validators that return errors without throwing exceptions or changing data.

  • Add required-field and duplicate checks
  • Validate references to parent entities
  • Build create, update, and delete migration actions
twentyhq/twenty59.5KUpdated Oct 21, 2026

Implement caching and data conversion for syncable entities in Twenty's server code. Build lookup maps, convert stored records and inputs into flat representations, and resolve references to universal identifiers for later validation and processing.

  • Build a cache service for a new syncable entity
  • Convert stored entities into flat data
  • Transform creation and update inputs
twentyhq/twenty59.5KUpdated Oct 21, 2026

See all skills by twentyhq

Report a problem with this skill