develop-akashic-plugin

develop-akashic-plugin is a skill for Claude Code, Codex from kachofugetsu09/akashic-agent. It costs 75 tokens per session (1,163 once invoked), scanned A, original, MIT.

A development guide for creating and changing Akashic v3 plugins, which are add-ons that extend the Akashic system. It also covers the skills and tool connections inside those plugins.

In plain words
What is it for?
Use it to create a plugin, add a skill or tool connection, update an existing plugin, reload it, and verify that it works.
Why use it?
It provides the required file structure, configuration, and validation rules so plugin changes fit the current Akashic system. It helps avoid editing generated or installed copies instead of the source code.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to create a plugin, add a skill or tool connection, update an existing plugin, reload it, and verify that it works.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/kachofugetsu09/akashic-agent/develop-akashic-plugin
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.

Any agent
npx skills add kachofugetsu09/akashic-agent --skill develop-akashic-plugin
Clone the repo
git clone --depth 1 https://github.com/kachofugetsu09/akashic-agent

Made for: Claude Code, Codex.

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

agentmods badge for develop-akashic-plugin

README.md
[![agentmods](https://agentmods.dev/badge/skills/kachofugetsu09/akashic-agent/develop-akashic-plugin/github.svg)](https://agentmods.dev/skills/kachofugetsu09/akashic-agent/develop-akashic-plugin)
Your own site
<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.

agentmods 80×15 button for develop-akashic-plugin

Your own site · 80×15
<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>
Per session 75 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,163 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
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.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

Measured 24d ago against content hash e0d6f480f58c, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

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.

The scan reads SKILL.md. This mod also ships 3 executable files (templates/page/plugin.py, templates/page/web_module.js, templates/tool/plugin.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

skills/develop-akashic-plugin/SKILL.md · 54 lines

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。

流程

  1. 定目标和形态:要的是模型可调用的工具、WebUI 页面、Skill,还是后台服务?只做能交付的最小版本。
  2. 建源码仓库:在 $AKASHIC_WORKSPACE/plugin-src/<name>/ 新建目录并 git init。一个插件一个仓库,插件根目录必须有 plugin.py。
  3. 从模板起步:按下表用文件读取工具读模板,写一份到源码目录,改名字和逻辑。name 在当前实例里必须唯一。
  4. 只查需要的接口:按下面的知识来源顺序读真实代码,不凭记忆写 API。
  5. 提交并安装:git add -A && git commit,然后加载 verify-akashic-plugin,按它安装并验收。
  6. 修到能用为止:失败就改同一个插件,重新 commit、重新安装新的 commit。能用后汇报插件 ID、commit、验收证据和没验证到的部分,不追加没被要求的功能。

知识来源,按顺序

  1. 本 skill 的模板和 references/extension-points.md:先确定用哪个扩展点。
  2. 真实合同:先确认当前执行环境可读的 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/ 可读内置合同。 容器内路径不能直接当宿主路径;目录必须实际存在,找不到就报告缺少源码入口,不猜路径或复制过期合同。
  3. 同类的真实插件:找一个用同一 ServiceKey 的内置插件读它的 plugin.py。
  4. 当前源码仓库的 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 候选晋升都已退役。

Read the full file on GitHub · 54 lines

Files

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.

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. 24d ago Changed · +23 lines · +32 tokens per session e0d6f480f58c
  2. 1mo ago Changed · -95 lines · -11 tokens per session 7431cd396e61
  3. 2mo ago First seen · 126 lines · 54 tokens per session scan A 799368f5c152

Subscribe to this mod's changes

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.

Related

develop-akashic-plugin compared with skills from other repositories

develop-akashic-plugin next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
develop-akashic-pluginkachofugetsu09/akashic-agentSkill518todayMITA75Claude Code, Codex
imagegenopenai/codexSkill133kyesterdayApache-2.0A113Codex
playwright-climicrosoft/playwrightSkill99kyesterdayApache-2.0A19Claude Code
local-ai-agentsmicrosoft/ai-agents-for-beginnersSkill79k4d agoMITA200Claude Code, Codex
systematic-debuggingobra/superpowersSkill313k3d agoMITA21Claude Code
next-cache-components-adoptionvercel/next.jsSkill143ktodayMITA95Claude Code
next-partial-prefetching-adoptionvercel/next.jsSkill143ktodayMITA103Claude Code