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.
npx skills add kachofugetsu09/akashic-agent --skill develop-akashic-plugingit clone --depth 1 https://github.com/kachofugetsu09/akashic-agentWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/kachofugetsu09/akashic-agent/develop-akashic-plugin)<a href="https://agentmods.dev/skills/kachofugetsu09/akashic-agent/develop-akashic-plugin"><img src="https://agentmods.dev/badge/skills/kachofugetsu09/akashic-agent/develop-akashic-plugin/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/kachofugetsu09/akashic-agent/develop-akashic-plugin"><img src="https://agentmods.dev/badge/skills/kachofugetsu09/akashic-agent/develop-akashic-plugin.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00075 | $0.01163 |
| Opus 5.5 | $0.00030 | $0.00465 |
| Sonnet 5.5 | $0.00015 | $0.00233 |
| Haiku 4.5 | $0.00007 | $0.00116 |
Grade A, and why
develop-akashic-plugin 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 24d 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.
How it starts
The opening of the file, as written. The whole thing — 54 lines — stays where its author put it; the contents beside it link to each section on GitHub.
开发 Akashic 插件
插件是给自己加能力的唯一正式方式:写源码 → git commit → 安装到当前实例 → 实际用一次验收。
不要改安装 cache、plugin-home、runtime/ 下的指针或别的插件的 plugin-data,也不要手写 manifest。
流程
- 定目标和形态:要的是模型可调用的工具、WebUI 页面、Skill,还是后台服务?只做能交付的最小版本。
- 建源码仓库:在
$AKASHIC_WORKSPACE/plugin-src/<name>/新建目录并git init。一个插件一个仓库,插件根目录必须有plugin.py。 - 从模板起步:按下表用文件读取工具读模板,写一份到源码目录,改名字和逻辑。
name在当前实例里必须唯一。 - 只查需要的接口:按下面的知识来源顺序读真实代码,不凭记忆写 API。
- 提交并安装:
git add -A && git commit,然后加载verify-akashic-plugin,按它安装并验收。 - 修到能用为止:失败就改同一个插件,重新 commit、重新安装新的 commit。能用后汇报插件 ID、commit、验收证据和没验证到的部分,不追加没被要求的功能。
知识来源,按顺序
- 本 skill 的模板和
references/extension-points.md:先确定用哪个扩展点。 - 真实合同:先确认当前执行环境可读的 Core 和插件源码目录,再读
agent/plugin_composition/context.py与提供方的<插件名>/contract.py。 开发实例通常提供$AKASHIC_CORE_ROOT、$AKASHIC_PLUGIN_DISTRIBUTION/sources/;Host Bridge 宿主可能没有这两个变量, 此时从$PYTHONPATH列出的目录核对agent/plugin_composition/context.py,同一运行 checkout 的plugins/可读内置合同。 容器内路径不能直接当宿主路径;目录必须实际存在,找不到就报告缺少源码入口,不猜路径或复制过期合同。 - 同类的真实插件:找一个用同一 ServiceKey 的内置插件读它的
plugin.py。 - 当前源码仓库的
docs/INDEX.md是需求与设计入口;分发产物可能不带docs/。签名以真实合同为准,语义冲突要指出,不能用实现覆盖已确认需求。
load_skill 返回的 base_directory 就是本 skill 目录,下表路径都相对它:
| 用途 | 文件 |
|---|---|
| 扩展点速查:工具、Skill、页面、提示词材料、后台任务、配置与数据 | references/extension-points.md |
| WebUI 模块的硬性限制、挂载点、主题 token、亮暗主题 | references/web-ui.md |
| 工具插件模板(一个文件) | templates/tool/plugin.py |
| 页面插件模板(三个文件) | templates/page/plugin.py、templates/page/web_module.js、templates/page/web_module.css |
省步数
一轮最多约 40 次模型输出,开发控制在 15 次以内,留足验收和汇报。只读模板和真正要用的那一两个合同文件,不通读插件源码;
WebUI 页面读 references/web-ui.md 和 templates/page/ 就够了,不再去找 ui 合同、类型定义或别的页面插件。不要用单独的 python 去 import 插件做自测:
插件模块只有宿主加载器能导入,安装本身就是加载检查,失败原因看 plugin-status 的 error。
硬规则
- 唯一入口是
async def apply(ctx);api_version = 3、name、version写成顶层字面量。 - 依赖的服务写进
inject,用ctx.require(KEY)取。资源、监听、后台任务都交给ctx.effect/ctx.spawn管理, 不在 import 时启动进程、开端口或发消息。 - 配置读
ctx.config(没有配置时是空对象),自己校验;插件自己的持久数据只写ctx.data_root。 - 外部 Python 依赖写
requirements.txt,没有时不要假设第三方包已装。 - 不恢复已删除的旧协议:
class Plugin、apply(ctx, config)、is_active、skill_roots、TOML MCP 声明、plugin_latest、stable/latest 候选晋升都已退役。
What ships with it
6 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.
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.
- 24d ago Changed · +23 lines · +32 tokens per session e0d6f480f58c
- 1mo ago Changed · -95 lines · -11 tokens per session 7431cd396e61
- 2mo ago First seen · 126 lines · 54 tokens per session scan A 799368f5c152
develop-akashic-plugin is a skill published in the GitHub repository kachofugetsu09/akashic-agent (518 stars, last pushed today), licensed MIT. It adds 75 tokens to every session and 1,163 once invoked, about $0.0003 per session on Opus 5.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.
develop-akashic-plugin compared with skills from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| develop-akashic-pluginkachofugetsu09/akashic-agent | Skill | 518 | today | MIT | A | 75 | Claude Code, Codex |
| imagegenopenai/codex | Skill | 133k | yesterday | Apache-2.0 | A | 113 | Codex |
| playwright-climicrosoft/playwright | Skill | 99k | yesterday | Apache-2.0 | A | 19 | Claude Code |
| local-ai-agentsmicrosoft/ai-agents-for-beginners | Skill | 79k | 4d ago | MIT | A | 200 | Claude Code, Codex |
| systematic-debuggingobra/superpowers | Skill | 313k | 3d ago | MIT | A | 21 | Claude Code |
| next-cache-components-adoptionvercel/next.js | Skill | 143k | today | MIT | A | 95 | Claude Code |
| next-partial-prefetching-adoptionvercel/next.js | Skill | 143k | today | MIT | A | 103 | Claude Code |