skill-authoring-gate

skill-authoring-gate is a skill for Codex from hxy91819/mason-skills. It costs 65 tokens per session (684 once invoked), scanned A, original, MIT.

A required checklist for creating or changing a coding-agent skill. It covers how the skill is triggered, how its instructions and configuration should agree, and what checks to run before delivery.

In plain words
What is it for?
Use it when creating, moving, renaming, or changing a skill, its agent configuration, or related scripts and references.
Why use it?
It reduces the risk of a skill running at the wrong time, having conflicting settings, or being shipped with invalid instructions or formatting.

Skill for Codex

Written for Codex: agents/openai.yaml present. Also seen: mentions Codex; $skill-name invocation; mentions OpenCode.

Good fit Use it when creating, moving, renaming, or changing a skill, its agent configuration, or related scripts and references.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/hxy91819/mason-skills/skill-authoring-gate
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.

Any agent
npx skills add hxy91819/mason-skills --skill skill-authoring-gate
Clone the repo
git clone --depth 1 https://github.com/hxy91819/mason-skills

Made for: Codex.

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 skill-authoring-gate

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

Your own site · 80×15
<a href="https://agentmods.dev/skills/hxy91819/mason-skills/skill-authoring-gate"><img src="https://agentmods.dev/badge/skills/hxy91819/mason-skills/skill-authoring-gate.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 65 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 684 The whole file, excluding the scripts and references it only reads on demand.
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.00065 $0.00684
Opus 5 $0.00032 $0.00342
Sonnet 5 $0.00013 $0.00137
Haiku 4.5 $0.00006 $0.00068

Measured today against content hash 40b46630bf2c, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

skill-authoring-gate 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 today.

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.

common-skills/skill-authoring-gate/SKILL.md · 25 lines

What it actually says

Skill 编写门禁

开始编辑前

  1. 加载 ~/.agents/skills/writing-for-agents/SKILL.md;涉及 frontmatter、触发方式或 router 时,继续加载同目录的 SKILL-MECHANICS.md
  2. 加载 ~/.agents/skills/.system/skill-creator/SKILL.md;它是系统 skill,不是目标仓库的 skill。不要把"系统可能自动选中 Skill Creator"当作门禁,规则本身必须保证被执行。
  3. 先读取目标 SKILL.mdagents/openai.yaml(如果存在),按实际工作流判断默认触发类型,再修改内容与配置。
  4. SKILL.md frontmatter 的 description 是触发规则,不是功能介绍。只写用户请求或任务形状何时匹配;能力、角色、实现和本轮改动写进正文。改行为时默认保持 description 不变,除非触发条件本身变了。

分类与配置一致

  • 流程类 Skill(规划、审查、复盘、治理、发布、迁移、编排,或带审批、用户决策、明显副作用的多步流程):默认仅显式触发,同时设置 policy.allow_implicit_invocation: false、frontmatter disable-model-invocation: truetriggers: [user](Devin 的等效标记),三层都必须存在。用户通过宿主原生语法显式调用:Codex、Pi、OpenCode 用 $skill-name,Kimi 用 /skill:skill-name,Devin 用 /skill-name
  • 被动型 Skill(低风险的格式化、生成、查询或验证能力):默认允许隐式触发,设置 policy.allow_implicit_invocation: true,且不得遗留 disable-model-invocation: true
  • 无法明确分类或混合型 Skill:采用流程类的保守默认值;用户要改成允许隐式触发时,必须明确提出并说明风险与影响。

交付前

  • 运行 Skill validator、YAML 解析和 git diff --check;如果 validator 尚不识别兼容性的 disable-model-invocationtriggers 字段,记录该工具限制并补做 frontmatter 结构检查,不得为了让 validator 通过而删除流程类 Skill 的禁用标记。
  • 核对 description 仍是触发匹配,没有被改成能力说明书。
  • 向用户报告:分类、默认策略、判断依据、配置位置,以及显式触发 Skill 的 $skill-name 用法;用户明确意图与默认分类冲突时,以用户意图为准并说明。
Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. today Changed 40b46630bf2c
  2. 7d ago Changed · +2 lines d63de0294a40
  3. 8d ago First seen · 23 lines · 65 tokens per session scan A fd82632a7bb2

Subscribe to this mod's changes

skill-authoring-gate is a skill published in the GitHub repository hxy91819/mason-skills (2 stars, last pushed today), licensed MIT. It adds 65 tokens to every session and 684 once invoked, about $0.0003 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-09-04.

Related

Other skills, from other repositories

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

local-ai-agents

Build local-first AI agents that run entirely on a developer workstation with Microsoft Foundry Local and Qwen function-calling models. Covers Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG with Chroma, local MCP servers, hybrid cloud/local routing, and the…

microsoft/ai-agents-for-beginners · 200 tokens

next-cache-components-adoption

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…

vercel/next.js · 95 tokens

chat-pet-sprite-creation

Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.

microsoft/vscode · 53 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens

insight-error-page

Write or audit an insight-kind error page for the Next.js dev overlay. Use when creating a new errors/ .mdx page, auditing an existing one, or checking that a page matches the framework fix cards. Covers page structure, title alignment, FixCard cards with Copy prompt button, code snippets, terminology verification…

vercel/next.js · 83 tokens