Agent skill

LobeHub Micro App Splitting Guide

by lobehub in lobehub/lobehub

Documents how LobeHub's standalone micro apps are hosted, built and routed differently on Cloud versus self-hosted Docker, so a change does not break one path while fixing the other.

Custom licenceAuto-check passedDevOps & Cloud

Install LobeHub Micro App Splitting Guide

skills CLI
$ npx skills add lobehub/lobehub --skill split-micro-app -a claude-code

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

GitHub CLI
$ gh skill install lobehub/lobehub split-micro-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/lobehub/lobehub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/split-micro-app .claude/skills/split-micro-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
split-micro-app
GitHub stars
83k
Token cost
~9.3k tokens
SKILL.md length
4,105 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
Custom licence

At a glance

Documents how LobeHub's standalone micro apps are hosted, built and routed differently on Cloud versus self-hosted Docker, so a change does not break one path while fixing the other.

  • Works in 5 steps: Splitting & Artifacts → Deploy: CDN Assets + Worker → SSR → …
  • Adding or fixing a standalone micro app's build for both Cloud and Docker
  • SKILL.md covers Hosting, Crossing from the main SPA, 1. Splitting & Artifacts and 1b. When the surface renders…, plus 7 more sections
  • Calls wrangler, bun and pnpm; reaches esm.sh and web-assets.lobehub.com; needs LOBEHUB_CLOUD_TOKEN and ACCESS_KEY_ID

What it does

The skill points at three real apps as living examples rather than duplicating their code: a workbench app that builds entirely from open-source CI, a share app that renders Cloud-only surfaces and builds from separate Cloud CI, and an auth app built as a static-site variant with no React in its worker bundle at all, serving prerendered documents across many locales and routes.

Its central rule is that one app has two serve paths that must never mix. On Cloud, a gateway routes to a worker doing server-side rendering, and the SPA build and CDN upload steps stay off. On OSS or self-hosted Docker, Next.js serves the client-rendered app from the same image, and a required-flag variable stops the template generator from skipping a missing build. A five-link Docker chain, from the root build script to a middleware rewrite, must be fully wired or the route is dead. The excerpt is cut off before further SEO and gateway details.

When your agent uses it

  • Adding or fixing a standalone micro app's build for both Cloud and Docker
  • Debugging a Docker deployment where a micro app's route is not served
  • Changing how a micro app's static or server-rendered output is generated

Example prompts

  • “Check whether the Docker build chain for the share app is missing a link.”
  • “Add a new static micro app that renders without any React in its worker bundle.”
  • “Explain why the SPA build is running on Cloud when it should only run in Docker.”

Requirements

  • A LobeHub monorepo checkout

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Splitting & Artifacts
  2. Deploy: CDN Assets + Worker
  3. SSR
  4. SEO
  5. Gateway Routing (torii, ../lobehub-gateway)

What it can do on your machine

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

    • wrangler
    • bun
    • pnpm
    • git

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • esm.sh
    • web-assets.lobehub.com
    • lobehub.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • LOBEHUB_CLOUD_TOKEN
    • ACCESS_KEY_ID
    • SECRET_ACCESS_KEY

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

Context cost

LobeHub Micro App Splitting Guide loads about 9.3k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 4,105 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 4,105 words (~9,314 tokens).

“Canonical living examples, both extracted 2026-08 — read the real files, this skill records the decisions and landmines, not copies of the code:”

— opening of SKILL.md by lobehub, Custom licence
name
split-micro-app
user-invocable
false

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/split-micro-app of lobehub/lobehub.

Open the folder on GitHubat commit 1863542

Compare with similar skills

LobeHub Micro App Splitting Guide 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.

LobeHub Micro App Splitting Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
LobeHub Micro App Splitting Guide this skilllobehub/lobehub83k—~9.3kAutomated safety check: PassCustom licence
GreptimeDB Dev Docker ImageGreptimeTeam/greptimedb6.7k—~4kAutomated safety check: NotesApache-2.0
Senior DevOps Toolkitmaslennikov-ig/claude-code-orchestrator-kit2596 repos~1.1kAutomated safety check: NotesCustom licence
LangBot Deployment Guidelangbot-app/LangBot18k—~1.2kAutomated safety check: NotesApache-2.0
Reflexo ReleaseMyriad-Dreamin/typst.ts1.2k—~1.5kAutomated safety check: PassApache-2.0
Classical Poem Silk VideoMr-funny/hbg-classical-poem-silk-video361—~1.6kAutomated safety check: PassMIT

