Agent skill

Nextclaw Narp Stdio Runtime Integration

by Peiiii in Peiiii/nextclaw

当把 Codex、Claude Code、Hermes 或其他外部 agent runtime 通过 NARP stdio 接入 NextClaw,或触达 narp-stdio entry、launcher、agent-side wrapper 和旧 runtime 插件迁移时使用。

MITAuto-check passed

Install Nextclaw Narp Stdio Runtime Integration

skills CLI
$ npx skills add Peiiii/nextclaw --skill nextclaw-narp-stdio-runtime-integration -a claude-code

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

GitHub CLI
$ gh skill install Peiiii/nextclaw nextclaw-narp-stdio-runtime-integration --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/.agents/wiki/skills/architecture/nextclaw-narp-stdio-runtime-integration .claude/skills/nextclaw-narp-stdio-runtime-integration && 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
nextclaw-narp-stdio-runtime-integration
GitHub stars
260
Token cost
~761 tokens
SKILL.md length
277 words
Files
1
Skills in repo
70
Repo updated
First seen
Licence
MIT

At a glance

当把 Codex、Claude Code、Hermes 或其他外部 agent runtime 通过 NARP stdio 接入 NextClaw,或触达 narp-stdio entry、launcher、agent-side wrapper 和旧 runtime 插件迁移时使用。

  • Works in 5 steps: 冻结不得触达的通用 client、旧 SDK 和核心边界。 → 复用通用 agent-side wrapper,把… → 为具体 runtime 提供薄 wrapper package 与 -narp… → …
  • SKILL.md covers 架构合同, 实现顺序, 实现前核对 and 能力验收, plus 3 more sections
  • Calls rg and claude

What it does

Nextclaw Narp Stdio Runtime Integration is an agent skill from Peiiii/nextclaw. 当把 Codex、Claude Code、Hermes 或其他外部 agent runtime 通过 NARP stdio 接入 NextClaw,或触达 narp-stdio entry、launcher、agent-side wrapper 和旧 runtime 插件迁移时使用。

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

The repository describes itself as: A human-centered long-term AI partner—not a task-centered assistant. The licence is MIT.

Example prompts

  • “/nextclaw-narp-stdio-runtime-integration”

Workflow steps

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

  1. 冻结不得触达的通用 client、旧 SDK 和核心边界。
  2. 复用通用 agent-side wrapper,把 NcpAgentRuntime 暴露为 NARP stdio 子进程。
  3. 为具体 runtime 提供薄 wrapper package 与 -narp launcher。
  4. 通过显式 runtime entry 注册,不在核心注入默认 provider 分支。
  5. 真实验收同时证明 entry、launcher 可执行、launcher 指向当前待验构建物和模型真实回复。

What it can do on your machine

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

    • rg
    • claude

    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

Nextclaw Narp Stdio Runtime Integration loads about 761 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 277 words of instructions outside code blocks.

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

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 973722e, republished under its MIT licence (© Peiiii). 277 words, ~761 tokens.

