Agent skill

Service App Creator

by Peiiii in Peiiii/nextclaw

Create or update the Service component of a NextClaw Mini App, choosing between Portable Rust/WASI Components and native-process MCP services.

MITAuto-check passed

Install Service App Creator

skills CLI
$ npx skills add Peiiii/nextclaw --skill service-app-creator -a claude-code

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

GitHub CLI
$ gh skill install Peiiii/nextclaw service-app-creator --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/Peiiii/nextclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/nextclaw-core/src/features/agent/shared/skills/service-app-creator .claude/skills/service-app-creator && 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
service-app-creator
GitHub stars
260
Token cost
~1k tokens
SKILL.md length
274 words
Files
3 (incl. references)
Skills in repo
70
Repo updated
First seen
Licence
MIT

At a glance

Create or update the Service component of a NextClaw Mini App, choosing between Portable Rust/WASI Components and native-process MCP services.

  • Explicitly asks for Service Actions
  • SKILL.md covers 先选择运行形态, Rust 工具链边界, 两种交付边界 and 两种运行时共享的 Service Action 合同, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Portable components

What it does

Service App Creator is an agent skill from Peiiii/nextclaw. Create or update the Service component of a NextClaw Mini App, choosing between Portable Rust/WASI Components and native-process MCP services. Use after nextclaw-app-creator selects a Service-backed app, or when the user explicitly asks for Service Actions, portable components, local files, external APIs, commands, Resident events, or capability Providers.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/native-process-service-app.md` and `references/portable-wasi-service-app.md`).

It works with WebAssembly, Rust and Model Context Protocol. The repository describes itself as: A human-centered long-term AI partner—not a task-centered assistant. The licence is MIT.

When your agent uses it

  • Explicitly asks for Service Actions
  • Portable components
  • Resident events
  • Capability Providers

Example prompts

  • “/service-app-creator”

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

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

  • Network

    No URLs in SKILL.md.

    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

Service App Creator loads about 1k tokens when it runs, and up to ~3.7k if it reads all its reference files. Until then it costs about 95 tokens; SKILL.md has 274 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~95
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.7k

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 Peiiii/nextclaw at commit 2c9e06e, republished under its MIT licence (© Peiiii). 274 words, ~1,047 tokens.

Download SKILL.mdSave it as .claude/skills/service-app-creator/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
service-app-creator
description
Create or update the Service component of a NextClaw Mini App, choosing between Portable Rust/WASI Components and native-process MCP services. Use after nextclaw-app-creator selects a Service-backed app, or when the user explicitly asks for Service Actions, portable components, local files, external APIs, commands, Resident events, or capability Providers.
description_zh
创建或修改 NextClaw Mini App 的 Service 组件,并在 Portable Rust/WASI Component 与 native-process MCP 服务之间选择。适用于 nextclaw-app-creator 判断应用需要 Service 后,或用户明确要求 Service…

NextClaw Service App Creator

本 skill 是 Service 运行形态、service-app.json、Service Action、risk 和验证入口的唯一 owner。若用户表达的是“做一个完整 NextClaw 小应用”,先由 nextclaw-app-creator 判断是否还需要 Panel;本 skill 不拥有 Panel UI 或 bridge 字段。

不要再把所有 schema v2 Service 都等同于 command/args + MCP stdio + native-process。当前 NextClaw 同时支持:

  • Portable WASI Service:protocol: "wasi-component",由 NextClaw 随产品提供的 runner 执行 Rust/WASI Component;
  • native-process Service:protocol: "mcp",由宿主启动 Node、Python、系统命令或其它本地进程。

先选择运行形态

优先 Portable WASI

满足以下条件时选择 Portable:

  • Service 可以表达为明确的 Action,或确实需要 Resident / Provider 生命周期;
  • KV、SQLite、受授权文件、允许域名、密钥槽位、Provider、model slot 或 agent slot 能覆盖需求;
  • 希望同一份 .napp 在支持的平台运行,且不把用户完整宿主权限交给 Guest;
  • 应用面向分发、安装或长期维护,安全能力边界比快速脚本更重要。

选择后必须读取 references/portable-wasi-service-app.md,不能凭本入口猜 WIT、manifest、生命周期或构建命令。

仅在真实需要时选择 native-process

以下情况选择 native-process:

  • 必须直接运行 Node/Python/系统程序、平台 SDK、驱动、socket 或外部守护进程;
  • 依赖无法由当前 Portable Runtime 能力合同承接;
  • 用户明确只要一个快速、本机、无需 Rust 工具链的 Service helper,并接受宿主用户权限边界;
  • 正在维护现有 workspace service-apps/<id>/ MCP Service。

选择后必须读取 references/native-process-service-app.md。不能仅因开发机暂时缺少 Rust,就把需要可移植或受限能力边界的应用静默降级为宿主进程。

Rust 工具链边界

必须准确区分创作者与最终用户:

  • 在本机创建并构建 Rust/WASI Guest,需要 cargo、rustc 和 wasm32-wasip2;先运行 nextclaw app doctor --profile wasi。
  • 安装和运行已经构建好的 Portable .napp 不要求最终用户安装 Rust、Cargo、Wasmtime 或系统 Node。WebAssembly Component 已在包内,runner 由 NextClaw 提供。
  • 纯 Panel App 和 native-process Service 不因 Portable Runtime 的存在而需要 Rust。

如果用户目标明确要求 Portable,但工具链检查失败,保留已创建的源码和失败证据,说明缺少的开发依赖;未经授权不要自动安装 Rust,也不要把未构建源码说成可交付应用。

两种交付边界

完整或可发布的 schema v2 Mini App

Service 应位于应用包根:

text
my-app/
├── manifest.json
├── marketplace.json
├── panels/<panel-id>.panel/              # 可选
├── service-components/<service-id>/
│   └── service-app.json
└── ...runtime-specific sources and artifacts

根 manifest.json.components 是组件归属的事实源。Portable 使用 runtime.profile: wasi;native-process 使用 runtime.profile: native-process。适用的 build/check/test/dev/call/pack/validate-publish 命令都从包根运行。

明确只做本机 loose Service

仅 native-process MCP Service 可以继续落在 NextClaw workspace 的 service-apps/<app-id>/。默认 workspace 是 ~/.nextclaw/workspace,但能读取配置时以 agents.defaults.workspace 为准。不要把 loose workspace 目录说成完整可发布包。

两种运行时共享的 Service Action 合同

  • action id 统一为 <service-id>.<action-name>;service id 不包含点号。
  • service-app.json.actions 静态声明每个 action;Panel、Agent 授权和列表都以它为事实源。
  • risk 只使用 read、write、external、dangerous;不确定时用 dangerous。
  • 每个 action 使用收窄的 inputSchema、准确标题与描述;不要做无类型万能 RPC。
  • Panel 在 panel-app.json.actions 声明完整 allowlist,并继续通过 window.nextclaw.serviceActions.invoke() 调用;Panel 不需要知道后端是 WASI 还是 native-process。
  • AI 分析默认走 NextClaw Agent/App Client。只有外部模型服务或 Portable manifest 中明确声明的 model/agent slot 才属于 Service 依赖。
  • 不保存 token、宿主私有路径或用户数据到 manifest、日志、验证记录或 action 错误中。

统一验收门

完整 schema v2 包从包根运行:

bash
nextclaw app check <app-dir> --json
nextclaw app dev <app-dir> --json
nextclaw app call <app-dir> <action-name> --input '{}' --json

Portable 分支还必须运行 build 和 test;native-process 分支必须验证 MCP tools/list 与 manifest actions 对齐。一个包有多个 Service 时,为 dev/call 提供 --component <service-id>。

调用带写入、外部访问或危险副作用的 action 前需要用户授权;默认只抽测无副作用的 read action 或专用 smoke fixture。修改普通组件后不要求重启 NextClaw 宿主。live native-process runtime 需要刷新时只运行 nextclaw app restart <service-id> --json,不要重启整个产品。

完成后返回使用了哪种 runtime、为什么、创作者工具链状态、实际验证范围,以及最终用户是否需要额外运行时依赖。

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

Files

SKILL.md and 2 other files (references) in packages/nextclaw-core/src/features/agent/shared/skills/service-app-creator of Peiiii/nextclaw.

  • SKILL.md
  • references/native-process-service-app.md
  • references/portable-wasi-service-app.md

Open the folder on GitHubat commit 2c9e06e

Compare with similar skills

Service App Creator 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.

Service App Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Service App Creator this skillPeiiii/nextclaw260—~1kAutomated safety check: PassMIT
Webapp Buildersidequery/sidemantic129—~5.5kAutomated safety check: PassAGPL-3.0
Harnessskillsynchq/txcript155—~4.2kAutomated safety check: PassApache-2.0
Releaseskillsynchq/txcript155—~775Automated safety check: PassApache-2.0
Corpus Checkskillsynchq/txcript155—~827Automated safety check: PassApache-2.0
Build And Profilingpikax/verter113—~4.3kAutomated safety check: PassMIT

Similar skills

  • Webapp Builder

    sidequery/sidemantic

    Build interactive analytics webapps, demos, dashboards, or embedded app surfaces from Sidemantic semantic models using copyable component primitives and deterministic query inspection.

    129 GitHub stars~5.5k tokensUpdated 3 days ago
    DatabasesAuto-check passed
  • Harness

    skillsynchq/txcript

    Integrate a new AI coding-agent harness into txcript — native Body types, Codec, TextCodec, Store, wiring, and tests.

    155 GitHub stars~4.2k tokensUpdated 12 days ago
    Auto-check passed
  • Release

    skillsynchq/txcript

    Cut a txcript release — dispatch the prepare-release workflow, approve the plan, watch the tag publish to crates.io, npm, and GitHub Releases, and verify.

    155 GitHub stars~775 tokensUpdated 12 days ago
    DevelopmentAuto-check passed
  • Corpus Check

    skillsynchq/txcript

    Validate a txcript parsing, discovery, or search change against every real agent session on this machine — old-vs-new parity, no panics, and release-build timings.

    155 GitHub stars~827 tokensUpdated 12 days ago
    MobileAuto-check passed
  • Build dependency chains, rebuild sequences, profiling with MCP, and Analysis MCP server setup for Verter

    113 GitHub stars~4.3k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • A skill your agent uses when creating Zed extensions with custom slash commands, language support, themes, or MCP servers - provides Rust/WASM extension structure, slash command API…

    122 GitHub stars~3.1k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check: notes

More from Peiiii/nextclaw

All 70 skills in this repo
  • Nextclaw Skin Studio

    Peiiii/nextclaw

    A skill your agent uses when a user wants to browse, apply, inspect, create, refine, switch, or remove a NextClaw skin; wants a personal skin with arbitrary CSS, JavaScript, images, SVG, DOM…

    260 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when a development task needs visible phase tracing, task-level or phase-level Token measurement, model/effort comparison, or a deterministic usage report or local dashboard…

    260 GitHub stars~802 tokensUpdated yesterday
    Auto-check passed
  • 当 NextClaw 产品更新后需要生成、替换、挑毛病或检查官网、GitHub README、用户文档或社交传播中的真实截图、AI 宣传视觉、整页 HTML 宣传预览、社区二维码等对外视觉资产时使用;也用于“更新截图”“重新截一批图”“做宣传页”“生成 campaign 页面”“视觉审稿”“五星挑刺法”或发布前检查视觉资产。普通站点布局开发或只写文章不触发。

    260 GitHub stars~801 tokensUpdated yesterday
    Auto-check passed
  • UI UX Pro Max

    Peiiii/nextclaw

    A skill your agent uses when the user wants professional UI/UX design guidance, design-system generation, UX review, or stack-specific frontend guidance through a bundled local UI/UX Pro Max dataset…

    260 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Impeccable

    Peiiii/nextclaw

    A skill your agent uses when the user wants distinctive, production-grade frontend design, anti-generic AI aesthetics, UX critique, technical UI audits, or final polish through bundled Impeccable…

    260 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Curate NextClaw skill resources, including OpenClaw and community sources.

    260 GitHub stars~479 tokensUpdated yesterday
    Auto-check passed

Questions about Service App Creator

What does Service App Creator do?

Create or update the Service component of a NextClaw Mini App, choosing between Portable Rust/WASI Components and native-process MCP services. Service App Creator is an agent skill from Peiiii/nextclaw. Create or update the Service component of a NextClaw Mini App, choosing between Portable Rust/WASI Components and native-process MCP services.

When should I use Service App Creator?

Service App Creator fits situations like: explicitly asks for Service Actions; portable components; resident events; capability Providers.

How do I install Service App Creator in Claude Code?

Run `npx skills add Peiiii/nextclaw --skill service-app-creator -a claude-code`. Or copy the skill folder (packages/nextclaw-core/src/features/agent/shared/skills/service-app-creator in Peiiii/nextclaw) into .claude/skills/service-app-creator in your project. Claude Code loads it when a task matches its description.

How do I install Service App Creator in Codex?

Run `npx skills add Peiiii/nextclaw --skill service-app-creator -a codex`. Or copy the skill folder (packages/nextclaw-core/src/features/agent/shared/skills/service-app-creator in Peiiii/nextclaw) into .agents/skills/service-app-creator in your project. Codex loads it when a task matches its description.

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

What does Service App Creator need to run?

SKILL.md names no scripts, command-line tools or credentials: Service App Creator is instructions for the agent only.

Does Service App Creator 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 Service App Creator 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 Service App Creator use?

Service App Creator 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 Service App Creator use?

About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.7k tokens, read only when the agent opens those files.

What are the alternatives to Service App Creator?

Skills that share tags, products or a category with Service App Creator: Webapp Builder (sidequery/sidemantic, 129 stars), Harness (skillsynchq/txcript, 155 stars), Release (skillsynchq/txcript, 155 stars) and Corpus Check (skillsynchq/txcript, 155 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Service App Creator?

Peiiii (a GitHub user) maintains it in Peiiii/nextclaw, which has 260 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on October 10, 2026.

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