Similar skills

  • GreptimeDB Dev Docker Image

    GreptimeTeam/greptimedb

    Packages a locally built GreptimeDB debug binary into a development-only Docker image for local-cluster testing, with an optional push to a dev registry.

    6.7k GitHub stars~4k tokensUpdated 2 days ago
    DevOps & CloudAuto-check: notes
  • Senior DevOps Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive DevOps skill for CI/CD, infrastructure automation, containerization, and cloud platforms (AWS, GCP, Azure). Includes pipeline setup…

    259 GitHub starsUsed in 6 repos~1.1k tokens
    DevOps & CloudAuto-check: notes
  • LangBot Deployment Guide

    langbot-app/LangBot

    Deploys and configures a LangBot instance with Docker Compose or Kubernetes, covering config.yaml, the Box sandbox runtime, the plugin runtime and the global API key.

    18k GitHub stars~1.2k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Reflexo Release

    Myriad-Dreamin/typst.ts

    Guide Reflexo/typst.ts release preparation and operator handoffs.

    1.2k GitHub stars~1.5k tokensUpdated 12 days ago
    DevOps & CloudAuto-check passed
  • Classical Poem Silk Video

    Mr-funny/hbg-classical-poem-silk-video

    Turn Chinese classical poems and ci into coherent vertical Chinese-art videos with poem-driven scene grouping, GPT ImageGen stills, Docker-only Gemini I2V, retained model-generated ambience, Gemini…

    361 GitHub stars~1.6k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • 1panel App Builder

    arch3rPro/1Panel-Appstore

    A skill your agent uses when packaging Docker deployments as 1Panel local app store apps, including GitHub projects, docker-compose.yml files, docker run commands, app metadata, version directories…

    213 GitHub stars~1.3k tokensUpdated today
    DevOps & CloudAuto-check passed

More from lobehub/lobehub

All 50 skills in this repo
  • Builds single-file interactive HTML prototypes rendered with the real LobeHub UI components and written as production-style React, so they can later be split into files.

    83k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Verifies a delivery end to end by driving the real product on a CLI, web, desktop or iOS Simulator surface, capturing evidence and publishing a round with the lh CLI.

    83k GitHub stars~9.7k tokensUpdated today
    Auto-check passed
  • Git Worktree Cleanup

    lobehub/lobehub

    Audits stale Git worktrees and branches with a bundled script, classifies each one, and deletes only after you approve the exact candidates.

    83k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Maintains LobeHub's model-backed alint rule set: writing rules, removing false positives against real code, deciding warn versus error and tracking token cost.

    83k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Guides building LobeHub builtin agent tools, from the manifest and execution runtime to executors, chat UI renders and registry wiring.

    83k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Explains how LobeHub client code fetches data through services, SWR store hooks and cache keys, and when to avoid useEffect fetching or duplicated state.

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

Questions about LobeHub Micro App Splitting Guide

What does LobeHub Micro App Splitting Guide do?

Documents how LobeHub's standalone micro apps are hosted, built and routed differently on Cloud versus self-hosted Docker, so a change does not break one path while fixing the other. The skill points at three real apps as living examples rather than duplicating their code: a workbench app that builds entirely from open-source CI, a share app that renders Cloud-only surfaces and builds from separate Cloud CI, and an auth app built as a static-site variant with no React in its worker bundle at all, serving prerendered documents across many locales and routes.

When should I use LobeHub Micro App Splitting Guide?

LobeHub Micro App Splitting Guide fits situations like: adding or fixing a standalone micro app's build for both Cloud and Docker; debugging a Docker deployment where a micro app's route is not served; changing how a micro app's static or server-rendered output is generated.

How do I install LobeHub Micro App Splitting Guide in Claude Code?

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

How do I install LobeHub Micro App Splitting Guide in Codex?

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

Can I use LobeHub Micro App Splitting Guide 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 lobehub/lobehub --skill split-micro-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/split-micro-app, .gemini/skills/split-micro-app, .github/skills/split-micro-app and .opencode/skills/split-micro-app in your project.

What does LobeHub Micro App Splitting Guide need to run?

Going by SKILL.md and its folder, LobeHub Micro App Splitting Guide needs the command-line tools its instructions call (wrangler, bun, pnpm and git) and credentials named LOBEHUB_CLOUD_TOKEN, ACCESS_KEY_ID and SECRET_ACCESS_KEY. Our summary lists: A LobeHub monorepo checkout.

Does LobeHub Micro App Splitting Guide access the network?

SKILL.md names 3 domains. In commands or code: esm.sh, web-assets.lobehub.com and lobehub.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is LobeHub Micro App Splitting Guide 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 LobeHub Micro App Splitting Guide use?

LobeHub Micro App Splitting Guide has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does LobeHub Micro App Splitting Guide use?

About 9.3k tokens (SKILL.md is roughly 37k 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 LobeHub Micro App Splitting Guide?

Skills that share tags, products or a category with LobeHub Micro App Splitting Guide: GreptimeDB Dev Docker Image (GreptimeTeam/greptimedb, 6.7k stars), Senior DevOps Toolkit (maslennikov-ig/claude-code-orchestrator-kit, 259 stars), LangBot Deployment Guide (langbot-app/LangBot, 18k stars) and Reflexo Release (Myriad-Dreamin/typst.ts, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains LobeHub Micro App Splitting Guide?

lobehub (a GitHub organization) maintains it in lobehub/lobehub, which has 83,023 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 7, 2026.

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