Agent skill

Common Reasoning Lenses

by lihaozheCharlie in lihaozheCharlie/the-way-here

为个人 Wiki 的查询、回信和解释性构建提供可动态发现的人物推理视角。它只改变怎样理解证据,不构成新证据,也不决定是否写入。

MITAuto-check passed

Install Common Reasoning Lenses

skills CLI
$ npx skills add lihaozheCharlie/the-way-here --skill common-reasoning-lenses -a claude-code

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

GitHub CLI
$ gh skill install lihaozheCharlie/the-way-here common-reasoning-lenses --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/lihaozheCharlie/the-way-here.git skills-src && mkdir -p .claude/skills && cp -r skills-src/knowledge-engine/skills/common/reasoning-lenses .claude/skills/common-reasoning-lenses && 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
common-reasoning-lenses
GitHub stars
145
Token cost
~640 tokens
SKILL.md length
125 words
Files
13 (incl. scripts, references)
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

为个人 Wiki 的查询、回信和解释性构建提供可动态发现的人物推理视角。它只改变怎样理解证据,不构成新证据,也不决定是否写入。

  • Works in 3 steps: 在 references/figures/ 新增一份符合既有… → 运行 python3… → 运行 python3…
  • SKILL.md covers 使用方式, 动态发现人物, 四档使用强度 and 共享工作流, plus 5 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Common Reasoning Lenses is an agent skill from lihaozheCharlie/the-way-here. 为个人 Wiki 的查询、回信和解释性构建提供可动态发现的人物推理视角。它只改变怎样理解证据,不构成新证据,也不决定是否写入。

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. The skill folder holds 16 other files, including scripts and reference files (for example `references/evidence-and-lens-guardrails.md`, `references/figures/albert-einstein.md` and `references/figures/benjamin-franklin.md`).

The repository describes itself as: the-way-here:想成为一个会记得你的来时路、越聊越懂你的朋友。 The licence is MIT.

Example prompts

  • “/common-reasoning-lenses”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 在 references/figures/ 新增一份符合既有 frontmatter 与章节契约的 Markdown 文件;
  2. 运行 python3 knowledge-engine/skills/common/reasoning-lenses/scripts/list_lenses.py --check;
  3. 运行 python3 knowledge-engine/tools/validate_skill_system.py。

What it can do on your machine

Read from SKILL.md and the folder at commit 760d128. 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 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Common Reasoning Lenses loads about 640 tokens when it runs, and up to ~8.5k if it reads all its reference files. Until then it costs about 22 tokens; SKILL.md has 125 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~640
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.5k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from lihaozheCharlie/the-way-here at commit 760d128, republished under its MIT licence (© lihaozheCharlie). 125 words, ~640 tokens.

