Agent skill

Ljg Is

by lijigang in lijigang/ljg-skills

把一个名词或概念写成可使用的理解:先用普通话讲清它是什么、与相邻概念差在哪里,再说明它怎样运作、会改写什么判断,最后给出面对它时的行动抓手。USE WHEN 用户问 X 是什么、怎么理解、意味着什么、为什么重要、以后怎样判断或使用;尤其适合技术概念、制度、产品、角色、方法、规范与实践。NOT FOR 单纯查事实、公式证明、逐步操作教程、纵向因果深挖(用 ljg-think)或母题结构(用…

MITAuto-check passed

Install Ljg Is

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

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

GitHub CLI
$ gh skill install lijigang/ljg-skills ljg-is --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-is .claude/skills/ljg-is && 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-is
GitHub stars
7.5k
Token cost
~671 tokens
SKILL.md length
68 words
Files
7
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

把一个名词或概念写成可使用的理解:先用普通话讲清它是什么、与相邻概念差在哪里,再说明它怎样运作、会改写什么判断,最后给出面对它时的行动抓手。USE WHEN 用户问 X 是什么、怎么理解、意味着什么、为什么重要、以后怎样判断或使用;尤其适合技术概念、制度、产品、角色、方法、规范与实践。NOT FOR 单纯查事实、公式证明、逐步操作教程、纵向因果深挖(用 ljg-think)或母题结构(用…

  • 用户问 X 是什么、怎么理解、意味着什么、为什么重要、以后怎样判断或使用;尤其适合技术概念、制度、产品、角色、方法、规范与实践。NOT FOR 单纯查事实、公式证明、逐步操作教程、纵向因果深挖(用 ljg-think)或母题结构(用 ljg-structure)
  • SKILL.md covers Workflow Routing, 成品标准, 判断边界 and Gotchas, plus 1 more section
  • Runs TypeScript scripts from its folder

What it does

Ljg Is is an agent skill from lijigang/ljg-skills. 把一个名词或概念写成可使用的理解:先用普通话讲清它是什么、与相邻概念差在哪里,再说明它怎样运作、会改写什么判断,最后给出面对它时的行动抓手。USE WHEN 用户问 X 是什么、怎么理解、意味着什么、为什么重要、以后怎样判断或使用;尤其适合技术概念、制度、产品、角色、方法、规范与实践。NOT FOR 单纯查事实、公式证明、逐步操作教程、纵向因果深挖(用 ljg-think)或母题结构(用 ljg-structure)。

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files (for example `Tools/ValidateNote.help.md`, `Tools/ValidateNote.test.ts` and `Tools/ValidateNote.ts`).

The licence is MIT.

When your agent uses it

  • 用户问 X 是什么、怎么理解、意味着什么、为什么重要、以后怎样判断或使用;尤其适合技术概念、制度、产品、角色、方法、规范与实践。NOT FOR 单纯查事实、公式证明、逐步操作教程、纵向因果深挖(用 ljg-think)或母题结构(用 ljg-structure)

Example prompts

  • “/ljg-is”

Requirements

  • Node.js

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

    Ships script files (TypeScript), which the agent can run.

    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 Is loads about 671 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 68 words of instructions outside code blocks.

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

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). 68 words, ~671 tokens.

Download SKILL.mdSave it as .claude/skills/ljg-is/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
ljg-is
description
把一个名词或概念写成可使用的理解:先用普通话讲清它是什么、与相邻概念差在哪里,再说明它怎样运作、会改写什么判断,最后给出面对它时的行动抓手。USE WHEN 用户问 X 是什么、怎么理解、意味着什么、为什么重要、以后怎样判断或使用;尤其适合技术概念、制度、产品、角色、方法、规范与实践。NOT FOR 单纯查事实、公式证明、逐步操作教程、纵向因果深挖(用 ljg-think)或母题结构(用 ljg-structure)。
version
5.0.0
user_invocable
true

把一个名词讲到能用

只给定义,读者可能记住了词,却仍不知道怎样认出它。只讲动词,读者又可能知道它做了什么,却不清楚它究竟是哪一类东西、边界在哪里。

ljg-is 把两者接起来:名词回答「它是什么」,让概念在认知地图里站稳;动词回答「它怎样起作用」,让概念在现实里动起来。真正完成的理解还要继续走一步:它改写了读者原来的什么判断,下次遇到它时又能怎样行动。

text
它是什么,和什么不一样?
它靠什么动作产生结果?
知道这一点后,我不再怎样想?
下次遇到它,我先看什么、怎样做?

这四个问题是一条理解路径,不是四个正文栏目。文章要像一个人顺着疑惑把事情讲明白,而不是把答案依次填进表格。

赵汀阳的「动词」思想在这里仍然重要,但它是一副有条件的透镜。面对制度、平台、角色或规范,可以继续追问谁选择了这种做法,它怎样改变参与者;面对目标函数、递归这类技术概念,动词首先是对象自身的运算与作用。材料没有显示社会反制,就不把技术说明硬拽成制度批判。

Workflow Routing

WorkflowTriggerFile
UnderstandInUse把「是什么」与「怎样运作」接成可辨认、可判断、可行动的 Org 解读Workflows/TraceCreation.md

成品标准

一篇合格解读会让读者发生四个连续变化:

  • 能用一句普通话说出 X 属于什么,以及它与最容易混淆的对象差在哪里。定义要给边界,不能只给比喻或用途。

  • 能顺着一个真实例子说明 X 怎样起作用。技术概念讲清输入、关键动作和结果;制度概念讲清参与者、规则怎样进入行动以及实际后果。只写对象真正具有的机制。

  • 能指出自己原来哪种看法需要修改。认知变化必须由前面的定义和机制推出,不另起炉灶追求「深刻」。

  • 能在一个具体情境里使用这番理解。行动指导要说清先看什么、怎样判断、何时调整,并能解释为什么。

正文从一个普通读者真的会有的疑惑、误解或使用场景进入,不强制编造人物故事。概念要尽早出现,例子负责验证解释,不负责制造戏剧性。

最后可以落在一句判断、一个行动原则或一个真实未决问题上。哪一种自然,由前文决定;问号不是深度证明。

默认写入:

text
~/Context/{时间戳}--理解-{目标片段}__is.org

新成品使用 ljg-is-v5 schema。正文使用两到四个随内容生出的标题和四到十个自然段,不把「是什么 / 怎样运作 / 认知改变 / 行动指导」直接用作四个栏目。

判断边界

  • 定义与理解不同。 用户若只要形式化定义、公式证明或术语翻译,直接回答即可;只有当他想理解概念如何工作、意味着什么或怎样使用时,才进入本技能。

  • 动词不等于社会创制。 技术对象可以通过计算、映射、比较、压缩或递归起作用,不必虚构一个创造者故事。制度对象才追问选择者、规则与反作用。

  • 行动指导不是操作手册。 本技能给判断抓手,不替代某个软件、流程或行业的逐步教程。

  • 理由不能伪造。 区分材料支持的事实和分析者的推断。不知道就缩小判断,不替人物补写动机,也不把一般机制冒充具体案例事实。

Gotchas

  • 不要把新合同写成新清单。 「定义、机制、启发、建议」若各占一栏,文章仍然生硬。它们应当像一条推理:因为 X 是这样运作的,所以原来的判断不够准确,下一次才应当这样做。

  • 不要只给用途当定义。 「目标函数用来优化」没有说明它是什么;要补上它怎样给候选方案建立可比较关系,读者才可能把它与约束、指标或奖励区分开。

  • 不要强制具体场景。 一个真实疑惑往往比虚构工程师或司机更自然。只有当人物行动确实承载机制时才使用故事。

  • 不要强造赵汀阳式转折。 未选可能、反制、本源和未来不是必填项。它们只有能解释对象,并且有现实根据时才进入正文。

  • 不要在结尾突然升级尺度。 前文讲算法,结尾忽然质问社会正义,通常不是深刻,而是换了问题。认知改变与行动指导必须能够逐句追溯到已经讲清的机制。

  • 不要给万能建议。 「保持关注」「综合考虑」「具体问题具体分析」删除概念名后仍然成立,说明它没有使用前文的理解。

  • 不要让元数据替正文说话。 definition、operation、recognition 与 guidance 是后台索引;正文可以用更自然的说法,但全文读回必须找到同一内容。

Examples

目标函数

text
不要写:目标函数是优化的灵魂,它最终会反过来支配设计者。
可以写:目标函数是一把供求解过程比较方案的尺子。它给每个候选方案一个
可比较的结果,让程序知道往哪边改进。因此看到「最优」时,先补问一句:
这是按照哪把尺子得到的最优?

绩效考核

text
先讲清:它是组织定期判断工作表现并连接后续决定的一套正式做法。
再讲它怎样通过指标、叙述或评议进入奖金与机会。由此自然推出:考核不只
记录工作,也会改变人们接下来选择什么工作;设计考核时要检查它正在奖励的
行为,而不能只检查表格是否完整。

边界案例

text
User: 请给出递归函数的形式化定义并证明这个定理。
→ 不调用 ljg-is;这是形式定义与证明任务。

User: 我知道递归是自己调用自己,但还是不懂它到底是什么,写程序时怎么判断该不该用?
→ 调用 ljg-is;这需要把定义、运作方式、认知修正与使用判断接起来。

© 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 6 other files in skills/ljg-is of lijigang/ljg-skills.

  • SKILL.md
  • Template.org
  • Tools/ValidateNote.help.md
  • Tools/ValidateNote.test.ts
  • Tools/ValidateNote.ts
  • Workflows/TraceCreation.md
  • evals/evals.json

Open the folder on GitHubat commit 9e75497

Compare with similar skills

Ljg Is 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 Is compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ljg Is this skilllijigang/ljg-skills7.5k—~671Automated 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
Light Idea CritiqueLight0305/Light-skills640—~4.7kAutomated safety check: PassMIT
Os ChannelCronusL-1141/AI-company371—~969Automated safety check: PassMIT
Reg Gap Analysiszhou210712/claude-for-legal-ZH225—~1kAutomated safety check: PassApache-2.0

Similar skills

  • 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
  • Light Idea Critique

    Light0305/Light-skills

    Light 科研主线第 4 步·审 idea:以顶会审稿人标准严审 idea,撞车/无创新 fatal flaw 一票否决(critical 门), 逼出真能发表的 idea。何时用:用户问"这 idea 行不行/够不够新/能不能发""帮我严审/挑刺/找致命问题" / idea 定稿前把关 / 收到 idea-generation 的候选要审 / 怀疑撞车(被人做过)。触发词:审 idea /…

    640 GitHub stars~4.7k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Os Channel

    CronusL-1141/AI-company

    CC 与 Codex(或两个各自独立运行的 CC 会话)之间用 OS 信道留言、查未读、被新消息唤醒。触发:要跨 harness 把结论交给对端、给对端留言或清未读、用户问"能不能让 Claude 和 Codex 互相沟通"。不适用于派子 agent 或 workflow 内部协作——那是 Agent 与 SendMessage,信道对同会话的子 agent 没有意义。

    371 GitHub stars~969 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Reg Gap Analysis

    zhou210712/claude-for-legal-ZH

    将新出台或变更的法规与现行个人信息处理规则及实践进行差异对比——输出差距清单和 附负责人和日期的整改计划。当新法规出台,用户问"[某法规]影响我们吗""[某法规] 差距分析""对照[法规]进行合规检查",或粘贴法规文本时使用。

    225 GitHub stars~1k tokensUpdated 4 mo ago
    Auto-check passed
  • X Content

    scarletkc/agents

    为 X(Twitter)寻找值得发的素材、筛选选题、撰写和改进帖文或串,并从读者视角重读,改善吸引力、阅读连贯性和真实讨论空间。用户问 X 最近有什么可以发、想写一条有流量的帖文,或反馈 X 帖文太复杂、读不下去时使用。只调整个人语气或忠实翻译已有文本时不触发。

    226 GitHub stars~215 tokensUpdated 19 days ago
    DevelopmentAuto-check passed

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 2 days ago
    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 2 days ago
    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 2 days ago
    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 2 days ago
    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 2 days ago
    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 2 days ago
    Auto-check passed

Questions about Ljg Is

What does Ljg Is do?

把一个名词或概念写成可使用的理解:先用普通话讲清它是什么、与相邻概念差在哪里,再说明它怎样运作、会改写什么判断,最后给出面对它时的行动抓手。USE WHEN 用户问 X 是什么、怎么理解、意味着什么、为什么重要、以后怎样判断或使用;尤其适合技术概念、制度、产品、角色、方法、规范与实践。NOT FOR 单纯查事实、公式证明、逐步操作教程、纵向因果深挖(用 ljg-think)或母题结构(用…. Ljg Is is an agent skill from lijigang/ljg-skills.

When should I use Ljg Is?

Ljg Is fits situations like: 用户问 X 是什么、怎么理解、意味着什么、为什么重要、以后怎样判断或使用;尤其适合技术概念、制度、产品、角色、方法、规范与实践。NOT FOR 单纯查事实、公式证明、逐步操作教程、纵向因果深挖(用 ljg-think)或母题结构(用 ljg-structure).

How do I install Ljg Is in Claude Code?

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

How do I install Ljg Is in Codex?

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

Can I use Ljg Is 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-is -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-is, .gemini/skills/ljg-is, .github/skills/ljg-is and .opencode/skills/ljg-is in your project.

What does Ljg Is need to run?

Going by SKILL.md and its folder, Ljg Is needs TypeScript for the scripts in its folder. Our summary lists: Node.js.

Does Ljg Is 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 Is 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 Is use?

Ljg Is 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 Is use?

About 671 tokens (SKILL.md is roughly 2.7k 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 Is?

Skills that share tags, products or a category with Ljg Is: Ljg Xray Article (lijigang/ljg-skill-xray-article, 130 stars), Paper Explainer for Non-Specialists (lijigang/ljg-skill-paper, 138 stars), Light Idea Critique (Light0305/Light-skills, 640 stars) and Os Channel (CronusL-1141/AI-company, 371 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ljg Is?

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.