Skip to content
Back to search

skills

AI Agent Skills for Chinese Knowledge Workers: iMandalArt, FIRE, planning, and publishing workflows for Claude Code, Codex, and LLM agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/twhsi--skills/badge.svg)](/listings/twhsi--skills)

HTML

<a href="/listings/twhsi--skills"><img src="/api/listings/twhsi--skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

From the repository root:

cp -R skills/fire-analysis-card ~/.codex/skills/
cp -R skills/thebrain-bird-address ~/.codex/skills/
cp -R skills/concise-key-points ~/.codex/skills/
cp -R skills/todays-daily-plan ~/.codex/skills/
cp -R skills/weekly-reverse-review ~/.codex/skills/
cp -R skills/imandalart ~/.codex/skills/
cp -R skills/keyword-graph-view ~/.codex/skills/
cp -R skills/a4-eight-page-booklet ~/.codex/skills/

Then validate a skill:

python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/fire-analysis-card

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 269 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # AI Agent Skills for Chinese Knowledge Workers
  2. > Three Kings 2.2: compress with iMandalArt, address with BIRD, and publish with an A4 eight-page booklet.
  3. iMandalArt, FIRE semantic analysis, planning, and publishing workflows for Claude Code, Codex, and mainstream LLM agents.
  4. [![Hermes All Skills Map](assets/hermes-all-skills-map.png)](assets/hermes-all-skills-map.png)
  5. This repository is TWHSI's public agent-skill system for Chinese knowledge workers. It turns repeatable writing, planning, note-making, and publishing workflows into skills that can be used by Claude Code, Codex, ChatGPT, Gemini, Hermes, and other LLM agents.
  6. The source of truth lives in `skills/*/SKILL.md`; [`skill-tree.json`](skill-tree.json) records the Three Kings relationship, and the website turns the skills into generated LLM manifests, a searchable index, install commands, revisions, and update timestamps.
  7. ## What This Repository Is
  8. `twhsi/skills` is an installable, shareable, LLM-readable skill registry. It turns long-running workflows for weekly review, iMandalArt, FIRE analysis, card-based notes, EPUB publishing, HyperCard returns, and desktop work into public procedures that agents can repeat and humans can inspect.
  9. The point is not to make humans behave like faster machines. The point is to let AI spend tokens on repetitive structure, while humans keep judgment, relationships, pace, and the quieter question:
  10. > Which action brings real happiness and peace?
  11. The flagship workflow is **Skills 三大天王 2.2**: [`imandalart`](skills/imandalart/) compresses a source, [`thebrain-bird-address`](skills/thebrain-bird-address/) gives every knowledge object an address and Route, and [`a4-eight-page-booklet`](skills/a4-eight-page-booklet/) returns the structure to a verified paper book.
  12. Live site: [https://www.twhsi.com/](https://www.twhsi.com/)
  13. Live Keyword Graph: [https://keyword-graph-view.twhsi.chatgpt.site/](https://keyword-graph-view.twhsi.chatgpt.site/)
  14. Agent manifest: [https://www.twhsi.com/agent.json](https://www.twhsi.com/agent.json)
  15. Skill index: [https://www.twhsi.com/skills.json](https://www.twhsi.com/skills.json)
  16. LLM context: [https://www.twhsi.com/llms.txt](https://www.twhsi.com/llms.txt)
  17. ## What It Does
  18. - Convert source material into iMandalArt 2.2 hard-line 9-grid cards.
  19. - Apply FIRE semantic analysis for card-box thinking, retrieval, and writing structure.
  20. - Turn permanent notes into BIRD 2.1 Book Addresses, structured Knowledge Indexes, Routes, verified Deep Links, Semantic Roles, and TheBrain manuscript scaffolds.
  21. - Compress answers with `concise-key-points`: reduce default length by 70% while retaining at least 95% of essential information.
  22. - Compile source material into a verified A4 one-sheet eight-page booklet, synchronized reading PDF, print imposition, and editable DOCX.
  23. - Generate agent-readable metadata through `agent.json`, `skills.json`, and `llms.txt`.
  24. - Route daily planning, weekly planning, booklet, EPUB, Markdown, and knowledge-management workflows.
  25. - Extract eight keywords and render a distributed weighted graph with definitions, evidence, and blacklist control.
  26. - Package Chinese-first workflows so LLM agents can operate on them consistently.
  27. ## Copyable Demo
  28. ```text
  29. Input: manuscript, notes, PDF, or long conversation
  30. Skills: imandalart 2.2 -> thebrain-bird-address 2.2 -> a4-eight-page-booklet 2.2
  31. Output: eight-angle index -> BIRD addresses and Routes -> reading PDF + print sheet + DOCX
  32. ```
  33. ## Skills 三大天王 2.2
  34. ```text
  35. 素材
  36. -> iMandalArt 2.2:一個中心、八個正交視角
  37. -> BIRD 拆書分析 2.2:Book Address、W+T+K+A、Route、Deep Link
  38. -> A4 八頁小書 2.2:八頁閱讀版、折頁列印版、可編輯 DOCX、驗證報告
  39. ```
  40. | Skill | Responsibility | Best use |
  41. |---|---|---|
  42. | [`iMandalArt 2.2`](skills/imandalart/) | 壓縮王:把混雜素材壓成中心與八個不重複視角。 | 每日計畫、章節總覽、64+8+1、手機九宮卡。 |
  43. | [`BIRD 拆書分析 2.2`](skills/thebrain-bird-address/) | 地址王:把主張變成可定位、可檢索、可跨章連結的知識節點。 | 拆書、TheBrain、Excel、Roam、Obsidian、書稿 Route。 |
  44. | [`A4 八頁小書 2.2`](skills/a4-eight-page-booklet/) | 出版王:把九宮概覽與七條 Routes 變成可讀、可印、可編輯的小書。 | A4 摺頁書、閱讀 PDF、紙本思考、教學與出版驗證。 |
  45. ### 2.2 New Functions
  46. - **Shared handoff**:中心、八角度、來源 ID、BIRD Address、Route 與引用一路保留到紙本。
  47. - **Seven-Route publishing**:第 1 頁放 iMandalArt 總覽,第 2–8 頁放七條 BIRD Routes。
  48. - **Backward compatibility**:BIRD 仍輸出 `BIRD-2.1`;小書仍讀取 `BookletManifest 2.0`。
  49. - **Machine-readable tree**:[`skill-tree.json`](skill-tree.json) 記錄三者的版本、成熟度、輸出與解鎖關係。
  50. ## Featured: Keyword Graph View
  51. [`keyword-graph-view`](skills/keyword-graph-view/) turns Chinese, English, or mixed text into a distributed network of exactly eight keywords. It removes blacklisted terms, weights co-occurrence edges from `W1` to `W9`, and gives every node a definition, note, and source evidence.
  52. Open the live tool: [keyword-graph-view.twhsi.chatgpt.site](https://keyword-graph-view.twhsi.chatgpt.site/)
  53. ## Featured: Weekly Reverse Review
  54. [`weekly-reverse-review`](skills/weekly-reverse-review/) turns an 11-step weekly review into an AI-assisted reverse planning loop.
  55. The skill reads four angles before writing the next week:
  56. - `YEAR`: annual plan and hundred-year life plan.
  57. - `Week`: last weekly plan and weekly review.
  58. - `Day`: daily plans, seven-day diary notes, and calendar evidence.
  59. - `Inbox`: loose tasks, reminders, subscriptions, errands, and collected noise.
  60. It then asks what should be smaller, slower, deleted, delayed, or kept as presence instead of achievement. The center question is:
  61. > Which action brings real happiness and peace?
  62. Default answer:
  63. > Speak less. Stay present. Move slowly.
  64. For an LLM or agent, start with:
  65. ```bash
  66. curl -s https://www.twhsi.com/llms.txt
  67. ```
  68. ## Deep Dive: iMandalArt 2.2
  69. [`imandalart`](skills/imandalart/) turns loose source material into one hard-line 3x3 Mandala index card.
  70. iMandalArt 2.2 is designed around a strict text contract:
  71. - Eight orthogonal surrounding angles labeled `Ⓐ` through `Ⓗ`.
  72. - A double center axis displayed as `◎◎◎◎◎`.
  73. - Exactly 11 physical text lines, so the card survives chat previews, note apps, and clipboard workflows.
  74. - Compact CJK-friendly cells for TheBrain/Cerebro, Hermes, Discord, Codex, and other LLM chat surfaces.
  75. Current status: iMandalArt 2.2 is optimized for CJK workflows, pure-text stability, の字型 identity preservation, and clean handoff to BIRD and booklet Routes.
  76. Conceptual example:
  77. ```text
  78. ⒶHealth Reset ⒷManuscript ⒸMoney Noise
  79. Move with care Pull one center Review first
  80. Build rhythm Draft before all Fund the work
  81. ⒹFamily Spark ◎◎◎◎◎ ⒺPeople Path
  82. Ask not lecture Weekly Review Keep three cards
  83. Walk the long ◎◎◎◎◎ Connect next
  84. ⒻInner Release ⒼLearning ⒽJoyful Rest
  85. Speak less Number lines Sing and loosen
  86. Prove nothing Build index Guitar and sun
  87. ```
  88. Use it for weekly planning, writing focus, knowledge capture, and CJK note workflows where visual stability matters as much as semantic compression.
  89. ## Deep Dive: BIRD and A4 2.2
  90. ### BIRD Book Deconstructor 2.2
  91. [`thebrain-bird-address`](skills/thebrain-bird-address/) turns manuscripts and permanent notes into addressable knowledge objects. The 2.2 Skill release applies the backward-compatible BIRD 2.1 protocol: `B = Book Address`, `I = Weight + Type + Keyword + Alias`, `R = Route`, and `D = exact Deep Link`, with optional evidence-based Semantic Roles. It supports Excel, TheBrain scaffolds, Roam JSON, monochrome double nine-grids, and a direct seven-Route booklet handoff.
  92. ### Supporting Skill: 言簡意賅|講重點|Concise
  93. [`concise-key-points`](skills/concise-key-points/) produces high-information-density answers: conclusion first, three to five key points, minimal repetition, and no unnecessary background. Its default target is 70% shorter while retaining at least 95% of essential information.
  94. ### A4 Eight Page Booklet 2.2
  95. [`a4-eight-page-booklet`](skills/a4-eight-page-booklet/) turns text, notes, images, BIRD Graph JSON, iMandalArt grids, 64+8+1 structures, FIRE material, daily plans, Bike or Bonsai outlines, templates, and PDFs into a printable, cuttable, and foldable eight-page booklet made from one A4 sheet.
  96. The skill does more than place content into eight panels. It separates content from layout, normalizes the source into `BookletManifest 2.0`, and generates every reading, printing, preview, and validation artifact from the same manifest.
  97. - Page 1 can hold the cover and overview. In BIRD or 64+8+1 mode, it contains one directory nine-grid and one keyword nine-grid.
  98. - Pages 2–8 can form seven Routes. Each page keeps one central claim, three to five concise points, and one ordered reading path.
  99. - iMandalArt spiral-order coordinates are preserved together with source IDs, BIRD Addresses, citations, and cross-route notes.
  100. - Outputs include eight upright A7 page PDFs, an eight-page reading PDF, an A4 landscape print imposition, an editable DOCX, preview images, and a validation report.
  101. - The fixed imposition order is `6, 7, 8, 1` upright on the top row and `5, 4, 3, 2` rotated 180 degrees on the bottom row.
  102. - Validation checks structure, typography, imposition, visual quality, Apple Pages compatibility, and source fidelity when required.
  103. Full skill specification and installation source: [`skills/a4-eight-page-booklet/SKILL.md`](skills/a4-eight-page-booklet/SKILL.md)
  104. ## What This Is
  105. - A GitHub-backed skill registry for Chinese agent workflows.
  106. - A machine-readable index for LLM agents that need routing, install commands, and resource discovery.
  107. - A human-readable map for deciding which workflows should become reusable skills.
  108. - A static website that publishes each skill's semantic version when declared, latest Git revision, and latest update time.
  109. ## Core Skill Stack
  110. | Skill | Role |
  111. |---|---|
  112. | [`imandalart`](skills/imandalart/) | iMandalArt 2.2 compression king: one center and eight orthogonal retrieval angles. |
  113. | [`fire-analysis-card`](skills/fire-analysis-card/) | Turn Chinese notes and manuscripts into FIRE semantic analysis cards. |
  114. | [`thebrain-bird-address`](skills/thebrain-bird-address/) | BIRD 2.2 address king: validated knowledge addresses, Routes, Excel, TheBrain, Roam, and printable indexes. |
  115. | [`concise-key-points`](skills/concise-key-points/) | Compress answers to the fewest useful words while retaining essential facts, constraints, and action items. |
  116. | [`todays-daily-plan`](skills/todays-daily-plan/) | Convert spoken planning notes into an Obsidian day-plan Mandala grid. |
  117. | [`weekly-reverse-review`](skills/weekly-reverse-review/) | Turn YEAR, Week, Day, and Inbox evidence into one happiness-and-peace-centered weekly plan. |
  118. | [`keyword-graph-view`](skills/keyword-graph-view/) | Extract eight keywords and build a centerless weighted network with node notes and evidence. |
  119. | [`a4-eight-page-booklet`](skills/a4-eight-page-booklet/) | A4 Booklet 2.2 publishing king: reading PDF, print imposition, editable DOCX, previews, and validation. |
  120. | [`project-note-json-to-epub`](skills/project-note-json-to-epub/) | Turn structured project-note JSON into EPUB and publishing outputs. |
  121. | [`markdown-nine-grid-clipboard`](skills/markdown-nine-grid-clipboard/) | Convert grids and cards into Markdown table workflows. |
  122. ## Current Metadata Highlight
  123. [`fire-analysis-card`](skills/fire-analysis-card/) is now on FIRE 2.0:
  124. - `F = Full-D`: stable numbering for temporary, permanent, and project notes.
  125. - `I = Index`: keyword webs and retrieval handles.
  126. - `R = Route`: thinking paths through the material.
  127. - `E = Evolution`: time-based card-box growth for semantic search.
  128. ## Skill Versions And Updates
  129. The live website generates freshness metadata from skill files and Git history on every deployment. Each skill entry includes:
  130. - `version`: the semantic skill version when declared, otherwise `Unversioned`
  131. - `revision` and `revision_short`: the latest Git commit for that skill path
  132. - `updated_at`: the latest update timestamp for that skill path
  133. Open the live generated table:
  134. - [https://www.twhsi.com/#updates](https://www.twhsi.com/#updates)
  135. - [https://www.twhsi.com/skills.json](https://www.twhsi.com/skills.json)
  136. Featured release check: iMandalArt, BIRD Book Deconstructor, and A4 Eight Page Booklet are presented together as **Skills 三大天王 2.2**. Their stable interchange formats remain backward compatible.
  137. [`thebrain-bird-address`](skills/thebrain-bird-address/) implements BIRD 2.1: `B = Book Address`, `I = Weight + Type + Keyword + Alias`, `R = Route`, and `D = exact Deep Link`, with optional evidence-based Semantic Roles. It complements FIRE by moving from reusable permanent notes into project notes, chapter structures, and book production.
  138. ## Registry Routes
  139. | Route | Purpose | Representative skills |
  140. |---|---|---|
  141. | Time | Daily focus, planning rhythm, calendar actions, weekly review, and long-range training loops. | `weekly-reverse-review`, `todays-daily-plan`, `imandalart`, `personal-athlete-81-grid`, `fantastical-calendar` |
  142. | Cards | FIRE analysis, BIRD book addresses, grid cards, Markdown tables, keyword graphs, and graph views. | `weekly-reverse-review`, `fire-analysis-card`, `thebrain-bird-address`, `markdown-nine-grid-clipboard`, `keyword-graph-view`, `obsidian-graph-view` |
  143. | LLM | Repeatable LLM workflows, structured inputs, scripts, and metadata. | `imandalart`, `thebrain-bird-address`, `a4-eight-page-booklet`, `project-note-json-to-epub` |
  144. | Desktop | Local Mac workflows, clipboard outputs, calendar bridges, and working-desk routines. | `fantastical-calendar`, `markdown-nine-grid-clipboard` |
  145. | Publish | BIRD manuscript scaffolds, booklets, EPUBs, HyperCard returns, and public GitHub publishing paths. | `thebrain-bird-address`, `a4-eight-page-booklet`, `project-note-json-to-epub`, `epub-hypercard-obsidian` |
  146. ## Core Files
  147. ```text
  148. assets/ public display assets
  149. skills/ installable skills for mainstream LLM workflows
  150. docs/ install notes, book links, and skill index
  151. examples/ sample inputs and outputs
  152. archive/ older drafts and retired skills
  153. Hermes.md system map and command file
  154. skill-tree.json Three Kings 2.2 machine-readable relationship map
  155. site/ static website source
  156. dist/ generated website output, ignored by git
  157. ```
  158. ## Install A Skill Locally
  159. From the repository root:
  160. ```bash
  161. cp -R skills/fire-analysis-card ~/.codex/skills/
  162. cp -R skills/thebrain-bird-address ~/.codex/skills/
  163. cp -R skills/concise-key-points ~/.codex/skills/
  164. cp -R skills/todays-daily-plan ~/.codex/skills/
  165. cp -R skills/weekly-reverse-review ~/.codex/skills/
  166. cp -R skills/imandalart ~/.codex/skills/
  167. cp -R skills/keyword-graph-view ~/.codex/skills/
  168. cp -R skills/a4-eight-page-booklet ~/.codex/skills/
  169. ```
  170. Then validate a skill:
  171. ```bash
  172. python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/fire-analysis-card
  173. ```
  174. ## Build The Website
  175. ```bash
  176. npm run build
  177. ```
  178. The build reads `skills/*/SKILL.md`, extracts frontmatter, detects declared versions, asks Git for latest per-skill revision timestamps, and writes:
  179. - `dist/agent.json`
  180. - `dist/skills.json`
  181. - `dist/llms.txt`
  182. - the static HTML/CSS/JS site
  183. Vercel configuration lives in [`vercel.json`](vercel.json): build command `npm run build`, output directory `dist`.
  184. ## Maintenance Rule
  185. When a skill changes, update the skill file first, run validation, rebuild the website, and push to `main`. The live site should always show the latest skill version, revision, and update time.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.