bf-caprt-dev

A guide for delivering skills, agents, and workflows through capability-runtime, the runtime layer that executes these capabilities and reports their results.

In plain words
What is it for?
Use it when building new capability-runtime applications or bringing older code to its runtime boundary. It covers runtime execution, structured output, node reports, host summaries, services, and sessions.
Why use it?
It keeps application code aligned with the runtime’s public interfaces and standard reports instead of bypassing the layer with custom integrations.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/okwinds/miscellany/bf-caprt-dev
Any agent
npx skills add okwinds/miscellany --skill bf-caprt-dev
Clone the repo
git clone --depth 1 https://github.com/okwinds/miscellany

Made for: Claude Code, Codex.

Per session 258 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,849 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00258 $0.05849
Opus 5 $0.00129 $0.02925
Sonnet 5 $0.00052 $0.01170
Haiku 4.5 $0.00026 $0.00585

Measured 2d ago against content hash 16f0345f5a89, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

bf-caprt-dev scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agent/skills/bf-caprt-dev/SKILL.md · 539 lines

How it starts

The opening of the file, as written. The whole thing — 539 lines — stays where its author put it; the contents beside it link to each section on GitHub.

bf-caprt-dev

定位

本技能用于指导编码智能体通过 capability-runtime 落地业务能力,而不是绕过它去直接拼接上游框架。

默认心智模型:

skill / agent / workflow -> Runtime public surface -> NodeReport / host summary / service surfaces

自包含约束

本技能是一个自包含技能:

  • 只允许引用当前技能目录内的 references/evals/
  • 不允许把 docs/examples/tests/help/README.md 等外部仓库路径写成技能依赖
  • 如需补充 capability-runtime 的新事实,先复制或整理到本技能目录,再在技能正文中引用

开场动作

  1. 先确认当前 Python 环境是否已经可导入 capability_runtime
  2. 若还不能导入,优先使用 PyPI 安装;只有本地源码开发或 monorepo 场景,才改用 editable install。
  3. 只在临时验证时使用 PYTHONPATH 兜底,不要把它当长期交付方案。
  4. 能导入之后再继续看 references/triad-and-routing.mdreferences/api-reference.md,不要一边猜环境一边写业务代码。

本地环境准备

如果是本地源码开发,再记本地仓库目录为 CAPRT_REPO_ROOT

export CAPRT_REPO_ROOT=/abs/path/to/capability-runtime

先做 import 预检:

python3 -c "import capability_runtime; print('capability_runtime import ok')"

如果导入失败,优先使用 PyPI 安装:

pip install capability-runtime

如果你正在改本地源码,或仓库是 monorepo / 需要跟随未发布改动,再对包含 pyproject.toml 的本地源码目录做 editable install:

pip install -e "$CAPRT_REPO_ROOT"

如果仓库是 monorepo,pyproject.toml 不在根目录,就把上面的路径改成实际 Python 包目录。

只做临时验证时,才使用 PYTHONPATH 兜底:

export PYTHONPATH="$CAPRT_REPO_ROOT${PYTHONPATH:+:$PYTHONPATH}"
python3 -c "import capability_runtime; print('capability_runtime import ok')"

继续前,至少完成一个 smoke check:

python3 -c "from capability_runtime import Runtime, RuntimeConfig; print('caprt api ok')"

何时使用

当任务目标符合下面任一情形时,优先使用本技能:

  • capability-runtime 新建业务 capability、agent、workflow、service 接口或离线回归样例
  • 把已有业务 skills、Agent 壳、Workflow 编排统一收敛到 Runtime public surface
  • 需要 Runtime.run() / run_stream() / run_structured() / run_structured_stream()
  • 需要 NodeReport、descriptor、host summary 作为程序判断或审计真相源
  • 需要 RuntimeServiceFacade / RuntimeSession 做 service/session continuity 落地
  • 需要 invoke_capability、approval/waiting-human、resume、legacy host convergence

不要使用

下面这些情况不应触发本技能:

  • 普通通用编码,与 capability-runtime 无关
  • 只改 prompt,不关心 Runtime、测试、注册、NodeReport 或执行链路
  • 想直接学习上游原生框架 API,例如 Agently/TriggerFlow 的原生写法
  • 明确要求绕过 capability-runtime,直接把 provider SDK 或上游框架接进业务主流程
  • 明确要求“直接用 skills-runtime-sdk / Agently / provider SDK 完成业务”,并且不需要 AgentSpec / WorkflowSpec / Runtime

Read the full file on GitHub · 539 lines

Files

What ships with it

8 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 539 lines · 258 tokens per session scan A 16f0345f5a89

Subscribe to this mod's changes

bf-caprt-dev is a skill published in the GitHub repository okwinds/miscellany (50 stars, last pushed 3mo ago), licensed MIT. It adds 258 tokens to every session and 5,849 once invoked, about $0.0013 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.