pin-llm-wiki

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

/pin-llm-wiki

Automates Karpathy's LLM wiki pattern: drop URLs in

inbox.md

, the skill fetches, ingests, and maintains a cited, agent-readable knowledge base.

自动化Karpathy的LLM维基模式：将URL放入

inbox.md

，该Skill会抓取、提取内容并维护一个带引用、可供Agent读取的知识库。

Trigger phrases

触发语

/pin-llm-wiki
(with subcommands:
```
init
```
,
```
ingest
```
,
```
lint
```
,
```
queue
```
,
```
remove
```
)
“Pin this YouTube video to my LLM wiki”
“Ingest these research links into my wiki”
“Run pin-llm-wiki lint on this knowledge base”
“Queue these URLs, then batch-process the inbox”
“Initialize a new Karpathy-style wiki with pin-llm-wiki”

inbox.md (human drops URLs)
    ↓  fetch
raw/  (immutable source captures)
    ↓  ingest
wiki/  (LLM-maintained, cited, linked)
    ↓  lint
a healthy, queryable knowledge base

/pin-llm-wiki
（包含子命令：
```
init
```
、
```
ingest
```
、
```
lint
```
、
```
queue
```
、
```
remove
```
）
“将这个YouTube视频固定到我的LLM维基”
“将这些研究链接提取到我的维基中”
“对这个知识库运行pin-llm-wiki检查”
“将这些URL加入队列，然后批量处理收件箱”
“使用pin-llm-wiki初始化一个新的Karpathy风格维基”

inbox.md (用户添加URL)
    ↓  抓取
raw/  (不可变的源内容快照)
    ↓  提取
wiki/  (由LLM维护、带引用、带链接)
    ↓  检查
一个健康、可查询的知识库

Phase 1 subcommands

第一阶段子命令

Command	Status
`init`	implemented
`ingest [<url>]`	implemented (single-URL form auto-queues if URL is not already in inbox)
`lint`	implemented
`remove <slug>`	implemented
`queue <url> [<url> ...]`	implemented

命令	状态
`init`	已实现
`ingest [<url>]`	已实现（单URL形式会自动将URL加入队列，如果该URL尚未在收件箱中）
`lint`	已实现
`remove <slug>`	已实现
`queue <url> [<url> ...]`	已实现

Skill directory

Skill目录

This SKILL.md and all sibling files (

ingest.md

init.md

lint.md

remove.md

queue.md

ingest-protocol.md

templates/...

) live inside the skill directory:

~/.claude/skills/pin-llm-wiki/

~/.copilot/skills/pin-llm-wiki/

~/.cursor/skills/pin-llm-wiki/

, or the project-local

.claude/skills/

.copilot/skills/

.cursor/skills/

equivalents. In this repository the canonical copy is skills/pin-llm-wiki/
. All

templates/...

and sibling-file paths in this skill are relative to whichever skill directory the loading tool used.

本SKILL.md及所有同级文件（

ingest.md

、

init.md

、

lint.md

、

remove.md

、

queue.md

、

ingest-protocol.md

、

templates/...

）位于Skill目录中：

~/.claude/skills/pin-llm-wiki/

、

~/.copilot/skills/pin-llm-wiki/

、

~/.cursor/skills/pin-llm-wiki/

，或项目本地的

.claude/skills/

.copilot/skills/

.cursor/skills/

等效目录。在本仓库中，标准副本位于**

skills/pin-llm-wiki/

**。本Skill中的所有

templates/...

和同级文件路径均相对于加载工具所使用的Skill目录。

Dispatch

调度流程

Identify the subcommand from the invocation args (the first word after
```
/pin-llm-wiki
```
).
Route — read the sibling file in this skill directory and follow its instructions exactly:
- init
  →
```
init.md
```
  (no Guard required — it scaffolds the wiki)
- ingest
  →
```
ingest.md
```
  (with or without a URL arg)
- lint
  →
```
lint.md
```
- remove
  →
```
remove.md
```
- queue
  →
```
queue.md
```
Guard (every subcommand except
init
): confirm
```
.pin-llm-wiki.yml
```
exists in the current working directory. If absent, stop with: "No wiki found here (
.pin-llm-wiki.yml
missing). Run
/pin-llm-wiki init
to scaffold one first." Subcommand files repeat this check by reference; you only need to enforce it once per invocation.
Do not proceed beyond this dispatch step before reading the target file.

从调用参数中识别子命令（
```
/pin-llm-wiki
```
后的第一个单词）。
路由——读取本Skill目录中的同级文件并严格遵循其说明：
- init
  →
```
init.md
```
  （无需Guard——它会搭建维基框架）
- ingest
  →
```
ingest.md
```
  （带或不带URL参数）
- lint
  →
```
lint.md
```
- remove
  →
```
remove.md
```
- queue
  →
```
queue.md
```
**Guard（除
```
init
```
外的所有子命令）：**确认当前工作目录中存在
```
.pin-llm-wiki.yml
```
。如果不存在，停止操作并提示：*“未在此处找到维基（缺少
```
.pin-llm-wiki.yml
```
）。请先运行
```
/pin-llm-wiki init
```
来搭建一个。”*子命令文件会引用此检查，你只需在每次调用时执行一次即可。
在读取目标文件之前，不要进行此调度步骤之后的操作。

Git policy (canonical)

Git规范（标准）

Never run
git commit
or
git push
after any subcommand —

init

ingest

refresh

lint

remove

queue

, or any auto-fix — unless the human explicitly asked to commit in this conversation. Subcommand files reference this policy without restating it. The wiki's own

AGENTS.md

carries the same rule for downstream agents.

任何子命令执行后，绝不要运行
git commit
或
git push
——包括

init

、

ingest

、

refresh

、

lint

、

remove

、

queue

或任何自动修复操作——除非用户在本次对话中明确要求提交。子命令文件会引用此规范但不会重复说明。维基自身的

AGENTS.md

也为下游Agent规定了相同规则。