Agent skill

X Made Easy Skill

by baibanbao in baibanbao/x-made-easy-skill

仿 Silvanus Thompson《Calculus Made Easy》(1910) 的教学精神,写作或修订一本"轻松学"小书:先除恐,再用白话、贴身例子和渐进练习教会读者。也用于把外部教材融入已有小书,并校对正文和插图文字。产出分章 Markdown(00 目录+分章+99 结语附录),附自检脚本,可合成 PDF。当用户说"轻松学""Made Easy…

MITAuto-check passedDocuments & Office

Install X Made Easy Skill

skills CLI
$ npx skills add baibanbao/x-made-easy-skill --skill x-made-easy-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install baibanbao/x-made-easy-skill x-made-easy-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
x-made-easy-skill
GitHub stars
174
Token cost
~773 tokens
SKILL.md length
144 words
Files
11 (incl. scripts, references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

仿 Silvanus Thompson《Calculus Made Easy》(1910) 的教学精神,写作或修订一本"轻松学"小书:先除恐,再用白话、贴身例子和渐进练习教会读者。也用于把外部教材融入已有小书,并校对正文和插图文字。产出分章 Markdown(00 目录+分章+99 结语附录),附自检脚本,可合成 PDF。当用户说"轻松学""Made Easy…

  • Works in 3 steps: 是"驱除恐惧",不是写教科书。… → 事实核查,绝不捏造。… → 守用户级写作约束。…
  • Tasks that involve PDF
  • SKILL.md covers 铁律(最重要,先读这三条), 工作流, 修订已有小书时 and 每章五段式(雷打不动), plus 3 more sections
  • Runs Shell and Python scripts from its folder; calls python3

What it does

X Made Easy Skill is an agent skill from baibanbao/x-made-easy-skill. 仿 Silvanus Thompson《Calculus Made Easy》(1910) 的教学精神,写作或修订一本"轻松学"小书:先除恐,再用白话、贴身例子和渐进练习教会读者。也用于把外部教材融入已有小书,并校对正文和插图文字。产出分章 Markdown(00 目录+分章+99 结语附录),附自检脚本,可合成 PDF。当用户说"轻松学""Made Easy 风格""仿《微积分入门》/《Calculus Made Easy》写本书""用这种风格教我 X""把 X 写成一本入门小书""x-made-easy",或用英文说 "X Made Easy" 时使用。不要用于普通问答、单篇文章或非教学性写作。

Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts and reference files (for example `CHANGELOG.md`, `README.md` and `references/pdf-build.md`).

It sits in Documents & Office, covering PDF. The repository describes itself as: A Chinese Made Easy writing skill inspired by Calculus Made Easy. The licence is MIT.

When your agent uses it

  • Tasks that involve PDF

Example prompts

  • “Made Easy 风格”
  • “仿《微积分入门》/《Calculus Made Easy》写本书”
  • “用这种风格教我 X”
  • “/x-made-easy-skill”

Requirements

  • Python 3
  • A Bash shell

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 是"驱除恐惧",不是写教科书。 全书第一目的是把读者从对术语、符号、"我没天赋"的恐惧里解救出来。先除恐,再讲规矩。
  2. 事实核查,绝不捏造。 例题与事实必须真实、正确,凡数值都要验算;真实经典内容标"经典/民间/经典题型",自己编的标"自编"——绝不给例题安假的"某年某竞赛/某文献"出处。有参考资料时忠实转述其事实,不替它编数字或日期。核不了的,标【待核】,不猜。简化可以,说错不行:抄了近路就记…
  3. 守用户级写作约束。 中文;不堆排比;不用感叹号;不说"总的来说";不说"显然""易知""不难看出"——这是汤普森骂的那种书的口头禅;不用官方陈词滥调与模糊措辞;用比喻要新鲜;浅白易明。用户用别的语言提问时,跟着用户的语言写,规矩照旧。

What it can do on your machine

Read from SKILL.md and the folder at commit 3af3680. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Shell and Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

X Made Easy Skill loads about 773 tokens when it runs, and up to ~6.2k if it reads all its reference files. Until then it costs about 80 tokens; SKILL.md has 144 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~773
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from baibanbao/x-made-easy-skill at commit 3af3680, republished under its MIT licence (© baibanbao). 144 words, ~773 tokens.

Download SKILL.mdSave it as .claude/skills/x-made-easy-skill/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.
name
x-made-easy-skill
description
仿 Silvanus Thompson《Calculus Made Easy》(1910) 的教学精神,写作或修订一本"轻松学"小书:先除恐,再用白话、贴身例子和渐进练习教会读者。也用于把外部教材融入已有小书,并校对正文和插图文字。产出分章 Markdown(00 目录+分章+99 结语附录),附自检脚本,可合成 PDF。当用户说"轻松学""Made Easy 风格""仿《微积分入门》/《Calculus Made Easy》写本书""用这种风格教我 X""把 X 写成一本入门小书""x-made-easy",或用英文说 "X Made Easy" 时使用。不要用于普通问答、单篇文章或非教学性写作。

X Made Easy("轻松学"系列书写作技能)

把用户指定的任意主题(奥数、某软件、某理论、某门手艺……)写成一本仿汤普森《Calculus Made Easy》风格的教学书:完整骨架、分章 Markdown、可合成 PDF。适合把一门看似吓人的知识,整理成一本可逐章推进的"轻松学"小书。

铁律(最重要,先读这三条)

  1. 是"驱除恐惧",不是写教科书。 全书第一目的是把读者从对术语、符号、"我没天赋"的恐惧里解救出来。先除恐,再讲规矩。
  2. 事实核查,绝不捏造。 例题与事实必须真实、正确,凡数值都要验算;真实经典内容标"经典/民间/经典题型",自己编的标"自编"——绝不给例题安假的"某年某竞赛/某文献"出处。有参考资料时忠实转述其事实,不替它编数字或日期。核不了的,标【待核】,不猜。简化可以,说错不行:抄了近路就记账,账在附录里结(见 references/style-guide.md 第六节)。
  3. 守用户级写作约束。 中文;不堆排比;不用感叹号;不说"总的来说";不说"显然""易知""不难看出"——这是汤普森骂的那种书的口头禅;不用官方陈词滥调与模糊措辞;用比喻要新鲜;浅白易明。用户用别的语言提问时,跟着用户的语言写,规矩照旧。

工作流

  • 第 1 步 摸清读者怕什么。 动笔前弄清三件事:读者是谁(现在会什么);读者怕什么(列出 5–10 个最吓人的术语、符号或场面,这张"恐惧清单"就是第 1 章的原料);学完能亲手做成哪件事(贯穿例子的终点)。用户没说的,先合理假设,写进 00 的"关于这本书",供用户核对。用户给了参考资料(PDF/网页/书),先读懂,以它为事实来源,不臆造。
  • 第 2 步 先出骨架。 新书先写 00-目录与体例.md:书名(仿 "X Made Easy" → "X轻松学")、四部式结构、每章一个"除恐"主旨、难度标注约定、出处标注规矩。篇幅按主题定:小册子 6–9 章,标准本 12–20 章,别为凑数加章。可用样章及早检验风格和深浅;用户已要求完整成书时,继续完成已授权的写作,不为等待中途确认而停下。
  • 第 3 步 逐章写或修订。 新章按下面的"五段式"讲清一个概念,讲完就用,用熟再走下一章。修订已有书稿时沿用原书骨架,不因外部教材另起一套目录。每写完或改完一章,跑一次自检:python3 scripts/check_book.py 书文件夹(路径相对本 skill 目录)。报"错"的改掉再往下写;报"提醒"的逐条看,有理由就留着。
  • 第 4 步 写 99-结语与附录.md。 包含:练法/用法、术语小词典、一页纸速查、各章工具速查、练习答案、"我们抄过的近路"(每处简化说清:省了什么、严格版在哪)、出处与难度说明(落实铁律 2)。可加一节"给行家的话",学汤普森的尾声:先认下行家会嫌它不严谨,再说为什么这样写。
  • 第 5 步 逐字校对并核对交付版本。 自检脚本只查部分体例和禁词,查不出病句、动作矛盾或图文不符。通读正文、练习和答案;有图时连同图中文字、图注及替代文字一起核对。若有纯文字版、网页或下载文件,确认各版内容一致。细则见 外部教材融合与校对。
  • 第 6 步(可选)合成 PDF。 一条命令:scripts/build_pdf.sh 书文件夹 书名(网页路线,要 pandoc 和 Chrome/Chromium/Edge)。要 LaTeX 精排,或者脚本出了问题,看 references/pdf-build.md,那里有两条路线的完整命令和踩过的坑。

修订已有小书时

用户给了教材、截图或论文,要求补进已有书稿时,先读 外部教材融合与校对。提取能帮助读者跨过具体难处的知识、练习和图意,放进原书合适的章节;不要按资料页序拼贴,也不要把易学的练习压缩成一句口令。保留原书的读者定位、章节骨架和用户要求的交付形式。

每章五段式(雷打不动)

  1. 开篇除恐:先点破这一章让人怕的东西,承诺这一章替读者卸掉它。第 1 章可以直说"让你怕的不是难,是它穿的那身西装";之后每章换一个切口。别拿序号开篇("第三件工具是……"),那是在报目录,不是在除恐。
  2. 白话化:每个术语先给一个脑子里能看见的画面(比喻/日常类比),再讲规矩。
  3. 直觉先行:先用小孩也懂的办法或小情形切入,再上严格证明/定义。说清此刻哪些细节可以先不管,什么时候才要管。
  4. 例子贴身:两个以上,标难度(☼ 热身 / ☼☼ 正经 / ☼☼☼ 硬骨头);真题标出处,自编标"自编";教"怎么想到的",不只给答案。章末留 2–4 道练习,答案统一放附录,汤普森原书就是这样。
  5. 收尾:列"这一章要带走的东西"要点,最后单独一句"就这样。"

风格 DNA 与目录模板

汤普森原书的几句原话(据 1914 年第二版逐字核对)、开篇句式、"可以不管"的写法、比喻纪律、抄近路记账、章名写法、难度符号、四部式目录模板,详见 references/style-guide.md。写每一章前先扫一眼它。

产物落地

  • 每本书一个独立文件夹(如 ~/X轻松学/)。
  • 文件命名:00-目录与体例.md、01-章名.md … 99-结语与附录.md;两位数字前缀保证排序正确(10–16 排在 01–09 之后、99 之前)。自检和合成 PDF 都只认这种文件名,别的 .md 会被跳过。
  • 贯穿全书用一个真实、贴近读者的例子,跨数章逐步搭起来(如奥数书的"七件工具"逐件登场;Git 书把一个真实小项目从第一次提交带到第一次合并)。

例子

用户说:"用《Calculus Made Easy》这种风格写一本教我做 X 的书。" 你应当:弄清读者、恐惧清单和学完要做成的事(必要的假设写明)→ 读懂 X 的素材 → 写 00-目录与体例 → 逐章按五段式写,每章跑自检 → 写结语附录(含练习答案、近路账、出处说明)→ 逐字校对 → 按用户要求交付,需要时合成 PDF。 结果:一本结构完整、风格统一、事实可靠、可出 PDF 的"X轻松学"。

© baibanbao, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 10 other files (scripts, references) in the repository root of baibanbao/x-made-easy-skill.

  • SKILL.md
  • .gitignore
  • CHANGELOG.md
  • LICENSE
  • README.md
  • references/pdf-build.md
  • references/source-integration-and-copyedit.md
  • references/style-guide.md
  • scripts/book.css
  • scripts/build_pdf.sh
  • scripts/check_book.py

Open the folder on GitHubat commit 3af3680

Compare with similar skills

X Made Easy Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

X Made Easy Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
X Made Easy Skill this skillbaibanbao/x-made-easy-skill174—~773Automated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Gzh Designisjiamu/gzh-design-skill4k—~2.2kAutomated safety check: PassAGPL-3.0
GenOffice Document CLIgenspark-ai/genoffice9.2k—~19kAutomated safety check: PassApache-2.0
Harness Book Best Practicewquguru/harness-books3.2k—~4.1kAutomated safety check: PassNone
Bookforge Korean Ebook PDF Makergongnyang/bookforge3161 repos~1.7kAutomated safety check: PassMIT

Similar skills

  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    4k GitHub stars~2.2k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • GenOffice Document CLI

    genspark-ai/genoffice

    Creates, converts, reads and edits real pptx, xlsx, docx and PDF files locally through the genoffice command line.

    9.2k GitHub stars~19k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Harness Book Best Practice

    wquguru/harness-books

    Best practices for working on the Harness books repo. An agent skill from wquguru/harness-books.

    3.2k GitHub stars~4.1k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Produces book-style Korean ebook PDFs from a topic or finished manuscript, with six design styles, real book parts and quality-check gates before output.

    316 GitHub starsUsed in 1 repo~1.7k tokens
    Documents & OfficeAuto-check passed
  • Instrument Data To Allotrope

    aws-samples/amazon-bedrock-agents-healthcare-lifesciences

    Official

    Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV.

    274 GitHub starsUsed in 2 repos~2.7k tokens
    Documents & OfficeAuto-check passed

Questions about X Made Easy Skill

What does X Made Easy Skill do?

仿 Silvanus Thompson《Calculus Made Easy》(1910) 的教学精神,写作或修订一本"轻松学"小书:先除恐,再用白话、贴身例子和渐进练习教会读者。也用于把外部教材融入已有小书,并校对正文和插图文字。产出分章 Markdown(00 目录+分章+99 结语附录),附自检脚本,可合成 PDF。当用户说"轻松学""Made Easy…. X Made Easy Skill is an agent skill from baibanbao/x-made-easy-skill.

When should I use X Made Easy Skill?

X Made Easy Skill fits situations like: tasks that involve PDF.

How do I install X Made Easy Skill in Claude Code?

Run `npx skills add baibanbao/x-made-easy-skill --skill x-made-easy-skill -a claude-code`. Or copy the skill folder (the baibanbao/x-made-easy-skill repository) into .claude/skills/x-made-easy-skill in your project. Claude Code loads it when a task matches its description.

How do I install X Made Easy Skill in Codex?

Run `npx skills add baibanbao/x-made-easy-skill --skill x-made-easy-skill -a codex`. Or copy the skill folder (the baibanbao/x-made-easy-skill repository) into .agents/skills/x-made-easy-skill in your project. Codex loads it when a task matches its description.

Can I use X Made Easy Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add baibanbao/x-made-easy-skill --skill x-made-easy-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/x-made-easy-skill, .gemini/skills/x-made-easy-skill, .github/skills/x-made-easy-skill and .opencode/skills/x-made-easy-skill in your project.

What does X Made Easy Skill need to run?

Going by SKILL.md and its folder, X Made Easy Skill needs a shell and Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3; A Bash shell.

Does X Made Easy Skill access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is X Made Easy Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does X Made Easy Skill use?

X Made Easy Skill is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does X Made Easy Skill use?

About 773 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.4k tokens, read only when the agent opens those files.

What are the alternatives to X Made Easy Skill?

Skills that share tags, products or a category with X Made Easy Skill: Markitdown (ImCa0/just-laws, 781 stars), Gzh Design (isjiamu/gzh-design-skill, 4k stars), GenOffice Document CLI (genspark-ai/genoffice, 9.2k stars) and Harness Book Best Practice (wquguru/harness-books, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains X Made Easy Skill?

baibanbao (a GitHub user) maintains it in baibanbao/x-made-easy-skill, which has 174 GitHub stars. The repository was last updated on September 24, 2026.

Source: baibanbao/x-made-easy-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.