Agent skill

Formal Knowledge Map

by lijigang in lijigang/ljg-skills

Reads an article, note or lecture draft and draws a plain-language formal map of its concepts, the tests for assigning things to them, and the conditional links between concepts.

MITAuto-check passedKnowledge Management

SKILL.md written in Chinese; this summary is our English description.

Install Formal Knowledge Map

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

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

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

At a glance

Reads an article, note or lecture draft and draws a plain-language formal map of its concepts, the tests for assigning things to them, and the conditional links between concepts.

  • Turning an essay, lecture script or set of notes into a map of concepts and relations
  • SKILL.md covers Workflow Routing, Gotchas, 成品约定 and Examples
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Redrawing a knowledge map that came out too dense or too abstract to follow

What it does

This skill reads a text you provide and looks for the knowledge structure underneath it: which terms point at something definite, what justifies putting real objects under each term, and under which conditions a relation between two concepts holds. It then draws that structure as a map in Markdown and Mermaid, with every node given a plain definition, a short formula and a concrete example.

The shape of the map comes from the material, so layers, crossings or loops appear only where the text has them. Arrows are labeled by kind (definition, classification, calculation, correlation, cause, analogy, inference, feedback), and gaps in the source, such as a missing criterion or example, are marked as gaps instead of filled in. The result is delivered in the chat by default, and the skill does not save notes or overwrite the original unless you ask. A workflow file covers building or revising a map and an examples file calibrates formula density. The skill files are written in Chinese.

When your agent uses it

  • Turning an essay, lecture script or set of notes into a map of concepts and relations
  • Redrawing a knowledge map that came out too dense or too abstract to follow
  • Separating definitions and classifications from predictions that still need evidence in a draft

Example prompts

  • “/ljg-map ./notes/learning-theory.md”
  • “Map the concepts, criteria and links in this essay, but do not rewrite the essay itself.”
  • “This map is too hard to read, so redraw it with fewer symbols and one running example.”

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.

    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

Formal Knowledge Map loads about 375 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 39 words of instructions outside code blocks.

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

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). 39 words, ~375 tokens.

Download SKILL.mdSave it as .claude/skills/ljg-map/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
ljg-map
description
以《学习观》的知识观洞察用户文稿,提炼概念、判别依据与有条件的联结,按文稿自身的关系绘制通俗的形式化知识地图;每个节点都有白话定义、短公式和具体语义,图形不预设层级。USE WHEN 用户调用 /ljg-map,或要求把文章、笔记、讲稿画成形式化地图、思考地形图、概念判别与关系图。NOT FOR 普通摘要、逐段改写、地理地图或单独的公式证明。
metadata.version
1.0.1

ljg-map · 形式化思考地图

用《学习观》关于概念、判别模型和联结模型的理解,看到文稿背后的知识结构:哪些词有明确的所指,现实对象凭什么归入它们,概念之间的关系在什么条件下成立。把看到的结构画出来,形式化负责减少歧义,白话和实例负责让关系可理解、可使用。

Workflow Routing

请求执行
从文稿生成地图,或修订已有地图阅读 Workflows/Map.md
需要校准公式密度、节点解释和来源边界按需阅读 Examples.md;学习表达方式,不套用题材和节点

Gotchas

  • 知识观是洞察视角,图形由材料决定。 具象、概念与应用的对应帮助检查知识是否接通,不构成固定的三个图层、三个栏目或必经步骤。分类交叉就画交叉关系,反馈就画循环;材料确有层级时才画层级。
  • 节点来自当前文稿。 不把任何文章都画成「经验—抽象—概念—记忆—学习」;只有文章本身讨论这些概念时,它们才成为内容节点。判别、验证可以写在边或节点解释里,无须一律占框。
  • 地图不是换成公式的长文。 成品先让读者看见承重关系,再解释图里的节点。不能只给概念清单、长表格或一串没有地图的公式。
  • 形式化不以符号数量计。 优先「中文名称 + 短公式」。定义符号后再使用,不另造一套图论元语言来描述本来很简单的文章。
  • 分类与预测分开。 「有圆圈」可以定义一类;「这一类会加分」是另一条需要依据的关系。满足分类条件不自动证明预测成立,也不能推出反面类别有反面结果。
  • 箭头有语义。 定义、归类、计算、相关、因果、类比、推断和反馈不能混作一种关系;用短边标签和必要条件区分。猜想仍标猜想。
  • 图的完整不能靠编造。 文稿缺少判别标准、实例或验证办法,就在对应位置标缺口。补充的教学例子、应用设想与可行性判断要与原文陈述分清。

成品约定

默认直接在对话中交付 Markdown、Mermaid 和可读公式。用户要求保存、特定格式或修改已有产物时,按其指定交付;本技能不默认写笔记、覆盖原文或发布。

主图显出这篇文稿特有的知识关系,不预设层数、形状或统一应用流程。主要关系保持易读,次要分支可以放到有连接位置的补图或标记表。每个图中节点均能在解释中找到相同编号或名称,以及定义、公式、语义和具体对应。

