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.

In plain words
What is it for?
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.
Why use it?
It gives agents a shared source of rules, reducing accidental changes to unrelated systems, unsafe handling of credentials or Git worktrees, and incomplete verification.

Instructions file for CodexOpenCode

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 instructions/voidtechnology/voidtech-claude-plugins/agents-md
Clone the repo
git clone --depth 1 https://github.com/VoidTechnology/voidtech-claude-plugins

Made for: Codex, OpenCode.

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. 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.00995 $0.00995
Opus 5 $0.00498 $0.00498
Sonnet 5 $0.00199 $0.00199
Haiku 4.5 $0.00100 $0.00100

Measured yesterday against content hash c4166119a7c1, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, 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 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.

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.mddocs/USAGE.md 和相关 ADR。

通用工作流程

  1. 明确用户、问题、成功标准和明确不做的范围。
  2. 先读实际实现、测试和专项规则,不依赖文档猜测现状。
  3. 采用独立短期分支或 worktree,保护用户已有改动。
  4. 先写能暴露风险的测试,再做最小实现。
  5. 能由代码、schema、状态机或 guard 保证的行为,不交给 Prompt 自由判断。
  6. 按路径运行定向检查,再运行仓库质量门。
  7. 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.

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

Related

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.

openai/codex · 5,182 tokens

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

microsoft/vscode · 6,785 tokens

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.

vercel/next.js · 7,296 tokens

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

microsoft/vscode · 5,001 tokens

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.

github/spec-kit · 7,040 tokens

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.

langchain-ai/langchain · 4,345 tokens