Agent skill

App Lifecycle

by rome-os in rome-os/rome

Install, reinstall, uninstall, enable, or disable Rome apps, including deployment after app edits and the first-party build and restart procedure.

MITAuto-check passedDevelopment

Install App Lifecycle

skills CLI
$ npx skills add rome-os/rome --skill app-lifecycle -a claude-code

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

GitHub CLI
$ gh skill install rome-os/rome app-lifecycle --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/rome-os/rome.git skills-src && mkdir -p .claude/skills && cp -r skills-src/rome_apps/system/src/skills/app-lifecycle .claude/skills/app-lifecycle && 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
app-lifecycle
GitHub stars
737
Token cost
~869 tokens
SKILL.md length
439 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Install, reinstall, uninstall, enable, or disable Rome apps, including deployment after app edits and the first-party build and restart procedure.

  • Works in 3 steps: Call system:app_management with the app… → Pass the same source object on every… → After the call succeeds, validate the…
  • Development work in your project
  • SKILL.md covers Install or reinstall a…, First-party apps, Uninstall a custom app and Enable or disable an app, plus 1 more section
  • Calls pnpm

What it does

App Lifecycle is an agent skill from rome-os/rome. Install, reinstall, uninstall, enable, or disable Rome apps, including deployment after app edits and the first-party build and restart procedure.

Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. The repository describes itself as: A compounding agent OS for recursive agents. Also an open source alternative to Grok Bot and Meta's Muse. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/app-lifecycle”

Workflow steps

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

  1. Call system:app_management with the app repository as the source
  2. Pass the same source object on every reinstall after edits. The daemon rebuilds and repacks each time.
  3. After the call succeeds, validate the app immediately. Do not poll deployment files or the active symlink.

What it can do on your machine

Read from SKILL.md and the folder at commit f187f45. 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:

    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    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

App Lifecycle loads about 869 tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 439 words of instructions outside code blocks.

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

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

The full file from rome-os/rome at commit f187f45, republished under its MIT licence (© rome-os). 439 words, ~869 tokens.

