soia-open-skills: Instructions file for Codex

AGENTS.md

soia-open-skills AGENTS.md is an instructions file for Codex, OpenCode from soia-team/soia-open-skills. It costs 839 tokens per session, scanned A, original, MIT.

Repository-specific instructions for soia-team/soia-open-skills, a project that publishes shared resources for AI-agent skills. They describe the repository's purpose, safety rules, validation, and Git workflow.

In plain words
What is it for?
Use them when editing that repository, especially when adding or changing skills, documentation, catalog tools, routing data, or other published files.
Why use it?
They help an agent avoid committing private credentials, machine-specific paths, or unrelated project content. They also clarify which files belong in this repository and how changes should be checked.

Instructions file for CodexOpenCode

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

This is soia-team/soia-open-skills's own configuration. It tells Codex and OpenCode how to work on soia-open-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 soia-open-skills configures →

Reuse

Borrowing it

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

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

Your own site · 80×15
<a href="https://agentmods.dev/instructions/soia-team/soia-open-skills/agents-md"><img src="https://agentmods.dev/badge/instructions/soia-team/soia-open-skills/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 839 This file is loaded in full into every session.
When invoked 839 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.00839 $0.00839
Opus 5.5 $0.00336 $0.00336
Sonnet 5.5 $0.00168 $0.00168
Haiku 4.5 $0.00084 $0.00084

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

Security

Grade A, and why

soia-open-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 · 40 lines

What it actually says

soia-open-skills

公开技能仓:soia-meta-* 生态技能、共享规范与市场门户。客户不共享维护者的机器、账号和私有工作区;仓名不触发 SOIA 产品 proposal/board 流程。

边界

  • 不提交秘密、账号标识、私有 config/.env、机器绝对路径或家庭/健康/财务等上下文;示例用占位符。凭据留在官方登录态/密钥存储,不复制到普通日志。
  • 新配置写 ~/.config/soia-skills/<skill-name>/config.yml(v2),客户差异经参数、环境变量或非秘密配置传入;v1 只读迁移输入,不自动搬移/删除用户配置。
  • 已授权局部修改与相关验证连续完成,保留他人改动;派发、提交/合并、发布、安装、权限与重要删除各守本次授权,不从完成自检推导后续授权。

按需入口

  • 修改技能时读目标完整 SKILL.md;创建/改名/拆分/实质重构才读 技能规范 和模板。
  • 改 config/state/cache/temp/凭据/落盘回执时读 数据规范;普通文案不加载它。
  • 贡献或生命周期操作查 CONTRIBUTING.md对应章节;不批量读所有参考。
  • skills/README.md 是生成物;事实列表保持单一机器真源。技能正文承载跨宿主核心流程,供应商细节按需放 references。
  • 安装须明确 scope、宿主及技能/整域/全量;正式验收使用已发布远端,不将未发布 checkout 当正式安装。普通维护不安装。

验证

纯指令/文案检查差异、链接与条款一致性;行为变化运行受影响测试。技能行为、脚本、依赖或公共工具提交前执行下列门禁;正式集成/发布的 CI 必选项仍全部保留:

python3 -m unittest discover -s tests -p 'test_*.py'
python3 scripts/generate_skill_catalog.py --check
python3 scripts/audit_skills.py
git diff --check

缺依赖且环境安装已获准时才安装 requirements-dev;辅助 quick validator 不支持本仓扩展 frontmatter 时记录限制,不删除必需版本/作者/时间字段迁就它。

Git 与发布

  • 新分支默认从正式 main 开,PR 显式指向 dev;确实依赖未发布内容才从 dev 开并说明。合并需 audit 通过与本次许可。
  • 普通开发不直接 push main/dev,feature PR 不改插件列车版本。dev 带 -SNAPSHOT;main 保持正式版。
  • 正式发布须当次明确授权:定稿 PR → dev/CI,核对 main 是 dev 祖先及实际合并冲突,再仅快进 main、tag/Release、重开 SNAPSHOT、完成 pin。一个已批准计划内不逐命令重问;夹带未批准内容时暂停。
  • 本仓默认分支必须 main:市场中的 soia-meta 使用 source: ./、无 pin,默认 dev 会直达 SNAPSHOT。
  • 特例仅限已批准正式 pin 与对应生成说明页:可 PR → main,经 audit 与许可合并;不得夹带技能实现或 SNAPSHOT。其余 PR → dev。
  • 未批准无人值守市场刷新,不新增 PAT 或削弱分支保护来自动刷新;市场排期/P3/P4/D5-D8 按 Owner 当前计划核实,不在入口复制旧状态。
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 · -59 lines · -1,195 tokens per session 413cb3082ff7
  2. 1mo ago Changed · +6 lines · +709 tokens per session 5d9dc60fdd5c
  3. 1mo ago First seen · 93 lines · 1,325 tokens per session scan A a19d00dfdc2d

Subscribe to this mod's changes

soia-open-skills AGENTS.md is an instructions file published in the GitHub repository soia-team/soia-open-skills (5 stars, last pushed yesterday), licensed MIT. It adds 839 tokens to every session, about $0.0034 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.

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

deepseek-harness AGENTS.md

AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.

deepseek-ai/deepseek-harness · 4,261 tokens