diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
new file mode 100644
index 0000000..dacf4d9
--- /dev/null
+++ b/.claude-plugin/marketplace.json
@@ -0,0 +1,8 @@
+{
+  "name": "jsc-plugins",
+  "description": "JSC 動漫助理 Claude Code mod 的 marketplace。",
+  "owner": {
+    "name": "JSC"
+  },
+  "plugins": []
+}
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..9796fd8
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,5 @@
+node_modules/
+.env
+# 輕小說原文與建置中間檔放在 repo 之外，不入版本控制
+corpus/
+build/
diff --git a/LICENSE b/LICENSE
index 9964464..0200ad2 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 jiantw83
+Copyright (c) 2026 Jeffery (jiantw83)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and 
 associated documentation files (the "Software"), to deal in the Software without restriction, including 
diff --git a/README.md b/README.md
index 9f2b27a..ffd72db 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,46 @@
+<p align="center"><img src="assets/icon.png" alt="jsc-plugins" width="128"></p>
+
 # jsc-plugins
 
-JSC 動漫助理 Claude Code mod 的 marketplace：以輕小說角色的個性與語氣陪你做事。
\ No newline at end of file
+JSC 動漫助理 Claude Code mod 的 marketplace。
+
+## 描述
+
+用輕小說角色的個性與語氣取代 Claude 與你對話，並照常協助你做事。
+
+- 插件 `anime-companion`：每個角色是一個 skill，以 `anime-companion:{作品代號}-{角色代號}` 啟動，例如 `anime-companion:sao-asuna`、`anime-companion:sao-suguha`。
+- 人格卡加對白檢索：依這一輪的溝通功能（安慰、吐槽、報告失敗等）檢索角色的對白當範例，讓語氣遷移到工程情境。
+- 強度 0～3 可調；錯誤、風險與需確認的事一律先講清楚，再加角色語氣。
+- 角色語氣只套在對你說的話，程式碼、commit 與檔案內容保持中性。
+- 輕小說原文與建置中間檔不入此 repo。
+
+狀態：規劃中，規格與工作項目見 [議題](https://gitea.jsc.idv.tw/jiantw83/jsc-plugins/issues)。
+
+## 安裝
+
+先加入 marketplace，再安裝插件：
+
+```bash
+claude plugin marketplace add https://gitea.jsc.idv.tw/jiantw83/jsc-plugins.git
+claude plugin install anime-companion@jsc-plugins
+```
+
+## 更新
+
+```bash
+claude plugin marketplace update jsc-plugins
+claude plugin update anime-companion@jsc-plugins
+```
+
+更新後需重新啟動 Claude Code 才會生效。
+
+## 移除
+
+```bash
+claude plugin uninstall anime-companion@jsc-plugins
+claude plugin marketplace remove jsc-plugins
+```
+
+## 授權
+
+[MIT License](LICENSE)
diff --git a/assets/icon.png b/assets/icon.png
new file mode 100644
index 0000000..af6c5f7
Binary files /dev/null and b/assets/icon.png differ