agentsclimarketplace

Briefing outline

Skill leoluyi/skills/skills/briefing-outline

My personal collection of portable SKILL.md agent skills and tooling for Claude Code, Cursor & Codex — currently focused on Traditional Chinese (Taiwan) writing, de-AI editing, and business docs.

Install
npx -y skills add leoluyi/skills --skill briefing-outline

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

說明提綱 (briefing outline) writing — distill detailed source material into one high-altitude overview that gives each part its purpose and essence, then points down for the detail. Source count is not the point: it works over several documents or one long report (pointing down to its sections). Use when the user wants to 整理/撰寫一份說明提綱, condense one or more sources into a navigable briefing for a 主管 or 委員會, summarise a long report into a high-altitude overview that points down for detail, or re-sync an existing 提綱 after its sources changed. Do NOT invoke to author a single formal document from scratch — 簽呈/會議紀錄/報告/專案規劃 (use formal-doc-structure), for RFP / 需求規格書 / 招標規格 (use rfp-writing), for lowering one term or passage to a non-technical audience (use plain-speak), or for pure language cleanup (use avoid-ai-writing-zh). This skill sits above the source material and points down into each part.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

12.0 KB, as published. Nobody here has run it

說明提綱 (Briefing Outline)

A 說明提綱 sits at a fixed altitude: high enough to see the whole body of source material at once, always pointing down to each source for the detail — where a source is a separate document, or a section of one long report. Its reader — a 主管 or 委員會 deciding direction — wants to grasp the whole and know where to drill, not re-read the sources. Every section carries enough essence to stand on its own, then hands off with 「(詳《source》)」.

The recurring failure is drift below altitude — dragging in 逐項標準、逐條規則、逐步操作、完整明細 that belong in the source. Hold altitude and the 提綱 stays readable and stable when sources churn.

Output Language

Match the language of the user's request, and apply it to all user-facing output — option labels, generated-document headings, table column names — not just prose. If the user explicitly asks for another language, that wins.

Language follows the request, not the source material. When the sources are in English but the user writes in Chinese, the 提綱 stays Chinese.

If the request is in Chinese, use Traditional Chinese (Taiwan business usage) and keep established technical terms in English.

The English in this file is structural labelling for you, not literal output. Never mirror this file's language into your response.

