Home / All Skills / Workflow & Core Tools / ljg-read
Workflow & Core Tools · lijigang/ljg-skills

ljg-read

Thoroughly explain user-provided text using the "bottom-up structure" from "A View of Learning": bridge concrete scenarios to concepts, classification criteria, and conditional relationships, enabling readers to grasp the original meaning and transfer their judgment; displayed directly in the conversation by default. USE WHEN the user says "read along", "read with me", "read this", "explain this passage thoroughly", or provides text seeking an accessible yet in-depth explanation. NOT FOR simple translation, full-book breakdowns, or merely drawing concept maps.

L1 Basic · Source registration onlyV1 Commit-PinnedDual-pass Audit
Author lijigangGitHub lijigang/ljg-skills ↗License MIT(仓库根 LICENSE)Commit 9e75497a95
Control levels describe skill capabilities and suggested control measures; they do not represent quality or safety certifications, nor do they dictate usability. Usage decisions rest entirely with users and administrators. Different agent hosts apply varying constraints; do not assume hosts provide automatic protection. Third-party skill copyrights belong to their original authors. Use at your own risk.

1How It Works & Mechanism

Use the "bottom-up structure" from "A View of Learning": place concrete objects and scenarios at the bottom layer, concepts and general relationships at the top layer, prioritizing practical problems.

skills/ljg-read/SKILL.md
**下层是实际问题,上层是理解问题的工具。**
What this does: Establishes a two-layer explanatory framework, emphasizing that the practical (bottom) precedes the abstract (top).

Discriminative models bridge objects and concepts: when explaining a concept, enable the reader to see its referent and classification criteria.

skills/ljg-read/SKILL.md
**判别模型接通对象与概念。** 它回答「眼前这个情况,凭什么算这一类?」
What this does: Defines "understanding a concept" as the ability to correctly classify it in novel scenarios.

Associative models bridge relationships between concepts: explain correct classification and relational validity separately.

skills/ljg-read/SKILL.md
**联结模型接通概念之间的关系。** 它回答「知道了这一类情况,在什么条件下能推出什么?」
What this does: Explicitly separates "reciting rules" from "identifying applicable scenarios."

Validation: restating explained examples is insufficient to prove transfer; present new scenarios for reader judgment.

skills/ljg-read/SKILL.md
**材料和验证承担不同作用。** 具体例子帮助建构,抽象表述帮助整理,未见情况用来检验迁移。
What this does: Postpones the judgment of "learned" until reader feedback is received; without feedback, only a check has been provided.

Source text and scope: read the actual content first; if the full text cannot be retrieved, state the gap rather than hallucinating text.

skills/ljg-read/SKILL.md
拿不到正文时说明缺口,不根据标题或摘要补写全文。
What this does: Establishes boundaries for source material to prevent hallucinating full text from titles or abstracts.

Six bridging requirements: make things visible, concepts distinguishable, relationships traceable, two layers aligned, boundaries shift judgment, and transfer verifiable.

skills/ljg-read/SKILL.md
- **让事情可见。** 优先使用原文例子;原文太抽象时补一个贴近日常的教学设例,并就地标明。
What this does: Deconstructs "explaining clearly" into six verifiable requirements (emphasizing they are not sections to be printed item by item).

Displayed only in the dialogue by default, without automatically generating files, memories, or learning logs.

skills/ljg-read/SKILL.md
**伴读结果默认只展示在对话中。** 不自动创建或更新笔记、Org 文件、对话记录、学习档案、记忆或其他产物,不返回虚构的文件路径。
What this does: Unlike writing-oriented skills in the same repository, specifies zero-artifact delivery and read-only handling of source text.

Optional interactions: fast-forward / expand / wait a moment / interactive self-test; asking questions does not gate delivery.

skills/ljg-read/SKILL.md
- **快进**:压缩铺陈与次要解释,保留主判断、关键对应与适用条件。
What this does: Makes interaction optional, delivering the current scope coherently by default.

Treat argumentative texts and narrative/lyrical texts separately; distinguish character motives shown in the text from speculation.

skills/ljg-read/SKILL.md
论证文本重在概念、依据与推理;叙事或抒情文本重在具体处境、人物变化、意象与表达效果。
What this does: Switches explanation focus based on text type, allowing lyrical texts to retain ambiguity.

Finished conversation format: defaults to coherent Chinese Markdown paragraphs, concluding with a single sentence capturing the key takeaway.