Download SKILL.mdSave it as .claude/skills/common-reasoning-lenses/SKILL.md (or your agent's skills folder). This skill also uses 12 other files; get the full folder from GitHub.
name
common-reasoning-lenses
description
为个人 Wiki 的查询、回信和解释性构建提供可动态发现的人物推理视角。它只改变怎样理解证据,不构成新证据,也不决定是否写入。

通用:共享推理视角

这个 Skill 提供一组来源可核实、边界明确的人物推理视角。它不负责页面归档和模板,也不把 Wiki 写成名人观点合集。领域 Skill 决定写什么页面、保留什么结构;本 Skill 只决定在解释性判断中首先注意什么、怎样推理、什么算洞见和何时停止。

使用方式

  • 用户明确要求用某个人物或多视角分析时,与 knowledge-engine/skills/consume/query/SKILL.md 一起使用。
  • 回信、个人主线、人生阶段、事件复盘、循环、思维模型、现实系统、城市和关系综合需要解释时,由对应领域 Skill 调用。
  • 本 Skill 本身不写入。是否沉淀、归档位置和页面模板始终由根 AGENTS.md 与领域构建 Skill 决定。
  • 来源索引、日期、标签、别名、实体消歧、直接引文和可观察状态分类保持中性,不使用人物视角改写。

动态发现人物

先运行:

bash
python3 knowledge-engine/skills/common/reasoning-lenses/scripts/list_lenses.py

脚本会扫描 references/figures/ 下当前存在的全部人物文件并输出路由卡。下游 Skill 不得硬编码人物名单、数量或文件名。选择主视角后,只读取对应人物文件;需要辅助校验时再读取辅助人物文件。

新增人物只需:

  1. 在 references/figures/ 新增一份符合既有 frontmatter 与章节契约的 Markdown 文件;
  2. 运行 python3 knowledge-engine/skills/common/reasoning-lenses/scripts/list_lenses.py --check;
  3. 运行 python3 knowledge-engine/tools/validate_skill_system.py。

只要路由信号与推理协议完整,现有下游会自动发现并可选择新人物。

四档使用强度

强度适用内容规则
0:中性原始证据、来源索引、元数据、日期、别名、实体事实禁止使用人物视角改变事实或选择性遗漏
1:审查状态追踪、人物事实、关系证据只检查是否漏掉重要维度;不让人物视角成为中心结论
2:解释主线、阶段、事件事后判断、循环、系统、城市、思维模型1 个主视角完整推理,通常最多 1 个辅助视角做有边界校验
3:表达近况回信、用户要求的解释性查询主视角同时决定注意力、推理和自然表达倾向;领域 Skill 决定口吻与成品格式

同一来源进入不同层时可以使用不同强度和不同主视角。例如日记回信可以由雅尼完整推理,职业事件页由芒格解释机制,状态追踪仍只记录可观察变化。

共享工作流

  1. 建立中性证据卡,只记录事实、原句、用户解释、必要旧线索和未知。
  2. 运行动态发现脚本,根据当前问题而非喜好选择主视角。不能先得出通用结论再挑人物包装。
  3. 读取主视角文件,建立视角任务卡。
  4. 完整沿主视角推理,形成候选解释。
  5. 只有存在具体盲点时才加入辅助视角。默认最多 1 个;领域 Skill 若允许更多,每个仍必须只有一个独立任务。
  6. 把候选解释放回领域模板,保持事实、解释和行动的边界。
  7. 完成领域质量门和主视角忠实度检查。

中性证据卡

  • 实际发生了什么,哪些原句和细节最有信息量?
  • 用户怎样解释它?哪些是愿望、估计或尚未发生的结果?
  • 哪些旧线索确实改变上下文?
  • 哪些部分不知道,不能由人物视角补写?

人物视角不是证据。它可以重排注意力、提出解释和暴露盲点,但不能让一项推断升级为事实。正常摄取没有新证据时,不能只因换了人物就改写页面核心判断;当前目标确实包含重解释既有页面时,保留仍成立的旧判断并说明更新范围。

视角任务卡

text
输出层与使用强度:
目标问题:
主视角:
选择理由:它会改变哪一项注意力或推理?
推理起点:
推理路径:
洞见标准:
停止位置:
禁止迁移:

辅助视角(如有):
唯一任务:
允许补充:
禁止改变:

主辅关系

  • 主视角决定中心关注、推理路径、洞见标准和停止位置,不是语气包。
  • 辅助视角只能校验一个证据跳跃、现实边界、长期后果、情感遗漏或执行缺口。
  • 辅助不能改变中心、主体结构、主要结论和结尾;若必须改变,应重新选择主视角。
  • 多元性应发生在整个 Wiki,不要求每个页面同时容纳多个人物。
  • 默认不在 Wiki 正文写人物姓名和名言。用户明确要求比较视角时可以展示名称,但结论仍须独立成立。

领域边界

  • 领域 Skill 仍是页面结构的唯一负责人;本 Skill 不复制个人主线、事件、系统、人物或城市模板。
  • 关系、家庭、健康和悲伤不得被商业、工程或投资视角商品化。
  • 人物公开形象不等于完整人格。只使用参考文件中有来源的推理原则和明确边界,不模仿口头禅、传奇形象和未经核实的名言。
  • 思维模型必须接受证据、反例和可观察结果检验,不能因为来自名人就获得豁免。

忠实度检查

  • 注意力、推理起点、推理路径、洞见类型和停止位置是否都来自主视角?
  • 如果只替换人物姓名和几个名词,结论仍无需重推,说明主视角没有真正工作。
  • 删掉人物姓名、意象和风格词后,推理还能辨认主视角吗?
  • 辅助内容能否被圈成一小处?移除后主视角是否仍完整?
  • 中性字段是否在加入视角前后保持事实一致?

跨领域行为规格见 tests/cross-domain-regression.md。

© lihaozheCharlie, 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 12 other files (scripts, references) in knowledge-engine/skills/common/reasoning-lenses of lihaozheCharlie/the-way-here.

  • SKILL.md
  • references/evidence-and-lens-guardrails.md
  • references/figures/albert-einstein.md
  • references/figures/benjamin-franklin.md
  • references/figures/charlie-munger.md
  • references/figures/elon-musk.md
  • references/figures/richard-feynman.md
  • references/figures/steve-jobs.md
  • references/figures/warren-buffett.md
  • references/figures/yanni.md
  • scripts/list_lenses.py
  • tests/cross-domain-regression.md
  • tests/test_dynamic_discovery.py

Open the folder on GitHubat commit 760d128

Compare with similar skills

Common Reasoning Lenses 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.

Common Reasoning Lenses compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Common Reasoning Lenses this skilllihaozheCharlie/the-way-here145—~640Automated safety check: PassMIT
Wiki Maintaineropenclaw/openclaw392k1 repos~462Automated safety check: PassMIT
LLM WikiYeachan-Heo/oh-my-claudecode40k—~721Automated safety check: PassMIT
Wiki Querypaperclipai/paperclip100k—~682Automated safety check: PassMIT
Wiki Lintpaperclipai/paperclip100k—~878Automated safety check: PassMIT
Wiki Ingestpaperclipai/paperclip100k—~933Automated safety check: PassMIT

Similar skills

  • Wiki Maintainer

    openclaw/openclaw

    Maintain the OpenClaw memory wiki vault with deterministic pages, managed blocks, and source-backed updates.

    392k GitHub starsUsed in 1 repo~462 tokens
    Knowledge ManagementAuto-check passed
  • LLM Wiki

    Yeachan-Heo/oh-my-claudecode

    Keeps a persistent markdown wiki of project and session knowledge that the agent can ingest into, query, lint and read across sessions.

    40k GitHub stars~721 tokensUpdated 3 days ago
    Knowledge ManagementAuto-check passed
  • Wiki Query

    paperclipai/paperclip

    A skill your agent uses when an LLM Wiki operation issue asks a question.

    100k GitHub stars~682 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Wiki Lint

    paperclipai/paperclip

    A skill your agent uses when an LLM Wiki operation issue is a lint or health check.

    100k GitHub stars~878 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Wiki Ingest

    paperclipai/paperclip

    A skill your agent uses when an operation issue asks to ingest a captured raw/ source into the LLM Wiki, or the user says "ingest <slug".

    100k GitHub stars~933 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Wiki Builder

    sickn33/agentic-awesome-skills

    Create and maintain reusable research wikis with source provenance, configurable structure, and local markdown outputs.

    47k GitHub starsUsed in 1 repo~1.4k tokens
    Knowledge ManagementAuto-check passed

More from lihaozheCharlie/the-way-here

All 8 skills in this repo
  • Common Quality Gate

    lihaozheCharlie/the-way-here

    验证 wiki 或 Skill 修改是否满足证据、归档、前置元数据、生成索引安全、链接和完成标准;纯健康检查保持只读. An agent skill from lihaozheCharlie/the-way-here.

    145 GitHub stars~488 tokensUpdated 2 days ago
    Auto-check passed
  • Common Retrieval

    lihaozheCharlie/the-way-here

    知识库共享检索:绑定资料范围,关键词召回、来源和时间辨析、渐进阅读、双链追溯与证据核验。由查询、预测、了解度和构建 Skill 按需调用;不负责回答格式、未来推演或写入。

    145 GitHub stars~399 tokensUpdated 2 days ago
    Auto-check passed
  • Common Skill System

    lihaozheCharlie/the-way-here

    分析、设计、验证或更新本 wiki 的 Codex Skill 体系、AGENTS.md 唯一路由、职责图和验证规则。当前目标只要求分析时保持只读。

    145 GitHub stars~609 tokensUpdated 2 days ago
    Auto-check passed
  • Common Signal Detector

    lihaozheCharlie/the-way-here

    在普通对话、wiki 维护或路由诊断中扫描可沉淀信号;本 Skill 只分类,是否更新由 Agent 结合当前目标判断。

    145 GitHub stars~228 tokensUpdated 2 days ago
    Auto-check passed
  • Consume Query

    lihaozheCharlie/the-way-here

    以只读方式回答个人 wiki 问题:先检索综合页面,仅在需要证据时查原始笔记。不要用于摄取或修改 wiki. An agent skill from lihaozheCharlie/the-way-here.

    145 GitHub stars~391 tokensUpdated 2 days ago
    Auto-check passed
  • Consume Predict Self

    lihaozheCharlie/the-way-here

    预测页主动触发:只读绑定知识库的冻结资料,生成有证据的五年生活情景。

    145 GitHub stars~896 tokensUpdated 2 days ago
    Auto-check passed

Questions about Common Reasoning Lenses

What does Common Reasoning Lenses do?

为个人 Wiki 的查询、回信和解释性构建提供可动态发现的人物推理视角。它只改变怎样理解证据,不构成新证据,也不决定是否写入。. Common Reasoning Lenses is an agent skill from lihaozheCharlie/the-way-here.

How do I install Common Reasoning Lenses in Claude Code?

Run `npx skills add lihaozheCharlie/the-way-here --skill common-reasoning-lenses -a claude-code`. Or copy the skill folder (knowledge-engine/skills/common/reasoning-lenses in lihaozheCharlie/the-way-here) into .claude/skills/common-reasoning-lenses in your project. Claude Code loads it when a task matches its description.

How do I install Common Reasoning Lenses in Codex?

Run `npx skills add lihaozheCharlie/the-way-here --skill common-reasoning-lenses -a codex`. Or copy the skill folder (knowledge-engine/skills/common/reasoning-lenses in lihaozheCharlie/the-way-here) into .agents/skills/common-reasoning-lenses in your project. Codex loads it when a task matches its description.

Can I use Common Reasoning Lenses 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 lihaozheCharlie/the-way-here --skill common-reasoning-lenses -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/common-reasoning-lenses, .gemini/skills/common-reasoning-lenses, .github/skills/common-reasoning-lenses and .opencode/skills/common-reasoning-lenses in your project.

What does Common Reasoning Lenses need to run?

Going by SKILL.md and its folder, Common Reasoning Lenses needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Common Reasoning Lenses 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 Common Reasoning Lenses 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Common Reasoning Lenses use?

Common Reasoning Lenses 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 Common Reasoning Lenses use?

About 640 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.9k tokens, read only when the agent opens those files.

What are the alternatives to Common Reasoning Lenses?

Skills that share tags, products or a category with Common Reasoning Lenses: Wiki Maintainer (openclaw/openclaw, 392k stars), LLM Wiki (Yeachan-Heo/oh-my-claudecode, 40k stars), Wiki Query (paperclipai/paperclip, 100k stars) and Wiki Lint (paperclipai/paperclip, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Common Reasoning Lenses?

lihaozheCharlie (a GitHub user) maintains it in lihaozheCharlie/the-way-here, which has 145 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 9, 2026.

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