What is voidtech-claude-plugins AGENTS.md?

A set of repository instructions for coding agents working on VoidTechnology's Claude plugins and marketplace. It defines which files and workflows belong in the repository.

Use it when maintaining plugins, skills, agents, hooks, marketplace entries, or repository automation. It points agents to the right rules and minimum quality checks for each kind of change.

It gives agents a shared source of rules, reducing accidental changes to unrelated systems, unsafe handling of credentials or Git worktrees, and incomplete verification.

How VoidTechnology/voidtech-claude-plugins configures Codex and OpenCo

Reuse

Borrowing it

Nothing to install: this file belongs to VoidTechnology/voidtech-claude-plugins. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/VoidTechnology/voidtech-claude-plugins/main/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/VoidTechnology/voidtech-claude-plugins

Made for: Codex, OpenCode.

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.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/voidtechnology/voidtech-claude-plugins/agents-md/github.svg)](https://agentmods.dev/instructions/voidtechnology/voidtech-claude-plugins/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/voidtechnology/voidtech-claude-plugins/agents-md"><img src="https://agentmods.dev/badge/instructions/voidtechnology/voidtech-claude-plugins/agents-md/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.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/voidtechnology/voidtech-claude-plugins/agents-md"><img src="https://agentmods.dev/badge/instructions/voidtechnology/voidtech-claude-plugins/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 995 This file is loaded in full into every session.

When invoked 995 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

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.

Model	Per session	Once invoked
Fable 5.1	$0.00995	$0.00995
Opus 5.5	$0.00398	$0.00398
Sonnet 5.5	$0.00199	$0.00199
Haiku 4.5	$0.00100	$0.00100

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

Security

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 1mo 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.

AGENTS.md · 86 lines

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

Read the full file on GitHub · 86 lines

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.

1mo ago First seen · 86 lines · 995 tokens per session scan A c4166119a7c1

Subscribe to this mod's changes

voidtech-claude-plugins AGENTS.md is an instructions file published in the GitHub repository VoidTechnology/voidtech-claude-plugins (2 stars, last pushed 5d ago), licensed Apache-2.0. It adds 995 tokens to every session, about $0.0040 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-31.

vscode buildNext.instructions.md

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

microsoft/vscode · 9,649 tokens

voidtech-claude-plugins: Instructions file for Codex