Examples

  • /ljg-map <文稿或文件路径>:读到实际内容后,画出该文稿的知识结构,解释每个节点,用合适的具体对应讲清关键关系。
  • 把这篇文章的概念、判别和联结画清楚,别改写文章:保留作者的主要推理、并列结构及重要分歧;在箭头处标明条件和来源中的不确定性。
  • 这张图太难懂,重新画:减少符号和主图拥挤度,用一个合适例子贯穿;保留会改变判断的条件,不以删掉论点换取表面简洁。

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

  • SKILL.md
  • Examples.md
  • Workflows/Map.md
  • agents/openai.yaml

Open the folder on GitHubat commit 9e75497

Compare with similar skills

Formal Knowledge Map 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.

Formal Knowledge Map compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Formal Knowledge Map this skilllijigang/ljg-skills7.5k—~375Automated safety check: PassMIT
Canvas GenerateAgriciDaniel/claude-canvas300—~2kAutomated safety check: PassMIT
Memoryyonatangross/orchestkit290—~1.8kAutomated safety check: NotesMIT
Scholar Conceptualjoshzyj/open-scholar-skill168—~5.3kAutomated safety check: PassCustom licence
Obsidian Canvas BoardsAgriciDaniel/claude-obsidian15k—~1.4kAutomated safety check: PassMIT
LLM Wikilewislulu/llm-wiki-skill655—~3.7kAutomated safety check: PassNone

Similar skills

  • Canvas Generate

    AgriciDaniel/claude-canvas

    Builds a complete Obsidian canvas from a plain description by picking one of 12 template archetypes, planning nodes, and generating text and media for it.

    300 GitHub stars~2k tokensUpdated 6 mo ago
    Knowledge ManagementAuto-check passed
  • Memory

    yonatangross/orchestkit

    Read-side memory operations on the knowledge graph: search past decisions and patterns, load session context, view decision timelines, render Mermaid graph visualizations.

    290 GitHub stars~1.8k tokensUpdated today
    Knowledge ManagementAuto-check: notes
  • Scholar Conceptual

    joshzyj/open-scholar-skill

    Build original theoretical frameworks and produce publication-quality conceptual diagrams for social science research.

    168 GitHub stars~5.3k tokensUpdated 21 days ago
    DevelopmentAuto-check passed
  • Obsidian Canvas Boards

    AgriciDaniel/claude-obsidian

    Creates, inspects and updates Obsidian JSON Canvas boards in a vault, with text, file, link, group and edge nodes, using safe recoverable edits.

    15k GitHub stars~1.4k tokensUpdated 29 days ago
    Knowledge ManagementAuto-check passed
  • LLM Wiki

    lewislulu/llm-wiki-skill

    Build and maintain a Karpathy-style LLM knowledge base — a self-compiling Obsidian markdown wiki where an Agent ingests raw sources, compiles cross-linked concept/entity/summary pages, answers…

    655 GitHub stars~3.7k tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed
  • Obsidian Markdown Syntax

    AgriciDaniel/claude-obsidian

    Explains, drafts and validates Obsidian Flavored Markdown such as properties, wikilinks, embeds, callouts and Mermaid, with vault edits applied through approved transactions.

    15k GitHub stars~1.1k tokensUpdated 29 days ago
    Knowledge ManagementAuto-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 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

Works with

Questions about Formal Knowledge Map

What does Formal Knowledge Map do?

Reads an article, note or lecture draft and draws a plain-language formal map of its concepts, the tests for assigning things to them, and the conditional links between concepts. This skill reads a text you provide and looks for the knowledge structure underneath it: which terms point at something definite, what justifies putting real objects under each term, and under which conditions a relation between two concepts holds. It then draws that structure as a map in Markdown and Mermaid, with every node given a plain definition, a short formula and a concrete example.

When should I use Formal Knowledge Map?

Formal Knowledge Map fits situations like: turning an essay, lecture script or set of notes into a map of concepts and relations; redrawing a knowledge map that came out too dense or too abstract to follow; separating definitions and classifications from predictions that still need evidence in a draft.

How do I install Formal Knowledge Map in Claude Code?

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

How do I install Formal Knowledge Map in Codex?

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

Can I use Formal Knowledge Map 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-map -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-map, .gemini/skills/ljg-map, .github/skills/ljg-map and .opencode/skills/ljg-map in your project.

What does Formal Knowledge Map need to run?

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

Does Formal Knowledge Map 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 Formal Knowledge Map 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 Formal Knowledge Map use?

Formal Knowledge Map 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 Formal Knowledge Map use?

About 375 tokens (SKILL.md is roughly 1.5k 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 Formal Knowledge Map?

Skills that share tags, products or a category with Formal Knowledge Map: Canvas Generate (AgriciDaniel/claude-canvas, 300 stars), Memory (yonatangross/orchestkit, 290 stars), Scholar Conceptual (joshzyj/open-scholar-skill, 168 stars) and Obsidian Canvas Boards (AgriciDaniel/claude-obsidian, 15k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Formal Knowledge Map?

lijigang (a GitHub user) maintains it in lijigang/ljg-skills, which has 7,474 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.