Agent skill

Knowledge Interaction Surfaces

by echoVic in echoVic/blade-code

覆盖 Blade 的 CLI、TUI、Hono Server、Web、ACP 与 VS Code 六种交互表面,以及它们对同一 Agent、Session 和事件事实的不同投影方式。进入时机:修改启动分流、跨端事件、用户输入、 会话导航、输出背压、宿主能力或任一表面的生命周期。

MITAuto-check passedFrontend & Design

Install Knowledge Interaction Surfaces

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

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

GitHub CLI
$ gh skill install echoVic/blade-code knowledge-interaction-surfaces --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 .claude/skills/knowledge-interaction-surfaces && 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
GitHub stars
180
Token cost
~1.4k tokens
SKILL.md length
348 words
Files
1
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

覆盖 Blade 的 CLI、TUI、Hono Server、Web、ACP 与 VS Code 六种交互表面,以及它们对同一 Agent、Session 和事件事实的不同投影方式。进入时机:修改启动分流、跨端事件、用户输入、 会话导航、输出背压、宿主能力或任一表面的生命周期。

  • Tasks that involve React components
  • 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
  • Tasks that involve Session handoff

What it does

Knowledge Interaction Surfaces is an agent skill from echoVic/blade-code. 覆盖 Blade 的 CLI、TUI、Hono Server、Web、ACP 与 VS Code 六种交互表面,以及它们对同一 Agent、Session 和事件事实的不同投影方式。进入时机:修改启动分流、跨端事件、用户输入、 会话导航、输出背压、宿主能力或任一表面的生命周期。 不包含:Agent 决策语义(见 ../agent-execution-and-orchestration/)、会话持久化内部实现(见 ../session-state-and-context/)、工具与 Browser 内核运行机制(见 ../tool-and-automation-platform/)。关键词:blade.tsx, headless, Ink, Hono, SSE, React Web, ACP, VS Code, SessionRef, surface projection。

Its SKILL.md is about 1.4k 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, covering React components and Session handoff. It works with Visual Studio Code, Hono and React. 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

  • Tasks that involve React components
  • Tasks that involve Session handoff

Example prompts

  • “/knowledge-interaction-surfaces”

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 loads about 1.4k tokens when it runs. Until then it costs about 106 tokens; SKILL.md has 348 words of instructions outside code blocks.

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

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). 348 words, ~1,426 tokens.

