plain-speak

Solid

Translate technical jargon, code concepts, or dense engineering text into plain language a non-technical colleague or manager can follow. Use when the user asks to "explain in plain language", "白話文", "翻成人話", "用白話解釋", "explain like I'm a PM", "make this non-technical", "simplify this term", "what does this term mean", or pastes technical text and asks for a business-audience version, or asks you to review/check whether an existing plain-language draft lands for a non-technical reader ("這樣夠白話嗎", "幫我看 非技術主管看不看得懂", "is this clear enough for a PM"). Reply in the language the user wrote in. Do NOT invoke for removing AI-isms / 潤飾語氣 from existing prose (use avoid-ai-writing-zh), for structuring a whole formal business document — 簽呈/會議紀錄/報告 (use formal-doc-structure), or for RFP / 需求規格書 / 招標規格 (use rfp-writing). This skill lowers the audience, not the voice, the structure, or the document type.

AI & Automation 0 stars 0 forks Updated 6 days ago MIT

Install

View on GitHub

Quality Score: 78/100

Stars 20%
0
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Plain Speak — 技術術語轉白話文 Turn a technical term, snippet, or paragraph into something a **non-technical business reader** can follow. The reader is the anchor for every choice below, so the first move is always to pin down *who they are* — by default someone who knows the business and the product but not the stack, sharpened to the specific listener whenever the user names or implies one. Write only what survives the test *"could this person repeat it in a meeting?"* That test — the **repeat-test** — is the single bar this skill works against, in either of two modes: **translate** a technical thing into plain language, or **review** an existing plain-language draft against the bar and fix what fails. Both run the same criteria below; translate produces to them, review checks them. ## When this applies - A single term to define ("什麼是 idempotent", "explain eventual consistency") - A chunk of technical text to rewrite for a business audience - A code snippet or error the user wants explained in human terms - Prep for a status update, exec summary, or doc aimed at non-engineers - A finished plain-language draft to review — a colleague's, or your own — against the bar before it reaches the reader Sibling skills own the adjacent axes — hand off rather than half-do their job: lowering AI-ish *voice* in prose → `avoid-ai-writing-zh`; organizing a whole formal *document* → `formal-doc-structure`; an *RFP* → `rfp-writing`. ## Output Language Match the language of the user's req...

Details

Author
leoluyi
Repository
leoluyi/skills
Created
3 months ago
Last Updated
6 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

plain-language

Load this skill whenever the project involves writing, editing, or reviewing content for a general audience, including UI copy, help text, error messages, documentation, and instructions. Under no circumstances use jargon, complex sentence structures, or unexplained acronyms without providing plain alternatives. Absolutely always target a reading level accessible to the broadest possible audience. Load alongside content-design/SKILL.md for all content work.

35 Updated today
mgifford
AI & Automation Solid

knowledge-doc-writing

把自學或研究一個技術主題的成果,整理成一份包含四個清楚分離 Diátaxis 區塊的知識文件——tutorial(帶著上手)、 how-to(照著完成任務)、reference(查參數與結構)、explanation(What/Why 論述與取捨決策);用 compass 兩問把每段素材路由到對應區塊,素材撐得起才寫,撐不起的型(研究過但未實作常缺 tutorial/how-to)明列為缺口, 不捏造、不搭空殼(繁體中文為主、術語保留英文)。觸發:使用者要把對話紀錄、官方文件或原始資料、或從零研究的主題 (強制查一手來源並標 as-of 時效)消化成可長期參考的技術文件;或改寫一份既有技術文件——依意圖分流: 更新時效/��入新素材→定點修補保留原形,重整/重構→依 compass 重建四型區塊。可接在 learn-loop 之後: learn 管互動學習迴圈與親手 distillation(鐵律:distillation 是學習本身,不代寫), 本 skill 只接手 distill 完成後重新組織、補讀者上下文、套完稿檢查。不要用於:公司內部簽呈/會議紀錄/ 評估報告等行政文件(用 formal-doc-structure,即使輸入是既有文件也不因此轉入本 skill)、RFP/招標規格 (用 rfp-writing)、部落格文章(用 blog-writing-zh)、只做語言層去 AI 味不動結構(用 avoid-ai-writing-zh)、 只要口頭白話解釋不產文件(用 plain-speak)、learn 的互動學習迴圈本身(用 learn-loop)。

0 Updated 6 days ago
leoluyi
AI & Automation Listed

plain-write

说人话——把"给人看的东西"改成真人能一遍看懂的话。用户说"这太AI了/说人话/别端着/人家看不懂/全是黑话/太人机了/正常人不这么发微信",或任何对外文档/邮件/消息定稿前使用。核心:先分清写文档(往多了解释,陌生人冷读)还是给认识的人发消息(往少了砍,删括号注解/铺垫/客服腔),两套方向相反。English triggers - "this sounds so AI", "humanize this", "make it sound human", "de-AI my writing", "too robotic". Works on text in any language.

0 Updated 1 weeks ago
NovaKepler513