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 agentmods add instructions/voidtechnology/voidtech-claude-plugins/agents-mdgit clone --depth 1 https://github.com/VoidTechnology/voidtech-claude-pluginsWhat 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 | $0.00995 | $0.00995 |
| Opus 5 | $0.00498 | $0.00498 |
| Sonnet 5 | $0.00199 | $0.00199 |
| Haiku 4.5 | $0.00100 | $0.00100 |
Grade A, and why
voidtech-claude-plugins AGENTS.md 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 yesterday.
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 — 86 lines — stays where its author put it; the contents beside it link to each section on GitHub.
VoidTech Claude Plugins:Agent 工作入口
本文件是维护本仓库时的 Agent 规则正本。
CLAUDE.md只引用本文件,不重复维护规则。
仓库边界
- 本仓库发布 Claude Code Marketplace、插件、仓库维护自动化和相关文档。
- 不修改 Claude Code 本体、外部 MCP 源码或使用本仓插件的下游项目。
- 开始前检查当前分支、worktree 和工作区状态;不覆盖、不回退已有改动。
- 未经用户明确授权,不 push、merge、发布、修改远端分支保护或删除数据。
规则索引
- 首次定位代码、判断文件归属前,读
docs/dev-rules/repo-map.md。 - 修改任何插件、Skill、Agent、Hook、MCP 或 Marketplace 清单前,读
docs/dev-rules/plugin-authoring-and-portability.md。 - 修改
voidtech-loop、Shell 执行、Git refs、worktree、protected paths、凭据或权限边界前,读docs/dev-rules/loop-security-boundaries.md。 - 准备提交、PR、Review 或处理并行工作区前,读
docs/dev-rules/development-workflow.md。 - 修改插件版本、README 版本表、CHANGELOG 或 GitHub Release 前,读
docs/dev-rules/release-and-versioning.md。 - 修改产品能力归属、用户工作流或公开命令前,先读
README.md、docs/USAGE.md和相关 ADR。
通用工作流程
- 明确用户、问题、成功标准和明确不做的范围。
- 先读实际实现、测试和专项规则,不依赖文档猜测现状。
- 采用独立短期分支或 worktree,保护用户已有改动。
- 先写能暴露风险的测试,再做最小实现。
- 能由代码、schema、状态机或 guard 保证的行为,不交给 Prompt 自由判断。
- 按路径运行定向检查,再运行仓库质量门。
- Review 完整 diff,如实报告已验证、未验证、风险和回滚方式。
最低验证
node scripts/run-quality.mjs --tier contract
node scripts/run-quality.mjs --tier unit
scripts/check-portability.sh
Renderer 变化追加:
node scripts/run-quality.mjs --tier browser
准备发布追加:
node scripts/run-quality.mjs --all
scripts/check-portability.sh --install-smoke
禁止通过删除测试、缩小发现范围、skip、放宽 schema 或把失败改成 warning 来制造通过。
插件与安全底线
- 会提交、推送、合并、发布或部署的 Skill 必须只能由用户显式触发。
- MCP 独立发布、默认禁用、固定精确版本;首次启用必须让用户审查权限。
- Hook 必须 fail closed,但不能拦截只读 Git 命令。
- Plugin Runtime 不依赖仓库 checkout、用户私有目录或未分发命令。
- 跨插件调用只指向 Marketplace 已发布的完整命名空间。
- 第三方内容必须保留来源、固定版本或 commit、许可证和修改说明。
- 不提交凭据、Token、授权文件、用户路径、用户数据或可识别个人的信息。
Git 与发布
- 默认 PR-first,
main始终可安装。 - 一个 PR 只解决一个目标;重构、行为变化和发布基础设施尽量分开。
- 插件安装内容变化必须提升对应
plugin.json版本,并同步 README 和 CHANGELOG。 - 自动化可以验证和准备 Release,但不得自行决定版本或触发发布。
EVALS_PASSED只表示指定 commit 通过约定 eval,不替代人工接受和合入。
事实来源
- 插件集合:
.claude-plugin/marketplace.json - 插件版本:
plugins/*/.claude-plugin/plugin.json - 公开 Skill / Agent:各插件的
skills/与agents/ - 测试覆盖清单:
scripts/quality-manifest.mjs - 发布历史:
CHANGELOG.md - 用户用法:
docs/USAGE.md
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.
- yesterday First seen · 86 lines · 995 tokens per session scan A c4166119a7c1
voidtech-claude-plugins AGENTS.md is an instructions file published in the GitHub repository VoidTechnology/voidtech-claude-plugins (2 stars, last pushed 28d ago), licensed Apache-2.0. It adds 995 tokens to every session, about $0.0050 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-31.
Other instructions, from other repositories
codex AGENTS.md
AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.
buildNext
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
Instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).
spec-kit AGENTS.md
Instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.
langchain AGENTS.md
Instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.