Skills

Axiom Explainer

Write Chinese Markdown articles for university students and adults with social...

Install

npx skills add digoal/blog --skill axiom-explainer -g -a claude-code -y
Repository
digoal/blog8.6k
Category
Git and review
Updated
3d ago
License
GPL-2.0
Context cost
Mediumabout 3,000 tokens
Runs scripts
No, instructions only

What it does

Write Chinese Markdown articles for university students and adults with social experience that explain one viewpoint, axiom, theorem, law, principle, or theory system through "求真讲法、求存讲法、思考", with text/Mermaid and standalone GitHub-renderable SVG files, assumptions, derivation or motivation, applicability boundaries, positive and negative examples, and save the result under the current project's markdown directory. Use when Codex is asked to generate 公理讲解文案、定理讲解、理论体系通俗解读、观点拆解、面向大学生和成年人的图文并茂 Markdown 文章.

Axiom Explainer

Overview

Generate a clear Chinese teaching article for university students and adults with social experience from a single viewpoint, axiom, theorem, law, principle, or theory system. The output must be Markdown, visually rich, and saved under the current project's markdown/ directory.

Input Contract

Required input:

  • One target concept: a viewpoint, axiom, theorem, law, principle, or theory system.

Optional input:

  • Audience level. Default: university students and adults with social experience.
  • Desired length. Default: 1800-3000 Chinese characters.
  • Source material or references supplied by the user.
  • Output filename or topic slug.

If the user gives several concepts, choose the central one only when the concepts clearly form one theory chain. Otherwise ask the user to pick one concept before writing.

Workflow

  1. Identify the input type:

    • Axiom or postulate: explain that it is not proven inside the system. Describe why people choose it, what problem it solves, what assumptions it introduces, and what changes if it is replaced.
    • Theorem or proposition: trace the axioms, definitions, lemmas, and reasoning chain that support it. Give an intuitive proof first, then a concise formal skeleton when useful.
    • Viewpoint, law, principle, or theory system: rewrite it as claims plus assumptions, then explain its evidence chain, mechanism, scope, and failure cases.
  2. Scope the audience:

    • Default to university students and adults with social experience unless the user specifies another level.
    • Use concrete analogies before abstract notation.
    • Prefer examples from investment and personal finance, product management, product operations, marketing, interpersonal relationships, and workplace scenarios unless the concept or user request clearly calls for another domain.
    • Define specialized terms at first use.
    • State any simplifications made for readability.
Read the whole SKILL.md on GitHub

More in Git and review