New: 97,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

Knowledge Interaction Surfaces Acp Host Integration

by echoVic in echoVic/blade-code

覆盖 Blade 的 ACP stdio Agent、Session load/list/fork/close、宿主能力协商、远程 文件系统与终端、权限模式、流式 update、历史回放和资源回收。进入时机：接入 Zed 或 其他 ACP 宿主、修改协议能力、调试远程文件/终端、Session 替换、输出背压或宿主工具 展示。

MITAuto-check passedDevelopment

Install Knowledge Interaction Surfaces Acp Host Integration

skills CLI
$ npx skills add echoVic/blade-code --skill knowledge-interaction-surfaces-acp-host-integration -a claude-code

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

GitHub CLI
$ gh skill install echoVic/blade-code knowledge-interaction-surfaces-acp-host-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/echoVic/blade-code.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.trae/knowledges/interaction-surfaces/acp-host-integration .claude/skills/knowledge-interaction-surfaces-acp-host-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
knowledge-interaction-surfaces-acp-host-integration
GitHub stars
180
Token cost
~1.6k tokens
SKILL.md length
441 words
Files
1
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

覆盖 Blade 的 ACP stdio Agent、Session load/list/fork/close、宿主能力协商、远程 文件系统与终端、权限模式、流式 update、历史回放和资源回收。进入时机：接入 Zed 或 其他 ACP 宿主、修改协议能力、调试远程文件/终端、Session 替换、输出背压或宿主工具 展示。

  • Development work in your project
  • SKILL.md covers Module Structure, Gotchas, Architecture and Decisions, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Knowledge Interaction Surfaces Acp Host Integration is an agent skill from echoVic/blade-code. 覆盖 Blade 的 ACP stdio Agent、Session load/list/fork/close、宿主能力协商、远程 文件系统与终端、权限模式、流式 update、历史回放和资源回收。进入时机：接入 Zed 或 其他 ACP 宿主、修改协议能力、调试远程文件/终端、Session 替换、输出背压或宿主工具 展示。 不包含：普通 Web API（见 ../hono-server-api-and-streaming/）、本地 TUI 交互（见 ../terminal-ui/）。关键词：BladeAgent, AcpSession, AcpServiceContext, AgentSideConnection, sessionUpdate, session/load, unstableforkSession, requestPermission。

Its SKILL.md is about 1.6k 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. It works with Hono and Git. The repository describes itself as: AI-powered CLI coding agent with 20+ built-in tools, MCP support, and multi-model providers. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/knowledge-interaction-surfaces-acp-host-integration”

What it can do on your machine

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

    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

Knowledge Interaction Surfaces Acp Host Integration loads about 1.6k tokens when it runs. Until then it costs about 109 tokens; SKILL.md has 441 words of instructions outside code blocks.

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

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 echoVic/blade-code at commit 30f8684, republished under its MIT licence (© echoVic). 441 words, ~1,646 tokens.

