diff --git a/.github/workflows/spellcheck.yml b/.github/workflows/spellcheck.yml
index 03730b0..9f0be67 100644
--- a/.github/workflows/spellcheck.yml
+++ b/.github/workflows/spellcheck.yml
@@ -17,8 +17,8 @@ jobs:
       - name: Check out repository
         uses: actions/checkout@v4
 
-      - name: Install codespell
-        run: python -m pip install --upgrade codespell --break-system-packages
-
       - name: Check Markdown spelling
-        run: codespell $(git ls-files '**/*.md')
+        uses: streetsidesoftware/cspell-action@v6
+        with:
+          config: cspell.json
+          files: "**/*.md"
diff --git a/cspell.json b/cspell.json
new file mode 100644
index 0000000..c0186e8
--- /dev/null
+++ b/cspell.json
@@ -0,0 +1,19 @@
+{
+  "version": "0.2",
+  "language": "en",
+  "words": [
+    "Codex",
+    "Claude",
+    "Gitea",
+    "MVP",
+    "OpenClaw",
+    "README",
+    "idea-evaluator",
+    "frontmatter",
+    "subagents",
+    "hyphen-case"
+  ],
+  "ignorePaths": [
+    "LICENSE"
+  ]
+}
diff --git a/openclaw/idea-evaluator/README.md b/openclaw/idea-evaluator/README.md
index e3ef30a..f4eb0d8 100644
--- a/openclaw/idea-evaluator/README.md
+++ b/openclaw/idea-evaluator/README.md
@@ -12,4 +12,3 @@ This folder contains the OpenClaw version of `idea-evaluator`.
 
 - `Intent.md` in the repo root
 - OpenClaw skill loading and frontmatter rules
-