Agent skill

Ljg Writes

by lijigang in lijigang/ljg-skills

写作引擎。把一个观点写成可理解、可迁移、经得住反例的 1000-1500 字中文文章。USE WHEN 写文章 OR 优化思想内容 OR 展开观点 OR 改写成逻辑递进的中文。NOT FOR 普通摘要、事实查询或结构风洞(用 ljg-structure)。

MITAuto-check passed

Install Ljg Writes

skills CLI
$ npx skills add lijigang/ljg-skills --skill ljg-writes -a claude-code

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

GitHub CLI
$ gh skill install lijigang/ljg-skills ljg-writes --agent claude-code

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

Manual copy
$ git clone --depth 1 https://github.com/lijigang/ljg-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ljg-writes .claude/skills/ljg-writes && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

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

Facts

Skill name
ljg-writes
GitHub stars
7.5k
Token cost
~830 tokens
SKILL.md length
76 words
Files
2
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

写作引擎。把一个观点写成可理解、可迁移、经得住反例的 1000-1500 字中文文章。USE WHEN 写文章 OR 优化思想内容 OR 展开观点 OR 改写成逻辑递进的中文。NOT FOR 普通摘要、事实查询或结构风洞(用 ljg-structure)。

  • 写文章 OR 优化思想内容 OR 展开观点 OR 改写成逻辑递进的中文。NOT FOR 普通摘要、事实查询或结构风洞(用 ljg-structure)
  • SKILL.md covers Workflow Routing, 成文契约, 怎样解释一个观点 and 姿态与语言, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Ljg Writes is an agent skill from lijigang/ljg-skills. 写作引擎。把一个观点写成可理解、可迁移、经得住反例的 1000-1500 字中文文章。USE WHEN 写文章 OR 优化思想内容 OR 展开观点 OR 改写成逻辑递进的中文。NOT FOR 普通摘要、事实查询或结构风洞(用 ljg-structure)。

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `Workflows/WriteEssay.md`).

The licence is MIT.

When your agent uses it

  • 写文章 OR 优化思想内容 OR 展开观点 OR 改写成逻辑递进的中文。NOT FOR 普通摘要、事实查询或结构风洞(用 ljg-structure)

Example prompts

  • “/ljg-writes”

What it can do on your machine

Read from SKILL.md and the folder at commit 9e75497. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are org).

    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

Ljg Writes loads about 830 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 76 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~830

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from lijigang/ljg-skills at commit 9e75497, republished under its MIT licence (© lijigang). 76 words, ~830 tokens.

Download SKILL.mdSave it as .claude/skills/ljg-writes/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
ljg-writes
description
写作引擎。把一个观点写成可理解、可迁移、经得住反例的 1000-1500 字中文文章。USE WHEN 写文章 OR 优化思想内容 OR 展开观点 OR 改写成逻辑递进的中文。NOT FOR 普通摘要、事实查询或结构风洞(用 ljg-structure)。
user_invocable
true
version
8.0.1

写作引擎

把一个观点讲清楚,让一个具体的人读懂它为什么成立、能用在哪里。用容易理解的案例说明关键关系;需要引入抽象概念时,先交代它能解释什么。

Workflow Routing

WorkflowTriggerFile
WriteEssay写文章、优化思想内容、展开或重写观点Workflows/WriteEssay.md

执行时完整读取工作流。分析和检查在内部完成,正文按内容需要展开,不逐项展示写作步骤。

成文契约

一篇文章围绕一个核心判断展开。涉及的其他机制、反馈和限制,都应帮助说明或修正这个判断:

  • 概念可指认:关键的抽象词都能用普通话解释,并对应到具体事物或现象。
  • 关系可运行:读者能说清谁在什么条件下作用于谁,产生什么结果。
  • 案例可映射:场景中的角色、条件和因果关系能对应原观点。
  • 判断可迁移:换掉人物和材料,关系仍成立;同时能指出一个失效边界。

例子帮助读者理解;换一个场景、检查一个反例,才能看出他是否掌握了这个判断。以上四项用于内部检查,不直接用作文章目录。

正文必须给出足够线索,让那个具体的人读完后能够:指出关键概念在现实中指什么,复述「条件—机制—结果」,并说出一个适用的新场景或一个失效边界。内部分析得再充分,这些线索也需要写进文章。