Download SKILL.mdSave it as .claude/skills/knowledge-interaction-surfaces-acp-host-integration/SKILL.md (or your agent's skills folder).
name
knowledge-interaction-surfaces-acp-host-integration
description
覆盖 Blade 的 ACP stdio Agent、Session load/list/fork/close、宿主能力协商、远程 文件系统与终端、权限模式、流式 update、历史回放和资源回收。进入时机：接入 Zed 或 其他 ACP 宿主、修改协议能力、调试远程文件/终端、Session 替换、输出背压或宿主工具 展示。 不包含：普通 Web API（见 ../hono-server-api-and-streaming/）、本地 TUI 交互（见 ../terminal-ui/）。关键词：BladeAgent, AcpSession, AcpServiceContext, AgentSideConnection, sessionUpdate, session/load, unstable_forkSession, requestPermission。

Module Structure

ACP 层把每个宿主 Session 映射为独占的 Agent、SessionRuntime、文件系统/终端服务和 有界更新队列，通过 stdio NDJSON 与 IDE 通信。

Directory Layout
  • packages/cli/src/acp/index.ts — stdio Web Streams 与 ACP connection 生命周期
  • packages/cli/src/acp/BladeAgent.ts — 协议方法、Session residency 和配置能力
  • packages/cli/src/acp/Session.ts — prompt、历史、权限、LoopEvent 与 update 投影
  • packages/cli/src/acp/AcpServiceContext.ts — 按 Session 隔离的 FS/Terminal 后端
  • packages/cli/src/acp/AcpFileSystemService.ts — ACP 文本文件能力适配
  • packages/cli/src/services/FileSystemService.ts — 本地/远程文件系统公共接口
  • packages/cli/src/tools/display/ToolResultProjector.ts — ACP 工具详情裁剪
Key Entry Points
  • runAcpIntegration() in packages/cli/src/acp/index.ts — 建立 AgentSideConnection 并绑定关闭清理
  • BladeAgent.initialize() in packages/cli/src/acp/BladeAgent.ts — 协商协议和 Agent 能力
  • BladeAgent.newSession() and BladeAgent.loadSession() — 创建或原子替换宿主 Session
  • AcpSession.initialize() in packages/cli/src/acp/Session.ts — 创建服务上下文、恢复交互和 Runtime
  • AcpSession.prompt() in packages/cli/src/acp/Session.ts — 处理 prompt 并串行投影事件

Gotchas

  • session/load 必须在返回响应前按协议回放所有用户可见历史；system、tool 和内部消息留在模型上下文但不发送给宿主 (packages/cli/src/acp/BladeAgent.ts, packages/cli/src/acp/Session.ts, git:6d712a03)
  • 同一个 Session 的并发 load/close 通过 sessionLoadQueues 串行，旧 owner 完全销毁后才能提交新 owner；否则两个 Runtime 会同时消费同一 durable inbox (packages/cli/src/acp/BladeAgent.ts, git:804a5c64)
  • ACP Runtime residency 的 allowEviction 为 false；容量满时新 Session 直接返回结构化 internal error，不能静默逐出宿主仍持有的 Session (packages/cli/src/acp/BladeAgent.ts)
  • 宿主声明 fs.readTextFile/writeTextFile 后，远端调用失败必须 fail closed，不能读取或写入 Agent 主机上的同名路径；只有未声明能力时才选择本地 FS (packages/cli/src/acp/AcpFileSystemService.ts)
  • Terminal 后端在 Session 初始化时按 capability 选择：声明 terminal 后远端创建失败不自动本地执行，未声明 terminal 才使用绑定 Session cwd 的本地后端 (packages/cli/src/acp/AcpServiceContext.ts, docs/testing/acp-terminal-capability-routing-evidence.md, git:4991291e)
  • ACP terminal 的 currentOutput() 是累计快照而非增量；轮询必须按已观察长度切 delta，输出回退或 truncated 时重建 capture 并标记 accounting incomplete (packages/cli/src/acp/AcpServiceContext.ts)
  • terminal timeout/abort 的完成顺序是 kill → 停止轮询 → 最终读取 → release；提前返回会丢尾部输出并泄漏宿主 terminal (packages/cli/src/acp/AcpServiceContext.ts)
  • 所有 sessionUpdate() 共用一个 BoundedSerialEgress；任何 overflow、超时或 connection abort 会中止当前 prompt、user shell 和 side conversation，而不是继续生成未送达内容 (packages/cli/src/acp/Session.ts, git:1af43232)
  • closeSession 会以 discardPendingInput: true 销毁，连接级 shutdown 默认保留 durable inbox 供下次恢复；这两个关闭语义不能合并 (packages/cli/src/acp/BladeAgent.ts, packages/cli/src/acp/Session.ts, git:e260f4bc)
  • available_commands_update 必须延迟到 session/new 或 session/load 响应之后；立即发送会命中尚未准备好的宿主 (packages/cli/src/acp/Session.ts)
  • ACP 的 auto-edit 与 Blade 内部 autoEdit 名称不同，模式变更必须先持久化 Session 权限，再发送 current_mode_update (packages/cli/src/acp/BladeAgent.ts, packages/cli/src/acp/Session.ts)
  • 模型、reasoning、tier、verbosity 和 communication style 在 prompt 活动期间不可切换；持久化 metadata 失败时模型切换会回滚 Runtime (packages/cli/src/acp/Session.ts)
  • ACP ! 命令始终要求 Session terminal 后端，allowLocalFallback 为 false；远程宿主 terminal 失败不能偷偷在 Blade 主机执行 (packages/cli/src/acp/Session.ts, packages/cli/src/acp/AcpServiceContext.ts)
Show full SKILL.md (209 more words)Show less

Architecture

  • BladeAgent 是连接级 owner，管理多个 AcpSession 与 residency；每个 AcpSession 再独占 Agent、SessionRuntime、服务上下文和 update queue (packages/cli/src/acp/BladeAgent.ts, packages/cli/src/acp/Session.ts)
  • AcpServiceContext 按 session ID 保存 connection、capabilities、cwd、FS 和 Terminal，避免并发 Session 共享“当前”远程服务；无 session 参数的兼容 API 只用于旧调用 (packages/cli/src/acp/AcpServiceContext.ts)
  • prompt 事件映射为 agent_message_chunk、agent_thought_chunk、tool_call(_update)、plan 与 session_info_update，所有 update 在 Agent generator 继续前可被 flush 形成背压 (packages/cli/src/acp/Session.ts)
  • Session setup 同时暴露权限 modes 和模型相关 configOptions；可选项来自该 Session 冻结的 model configuration，不从宿主请求临时拼装 (packages/cli/src/acp/BladeAgent.ts, packages/cli/src/acp/Session.ts)
  • fork 先由 SessionService 复制 durable history 与 metadata，再创建独立 AcpSession；父子共享来源 workspace 但拥有不同 Session ID、Runtime 和终端上下文 (packages/cli/src/acp/BladeAgent.ts)
  • Slash commands 复用核心命令注册表，但 model、permissions、theme、config、exit、ide 等由 ACP 原生 UI/协议接管的命令不会重复暴露 (packages/cli/src/acp/Session.ts)

Decisions

  • ACP 能力协商是后端选择，而不是失败回退：未声明能力允许本地实现，已声明能力则认定资源归宿主所有并 fail closed (packages/cli/src/acp/AcpServiceContext.ts, packages/cli/src/acp/AcpFileSystemService.ts)
  • 工具结果优先投影为 ACP 原生 diff content；没有结构化 edit/patch metadata 时才退化为经统一预算裁剪的文本内容 (packages/cli/src/acp/Session.ts, packages/cli/src/tools/display/ToolResultProjector.ts)
  • Session 配置是 durable 状态，setSessionMode 和 config option 不只是 UI 通知；宿主看到成功前必须已更新 Runtime 与 Session metadata (packages/cli/src/acp/Session.ts)
  • 用户问题和 MCP Elicitation 被线性化为 ACP permission 选择流程，以适配宿主交互能力；取消或协议错误统一 fail closed (packages/cli/src/acp/Session.ts)

Patterns

  • 创建、fork、load 都先预留 residency，完成 Session 初始化后才 commit；任一步失败都会 cancel reservation 并销毁半初始化 Session (packages/cli/src/acp/BladeAgent.ts)
  • 所有异步宿主更新先检查 Session 未 destroyed、connection 未 aborted、egress 未 closed；迟到 timer、Bus 回调和 completion 都不得重新激活已释放 Session (packages/cli/src/acp/Session.ts)
  • 后台子代理完成和 team message 先进入 durable inbox，再在 Session idle 时通过空 prompt 自动续跑；连接关闭时保留该 inbox (packages/cli/src/acp/Session.ts)
  • durable inbox 自动续跑失败时只重试结构化标记为 retryable、且尚未产生部分输出或任何 tool_start/tool_progress/tool_result 的回合；重试采用单飞、有界指数退避、稳定抖动和硬总时限，cancel、egress 失败与 destroy 会使排队及执行中的旧代际失效，Goal/preflight 失败也不能吞掉随后到达的新输入；blade/pendingResume metadata 投影恢复状态 (packages/cli/src/acp/Session.ts)
  • destroy() 是 single-flight，先关闭 update egress 与订阅，再 cancel 活动工作并等待 completion，最后销毁 Agent、Runtime 和服务上下文，同时保留首个错误 (packages/cli/src/acp/Session.ts)
  • 图片 prompt 在协议入口同时限制数量、base64 总字节和文本字符/字节；通过校验后才转换成 Blade UserMessageContent (packages/cli/src/acp/Session.ts)

Dependencies

  • ACP 协议、NDJSON stream、Session capabilities 和 terminal/file RPC 来自 @agentclientprotocol/sdk；本地 fallback 仍使用 Blade 的 FileSystemService 与受控进程树 (packages/cli/src/acp/index.ts, packages/cli/src/acp/AcpServiceContext.ts)

© echoVic, 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 .trae/knowledges/interaction-surfaces/acp-host-integration of echoVic/blade-code.

Open the folder on GitHubat commit 30f8684

Compare with similar skills

Knowledge Interaction Surfaces Acp Host 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.

Knowledge Interaction Surfaces Acp Host Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Knowledge Interaction Surfaces Acp Host Integration this skillechoVic/blade-code180—~1.6kAutomated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT
Codebase Knowledge Graph Q&AEgonex-AI/Understand-Anything85k1 repos~1.2kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Understand Diff AnalysisEgonex-AI/Understand-Anything85k1 repos~1.4kAutomated safety check: PassMIT

Similar skills

  • Finishing a Development Branch

    obra/superpowers

    Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed

  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed

  • Codebase Knowledge Graph Q&A

    Egonex-AI/Understand-Anything

    Answers questions about a codebase by searching a prebuilt knowledge graph of its files, functions, classes and dependencies, not by rereading every source file.

    85k GitHub starsUsed in 1 repo~1.2k tokens
    DevelopmentAuto-check passed

  • Code Design Rationale Investigator

    cursor/plugins

    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

  • Understand Diff Analysis

    Egonex-AI/Understand-Anything

    Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.

    85k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed

  • Understand Explain

    Egonex-AI/Understand-Anything

    Gives an in-depth explanation of one file, function or module by reading the project's knowledge graph and checking that the graph is still fresh.

    85k GitHub starsUsed in 1 repo~1.3k tokens
    DevelopmentAuto-check passed

More from echoVic/blade-code

All 38 skills in this repo

  • Base64 Parser

    echoVic/blade-code

    Base64 编解码工具，支持编码/解码文本、JSON、二进制文件，自动检测格式，支持批量处理. An agent skill from echoVic/blade-code.

    180 GitHub stars~545 tokensUpdated 10 days ago
    Auto-check: notes

  • Code Review

    echoVic/blade-code

    Review frontend code for best practices, bugs, and improvements.

    180 GitHub stars~377 tokensUpdated 10 days ago
    Auto-check: notes

  • GitHub Explorer

    echoVic/blade-code

    Explore and summarize popular GitHub projects. An agent skill from echoVic/blade-code.

    180 GitHub stars~434 tokensUpdated 10 days ago
    Auto-check passed

  • Knowledge Extension Ecosystem Lsp Code Intelligence

    echoVic/blade-code

    覆盖 Session 级 LSP 配置快照、stdio 进程、文档同步、语义查询、诊断回注、崩溃恢复 和子 Session 继承。进入条件：新增语言服务器、修改 LSP 工具、排查诊断缺失/重复、 处理 worktree 或 ACP 差异、修复进程泄漏或 transport 代际问题。不包含：VS Code 扩展桥接（见…

    180 GitHub stars~1.9k tokensUpdated 10 days ago
    Auto-check passed

  • Knowledge Extension Ecosystem Skills And Custom Commands

    echoVic/blade-code

    覆盖 SkillRegistry、SKILL.md 延迟加载、自定义命令 Markdown 解析、来源覆盖、插件 命名空间、Session 快照和模型/用户调用入口。进入条件：新增 Skill 或命令字段、调整 发现优先级、调试 /command 或 Skill 工具、修改 Prompt 元数据或消费者集成。不包含： 插件安装生命周期（见…

    180 GitHub stars~2.1k tokensUpdated 10 days ago
    Auto-check passed

  • Knowledge Integration And Workflow Tool Adapters

    echoVic/blade-code

    Covers 领域能力如何包装成内置工具、getBuiltinTools 的 Session 依赖注入、ToolSearch 延迟激活，以及 Goal/Task/Team/Plan/Skill/LSP/MCP/Web/Config/Worktree 适配边界。

    180 GitHub stars~2.1k tokensUpdated 10 days ago
    Auto-check passed

Works with

Categories

Questions about Knowledge Interaction Surfaces Acp Host Integration

What does Knowledge Interaction Surfaces Acp Host Integration do?

覆盖 Blade 的 ACP stdio Agent、Session load/list/fork/close、宿主能力协商、远程 文件系统与终端、权限模式、流式 update、历史回放和资源回收。进入时机：接入 Zed 或 其他 ACP 宿主、修改协议能力、调试远程文件/终端、Session 替换、输出背压或宿主工具 展示。. Knowledge Interaction Surfaces Acp Host Integration is an agent skill from echoVic/blade-code.

When should I use Knowledge Interaction Surfaces Acp Host Integration?

Knowledge Interaction Surfaces Acp Host Integration fits situations like: development work in your project.

How do I install Knowledge Interaction Surfaces Acp Host Integration in Claude Code?

Run `npx skills add echoVic/blade-code --skill knowledge-interaction-surfaces-acp-host-integration -a claude-code`. Or copy the skill folder (.trae/knowledges/interaction-surfaces/acp-host-integration in echoVic/blade-code) into .claude/skills/knowledge-interaction-surfaces-acp-host-integration in your project. Claude Code loads it when a task matches its description.

How do I install Knowledge Interaction Surfaces Acp Host Integration in Codex?

Run `npx skills add echoVic/blade-code --skill knowledge-interaction-surfaces-acp-host-integration -a codex`. Or copy the skill folder (.trae/knowledges/interaction-surfaces/acp-host-integration in echoVic/blade-code) into .agents/skills/knowledge-interaction-surfaces-acp-host-integration in your project. Codex loads it when a task matches its description.

Can I use Knowledge Interaction Surfaces Acp Host 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 echoVic/blade-code --skill knowledge-interaction-surfaces-acp-host-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/knowledge-interaction-surfaces-acp-host-integration, .gemini/skills/knowledge-interaction-surfaces-acp-host-integration, .github/skills/knowledge-interaction-surfaces-acp-host-integration and .opencode/skills/knowledge-interaction-surfaces-acp-host-integration in your project.

What does Knowledge Interaction Surfaces Acp Host Integration need to run?

SKILL.md names no scripts, command-line tools or credentials: Knowledge Interaction Surfaces Acp Host Integration is instructions for the agent only.

Does Knowledge Interaction Surfaces Acp Host 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 Knowledge Interaction Surfaces Acp Host 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 Knowledge Interaction Surfaces Acp Host Integration use?

Knowledge Interaction Surfaces Acp Host 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 Knowledge Interaction Surfaces Acp Host Integration use?

About 1.6k tokens (SKILL.md is roughly 6.6k 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 Knowledge Interaction Surfaces Acp Host Integration?

Skills that share tags, products or a category with Knowledge Interaction Surfaces Acp Host Integration: Finishing a Development Branch (obra/superpowers, 296k stars), Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars), Codebase Knowledge Graph Q&A (Egonex-AI/Understand-Anything, 85k stars) and Code Design Rationale Investigator (cursor/plugins, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Knowledge Interaction Surfaces Acp Host Integration?

echoVic (a GitHub user) maintains it in echoVic/blade-code, which has 180 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on September 27, 2026.

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