Home / ccdawn / codex-skills · skills/engineering/briefbound-skill-authoring/SKILL.md · GitHub

briefbound-skill-authoring skillA

briefbound-skill-authoring is agent-read markdown (skill) from ccdawn/codex-skills: Use when adding, changing, or removing a skill in the Briefbound package itself: contract structure, routing anchors, catalogs, test cases, validator budgets, and install refresh; do not use for ordinary project features or general documentation work..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Briefbound Skill Authoring

## 目标

让技能包自身的增、改、删保持一致:契约结构、路由可达、目录登记、用例覆盖、预算不越线、校验全绿。它只维护技能包,不实现业务功能。

## Briefbound task contract

- Context Boundary: 目标技能与动机、触发/排除语义、与相邻 owner 的边界、允许写入的包内路径。
- Output Contract: 技能目录(SKILL.md、agents/openai.yaml、按需 references/)、全部锚点同步、测试用例、预算登记和校验结果。
- Allowed Action: 修改 `skills/`、`tests/`、`scripts/`、`.claude-plugin/plugin.json`、README 与桶 README;不动无关技能内容。
- Success Evidence: `validate_briefbound_skills.py --repo-root .` 退出码 0;新旧技能在 routing_cases 各有正/负用例;徽章计数与实际技能数一致。
- Stop Condition: 设计分歧需用户拍板、router 预算无法在不破坏语义下腾出、或改动会破坏既有 pinned markers。
- Route Out: 包外实现工作回对应工程 owner;已验证残留 `briefbound-development-cleanup`;`briefbound-router` 或 BLOCKED。

## 统一调用契约

- 只处理 Briefbound task contract 范围;复合任务不吞其他 owner。
- 用户可见内容默认中文,先说技能定位与边界,再报锚点清单与校验结果;Route Out 仅以 Briefbound task contract 为准,有自然闸门时末行 `下一步建议: <一个具体动作>`,否则继续已授权工作。

## 激活闸门

请求对象是技能包本身的技能新增、修改、删除或结构变更时进入。给业务项目写 prompt、文档或配置不适用本 skill。

## 契约结构

每个技能必须满足校验器的结构规则:

- `SKILL.md` frontmatter:`name`、英文 `description`(Use when…/do not use…)、`license: MIT`。
- 恰好一条 `- Route Out:`(任务契约内);输出示例中的 Route Out 只能写 `Route Out: <沿用 Briefbound task contract>`。
…

Read the whole file at its exact version.

How to install

Latest version
mdr add ccdawn/codex-skills/briefbound-skill-authoring@git:20260920.b6f2d18
Exact content
mdr add ccdawn/codex-skills/briefbound-skill-authoring@sha256:22f677819693b06f

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_4a2tjxfxyxtmoztv.svg)](https://markdownregistry.com/a/art_4a2tjxfxyxtmoztv)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260920.b6f2d18 latest2026-09-20 b6f2d18 4,543 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4543 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ccdawn/codex-skills · 6 stars · license MIT · pushed 2026-09-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_4a2tjxfxyxtmoztv
GET https://markdownregistry.com/api/v1/resolve?ref=ccdawn/codex-skills/briefbound-skill-authoring
GET https://markdownregistry.com/api/v1/blob/22f677819693b06fe469451bab23b0f9cd980fffdad388202f240a9e7eab9cb0

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from ccdawn/codex-skills

AGENTS.md agents
ccdawn/codex-skills · AGENTS.md
git:20260813.dec1d14 · audit A · 6 stars
CLAUDE.md claude
ccdawn/codex-skills · CLAUDE.md
git:20260813.dec1d14 · audit A · 6 stars
briefbound-huawei-nslb-score-loop skill
ccdawn/codex-skills · skills/competition/briefbound-huawei-nslb-score-loop/SKILL.md · Use when a Huawei Algorithm Challenge 37 NSLB workspace needs live status, adaptive solver search, comparable…
git:20260916.292b0ac · audit A · 6 stars
briefbound-score-loop skill
ccdawn/codex-skills · skills/competition/briefbound-score-loop/SKILL.md · Use when repeated work is governed by an explicit metric, active baseline, candidate search, promotion rule…
git:20260916.292b0ac · audit A · 6 stars
briefbound-creative-toolbox skill
ccdawn/codex-skills · skills/creative/briefbound-creative-toolbox/SKILL.md · Use when the user wants non-obvious but useful ideas, concept invention, naming, reframing, variation, selection…
git:20260916.292b0ac · audit A · 6 stars
briefbound-diagram-design skill
ccdawn/codex-skills · skills/creative/briefbound-diagram-design/SKILL.md · Use when creating or redrawing structured diagrams such as architecture, flowcharts, sequences, ER/UML, timelines or…
git:20260916.ed1d50d · audit A · 6 stars
briefbound-api-contract skill
ccdawn/codex-skills · skills/engineering/briefbound-api-contract/SKILL.md · Use when a change touches an external contract surface - REST/GraphQL endpoints, request/response schemas, DB schema…
git:20260920.280b6d2 · audit A · 6 stars
briefbound-autonomous-collaboration-loop skill
ccdawn/codex-skills · skills/engineering/briefbound-autonomous-collaboration-loop/SKILL.md · Use when the user explicitly enables an automated same-project multi-thread development loop that keeps peer Codex…
git:20260919.ae05288 · audit A · 6 stars
briefbound-bdd-tdd-development skill
ccdawn/codex-skills · skills/engineering/briefbound-bdd-tdd-development/SKILL.md · Use when an already-defined new behavior or high-risk implementation contract needs a failing test before…
git:20260916.292b0ac · audit A · 6 stars
briefbound-bug-review skill
ccdawn/codex-skills · skills/engineering/briefbound-bug-review/SKILL.md · Use when an observed bug, correctness regression, failing test, build failure, abnormal behavior, or unresolved root…
git:20260916.292b0ac · audit A · 6 stars
briefbound-code-structure-guard skill
ccdawn/codex-skills · skills/engineering/briefbound-code-structure-guard/SKILL.md · Use when active development or explicit refactoring has concrete code-structure risk: a source file is accumulating…
git:20260916.292b0ac · audit A · 6 stars
briefbound-design-system skill
ccdawn/codex-skills · skills/engineering/briefbound-design-system/SKILL.md · Use when a frontend task primarily concerns cross-component design tokens, semantic theming, component APIs, variants…
git:20260916.292b0ac · audit A · 6 stars

Every file in ccdawn/codex-skills

Browse by kind, by grade A, or by owner.