New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Run App

by macro-inc in macro-inc/macro

Run the Macro app on Cursor Cloud and pick up edits. An agent skill from macro-inc/macro.

AGPL-3.0Auto-check passedFrontend & Design

Install Run App

skills CLI
$ npx skills add macro-inc/macro --skill run-app -a claude-code

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

GitHub CLI
$ gh skill install macro-inc/macro run-app --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/macro-inc/macro.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/run-app .claude/skills/run-app && 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
run-app
GitHub stars
4.6k
Token cost
~712 tokens
SKILL.md length
352 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Run the Macro app on Cursor Cloud and pick up edits. An agent skill from macro-inc/macro.

  • Asked to run the app
  • SKILL.md covers Start, After a Rust edit, After an apps/web edit and Show the change, plus 2 more sections
  • Calls bash, just and docker; needs DOPPLER_TOKEN
  • Open it in the browser

What it does

Run App is an agent skill from macro-inc/macro. Run the Macro app on Cursor Cloud and pick up edits. Use when asked to run the app, open it in the browser, test a frontend or backend change, hot reload, or before touching stack.sh, rebuild.sh, frontend.sh, or just stack.

Its SKILL.md is about 710 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 Frontend & Design. It works with Docker and Bash. The repository describes itself as: Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory. The licence is AGPL-3.0.

When your agent uses it

  • Asked to run the app
  • Open it in the browser
  • Test a frontend
  • Before touching stack.sh

Example prompts

  • “/run-app”

Requirements

  • Docker
  • A credential in DOPPLER_TOKEN

What it can do on your machine

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

    • bash
    • just
    • docker
    • nix
    • cargo
    • curl

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

  • Network

    No URLs in SKILL.md. Its commands use docker and curl, 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 these keys or tokens, usually read from environment variables:

    • DOPPLER_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Run App loads about 712 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 352 words of instructions outside code blocks.

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

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 macro-inc/macro at commit 49418e7, republished under its AGPL-3.0 licence (© macro-inc). 352 words, ~712 tokens.

