awesome-dsh-plugin: Instructions file for Codex

AGENTS.md

awesome-dsh-plugin AGENTS.md is an instructions file for Codex, OpenCode from beancookie/awesome-dsh-plugin. It costs 2,209 tokens per session, scanned A, original, CC0-1.0.

Maintenance instructions for a curated list of DeepSeek Harness plugins, with Chinese and English README files as the only editable content sources. The website, data files and counts are generated automatically from those files.

In plain words
What is it for?
Use them when adding or reorganising plugins, updating descriptions, checking alphabetical order or rebuilding the website and its data.
Why use it?
They prevent manual edits to generated output and keep both language versions, categories and plugin ordering consistent.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions AGENTS.md.

This is beancookie/awesome-dsh-plugin's own configuration. It tells Codex and OpenCode how to work on awesome-dsh-plugin 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 awesome-dsh-plugin configures →

Reuse

Borrowing it

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

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 awesome-dsh-plugin AGENTS.md

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

Your own site · 80×15
<a href="https://agentmods.dev/instructions/beancookie/awesome-dsh-plugin/agents-md"><img src="https://agentmods.dev/badge/instructions/beancookie/awesome-dsh-plugin/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,209 This file is loaded in full into every session.
When invoked 2,209 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.02209 $0.02209
Opus 5.5 $0.00884 $0.00884
Sonnet 5.5 $0.00442 $0.00442
Haiku 4.5 $0.00221 $0.00221

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

Security

Grade A, and why

awesome-dsh-plugin 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 2mo 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 · 97 lines

How it starts

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

AGENTS.md

DeepSeek Harness(dsh)插件的精选列表(awesome list)。两个 README 是内容唯一来源,其余文件均由它们生成。

内容来源(source of truth)

  • README.md(中文,GitHub 默认展示)与 README.en.md(英文)是唯一需要手动编辑内容的文件。二者必须保持同步:插件集合相同、分类相同、每个插件各占一行。
  • 语言映射:site/locales.mjs 中 zh locale 的 readme 指向 README.md(中文内容)、en locale 指向 README.en.md(英文内容)——zh 是默认 locale(x-default),站点 / 为中文、/en/ 为英文。改动时保持这个映射。
  • docs/(生成的网站)、data/npm-map.json、data/added-dates.json、data/stars.json 都是自动生成的——切勿手动编辑。
  • 插件计数行由构建脚本自动改写(README.md 用 **N** 个插件、README.en.md 用 **N** plugins),不要手动改动。

目录结构(每个文件夹的作用)

  • site/ — 网站源码:template.html(页面骨架,含 CSS 样式与前端交互 JS,用 __TOKEN__ 占位)与 locales.mjs(语言与文案的唯一来源:分类名、标题、界面字符串)。build-site.mjs 据此生成页面。
  • scripts/ — 构建与探测脚本:build-site.mjs(解析两个 README,生成站点、data/ 产物,按 owner/repo 字母序规范化 README 并同步计数)、probe-npm.mjs(探测各仓库对应的 npm 包,写入缓存)、probe-stars.mjs(探测各仓库 GitHub Star 数,写入缓存;需联网)、check-order.mjs(离线 lint:校验两 README 分类内插件是否按字母序)、readme.mjs(共享的解析与排序键,供 build-site / check-order 复用)。
  • docs/ — 生成的网站(GitHub Pages 部署目录):index.html、各分类页、plugins.json、sitemap.xml、feed.xml、logo.png、badge.svg。自动生成,切勿手动编辑。
  • data/ — 自动生成的账本/缓存:npm-map.json(repo → npm 包映射)、stars.json(repo → GitHub Star 数与首次提交时间,供站点 Star/最新排序)与 added-dates.json(插件收录日期)。由脚本维护,切勿手动编辑。
  • images/ — 源素材:logo.png(站点与 README 使用的 logo 源文件)。
  • .github/ — GitHub 配置:workflows/build-site.yml(每 6 小时定时 + 推送 main 时自动构建并提交生成文件)、workflows/pr-check.yml(PR 时离线校验 README 排序)与 pull_request_template.md(PR 提交模板)。
  • .git/ — git 内部元数据,无需改动。

添加插件

每个插件占一行,由 scripts/build-site.mjs 中的严格正则解析:

- [owner/repo](https://github.com/owner/repo) - 以句号结尾的一句话描述。
  • URL 必须是 https://github.com/...,其他域名不会被解析。
  • 分类取自最近的 ### 标题,标题必须包含 site/locales.mjs(categories)中对应的分类名。共 11 个固定分类(ui、theme、session、memory、tools、skill、workflow、notify、model、dev、fun)——不要新增分类,除非同时更新 scripts/build-site.mjs 中的 CAT_IDS。
  • 必须在两个 README 的对应分类下各加同一行,否则 build-site.mjs 会报 missing: <url> 并失败。
  • 分隔符为 -(英文)或 —(中文),解析器两者都接受。
  • 分类内插件按 owner/repo 字母序(大小写不敏感)排列:scripts/build-site.mjs 每次构建会按此重排并回写两个 README,PR 经 scripts/check-order.mjs 校验。新行加在分类下任意位置即可,构建会自动排好。

Read the full file on GitHub · 97 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. 2mo ago First seen · 97 lines · 2,209 tokens per session scan A f8a242a04e99

Subscribe to this mod's changes

awesome-dsh-plugin AGENTS.md is an instructions file published in the GitHub repository beancookie/awesome-dsh-plugin (188 stars, last pushed today), licensed CC0-1.0. It adds 2,209 tokens to every session, about $0.0088 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

awesome-dsh-plugin AGENTS.md compared with instructions from other repositories

awesome-dsh-plugin AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
awesome-dsh-plugin AGENTS.mdbeancookie/awesome-dsh-pluginInstructions file188todayCC0-1.0A2,209Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149ktodayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file275k2d agoMITA4,313Codex, OpenCode