Steps

  1. Inventory the sources. List every source and one line on what each holds — a source being a separate document, or (for a single long report) one of its sections. Separate any umbrella overview (a peer 設立計畫/總說明, or the report's own 摘要/總則) from the detail sources: the umbrella lends the spine; the detail sources are what you point down to. Completion: every source accounted for.
  2. Fix reader and decision. One line: who reads this 提綱, to decide what. This sets the altitude for everything below (a decision-maker choosing direction needs 目的 and 關鍵數字, not 執行細則).
  3. Lay the spine. Order the top-level sections (一、二、三…) so they are MECE — 段落分明, each source's essence living in exactly one section (no overlap), the set together covering the whole. Default spine: the process or lifecycle the sources describe (each stage in the order it happens), else the umbrella's own structure. Open with one line naming the spine, and mark each bend with a short transition line that situates the sections about to follow. Place a governing or oversight section beside the phase it governs, not after phases it doesn't touch; only genuinely cross-cutting resourcing tails as an appendix. Completion: every source maps to exactly one section, or is deliberately folded into one.
  4. Draft each section purpose-first. Lead with the section's intent (目的/要驗證/要達成), then the essence, then point down with 「(詳《source》)」. Rewrite spec-voice into stakeholder-voice — turn a source's noun-list objective (「…之能力/功能/規格」) into a plain 「能做到〔動詞成果〕」 statement — and run the retained sentences through the plain-speak skill against the least-technical reader in the room (its repeat-test). Source already at altitude passes through; don't rewrite well-pitched material to rewrite it.
  5. Cut to altitude — per item, not a flat line. Give each item only the room it earns (see Altitude); collapse the rest to a label and point down. When one section is deliberately more granular than its siblings, say so rather than let it read as drift. This is the core editorial act — when in doubt, cut and point down.
  6. Apply house style. Conform the draft to the style reference below, then offer to run the avoid-ai-writing-zh skill on it as a deep de-AI pass (run it only if the user agrees).
  7. Verify. Run the draft through every gate in ## Verification below; each is pass/fail and a fail sends you back to the named step. When a change is important enough, cascade a brief mention into companion overview docs (e.g. a one-page 版). Completion: every gate passes.

Re-sync branch — a source document changed: identify the affected sections and re-run steps 4–7 for those only, including the cascade check in step 7.

Visual-emphasis branch — the 提綱 will be rendered (PDF/HTML) for a 主管 to read from or scan aloud: after step 7, optionally add a visual emphasis layer (sparse yellow keyword anchors, blue definitional fields, boxed labels, A/B/C on parallel groups). Applies only when the render pipeline's CSS carries the classes; sparse by default; skip entirely for plain-text delivery. See references/visual-emphasis.md (full working stylesheet: references/report.css).

Altitude: what stays, at what depth

Stays in the 提綱Points down to the source
目的、範圍、要驗證/要達成逐項標準、權重、門檻與區間
定義範圍/成本/成果/汰選的數字只用來調參的比例與細分數字
決策點、汰選與階段邏輯詳細判斷標準、逐條規則、SOP
一句話的成果/驗收方式完整內容、原始碼、設定檔、記錄檔範例
分類軸(如:門檻 vs 觀察)表格內的逐列明細

Two moves the table can't show:

  • Keep the container's dimensions, drop the payload. An artifact's dimensions (時長、項數、類型數) scope it at no cost and stay; its contents (逐題、逐條、逐項的內容) go down. A number survives by function, not size — it stays if it is or proves a decision, goes if it only parameterizes one.
  • Keep the schema, drop the rows. A below-altitude criteria table collapses to its classification axis in one sentence; the cells go down.

How much each item earns

Altitude is graduated. An item earns a paragraph only when it is:

  • non-obvious — the reader can't reconstruct it from its label (an unfamiliar procedure needs its flow spelled out, while a self-explanatory category name collapses to the bare label);
  • self-arguing — it carries a rationale that pre-empts the reader's likely objection; or
  • decision-bearing — it embeds a choice or policy the reader must approve.

Routine, self-describing, decision-free items collapse to a label + gloss. When an item is one of many interchangeable instances (a question, a case, a checklist row), the gloss encodes the discriminating point — what a good instance turns on — not the instance itself.

The 提綱 may also synthesize what the sources only imply: name a structure the sources leave implicit, compute a total they leave split (a sum the reader would otherwise add up), add a concrete tag that makes an abstract claim legible. Two cautions: every synthesized load-bearing number must still trace to a source, and recutting a source's own structure (its N buckets regrouped into your M) risks a visible mismatch — do it consciously.

House style

  • Traditional Chinese, Taiwan corporate / financial-institution register. Declarative and compressed; one idea per sentence.
  • Purpose-first framing on each section and bullet cluster: open with a label that names the intent, then the content — 「目的:…」「要驗證:…」「成果:…」 or whatever fits the material. The sentence-level lowering to a non-technical reader is plain-speak's job (step 4) — don't re-teach it here.
  • Flat over nested. Render multi-item essence as flat, purpose-labeled bullet clusters — not nested 槽狀 paragraphs or interwoven A-vs-B comparison prose. Flatness keeps the 提綱 scannable and lets a source change touch one bullet instead of unpicking a clause.
  • Cross-reference format 「(詳《檔名》)」, pointing down to detail docs only — never to the umbrella overview (that would be circular).
  • Tables for governance/structure — 階段/數量、組成、角色分工. Flat bullets for enumerable essence. Prose for the opening one-or-two-sentence essence.
  • Truncate long enumerations to anchor items + 「等」.
  • Top-level sections numbered 一、二、三; keep numbering stable across edits so references hold.
  • Lock owner-designated keywords verbatim. When the source's owner (主管/委員) has fixed specific technical keywords, carry them through unchanged even while rewriting the surrounding prose to altitude; fix only a typo, mis-set term, or technical/logic error, flag it, and confirm before removing or merging a keyword.
  • Lock shared terms across the source set. One canonical form per concept (課程類別、委員會職務、關卡名、機構/子公司名); change one, change all, so cross-references hold.
  • No emoji. Strip AI-isms (the avoid-ai-writing-zh pass in step 6 handles this).

Verification

Before declaring a 提綱 done, run every gate. Each is pass/fail; a fail sends you back to the named step. Verify by inspecting the draft against the sources, not from memory of what you intended.

  • Coverage (step 3) — every source maps to exactly one section; the umbrella lent the spine and is not pointed to. Any orphaned or double-covered source fails.
  • MECE (step 3) — no fact lives in two sections, and no section needs a back-reference to another to be understood.
  • Governance placement (step 3) — any oversight/governing section sits beside the phase it governs, not after phases it doesn't touch.
  • Altitude (step 5) — scan for below-altitude leakage (逐項配分、逐條標準、SOP、逐步操作、原始碼/設定/記錄檔、完整表格明細). Each hit is cut and pointed down, or the gate fails.
  • Earned depth (step 5) — each item's room matches what it earns; no self-describing label padded, no non-obvious or decision-bearing item starved. A section deliberately more granular than its siblings says so.
  • Traceability (step 4) — every claim and every load-bearing number, including synthesized ones (computed totals, regrouped structures), traces to a source. A load-bearing number with no anchor fails.
  • Pointer coverage (step 4) — cross-reference density tracks detail density: the heaviest sections each carry a 「(詳《source》)」, not just the light ones.
  • Voice & shape (steps 4, 6) — purpose-first labels present; essence is flat bullet clusters, not nested 槽狀 prose; retained sentences pass plain-speak's repeat-test; avoid-ai-writing-zh has been offered as a deep de-AI pass (run if the user accepts).

Worked example

For these moves applied end-to-end to a real 7-document set — with before/after snippets — see references/example.md. Load it only when you want to see the rules in action; skip it on a routine run.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.