Download SKILL.mdSave it as .claude/skills/run-app/SKILL.md (or your agent's skills folder).
name
run-app
description
Run the Macro app on Cursor Cloud and pick up edits. Use when asked to run the app, open it in the browser, test a frontend or backend change, hot reload, or before touching stack.sh, rebuild.sh, frontend.sh, or just stack.

Run the app

The app is http://localhost:3000/app. Open it in the VM browser. The user's laptop cannot reach these URLs.

GoalCommand
Startbash .cursor/stack.sh
After a Rust editbash .cursor/rebuild.sh
After an apps/web editsave the file

The .cursor scripts re-enter the pinned nix shell. For any other docker, just, bun, or doppler command, prefix with nix develop /workspace --command.

Do not run just run_local. That is the laptop TUI.

Start

bash
bash .cursor/stack.sh

Let the first run finish. It compiles whatever changed since the environment bake. Do not kill the Nix build, copy binaries out of /nix/store, or replace this with hand-rolled docker compose.

Log in with any email. The login API returns the code. Codes also land in Mailpit at http://localhost:8025.

After a Rust edit

bash
bash .cursor/rebuild.sh

Volumes stay. If the log says binaries are unchanged, the mounts were left alone.

Do not run just stack up or stack.sh --fresh to pick up an edit. up deletes the stack and recreates it. Use --fresh only when you mean to wipe.

cargo build and just build do not remount containers. rebuild.sh is the remount path.

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

After an apps/web edit

Save the file. Vite watches apps/web. If the page does not update, read ~/.cursor-cloud/frontend-dev.log for hmr update.

If http://localhost:3000/app stops responding, restart the dev server:

bash
bash .cursor/frontend.sh stop && bash .cursor/frontend.sh

Use the same restart after a frontend dependency or Vite config change.

Do not run just stack update --frontend. That builds a static bundle. This Cloud stack does not serve one. On a --no-frontend stack that flag then tells you to re-run just stack up, which wipes volumes.

Show the change

Bring the stack up, log in, and demonstrate the change in the UI. Unit tests and SQL probes are not a walkthrough.

If login fails

If the page says "unable to lookup identity providers", FusionAuth is in maintenance mode. docker ps shows macro-fusionauth-1 as unhealthy. curl localhost:9011/api/status returns 302.

bash
docker restart macro-fusionauth-1

Wait until the container is healthy.

If the page loads and API calls fail, the backend is down. Run just stack status --json, then bash .cursor/stack.sh.

Do not chase agent_harness_service restart loops when DOPPLER_TOKEN is absent. That loop is expected.

Status

bash
just stack status --json
docker compose -p macro logs -f <service>

© macro-inc, AGPL-3.0. 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 .claude/skills/run-app of macro-inc/macro.

Open the folder on GitHubat commit 49418e7

Compare with similar skills

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

Run App compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Run App this skillmacro-inc/macro4.6k—~712Automated safety check: PassAGPL-3.0
Skillshare DevcontainerJetBrains/skills3641 repos~2kAutomated safety check: PassNone
MCP Developmentcoollabsio/coolify63k1 repos~949Automated safety check: PassMIT
Agent Readiness Auditdocker/docs4.7k—~1.8kAutomated safety check: PassApache-2.0
Frontend Build Timing Auditopenops-cloud/openops1.1k—~2.3kAutomated safety check: PassCustom licence
Migrate Content Iadocker/docs4.7k—~5.1kAutomated safety check: PassApache-2.0

Similar skills

  • Skillshare Devcontainer

    JetBrains/skills

    Official

    Run CLI commands, tests, and debugging inside the skillshare devcontainer.

    364 GitHub starsUsed in 1 repo~2k tokens
    Frontend & DesignAuto-check passed

  • MCP Development

    coollabsio/coolify

    A skill your agent uses for Laravel MCP development. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 1 repo~949 tokens
    Frontend & DesignAuto-check passed

  • Agent Readiness Audit

    docker/docs

    Official

    Audit a documentation site for agent-friendliness: discovery, markdown delivery, crawlability, semantic structure, machine-readable surfaces, and content legibility.

    4.7k GitHub stars~1.8k tokensUpdated today
    Frontend & DesignAuto-check passed

  • Frontend Build Timing Audit

    openops-cloud/openops

    Detects and diagnoses chunk-evaluation timing bugs in the Vite/rolldown production build of react-ui (works-in-dev / broken-in-build i18n regressions, missing UI labels, module-scope t()…

    1.1k GitHub stars~2.3k tokensUpdated today
    Frontend & DesignAuto-check passed

  • Migrate Content Ia

    docker/docs

    Official

    Handle Hugo docs information-architecture moves: discover old vs new URLs, add front matter aliases (Phase 1), update in-repo links (Phase 2), interactive List 2 resolution and fragment validation…

    4.7k GitHub stars~5.1k tokensUpdated today
    Frontend & DesignAuto-check passed

  • Aspire

    microsoft/aspire.dev

    Official

    Orchestrates Aspire distributed applications using the Aspire CLI for running, debugging, and managing distributed apps.

    196 GitHub starsUsed in 4 repos~1.1k tokens
    DevOps & CloudAuto-check passed

More from macro-inc/macro

All 19 skills in this repo

  • Mintlify API

    macro-inc/macro

    Interact with the Mintlify REST API to manage deployments, trigger builds, and query documentation site metadata programmatically.

    4.6k GitHub starsUsed in 2 repos~333 tokens
    Auto-check passed

  • Add Tour

    macro-inc/macro

    Add or change an in-app feature tour (a view's guided flyover) in the web app.

    4.6k GitHub stars~1.8k tokensUpdated today
    Auto-check passed

  • Define Feature Flag

    macro-inc/macro

    Define a frontend feature flag with defineFlag and wire its readers.

    4.6k GitHub stars~780 tokensUpdated today
    Auto-check passed

  • Add SDK Endpoint

    macro-inc/macro

    Wrap a new backend endpoint in the TypeScript SDK (packages/sdk), or record it as skipped.

    4.6k GitHub stars~1k tokensUpdated today
    Auto-check: notes

  • Cloud Storage Hexagonal Architecture

    macro-inc/macro

    Enforce hexagonal architecture in the Rust backend. An agent skill from macro-inc/macro.

    4.6k GitHub stars~3k tokensUpdated today
    Auto-check passed

  • Collab Surface Core

    macro-inc/macro

    A skill your agent uses when adding collaborative markdown, notes, or descriptions to a feature with collab surfaces.

    4.6k GitHub stars~639 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Run App

What does Run App do?

Run the Macro app on Cursor Cloud and pick up edits. An agent skill from macro-inc/macro. Run App is an agent skill from macro-inc/macro. Run the Macro app on Cursor Cloud and pick up edits.

When should I use Run App?

Run App fits situations like: asked to run the app; open it in the browser; test a frontend; before touching stack.sh.

How do I install Run App in Claude Code?

Run `npx skills add macro-inc/macro --skill run-app -a claude-code`. Or copy the skill folder (.claude/skills/run-app in macro-inc/macro) into .claude/skills/run-app in your project. Claude Code loads it when a task matches its description.

How do I install Run App in Codex?

Run `npx skills add macro-inc/macro --skill run-app -a codex`. Or copy the skill folder (.claude/skills/run-app in macro-inc/macro) into .agents/skills/run-app in your project. Codex loads it when a task matches its description.

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

What does Run App need to run?

Going by SKILL.md and its folder, Run App needs the command-line tools its instructions call (bash, just, docker, nix, cargo and curl) and credentials named DOPPLER_TOKEN. Our summary lists: Docker; A credential in DOPPLER_TOKEN.

Does Run App access the network?

SKILL.md contains no URLs. Its commands use docker and curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

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

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

How many tokens does Run App use?

About 712 tokens (SKILL.md is roughly 2.8k 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 Run App?

Skills that share tags, products or a category with Run App: Skillshare Devcontainer (JetBrains/skills, 364 stars), MCP Development (coollabsio/coolify, 63k stars), Agent Readiness Audit (docker/docs, 4.7k stars) and Frontend Build Timing Audit (openops-cloud/openops, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run App?

macro-inc (a GitHub organization) maintains it in macro-inc/macro, which has 4,590 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 8, 2026.

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