怎样解释一个观点

优先选择一个容易理解、关键因果关系完整的案例。从读者可能已有的解释出发,检查它会怎样判断、预期什么结果。若它解释不了某一步、预测有误,或忽略了某种代价,就把这个具体问题说明白。

随后引入能解决当前问题的概念,用普通话说明它增加了什么区分,再回到同一个案例,看解释或判断发生了什么变化。还有解释不清的地方,再继续补充。先说明概念的意思和用处,需要准确指称时再给出术语。

text
具体案例 -> 原有解释 -> 解释不清的地方
         -> 引入所需概念 -> 重新分析案例
         -> 说明完整关系 -> 检查其他场景与边界

这条路径用于帮助分析。正文可以先说判断,也可以从案例展开;原有解释已经够用时,直接说明原因,不必安排一次失败。解释结束时,读者应能看清各概念之间的关系,以及它们如何支持或修正最初的判断。

姿态与语言

写得清楚、准确,语气平实。可以有自己的判断和节奏,不必句句用力。

  • 心里有一个具体的人,根据他的知识和文章用途选择说法。自然中文可以是口语,也可以是书面语;不要为了显得亲切,硬加聊天口吻。
  • 改写先保住原意、事实和语气。已经自然的句子可以保留;某个词不贴切时,先看它的意思、搭配和语气是否合适。换近义词仍然别扭,就按整句意思重新组织。
  • 简洁以意思完整、搭配自然为准。「讨论」不必一律改成「聊」;说明因果、条件和程度的词,该留就留。
  • 抽象表述让人费解时,写清谁做了什么、发生了什么变化。需要术语就准确使用;比喻应帮助理解,同一段不要混用几套比喻。计算机类比只在贴合问题、读者也熟悉时使用。
  • 表达判断时,直接说清主张,再说明理由和适用条件。判断在文章中的位置按内容决定,段落也可以用事实、动作或承接上文的句子起笔。避免用「不是……而是……」制造转折;事实否定、必要辨析和边界可以保留。
  • 句子长短服从意思。因果相连的内容可以放在一个完整句子里,需要停顿时再断开。连接词用来交代真实关系,不按词表一概删去,也不靠「因此」「更重要的是」替代推理。
  • 用具体内容说明理由,不宣告「接下来深入剖析」。少用连续排比、刻意对仗和每段末尾的警句;发现节奏反复时,重写整段,不按句式次数配额写作。
  • 不确定时,说明哪些有依据、哪些是推测、还缺什么信息。保留必要的「可能」「通常」「在这些条件下」;百分比需要数据、计算或明确的估计依据。
  • 第一人称经历只写真实材料,不编造亲历,也不替一个群体宣称共同感受。

最后检查

连起来读一遍:这像一个人把事情想清楚后写出的中文吗?词语是否贴切,句子是否顺畅,前后是否接得上?局部换词解决不了的问题,重写整句或整段。

再检查:读者能否用这个判断理解一件新事,并知道它有什么限制?

Gotchas

  • 继续分析应让解释更准确,或让适用条件更清楚。只换成更抽象的词,并没有增加理解。
  • 不为引出概念编造失败。原有解释的不足必须能在案例、材料或逻辑中找到;解释已经够用,就不要继续加概念。
  • 简化案例时保留关键反馈、时序和约束。删去某项会改变结论,就保留它或换一个案例。
  • 多个因素相互影响、同时发生或共同改变结果概率时,可以并排展示过程、列出状态变化,或使用两个相关案例,不强行写成先后相接的单线故事。
  • 案例说明关系如何发生,事实主张需要证据支持。案例中的角色与因果对应不上观点时,换掉它。
  • 一个案例讲得顺,不代表观点到处成立。需要用差异较大的场景和反例检查。
  • 正文应把关键关系说完整;「概念、关系、案例、迁移」等检查项目留在内部。
  • 观点已经清楚时,直接展开;不为追求深刻制造反问、翻转或悬念。
  • 用户只要短改、金句或标题时,按用户长度交付,保留核心意思和必要限定;不为凑齐长文流程额外添加案例或观点。