skills/ljg-read/SKILL.md
默认中文 Markdown,以连贯段落讲解。短文本不硬分章;长文本用贴合内容的小标题。
What this does: Defines the final deliverable format, avoiding lists of terminology, extended reading lists, or mandatory post-reading questions.

2Core Capabilities

01Thoroughly explain a passage using the bottom-up structure (scenario → concept → return to concrete judgment)
02Concept disambiguation and discriminative modeling (referents / classification criteria / neighboring scenarios)
03Relationship tracking and type distinction (definition / taxonomy / correlation / causality / analogy / value judgment / action proposition)
04Boundary and transfer checks (modifying load-bearing premises / counterexamples; optional reference analysis or interactive self-tests)
05English-to-Chinese translation: provide natural Chinese translation first, retaining key original sentences as verification anchors
06Optional interactions (fast-forward / expand / wait a moment / interactive self-test)
07Zero-artifact delivery by default (no disk writes, no fabricated paths returned)
08Delivery check: reread explanation against source text to verify element coverage

4Recommended Governance & Evidence

Suggested Controls for Safe Operation
For Agent Runtime
Can be auto-loaded
For Administrators
Register source and version
Evidence & Triggers (File Paths & Excerpts)
  • SKILL.md: Pure prompt instructions and rule text; no script execution or external impact
Audit Notes: Grading is based solely on the skill's own directory (skills/ljg-read/ = single SKILL.md, 8946 bytes, no scripts/binaries/hidden files): zero built-in executable code, zero credential access, zero network endpoints, zero disk writes (all 7 risk scan categories hit 0). The text only mentions using "currently available web retrieval capabilities" for URLs without naming specific tools or domains; defaults to zero-artifact delivery, leaving all items empty.

5Second-Pass Verification

  • [ok] 实现原理=纯 prompt 编排,无自带可执行代码 — 目录仅 SKILL.md(8946 bytes);风险扫描 URL/凭据/外部程序/写盘/网络/危险旗标 全线 0 命中,token 扫描同样无 fetch/curl/child_process/process.env。
  • [ok] 「下上结构」的两层定义前后一致 — 题头与正文都写下层=实际问题/具体对象、上层=通用关系/工具,并强调两层相对可互换、不能把下固定成物质上固定成语言,无矛盾。
  • [ok] 方法论出处属实 — 明确署名依据于建国《学习观:从感觉懂了到真正学会》的下上结构、判别模型、联结模型与学习验证论述,并自称讲解安排是本技能的应用设计。
  • [ok] 默认零产物、不返回虚构路径的约束明确 — 正文加粗强调『伴读结果默认只展示在对话中』,列明不创建笔记/Org/对话记录/学习档案/记忆,原文保持只读,仅用户明确要求才保存。
  • [ok] 外部依赖为零 — 风险扫描七类全部 0 命中;正文只说 URL 用『当前可用的网页获取能力』,未点名任何具体工具或域,故 external_deps 与 network_calls 均空。
  • [ok] frontmatter 自述版本与 git commit 不是同一体系 — metadata.version 为 "2.0.0"(skill 自述版本),audit.skill_commit 为 git commit 9e75497…;两者不混用,结论只对 pin commit 有效。
  • [ok] meta 直采项无可定位 per-skill 值 — §0 未提供 stars/last_push,installs 无 per-skill 可定位值,按契约均保持 null。

6Verdict & Scenarios

  • Explicit pedagogical core (bottom-up structure + discriminative/associative models + learning validation), not just generic "accessible explanations"
  • Zero-artifact delivery by default, read-only source text with clear boundaries: no automatic note creation, no fabricated paths returned
  • Context-sensitive processing by text type (argumentative vs. narrative/lyrical), distinguishing textual evidence from speculation
  • Six bridging requirements + delivery checks turn "explaining clearly" into verifiable items
  • Best for: Suitable for: Readers who have a passage or article they genuinely want to understand, wishing to be guided from concrete scenarios to concepts and conditional judgments, and to check whether knowledge transfers; close reading of English materials.
    Not for: Not suitable for: Scenarios requiring simple translation, whole-book breakdowns, concept maps only, or saving into note files (should be divided among writing skills like ljg-qa, ljg-rank).
    Install Agent-Ready
    ① Verified Mirror 2026-10-10
    Option A · Direct DownloadDownload ljg-read.tar.gz
    sha256: df27a93b98396555…
    Option B · Copy Guide for Agent
    install.json
    Agents automatically download and verify mirrors from this JSON guide.
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 9e75497a95.