Download SKILL.mdSave it as .claude/skills/knowledge-interaction-surfaces/SKILL.md (or your agent's skills folder).
name
knowledge-interaction-surfaces
description
覆盖 Blade 的 CLI、TUI、Hono Server、Web、ACP 与 VS Code 六种交互表面,以及它们对同一 Agent、Session 和事件事实的不同投影方式。进入时机:修改启动分流、跨端事件、用户输入、 会话导航、输出背压、宿主能力或任一表面的生命周期。 不包含:Agent 决策语义(见 ../agent-execution-and-orchestration/)、会话持久化内部实现(见 ../session-state-and-context/)、工具与 Browser 内核运行机制(见 ../tool-and-automation-platform/)。关键词:blade.tsx, headless, Ink, Hono, SSE, React Web, ACP, VS Code, SessionRef, surface projection。

Module Structure

该域是 Blade 的运行边界层:各表面负责接收用户或宿主输入、建立 Session 运行环境并投影 统一事件,但不拥有 Agent 决策或 durable transcript 的权威状态。

Directory Layout
  • packages/cli/src/blade.tsx — 统一进程入口与运行表面分流
  • packages/cli/src/cli/ — 全局参数、设置覆盖和 yargs 中间件
  • packages/cli/src/commands/ — Headless、Print、Serve、Web 与管理命令
  • packages/cli/src/ui/ — React + Ink 终端交互与本地事件投影
  • packages/cli/src/server/ — Hono HTTP、SSE、WebSocket 终端和服务端资源所有权
  • packages/cli/web/src/ — React Web、Zustand 投影、导航和预览工作区
  • packages/cli/src/acp/ — ACP Agent、Session、远程文件系统与终端能力适配
  • packages/vscode/src/ — VS Code WebSocket 桥
Key Entry Points
  • main() in packages/cli/src/blade.tsx — 按 Headless、Print、ACP、子命令和默认 TUI 的优先级启动表面
  • AppWrapper in packages/cli/src/ui/App.tsx — TUI 的信任判断、资源初始化和主界面入口
  • BladeServer.listenAsync() in packages/cli/src/server/server.ts — Web/API 服务启动与关闭入口
  • App in packages/cli/web/src/App.tsx — Web 导航恢复、任务流订阅和页面分流入口
  • runAcpIntegration() in packages/cli/src/acp/index.ts — ACP stdio/NDJSON 连接入口
  • activate() in packages/vscode/src/extension.ts — VS Code 桥激活入口

Gotchas

  • 各表面只是同一 Runtime 事实的投影,不能把 TUI Store、Web Zustand、ACP update 或 Headless 输出当作持久化权威;恢复必须重新读取 Session 数据或 committed event (packages/cli/src/store/slices/sessionSlice.ts, packages/cli/web/src/store/session/slices/sessionSlice.ts, packages/cli/src/acp/Session.ts)
  • 远端表面中的 Session 身份是 projectPath + sessionId,只按 session ID 过滤或缓存会把不同工作区的同名 Session 串在一起 (packages/cli/src/server/sessionRef.ts, packages/cli/web/src/store/session/sessionIdentity.ts)
  • committed event 带单调 seq 并可重放,流式 delta、heartbeat 和瞬时工具活动不带 seq;让 ephemeral 事件推进恢复游标会造成重连丢事件 (packages/cli/src/server/bus.ts, packages/cli/src/server/routes/session.ts, git:c776d496)
  • Headless、Web SSE 与 ACP 都必须有界且串行输出,但失败语义不同:Headless 取消当前运行,Web 逐出单个订阅者,ACP 中止当前 Session 操作;不能用一个表面的断连策略推断另一个表面 (packages/cli/src/commands/HeadlessOutputEgress.ts, packages/cli/src/server/OrderedSseEgress.ts, packages/cli/src/acp/Session.ts)
  • 工具结果先经过统一展示投影和表面字符预算,再映射成卡片、JSONL、SSE 或 ACP content;直接发送原始工具输出会绕过敏感元数据清理与有界输出规则 (packages/cli/src/tools/display/ToolResultProjector.ts, packages/cli/src/server/routes/session.ts)
  • ! <command> 在各表面共享 Session-owned 持久语义,但终端后端由表面决定;尤其 ACP 是否远程执行取决于宿主声明的 terminal capability (packages/cli/src/services/UserShellCommandService.ts, packages/cli/src/acp/AcpServiceContext.ts)

Architecture

  • CLI/TUI 直接在当前进程消费 Agent.chatStream(),Web 通过 Hono + SSE 控制 server-owned run,ACP 将同一 LoopEvent 映射为协议 update,VS Code 则是独立的轻量 WebSocket 编辑器桥 (packages/cli/src/commands/headless.ts, packages/cli/src/server/routes/session.ts, packages/cli/src/acp/Session.ts, packages/vscode/src/extension.ts)
  • 每个长生命周期表面都把 SessionRuntime 作为资源所有权边界:TUI Hook 持有一个活动 Runtime,Server 与 ACP 再用 residency 管理多个 Runtime;视图组件不能自行复制 Runtime 生命周期 (packages/cli/src/ui/hooks/useAgent.ts, packages/cli/src/server/routes/session.ts, packages/cli/src/acp/BladeAgent.ts)
  • Web 的单 Session SSE 与全局任务 SSE 是两条不同通道:前者承载完整会话投影和 durable replay,后者只发布看板安全元数据,避免跨 Session 泄露 prompt 与执行细节 (packages/cli/src/server/routes/session.ts, packages/cli/src/server/routes/events.ts)
  • TUI 是本地 Ink 投影,不经过远端 egress 队列;远端 viewer 变慢不会阻塞 TUI,而 raw PTY 自身的背压由终端进程处理 (docs/reference/surface-egress.md)

Decisions

  • 统一事件溯源改造后,CLI、Web 与 ACP 都围绕 committed/ephemeral 两层事件工作,新增跨端状态应先定义 canonical Runtime 事件,再分别补投影,而不是在各 UI 自建事实 (packages/cli/src/context/events/SessionEventLog.ts, git:c776d496)
  • 运行表面统一采用有界串行 egress,是为了让慢消费者无法造成无界内存,同时保留 canonical Session 供 reload/resume;普通事件不会为保活而静默丢弃 (docs/reference/surface-egress.md, git:1af43232)
  • Web Server 与 Web Client 通过 packages/cli/src/api/ 的 TypeBox schema 共享契约,ACP 和 Headless 保留各自外部协议形状;不要强行把 ACP 或 JSONL wire 格式复用为 HTTP schema (packages/cli/src/api/schemas.ts, packages/cli/src/commands/headlessEvents.ts)

Patterns

  • 终态投影采用“先排空增量,再发布终态,再按需重读权威历史”的顺序,避免最后一个 delta 被异步缓冲器留在终态之后 (packages/cli/web/src/store/session/handlers/eventHandlers.ts, packages/cli/src/ui/utils/loopEventHandler.ts)
  • 表面切换或 Session 替换都先停止旧输入/订阅并释放旧 Runtime,再提交新身份;迟到结果必须以 generation 或精确 SessionRef 丢弃 (packages/cli/src/ui/utils/sessionActivation.ts, packages/cli/web/src/store/session/slices/sessionSlice.ts, packages/cli/src/acp/BladeAgent.ts)
  • 用户可见的 Provider、Goal、Subagent、Team 和 Tool 状态都来自事件映射;增加新的 LoopEvent 时应检查 Headless exhaustive switch、TUI handler、Server emitter、Web dispatcher 与 ACP update (packages/cli/src/commands/headless.ts, packages/cli/src/ui/utils/loopEventHandler.ts, packages/cli/src/server/routes/session.ts, packages/cli/web/src/store/session/handlers/eventHandlers.ts, packages/cli/src/acp/Session.ts)

Child Knowledge Nodes

  • ./cli-bootstrap-headless-and-print/SKILL.md — 进入时机:修改 CLI 启动优先级、全局参数、Headless/Print 输入输出、信号处理或管理子命令
  • ./terminal-ui/SKILL.md — 进入时机:修改 Ink 输入、消息渲染、确认流程、Session 切换、流式缓冲或 TUI Runtime 生命周期
  • ./hono-server-api-and-streaming/SKILL.md — 进入时机:修改 Hono 路由、Session/Task API、SSE replay、WebSocket 终端、认证或服务关闭
  • ./web-client/SKILL.md — 进入时机:修改 React Web、Zustand Session 投影、SSE 重连、导航、草稿、布局、预览或任务看板
  • ./acp-host-integration/SKILL.md — 进入时机:修改 ACP 能力协商、Session load/fork、远程 FS/Terminal、权限、流式 update 或宿主展示
  • ./vscode-bridge/SKILL.md — 进入时机:修改 VS Code 扩展激活、端口发现、WebSocket RPC、编辑器/诊断/Diff 操作或扩展打包

© 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 of echoVic/blade-code.

Open the folder on GitHubat commit 30f8684

Compare with similar skills

Knowledge Interaction Surfaces 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Knowledge Interaction Surfaces this skillechoVic/blade-code180—~1.4kAutomated safety check: PassMIT
South Admin CRUD Generatorsouthliu/south-admin-react580—~1.7kAutomated safety check: PassMIT
Clerk React Patternsgeekskai/blog1031 repos~1kAutomated safety check: NotesMIT
React Emailaiskillstore/marketplace4301 repos~3.6kAutomated safety check: PassMIT
React Composition Patternsvercel-labs/openreview1.7k58 repos~721Automated safety check: PassMIT
Vercel React Best Practicessanity-io/sanity6.4k130 repos~1.6kAutomated safety check: PassMIT

Similar skills

  • South Admin CRUD Generator

    southliu/south-admin-react

    Generates a full CRUD page - page component, data model and API client - from the south-admin-react project's own VS Code snippet templates.

    580 GitHub stars~1.7k tokensUpdated 17 days ago
    Frontend & DesignAuto-check passed
  • React SPA auth patterns with @clerk/react for Vite/CRA - ClerkProvider setup, useAuth/useUser/useClerk hooks, React Router protected routes, custom sign-in flows.

    103 GitHub starsUsed in 1 repo~1k tokens
    Frontend & DesignAuto-check: notes
  • React Email

    aiskillstore/marketplace

    A skill your agent uses when building HTML email templates with React components, adding a visual email editor to an application using the React Email visual editor, rendering emails to HTML, or…

    430 GitHub starsUsed in 1 repo~3.6k tokens
    Frontend & DesignAuto-check passed
  • React Composition Patterns

    vercel-labs/openreview

    Official

    Rules for structuring React components with composition instead of boolean props, covering compound components, lifted state, variants and React 19 changes.

    1.7k GitHub starsUsed in 58 repos~721 tokens
    Frontend & DesignAuto-check passed
  • Official

    React and Next.js performance optimization guidelines from Vercel Engineering.

    6.4k GitHub starsUsed in 130 repos~1.6k tokens
    Frontend & DesignAuto-check passed
  • React Best Practices

    mastra-ai/mastra

    React performance optimization guidelines from Mastra Engineering.

    29k GitHub stars~1.9k tokensUpdated today
    Frontend & DesignAuto-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
  • 覆盖 Session 级 LSP 配置快照、stdio 进程、文档同步、语义查询、诊断回注、崩溃恢复 和子 Session 继承。进入条件:新增语言服务器、修改 LSP 工具、排查诊断缺失/重复、 处理 worktree 或 ACP 差异、修复进程泄漏或 transport 代际问题。不包含:VS Code 扩展桥接(见…

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

    180 GitHub stars~2.1k tokensUpdated 10 days ago
    Auto-check passed
  • 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

Questions about Knowledge Interaction Surfaces

What does Knowledge Interaction Surfaces do?

覆盖 Blade 的 CLI、TUI、Hono Server、Web、ACP 与 VS Code 六种交互表面,以及它们对同一 Agent、Session 和事件事实的不同投影方式。进入时机:修改启动分流、跨端事件、用户输入、 会话导航、输出背压、宿主能力或任一表面的生命周期。. Knowledge Interaction Surfaces is an agent skill from echoVic/blade-code.

When should I use Knowledge Interaction Surfaces?

Knowledge Interaction Surfaces fits situations like: tasks that involve React components; tasks that involve Session handoff.

How do I install Knowledge Interaction Surfaces in Claude Code?

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

How do I install Knowledge Interaction Surfaces in Codex?

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

Can I use Knowledge Interaction Surfaces 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 -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, .gemini/skills/knowledge-interaction-surfaces, .github/skills/knowledge-interaction-surfaces and .opencode/skills/knowledge-interaction-surfaces in your project.

What does Knowledge Interaction Surfaces need to run?

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

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

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

About 1.4k tokens (SKILL.md is roughly 5.7k 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?

Skills that share tags, products or a category with Knowledge Interaction Surfaces: South Admin CRUD Generator (southliu/south-admin-react, 580 stars), Clerk React Patterns (geekskai/blog, 103 stars), React Email (aiskillstore/marketplace, 430 stars) and React Composition Patterns (vercel-labs/openreview, 1.7k 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?

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.