Download SKILL.mdSave it as .claude/skills/app-lifecycle/SKILL.md (or your agent's skills folder).
name
app-lifecycle
description
Install, reinstall, uninstall, enable, or disable Rome apps, including deployment after app edits and the first-party build and restart procedure.

App lifecycle

Read system:app_management with read_action before calling it through execute_action. For new app scaffolding, also read coding:app_creation.

Install or reinstall a standalone app

Use this path for a custom app under ~/.rome/<profile>/projects/apps/<id>/ or another standalone checkout outside the Rome monorepo.

  1. Call system:app_management with the app repository as the source:

    json
    {
      "op": "install",
      "source": { "mode": "source", "path": "<absolute app repo path>" }
    }
  2. Pass the same source object on every reinstall after edits. The daemon rebuilds and repacks each time.

  3. After the call succeeds, validate the app immediately. Do not poll deployment files or the active symlink.

The daemon derives the app ID from app.yaml, runs the workspace's build, and packs it into <repo>/.rome/artifact. It installs the bundle and awaits the runtime reload before returning. The guardian can also use Install/Upgrade on the Apps dashboard.

The bundle source mode accepts an already-packed artifact, not a raw source workspace. A raw workspace fails with "not a packed artifact".

For a Rome App Store install, discover the listing with system:app_store_search and follow the appstore source schema in system:app_management.

First-party apps

First-party apps under the monorepo's rome_apps/<appId>/ ship with Rome. The action cannot install or uninstall them. Only enable/disable applies through the action.

  1. After editing a first-party app, run pnpm build:apps in the Rome monorepo to build and pack the artifacts.
  2. Restart Rome to load the changes. Boot installs the packed artifacts and reinstalls an app when its artifact hash changes.
  3. Validate the app after startup completes.

Do not pass a monorepo member as a source install. The daemon refuses to run pnpm in it. Do not bypass that protection by passing a raw source workspace as a bundle.

Show full SKILL.md (170 more words)Show less

Uninstall a custom app

Call system:app_management with:

json
{ "op": "uninstall", "appId": "<app id>", "purge": false }

The default, purge: false, removes the lockfile entry and installed bundle but keeps the app's database tables and data. Reinstalling restores access to that state.

Use purge: true only when the guardian requests deletion of the app's data as well. It drops the app's tables and data directory.

Enable or disable an app

Call system:app_management with:

json
{ "op": "set_enabled", "appId": "<app id>", "enabled": false }

Use enabled: true to enable the app. This does not reinstall it. The manager updates the lockfile and awaits the catalog subscribers before returning.

Runtime guarantees

  • AppManager is the sole writer of ~/.rome/<profile>/apps.lock.json. Each lifecycle operation runs to a terminal state.
  • Install activates a content-addressed bundle atomically, records its installedHash, and awaits the catalog subscriber chain that reloads runtime artifacts.
  • The pnpm app:* CLI sends HTTP requests to the running main process. It uses the same manager, not a separate lifecycle path.
  • At startup, Rome probes each installed lockfile entry against its active bundle. It marks non-system failures broken and replays catalog events to load the runtime.

© rome-os, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in rome_apps/system/src/skills/app-lifecycle of rome-os/rome.

Open the folder on GitHubat commit f187f45

Compare with similar skills

App Lifecycle 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.

App Lifecycle compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
App Lifecycle this skillrome-os/rome737—~869Automated safety check: PassMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Simple Englishmoeru-ai/airi50k2 repos~4.6kAutomated safety check: PassMIT
Mole CLI Release Flowtw93/Mole70k—~2.6kAutomated safety check: PassGPL-3.0
Babysit PR To Pass CIsgl-project/sglang37k2 repos~3kAutomated safety check: PassApache-2.0

Similar skills

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • Runbook for assessing and executing a Mole CLI release: distribution channels, pre-flight checks, capital-V tags, build artifacts and the handoff to curated release notes.

    70k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Babysit PR To Pass CI

    sgl-project/sglang

    Start and persistently pursue a goal to babysit an SGLang pull request until selected GitHub Actions workflows pass on the latest PR head.

    37k GitHub starsUsed in 2 repos~3k tokens
    DevelopmentAuto-check passed
  • Load Ansible project development guidelines, testing conventions, PR review processes, and code structure reference into context

    71k GitHub stars~427 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from rome-os/rome

All 18 skills in this repo
  • Color Audit

    rome-os/rome

    Audit a design system's color palette against measurable color-science disciplines — WCAG/APCA contrast of declared token pairs, perceptual (OKLCH) ramp uniformity, color-blindness safety of…

    737 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Audit the subordinate copy in a UI — section descriptions, field helper text, hints, card subtitles, empty-state body copy, tooltip bodies — against the secondary-text ruleset, and emit a per-string…

    737 GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • UX Semantics Audit

    rome-os/rome

    Audit an existing UI/UX design (React/JSX/TSX components, HTML, or generated app code) against a tiered ruleset of verifiable UX principles, and produce structured, evidence-cited findings that a…

    737 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Add a new Rome-managed OAuth integration for a third-party service so a user can delegate access by clicking Connect, and Rome can act on the service with the delegated token (the GitHub/Slack model…

    737 GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Composio CLI

    rome-os/rome

    Help users operate the published Composio CLI to find the right tool, connect accounts, inspect schemas, execute tools, subscribe to trigger events with composio listen, script workflows with…

    737 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • File Issue

    rome-os/rome

    File one GitHub issue from a description the user gives — classify it as a bug report, feature request, or task spec, gather what the body needs from the tracker and the code, ask the user only for…

    737 GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Questions about App Lifecycle

What does App Lifecycle do?

Install, reinstall, uninstall, enable, or disable Rome apps, including deployment after app edits and the first-party build and restart procedure. App Lifecycle is an agent skill from rome-os/rome. Install, reinstall, uninstall, enable, or disable Rome apps, including deployment after app edits and the first-party build and restart procedure.

When should I use App Lifecycle?

App Lifecycle fits situations like: development work in your project.

How do I install App Lifecycle in Claude Code?

Run `npx skills add rome-os/rome --skill app-lifecycle -a claude-code`. Or copy the skill folder (rome_apps/system/src/skills/app-lifecycle in rome-os/rome) into .claude/skills/app-lifecycle in your project. Claude Code loads it when a task matches its description.

How do I install App Lifecycle in Codex?

Run `npx skills add rome-os/rome --skill app-lifecycle -a codex`. Or copy the skill folder (rome_apps/system/src/skills/app-lifecycle in rome-os/rome) into .agents/skills/app-lifecycle in your project. Codex loads it when a task matches its description.

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

What does App Lifecycle need to run?

Going by SKILL.md and its folder, App Lifecycle needs the command-line tools its instructions call (pnpm).

Does App Lifecycle access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is App Lifecycle 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 App Lifecycle use?

App Lifecycle is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does App Lifecycle use?

About 869 tokens (SKILL.md is roughly 3.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 App Lifecycle?

Skills that share tags, products or a category with App Lifecycle: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Code Design Rationale Investigator (cursor/plugins, 10k stars), Simple English (moeru-ai/airi, 50k stars) and Mole CLI Release Flow (tw93/Mole, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains App Lifecycle?

rome-os (a GitHub organization) maintains it in rome-os/rome, which has 737 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 9, 2026.

Source: rome-os/rome on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.