Examples

Example 1:把抽象观点写成文章

text
User: 「为什么越聪明的人越容易困在自己的解释里?写一篇。」
-> 用一个明确标为假设的会议场景,观察预测落空后,一个人如何解释结果
-> 检查「理由完整就说明理解深」是否成立:理由能否帮助他提前判断结果?
-> 需要时引入「可证伪性」,回到同一场景,说明什么结果会让他承认判断有误
-> 说明善于解释为什么可能使人更难放弃旧判断,再用其他场景和反例检查
-> 写成自然推进的文章,不输出分析表

Example 2:优化一段思想

text
User: 「预测是一种选择压,它逼出对结构的理解。帮我完整优化。」
-> 保住「预测如何暴露解释中的含混之处」这个意思
-> 比较事后解释与事前预测:说法能否修改,结果能否核对?
-> 加入一次有截止时间、判断标准明确的预测,说明哪些条件需要提前讲清
-> 说明预测怎样帮助筛选解释,再交代「选择压」这个类比成立的条件

输出约束

  • 总量默认 1000-1500 字;用户明确要短改、金句或标题时服从用户长度。
  • Org 加粗使用单星号,标题从 * 开始且不跳级。
  • 图表只用纯 ASCII 字符。
  • 取得两个时间值:date +%Y%m%dT%H%M%S 与 date "+%Y-%m-%d %a %H:%M"。
  • 文件名:~/Documents/notes/{时间戳}==z--{标题关键词}__write.org。
  • 文件头:
org
#+title:      {标题}
#+date:       [{YYYY-MM-DD Day HH:MM}]
#+filetags:   :write:
#+identifier: {YYYYMMDDTHHMMSS}
#+author:     李继刚
  • 初稿完成后,先检查观点与证据,再通读修改中文。按整段的意思和衔接选择表达,不把两稿的漂亮句子逐句拼接;只保存最终稿。
  • 保存后读回文件,验证 Denote 接受与 org-lint,再报告路径。

© lijigang, 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 1 other file in skills/ljg-writes of lijigang/ljg-skills.

  • SKILL.md
  • Workflows/WriteEssay.md

Open the folder on GitHubat commit 9e75497

Compare with similar skills

Ljg Writes 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.

Ljg Writes compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ljg Writes this skilllijigang/ljg-skills7.5k—~830Automated safety check: PassMIT
First 1000 UsersLeoYeAI/openclaw-master-skills2.2k—~4.1kAutomated safety check: PassMIT
Ljg Xray Articlelijigang/ljg-skill-xray-article130—~607Automated safety check: PassMIT
Paper Explainer for Non-Specialistslijigang/ljg-skill-paper138—~712Automated safety check: PassMIT
Video Downloadcalesthio/OpenMontage66k—~885Automated safety check: PassAGPL-3.0
Connect Apps with ComposioComposioHQ/awesome-claude-skills77k3 repos~557Automated safety check: PassNone

Similar skills

  • First 1000 Users

    LeoYeAI/openclaw-master-skills

    AI-powered Reddit seeding agent for founders. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~4.1k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed
  • Ljg Xray Article

    lijigang/ljg-skill-xray-article

    X-ray scans articles (blog posts, essays, opinion pieces) to extract the real question and cognitive collisions.

    130 GitHub stars~607 tokensUpdated 7 mo ago
    Writing & ContentAuto-check passed
  • Paper Explainer for Non-Specialists

    lijigang/ljg-skill-paper

    Explains a research paper to a non-specialist reader: what was studied, what was contributed, how the findings follow, and what the evidence does not establish.

    138 GitHub stars~712 tokensUpdated 7 mo ago
    Research & ScienceAuto-check passed
  • Video Download

    calesthio/OpenMontage

    Download video and audio from YouTube and 1000+ sites using yt-dlp.

    66k GitHub stars~885 tokensUpdated 6 days ago
    Media & CreativeAuto-check passed
  • Connect Apps with Composio

    ComposioHQ/awesome-claude-skills

    Connects an agent to 1000+ external apps through the Composio Tool Router plugin, so it can actually send emails, create issues and post messages instead of only drafting them.

    77k GitHub starsUsed in 3 repos~557 tokens
    Productivity & AutomationAuto-check passed
  • Onekgpd

    K-Dense-AI/scientific-agent-skills

    Queries the 1000 Genomes Project dataset (3,202 whole-genome-sequenced individuals, GRCh38) at the level of individual participants.

    48k GitHub starsUsed in 1 repo~5.6k tokens
    Research & ScienceAuto-check: notes

