diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d2d457b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# opencode-notes
+
+阅读 [opencode](https://github.com/anomalyco/opencode) 源码时的笔记。
+
+## 目录
+
+- [skill-handling.md](./skill-handling.md) — skill 的发现、加载、权限过滤、注入 SystemContext 的完整链路；以及最终下发给 LLM 的 system prompt 形态（V1 / V2 对比）。