Download SKILL.mdSave it as .claude/skills/nextclaw-narp-stdio-runtime-integration/SKILL.md (or your agent's skills folder).
name
nextclaw-narp-stdio-runtime-integration
description
当把 Codex、Claude Code、Hermes 或其他外部 agent runtime 通过 NARP stdio 接入 NextClaw,或触达 narp-stdio entry、launcher、agent-side wrapper 和旧 runtime 插件迁移时使用。

NARP Stdio Runtime Integration

架构合同

  • core/kernel/service 只识别通用 narp-stdio,不得硬编码具体 runtime/provider id。
  • runtime 身份只存在于 agents.runtimes.entries、installer/repair/marketplace metadata、具体 wrapper package 和显式测试配置。
  • Codex、Claude Code 等用户入口保持独立 marketplace skill;公共 NARP 协议实现复用,不合并用户入口。
  • host-side stdio client 保持通用;provider 差异属于 agent-side wrapper/bridge。
  • 旧 SDK runtime package 可作为 library 复用;除非它有阻塞 bug,不因迁移顺手修改。
  • 配置使用 type: "narp-stdio"、config.wireDialect: "acp" 和具体 config.command。

实现顺序

  1. 冻结不得触达的通用 client、旧 SDK 和核心边界。
  2. 复用通用 agent-side wrapper,把 NcpAgentRuntime 暴露为 NARP stdio 子进程。
  3. 为具体 runtime 提供薄 wrapper package 与 <runtime>-narp launcher。
  4. 通过显式 runtime entry 注册,不在核心注入默认 provider 分支。
  5. 真实验收同时证明 entry、launcher 可执行、launcher 指向当前待验构建物和模型真实回复。

实现前核对

  • 结构:读取目标 package 的 module structure、tsconfig、现有 role 目录和同类 bridge/mapper 落点;新增路径走目录 preflight。
  • 上游协议:用最小直连/mock 确认 stream、provider 参数、thinking/reasoning 字段和错误形状。
  • 模型路由:确认用户模型 id 是否带 provider 前缀,以及上游前的剥离/映射位置。
  • raw event:改 NCP mapper 前先看 SDK/CLI 是否暴露目标增量,还是把 bridge 增量聚合为 snapshot。
  • 构建入口:确认 launcher/bin 指向当前源码构建的 dist,不是旧全局版本;改 bridge/wrapper 后重建相关包。
  • 配置安全:只核对 apiBase、wireApi、model 和 enabled,不输出 key、token 或 extra headers。

核对后先判断第一个错误 owner:provider bridge、runtime SDK mapper、agent-side wrapper、host-side stdio client 或服务 SSE;owner 不明确时不修改业务代码。

能力验收

完成当前 runtime 集成 slice 后返回生命周期,由 Validation 阶段选择 NCP Chat 冒烟合同。按本次目标断言:

  • 文本:固定 marker、text delta 和最终文本;
  • 工具:tool-call start/result 与最终 marker;
  • 思考:reasoning start/delta/end 与非空 reasoning text;
  • 组合:agent runtime 至少一轮 thinking + tool + final text;
  • 流式:增量随上游到达,不能完成后一次吐出;
  • 连续性:同一产品 session 稳定映射同一 runtime session。触达绑定/恢复时验证首轮 marker、重启、追问,并核对持久化 runtime id;触达模型切换时再验证切换 provider/model 后上下文和 runtime id 不丢。

结论必须写成 runtime + provider/model + capability,不能用一个 provider 代表 runtime,也不能用文本成功代表工具或思考。

分层缩圈

按 provider 直连 -> bridge -> SDK/CLI raw event -> agent-side wrapper -> host-side stdio -> service SSE 找第一个错误 hop;每轮只验证一个假设。若用户问题发生在 dev URL,必须用进程证据确认真实子进程来自当前仓库,而不是转发到全局包。

真实冒烟默认隔离 NEXTCLAW_HOME 和 launcher bin;必要时隔离 runtime home。修改后重建 dist,长期进程重启或新开 session,输出全部脱敏。

Bridge 与 Reasoning

  • 分别确认上游 thinking 参数、provider 原始字段、bridge 目标形状和 SDK/CLI raw event。
  • 不可读 reasoning 先在三段流中定位首次空白丢失或改写,不在展示 mapper 统一伪造摘要;内容型 delta reader 不得 .trim() 文本、reasoning 或 tool arguments。
  • 修一个同构 bridge 后横向搜索 sibling runtime 的 stream reader、normalizer 和 event mapper。
  • MiniMax M2 的 ChatCompletions 可能需 reasoning_split: true;桥到 OpenAI Responses/Codex 时要核对 runtime 实际消费的 reasoning.summary 形状,不能只填另一个 reasoning 字段。

漂移检查

bash
rg -n 'codex|claude|nextclaw-codex|nextclaw-claude' packages/nextclaw-core/src packages/nextclaw-kernel/src packages/nextclaw-service/src

若命中来自新 provider 硬编码、默认 entry 注入、kind 特判或注册绕过,移到配置、installer 或 wrapper owner。

© 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

Just SKILL.md in .agents/wiki/skills/architecture/nextclaw-narp-stdio-runtime-integration of Peiiii/nextclaw.

Open the folder on GitHubat commit 973722e

Compare with similar skills

Nextclaw Narp Stdio Runtime Integration 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.

Nextclaw Narp Stdio Runtime Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nextclaw Narp Stdio Runtime Integration this skillPeiiii/nextclaw260—~761Automated safety check: PassMIT
Hermes Importsaffaan-m/ECC275k—~324Automated safety check: PassMIT
Hermes Importsaffaan-m/ECC275k1 repos~752Automated safety check: PassMIT
Inspecting Hermes Desktop DomNousResearch/hermes-agent252k1 repos~1.6kAutomated safety check: PassMIT
Hermes Tweetwshobson/agents40k—~1.4kAutomated safety check: PassMIT
Hermes Agent Skill AuthoringNousResearch/hermes-agent252k—~3.6kAutomated safety check: PassMIT

Similar skills

  • Hermes Imports

    affaan-m/ECC

    将本地 Hermes 操作员工作流转换为经过清理的 ECC 技能和发布包工件。在准备将 Hermes 工作流用于公共 ECC 重用而不泄露私有工作区状态、凭据或仅本地路径时使用。

    275k GitHub stars~324 tokensUpdated 3 days ago
    Auto-check passed
  • Hermes Imports

    affaan-m/ECC

    Convert local Hermes operator workflows into sanitized ECC skills and release-pack artifacts.

    275k GitHub starsUsed in 1 repo~752 tokens
    Auto-check passed
  • Inspecting Hermes Desktop Dom

    NousResearch/hermes-agent

    Read the live Hermes desktop DOM/CSS over CDP. An agent skill from NousResearch/hermes-agent.

    252k GitHub starsUsed in 1 repo~1.6k tokens
    Frontend & DesignAuto-check passed
  • Hermes Tweet

    wshobson/agents

    Install and operate Hermes Tweet, a Hermes Agent plugin for X/Twitter research, timeline reading, tweet analysis, and approval-gated private or state-changing operations.

    40k GitHub stars~1.4k tokensUpdated 4 days ago
    Writing & ContentAuto-check passed
  • Hermes Agent Skill Authoring

    NousResearch/hermes-agent

    Author in-repo SKILL.md files: frontmatter and structure. An agent skill from NousResearch/hermes-agent.

    252k GitHub stars~3.6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Guides Hermes Agent through building, refining and testing a CLI-Anything harness that wraps a GUI application or source repository in a scriptable command line.

    52k GitHub stars~1.1k tokensUpdated 17 days ago
    DevelopmentAuto-check passed

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 Nextclaw Narp Stdio Runtime Integration

What does Nextclaw Narp Stdio Runtime Integration do?

当把 Codex、Claude Code、Hermes 或其他外部 agent runtime 通过 NARP stdio 接入 NextClaw,或触达 narp-stdio entry、launcher、agent-side wrapper 和旧 runtime 插件迁移时使用。. Nextclaw Narp Stdio Runtime Integration is an agent skill from Peiiii/nextclaw.

How do I install Nextclaw Narp Stdio Runtime Integration in Claude Code?

Run `npx skills add Peiiii/nextclaw --skill nextclaw-narp-stdio-runtime-integration -a claude-code`. Or copy the skill folder (.agents/wiki/skills/architecture/nextclaw-narp-stdio-runtime-integration in Peiiii/nextclaw) into .claude/skills/nextclaw-narp-stdio-runtime-integration in your project. Claude Code loads it when a task matches its description.

How do I install Nextclaw Narp Stdio Runtime Integration in Codex?

Run `npx skills add Peiiii/nextclaw --skill nextclaw-narp-stdio-runtime-integration -a codex`. Or copy the skill folder (.agents/wiki/skills/architecture/nextclaw-narp-stdio-runtime-integration in Peiiii/nextclaw) into .agents/skills/nextclaw-narp-stdio-runtime-integration in your project. Codex loads it when a task matches its description.

Can I use Nextclaw Narp Stdio Runtime Integration 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 nextclaw-narp-stdio-runtime-integration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nextclaw-narp-stdio-runtime-integration, .gemini/skills/nextclaw-narp-stdio-runtime-integration, .github/skills/nextclaw-narp-stdio-runtime-integration and .opencode/skills/nextclaw-narp-stdio-runtime-integration in your project.

What does Nextclaw Narp Stdio Runtime Integration need to run?

Going by SKILL.md and its folder, Nextclaw Narp Stdio Runtime Integration needs the command-line tools its instructions call (rg and claude).

Does Nextclaw Narp Stdio Runtime Integration 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 Nextclaw Narp Stdio Runtime Integration 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 Nextclaw Narp Stdio Runtime Integration use?

Nextclaw Narp Stdio Runtime Integration 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 Nextclaw Narp Stdio Runtime Integration use?

About 761 tokens (SKILL.md is roughly 3k 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 Nextclaw Narp Stdio Runtime Integration?

Skills that share tags, products or a category with Nextclaw Narp Stdio Runtime Integration: Hermes Imports (affaan-m/ECC, 275k stars), Hermes Imports (affaan-m/ECC, 275k stars), Inspecting Hermes Desktop Dom (NousResearch/hermes-agent, 252k stars) and Hermes Tweet (wshobson/agents, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nextclaw Narp Stdio Runtime Integration?

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 7, 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.