About editorial-monograph
editorial-monograph is a document-design skill for formal long-form publications, with a runnable React/MDX starter workspace and design rules. It is intended for A4 proposals, white papers, research reports, and specifications, using structured chapters and numbered figures and tables.
Key features
- 01Runnable React/MDX document starter
- 02Chapter layout for long-form reading
- 03A4 pages and paginated table of contents
- 04Automatic figure and table numbering
- 05Configurable numbering and theme styles
Use cases
- 01Prepare a product proposal or business plan
- 02Structure a white paper or specification
- 03Lay out a long research report or monograph
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ quan0715/ open-press --skill editorial-monographAfter installing, type/editorial-monographin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
starter/package.openpress.jsonstarter/press/design.mdstarter/press/editorial-monograph/press.tsxstarter/press/editorial-monograph/chapters/01-product-and-use-cases/content/01-product-and-use-cases.mdxstarter/press/editorial-monograph/chapters/02-workflow/content/01-workflow.mdxstarter/press/editorial-monograph/chapters/03-agent-skills-contributors/content/01-agent-skills-contributors.mdxstarter/press/editorial-monograph/chapters/04-validation-deploy/content/01-validation-deploy.mdxstarter/press/editorial-monograph/components/Page.tsxstarter/press/editorial-monograph/components/ChapterOpenerVisual/index.tsxstarter/press/editorial-monograph/components/TokenSwatchGrid/index.tsxstarter/press/editorial-monograph/components/TypeSpecimen/index.tsxstarter/press/editorial-monograph/media/README.mdstarter/press/editorial-monograph/theme/fonts.cssREADME.mdtokens.cssstarter/press/editorial-monograph/theme/base/page-contract.cssprint.csstypography.cssstarter/press/editorial-monograph/theme/page-surfaces/back-cover.csschapter-opener.csscover.csstoc.cssDetails
From the project READMEEditorial Monograph
A document style for 嚴肅長文——日系簡約 + IBM Carbon hairline 風格的衍生,適合產品提案書、白皮書、研究報告、規格文件等需要 A4 印製、章節結構清楚、長段閱讀的場合。
This is a starter-bearing skill: it ships SKILL rules plus a runnable starter/ document workspace (React/MDX entry, theme, design doc, sample chapters). Use openpress to initialize the OpenPress runtime workspace; this skill owns the editorial starter files and design rules.
Visual Signature
- Type: serif 章首(Noto Serif TC / Source Han Serif TC)+ sans body(IBM Plex Sans / PingFang TC)
- Lines: 1px hairline + dotted underline for links;不用 box-shadow / gradient
- Color: 黑白灰主體 + 三色 status accent(warn / success / info)+ chart palette(gold / coral / dark)
- Layout: A4 固定版面、章首占整頁、TOC 帶頁碼但不顯示 footer、可選章節 mini cover、figure / table 自動編號
- Chapter numbering: default
01 / 02 / 2.1(pagination + CSS::before);可改一、二、(一)或Chapter 1 / §1.1,token 與 selector 在 starter 內theme/base/typography.css與design.md的 Typography Scale / Chapter & Section Numbering 段
Suitable For
- product proposal / business plan
- whitepaper / spec / requirements doc
- academic monograph / long-form research report
- editorial-format business report
Not Suitable For
- slide deck(沒有 bundled starter;自訂尺寸時改
config.page,不要把 A4 starter 當成投影片硬改 tokens) - poster / one-pager
- marketing landing page
Related Starters
claude-document— warmer paper, Claude-like rhythm. Choose it when the document is closer to a working brief / spec / note than a formal monograph.
Apply To A Workspace
Use openpress to initialize a target workspace, then copy or adapt this skill's
starter/press tree into the workspace. Then:
- Fill
title/subtitle/organizationon the<Press>props insidepress/<slug>/press.tsx. Mergestarter/package.openpress.jsoninto the workspacepackage.json's"openpress"field for deploy / pdf settings. - Ask
openpressto choose the validation/export/render commands needed to confirm the workspace is healthy. - Use
openpressfor the source-boundary decision; typical editable source areas arepress/<slug>/chapters/**/*.mdxfor content,press/<slug>/press.tsxfor cover/TOC/back-cover, andpress/<slug>/theme/tokens.cssorpress/shared/theme/tokens.cssfor visual tokens.
Page content rules (hierarchy, table captions, figure numbering, factual boundaries) live in openpress-create-pages; this skill does not redefine them.
Do / Don't
Do:
- 換 brand color:改
tokens.css內--openpress-chart-gold或新增--openpress-brand-accent - 換字體:改
--openpress-font-serif/--openpress-font-body的字體棧;需要跨 mobile / iPad 穩定時,同步更新theme/fonts.css載入 webfont,不要只靠local(...) - 加新 page kind(divider / appendix-cover):在
theme/page-surfaces/新增 CSS;已有chapter-opener可作書籍/教材章節 mini cover - 換編號樣式(一、二、 or §1.1):改
theme/base/typography.css的::before content,搭@counter-style - 改 page 尺寸(B5 / Letter / 投影片):改
press/<slug>/press.tsx內<Press page="...">的 prop;tokens.css只保留 theme defaults 與視覺 token
Don't:
- 不要把 inline emphasis color 改成自由色票(破壞語意系統);新狀態色票要先補
--openpress-status-*token 再用 - 不要在
theme/base/typography.css內放單一 chart / specimen 的 CSS(那是press/<slug>/components/<name>/的責任) - 不要為了 dense 內容把字級縮太小;A4 body 正文不應低於 9.5pt
- 不要把 hairline 改成 2px 以上實線;這個 starter 的氣質就靠線細
深入設計規則
editorial-monograph 不單獨維護一份 reference/ 文件——所有規格都寫在 starter/press/design.md 內,跟著 starter 一起拷貝到 workspace 後變成該專案的 design document:
- 第 1 節 風格目標與使用場景 — 目標 / 適用場景 / 角色定義
- 第 2 節 Tokens — typography / color / spacing / page geometry / inline emphasis / chapter & section numbering
- 第 3 節 Components — page surfaces / text components / tables / figures / charts
- 第 4 節 CSS 權責
Agent 套用 skill 後,這份檔案就成為該專案 press/design.md 的內容;之後 user 想客製,直接改 design.md,不用回頭改 skill。