publish-app

Prepares Twenty apps for npm and marketplace publication with listing metadata and assets.

Updated Aug 3, 2026
One-click install
npx skills add https://github.com/masoodtalha/twenty --skill publish-app-masoodtalha
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: publish-app
Source: https://github.com/masoodtalha/twenty/tree/main/packages/twenty-codex-plugin/skills/publish-app
Command: npx skills add https://github.com/masoodtalha/twenty --skill publish-app-masoodtalha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Publishing a Twenty app to npm or the marketplace requires correct package metadata, marketplace fields in defineApplication, README copy, logos, and screenshots, and missing any of these blocks or degrades the listing. ## Core Features & Use Cases - Publication Checklist: Inspects package.json, README.md, src/application-config.ts, and public/ to verify version bumps, the twenty-app keyword, and marketplace-facing fields like displayName, category, logoUrl, and screenshots. - Listing Asset Guidance: Ensures logos and screenshots live in public/ and contain no secrets, tokens, or confidential data before going live. - Build and Publish Workflow: Validates with yarn twenty dev:build and publishes via yarn twenty app:publish, optionally with a dist-tag. - Use Case: Before shipping a new version of your Twenty app, run this skill to review the marketplace listing, confirm metadata completeness, and publish the updated package. ## Quick Start Use the publish-app skill to review my Twenty app's marketplace metadata and prepare it for publication to npm.

Frequently Asked Questions about publish-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a Twenty app to npm?▼

Ensure package.json has a bumped version and the twenty-app keyword, then validate with yarn twenty dev:build and publish using yarn twenty app:publish. You can add a dist-tag with yarn twenty app:publish --tag <tag>.

What marketplace metadata does defineApplication require for a Twenty app listing?▼

Key fields include displayName, description, author, category, logoUrl, screenshots, aboutDescription, websiteUrl, termsUrl, emailSupport, and issueReportUrl. If aboutDescription is omitted, the marketplace falls back to the package README.md from npm.

Where should logos and screenshots for a Twenty app listing be stored?▼

Point logoUrl and screenshots at files in the app's public/ directory. Public assets must not contain secrets, private data, customer records, real tokens, or unreleased confidential material.

When should I not use the publish-app skill?▼

Do not use it to scaffold a new app (use create-app), change app entities (use develop-app), deploy to a specific Twenty server or manage remotes and logs (use manage-app), or query workspace records (use use-twenty-mcp).

How do I verify a Twenty app before marketplace publication?▼

Inspect package.json, README.md, src/application-config.ts, and public/ for completeness, then run yarn twenty dev:build to validate the build. The skill's checklist covers metadata, branding, and asset safety before publishing.