More from lijigang/ljg-skills

All 26 skills in this repo
  • Whole-Book Explainer Notes

    lijigang/ljg-skills

    Explains a whole book to someone who has not read it, keeping its specific content and showing how its threads connect, and saves the result as an Org note.

    7.5k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Ljg Paper

    lijigang/ljg-skills

    Explain research papers to readers without a specialist background: what the paper studies, what the authors contribute, how the findings follow, and what the evidence does not establish.

    7.5k GitHub stars~798 tokensUpdated yesterday
    Auto-check passed
  • Text to PNG Card Caster

    lijigang/ljg-skills

    Turns text, URLs or local files into tall PNG cards through HTML typography, with four modes: long reading card, full-text layout, comic and whiteboard.

    7.5k GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Turns a named classical Chinese chapter, such as one from the Tao Te Ching or the Analects, into a single annotated PNG image with notes and commentary.

    7.5k GitHub stars~551 tokensUpdated yesterday
    Auto-check passed
  • Constraint Engine

    lijigang/ljg-skills

    Finds the handful of constraints that truly define a domain, role, product or debate, grades each by hardness, and explains the behavior those constraints produce.

    7.5k GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Offline HTML Talk Decks

    lijigang/ljg-skills

    Builds single-file offline HTML talk decks from Org or Markdown outlines, with faithful layout or editorial condensing and keyboard navigation.

    7.5k GitHub stars~506 tokensUpdated yesterday
    Auto-check passed

Questions about Ljg Writes

What does Ljg Writes do?

写作引擎。把一个观点写成可理解、可迁移、经得住反例的 1000-1500 字中文文章。USE WHEN 写文章 OR 优化思想内容 OR 展开观点 OR 改写成逻辑递进的中文。NOT FOR 普通摘要、事实查询或结构风洞(用 ljg-structure)。. Ljg Writes is an agent skill from lijigang/ljg-skills.

When should I use Ljg Writes?

Ljg Writes fits situations like: 写文章 OR 优化思想内容 OR 展开观点 OR 改写成逻辑递进的中文。NOT FOR 普通摘要、事实查询或结构风洞(用 ljg-structure).

How do I install Ljg Writes in Claude Code?

Run `npx skills add lijigang/ljg-skills --skill ljg-writes -a claude-code`. Or copy the skill folder (skills/ljg-writes in lijigang/ljg-skills) into .claude/skills/ljg-writes in your project. Claude Code loads it when a task matches its description.

How do I install Ljg Writes in Codex?

Run `npx skills add lijigang/ljg-skills --skill ljg-writes -a codex`. Or copy the skill folder (skills/ljg-writes in lijigang/ljg-skills) into .agents/skills/ljg-writes in your project. Codex loads it when a task matches its description.

Can I use Ljg Writes 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 lijigang/ljg-skills --skill ljg-writes -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ljg-writes, .gemini/skills/ljg-writes, .github/skills/ljg-writes and .opencode/skills/ljg-writes in your project.

What does Ljg Writes need to run?

SKILL.md names no scripts, command-line tools or credentials: Ljg Writes is instructions for the agent only.

Does Ljg Writes 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 Ljg Writes 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. Review the folder before installing.

What licence does Ljg Writes use?

Ljg Writes is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ljg Writes use?

About 830 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ljg Writes?

Skills that share tags, products or a category with Ljg Writes: First 1000 Users (LeoYeAI/openclaw-master-skills, 2.2k stars), Ljg Xray Article (lijigang/ljg-skill-xray-article, 130 stars), Paper Explainer for Non-Specialists (lijigang/ljg-skill-paper, 138 stars) and Video Download (calesthio/OpenMontage, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ljg Writes?

lijigang (a GitHub user) maintains it in lijigang/ljg-skills, which has 7,481 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on October 8, 2026.

Source: lijigang/ljg-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.