skills: Instructions file for Codex

AGENTS.md

skills AGENTS.md is an instructions file for Codex, OpenCode from huangwb8/skills. It costs 12,479 tokens per session, scanned A, original, MIT.

Project instructions stored in an AGENTS.md file for a repository that creates and maintains reusable AI-agent skills. They define directory boundaries, supported platforms, testing locations, temporary files, and the workflow for skill development.

In plain words
What is it for?
Use them when creating, updating, testing, or organizing skills and related files in the repository.
Why use it?
They help contributors place files correctly and keep skill packages, tests, documentation, and temporary work separated.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions Claude Code.

This is huangwb8/skills's own configuration. It tells Codex and OpenCode how to work on skills itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything skills configures →

Reuse

Borrowing it

Nothing to install: this file belongs to huangwb8/skills. 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/huangwb8/skills/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/huangwb8/skills

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.

agentmods badge for skills AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/huangwb8/skills/agents-md/github.svg)](https://agentmods.dev/instructions/huangwb8/skills/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/huangwb8/skills/agents-md"><img src="https://agentmods.dev/badge/instructions/huangwb8/skills/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.

agentmods 80×15 button for skills AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/huangwb8/skills/agents-md"><img src="https://agentmods.dev/badge/instructions/huangwb8/skills/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 12,479 This file is loaded in full into every session.
When invoked 12,479 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.12479 $0.12479
Opus 5.5 $0.04992 $0.04992
Sonnet 5.5 $0.02496 $0.02496
Haiku 4.5 $0.01248 $0.01248

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

Security

Grade A, and why

skills 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 · 449 lines

How it starts

The opening of the file, as written. The whole thing — 449 lines — stays where its author put it; the contents beside it link to each section on GitHub.

skills - 项目指令

本项目是 Agent Skills 开发流水线:用于创建、优化和维护高质量、可复用的 AI Agent Skills。所有技能遵循 Agent Skills 开放标准,确保在 Claude Code、OpenAI Codex、Cursor 等多个平台间"编写一次,随处使用"。

核心价值:

  • 提供标准化的技能开发框架和工作流
  • 确保技能质量(安全性、可靠性、通用性)
  • 支持有机迭代和持续优化

兼容平台:Claude Code、OpenAI Codex、Cursor、GitHub、VS Code、Amp、Letta、Goose(详见 Agent Skills 官方网站)。

目录结构与边界

  • skills/alpha/<skill-name>/:可发布、默认安装的成熟 Skill;以自身 SKILL.md 为识别边界,可包含专属的 scripts/、references/、templates/ 和资源文件。
  • skills/beta/<skill-name>/:尚未成熟的候选 Skill;不进入默认安装源,仅当用户显式指定 beta 源目录时才处理。
  • skills/alpha/auto-draw-plot/:该 Skill 属于 BenszAPI 生态,在 BenszAPI 源仓库的 skills/auto-draw-plot/ 协同开发。本项目不承担其功能开发、测试计划或日常维护,仅托管从外部开发源同步的最新可发布源代码,供公开发布与安装发现。除非人类明确表示要修改 auto-draw-plot 的源代码或源文件,否则严禁修改该目录及其内容。
  • packages/<project>/:独立运行时包边界,拥有自己的项目配置、版本、依赖和测试;不得在包内放置领域 Skill 流程。
  • docs/plans/:正式计划、迁移说明和治理文档;不得在 Skill 目录内新建 plans/。
  • tests/:面向 packages/ Python 包核心公开 API 及仓库级公开入口(如安装器)的可执行 smoke/integration 测试脚本;不承载测试计划、报告、artifacts、fixture 或运行缓存。
  • tmp/:测试脚本运行过程的临时承载目录,可包含测试计划、报告、artifacts、fixture 和日志;Python/pytest/Ruff 等运行缓存统一写入 .bensz-api/,不得回写到 tests/ 或 tmp/。
  • ./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/:本轮任务的输入、过程产物、日志和验证证据;正式交付物不写入其中。

目录职责规则:

  • 包内单元测试放在对应 packages/<project>/tests/;跨包或仓库公开入口测试脚本放在根级 tests/;测试运行产物统一写入根级 tmp/。
  • Skill 目录内不得新建历史计划、测试夹具或运行缓存目录。
  • AI 任务级中间材料遵循下方 .bensz-api 工作区协议。

Python 与工具运行产物归档

本仓库的标准开发与完整运行环境统一为 Python 3.11+;本地完整安装器和 bensz-skill-kernel 均不得声明或暗示支持更低版本。skills/alpha/install-bensz-skills/scripts/bootstrap_install.py 是唯一例外:它作为只依赖标准库的首次/应急远程引导入口,最低支持 Python 3.8,但这一兼容范围不扩展到本地完整安装器、Kernel 或仓库开发流程。Python 3.8–3.10 环境只能使用 bootstrap 安装生产 Skill;需要本地源码安装、开发或 Kernel 时必须升级到 Python 3.11+。

  • Python、pytest、Ruff、mypy、coverage、tox/nox、构建工具和新建/临时虚拟环境产生的运行产物必须集中放在当前项目的 .bensz-api/ 下,不得在仓库根目录或 packages/<project>/ 留下同类目录。
  • 重点包括但不限于:.ruff_cache/、.pytest_cache/、.mypy_cache/、__pycache__/、.tox/、.nox/、.coverage、coverage.xml、htmlcov/、*.egg-info/、临时 build//dist/、.venv/ 和 venv/。其中可复用的正式构建交付物仍按项目发布约定保存;已有且可能被用户维护的虚拟环境不得未经确认直接迁移,后续新环境统一使用 .bensz-api/.venv。
  • 仓库级 pytest 使用 .bensz-api/.pytest_cache;Ruff 使用 .bensz-api/.ruff_cache;包级配置不得回退到 packages/<project>/.pytest_cache 或 packages/<project>/.ruff_cache。
  • 脚本不得把上述路径硬编码到源码树;优先从项目根目录推导 .bensz-api,通过工具原生配置或子进程环境变量(如 RUFF_CACHE_DIR、PYTHONPYCACHEPREFIX)指定路径,并允许用户显式环境变量覆盖。
  • 已有历史缓存可安全清理或迁移;验证时应检查运行前后仓库源码目录没有新生成的缓存目录。

Read the full file on GitHub · 449 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. 1mo ago Changed · +1 lines · +88 tokens per session 92039b8146cb
  2. 1mo ago Changed · +29 lines · +1,348 tokens per session 4c7c0873d678
  3. 1mo ago Changed · +2 lines · +201 tokens per session e439b5bad74a
  4. 1mo ago Changed · +7 lines · +266 tokens per session 0c2ef7b62099
  5. 1mo ago Changed · +10 lines · +557 tokens per session 2de48c3c6688
  6. 1mo ago Changed · +49 lines · +1,389 tokens per session 084b2d9d35c6
  7. 1mo ago Changed · +11 lines · +387 tokens per session 644710dd1074
  8. 1mo ago First seen · 340 lines · 8,243 tokens per session scan A 5fbc2c744ab1

Subscribe to this mod's changes

skills AGENTS.md is an instructions file published in the GitHub repository huangwb8/skills (50 stars, last pushed 10d ago), licensed MIT. It adds 12,479 tokens to every session, about $0.0499 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

Other instructions, from other repositories

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,715 tokens

next.js AGENTS.md

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,461 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, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

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,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,731 tokens

deno copilot-instructions.md

Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.

denoland/deno · 3,077 tokens