CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

manage-app

Use when the user wants to manage or troubleshoot tooling, remotes, sync, build, deploy, logs, CI/CD, or operational workflows for an existing Twenty app.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, command-dense operations guide: nearly all guidance is executable as written, destructive actions carry confirmation gates and validation checks, and deep details are delegated to clearly described one-level-deep reference files. Weaknesses are minor — a duplicated exclusion list between When To Use and Boundaries, no post-deploy verification step, and slight overlap between the inline sections and the delegated cli-and-sync.md reference.

DimensionReasoningScore

Conciseness

Mostly lean, command-first guidance with no explanations of concepts Claude already knows ('Do not use bare `twenty app dev` (watch mode). Run `twenty app apply` each time changes need to be synced.'), matching 'efficient; minor instances of over-explanation that could be trimmed'. It is not 5 because the exclusion list in When To Use ('Do not use this skill to scaffold (use `create-app`)...') is repeated nearly verbatim in the Boundaries section, and the Operating Rules delegation sentence re-enumerates the same topics that get dedicated inline sections.

4 / 5

Actionability

Nearly every section provides copy-paste-ready commands — `printf '%s' "$TWENTY_API_KEY" | twenty auth login --with-token --url https://your-twenty-server.com --name production`, `docker start twenty-app-dev-test`, `TWENTY_API_URL=http://localhost:2021 yarn test`, `twenty app exec --name <function-name> --payload '{"key":"value"}'` — with clearly marked placeholders covering the common operational cases, matching 'fully executable; copy-paste ready code or commands'.

5 / 5

Workflow Clarity

Sequences are clear with most checkpoints present: a pre-flight check ('First confirm the current directory is a Twenty app'), explicit confirmation gates for destructive actions ('Ask for explicit confirmation before running them when the target is production or user data could be affected'), a pre-deploy semver check, and a retry loop ('If authentication fails, re-add or switch the remote before retrying'), plus layered troubleshooting with diagnostic commands (`twenty app apply --json`). It is not 5 because there is no post-deploy/post-install verification step and CI/CD failures get only checks rather than an explicit validate-fix-retry loop; it is not 3 because the destructive operations (deploy, uninstall, production sync) do carry validation and confirmation, so the destructive-operation cap does not apply.

4 / 5

Progressive Disclosure

Clear section headers and well-signaled references that state what each file covers ('For command details, remotes, validation command semantics, sync modes, troubleshooting, build, deploy, logs, exec, and CI/CD, read `../../references/manage-app/cli-and-sync.md`'), matching 'good structure; most content is appropriately placed; references mostly clear'. It is not 5 because the body inlines fairly substantial per-topic detail whose scope it simultaneously delegates to cli-and-sync.md (mild ambiguity about where authoritative detail lives), the references are plain paths rather than links, and no bundle files (references/, scripts/, assets/) exist in the skill folder to verify the referenced paths; it is not 3 because the references that are present are clearly signaled, not buried.

4 / 5

Total

17

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A concise, well-scoped description with an explicit 'Use when' clause and good natural trigger coverage for operating an existing Twenty app. Its main limitation is that the 'what' is folded into the trigger clause using two generic verbs (manage/troubleshoot) rather than stated as distinct concrete actions, and a few natural triggers the body covers (publish, tests, uninstall) are missing.

Suggestions

State the skill's actions separately from the trigger, e.g. 'Manages remotes, syncs app changes with bounded apply, builds and publishes releases, tails function logs, and runs logic functions manually. Use when the user wants to operate or troubleshoot an existing Twenty app.'

Add the missing natural trigger terms users would say — 'publish', 'install/uninstall', 'run tests', 'staging' — to broaden keyword coverage toward the top anchor.

Sharpen distinctiveness by contrasting with sibling skills in one clause, e.g. '...operational workflows for an existing Twenty app (not scaffolding, app code changes, or marketplace listing).' to reduce overlap with develop-app and publish-app.

DimensionReasoningScore

Specificity

Names the domain ('an existing Twenty app') and enumerates concrete operational areas — 'manage or troubleshoot tooling, remotes, sync, build, deploy, logs, CI/CD' — matching 'lists several specific actions; minor gaps in coverage'. It is not 5 because the only verbs are the generic 'manage'/'troubleshoot' applied to a list of nouns rather than multiple distinct concrete actions, and not 3 because coverage spans eight named areas, well beyond '1-2 concrete actions'.

4 / 5

Completeness

The explicit 'Use when the user wants to...' clause answers 'when' with concrete triggers, and the 'what' (managing/troubleshooting Twenty app operations) is embedded in that same clause, matching 'has both what and when; when could be more explicit or specific'. It is not 5 because the skill's own actions are never stated separately from the trigger condition, and not 3 because the when-guidance is fully explicit rather than 'weakly implied'.

4 / 5

Trigger Term Quality

Natural terms a user would actually say are present — 'sync', 'deploy', 'logs', 'CI/CD', 'remotes', 'troubleshoot' — matching 'good keyword coverage; a few natural terms missing'. It is not 5 because common phrasings the skill body itself lists as triggers ('publish', 'install/uninstall', 'run tests', 'staging') are absent from the description, and not 3 because the included terms go well beyond 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

Scoped to 'an existing Twenty app' with operations-specific triggers (sync, deploy, logs, remotes, CI/CD), giving a clear niche with 'minor overlap risk with closely related skills' — build troubleshooting could belong to develop-app and deploy/publish to publish-app. It is not 5 because 'tooling' and 'operational workflows' remain somewhat broad, and not 3 because the existing-app + Twenty scoping is much tighter than 'somewhat specific'.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

twentyhq/twenty

Path

packages/twenty-agent-skills/skills/manage-app/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.