clew-code 0.2.7 → 0.2.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/README.md +292 -299
  2. package/dist/main.js +2745 -2869
  3. package/docs/architecture.html +148 -145
  4. package/docs/architecture.th.html +79 -78
  5. package/docs/clew-code-architecture.html +1125 -0
  6. package/docs/commands.html +224 -223
  7. package/docs/commands.th.html +131 -130
  8. package/docs/configuration.html +147 -145
  9. package/docs/configuration.th.html +108 -106
  10. package/docs/css/styles.css +48 -42
  11. package/docs/daemon.html +129 -128
  12. package/docs/daemon.th.html +73 -72
  13. package/docs/features/bridge-mode.html +99 -98
  14. package/docs/features/bridge-mode.th.html +90 -89
  15. package/docs/features/evals.html +182 -181
  16. package/docs/features/evals.th.html +90 -89
  17. package/docs/features/peer.html +178 -177
  18. package/docs/features/searxng-search.html +151 -150
  19. package/docs/features/searxng-search.th.html +95 -94
  20. package/docs/features/sentry-setup.html +157 -156
  21. package/docs/features/sentry-setup.th.html +97 -96
  22. package/docs/index.html +299 -298
  23. package/docs/index.th.html +292 -290
  24. package/docs/installation.html +105 -103
  25. package/docs/installation.th.html +105 -103
  26. package/docs/internals/growthbook-ab-testing.html +113 -112
  27. package/docs/internals/growthbook-ab-testing.th.html +81 -80
  28. package/docs/internals/hidden-features.html +149 -147
  29. package/docs/internals/hidden-features.th.html +109 -107
  30. package/docs/js/main.js +83 -3
  31. package/docs/loop.html +181 -180
  32. package/docs/loop.th.html +227 -226
  33. package/docs/mcp.html +247 -246
  34. package/docs/mcp.th.html +207 -206
  35. package/docs/models.html +111 -110
  36. package/docs/models.th.html +61 -60
  37. package/docs/peer.html +236 -235
  38. package/docs/peer.th.html +280 -279
  39. package/docs/permission-model.html +102 -101
  40. package/docs/permission-model.th.html +67 -66
  41. package/docs/plugins.html +102 -101
  42. package/docs/plugins.th.html +79 -78
  43. package/docs/providers.html +126 -117
  44. package/docs/providers.th.html +80 -78
  45. package/docs/quick-start.html +93 -92
  46. package/docs/quick-start.th.html +40 -39
  47. package/docs/research-memory.html +82 -79
  48. package/docs/research-memory.th.html +72 -71
  49. package/docs/skills.html +117 -116
  50. package/docs/skills.th.html +90 -89
  51. package/docs/tools.html +170 -169
  52. package/docs/tools.th.html +84 -83
  53. package/docs/troubleshooting.html +106 -105
  54. package/docs/troubleshooting.th.html +85 -84
  55. package/package.json +164 -162
  56. package/docs/taste.html +0 -436
  57. package/docs/taste.th.html +0 -236
package/docs/research-memory.html CHANGED
@@ -1,79 +1,82 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Research & Memory — Clew</title>
7
- <meta name="description" content="Deep research system and semantic memory — citation extraction, claim verification, dossier generation, cross-lingual memory search.">
8
- <link rel="preconnect" href="https://fonts.googleapis.com">
9
- <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
10
- <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
11
- <link rel="stylesheet" href="css/styles.css">
12
- <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
13
- </head>
14
- <body>
15
- <header class="header"></header>
16
- <div class="app">
17
- <aside class="sidebar" id="sidebar"></aside>
18
- <div class="sidebar-overlay" id="sidebarOverlay"></div>
19
- <div class="content-wrap">
20
- <main class="content">
21
- <div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span>Research &amp; Memory</span></div>
22
- <h1>Research &amp; Memory</h1>
23
- <p class="section-subtitle">Clew provides a built-in deep research system and cross-session semantic memory — both designed to work with local files, web sources, and a persistent knowledge store.</p>
24
-
25
- <h2>Research System</h2>
26
- <p>The research system lives in <code>src/research/</code> and supports deep, source-grounded research across local files, wiki content, and memory:</p>
27
- <ul>
28
- <li><strong>Citation extraction</strong> — Automatic extraction of citations from research sources</li>
29
- <li><strong>Claim verification</strong> — Fact-check claims against multiple sources</li>
30
- <li><strong>Dossier generation</strong> — Structured reports with source attribution</li>
31
- <li><strong>Truth checking</strong> — Cross-reference claims for accuracy</li>
32
- <li><strong>Source ranking</strong> — Prioritize authoritative sources</li>
33
- </ul>
34
-
35
- <h3>Research Commands</h3>
36
- <table>
37
- <tr><th>Command</th><th>Description</th></tr>
38
- <tr><td><code>/research</code></td><td>Deep source-grounded research across local files, wiki, and memory</td></tr>
39
- </table>
40
-
41
- <h2>Memory System</h2>
42
- <p>The memory system lives in <code>src/memdir/</code> and provides cross-session persistent knowledge storage with semantic search:</p>
43
- <ul>
44
- <li><strong>Semantic search</strong> — Find relevant memories using text embedding similarity</li>
45
- <li><strong>Cross-lingual</strong> — Search across languages using semantic embeddings</li>
46
- <li><strong>Memory age tracking</strong> — Automatically age and prune old memories</li>
47
- <li><strong>Auto-memory capture</strong> — Automatically save important information</li>
48
- <li><strong>Hybrid recall</strong> — Combines local embedding search with LLM-based retrieval</li>
49
- <li><strong>Team sync</strong> — Share memory across team members</li>
50
- </ul>
51
-
52
- <h3>Memory Commands</h3>
53
- <table>
54
- <tr><th>Command</th><th>Description</th></tr>
55
- <tr><td><code>/memory</code></td><td>Edit Claude memory files</td></tr>
56
- <tr><td><code>/memory-search</code></td><td>Search memories using semantic search (cross-lingual)</td></tr>
57
- </table>
58
-
59
- <h2>Architecture Files</h2>
60
- <table>
61
- <tr><th>Path</th><th>Role</th></tr>
62
- <tr><td><code>src/research/</code></td><td>Deep research, dossier generation, truth checking, source ranking</td></tr>
63
- <tr><td><code>src/memdir/</code></td><td>Semantic memory search and storage</td></tr>
64
- </table>
65
-
66
- <footer class="footer">
67
- <span>Clew Code v0.2.4 — Open Source</span>
68
- <div class="footer-links">
69
- <a href="https://github.com/JonusNattapong/ClewCode">GitHub</a>
70
- <a href="https://github.com/JonusNattapong/ClewCode/issues">Issues</a>
71
- </div>
72
- </footer>
73
- </main>
74
- <nav class="toc-sidebar"></nav>
75
- </div>
76
- </div>
77
- <script src="js/main.js"></script>
78
- </body>
79
- </html>
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Research & Memory — Clew</title>
7
+ <meta name="description" content="Deep research system and semantic memory — citation extraction, claim verification, dossier generation, cross-lingual memory search.">
8
+ <link rel="preconnect" href="https://fonts.googleapis.com">
9
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
10
+ <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
11
+ <link rel="stylesheet" href="css/styles.css">
12
+ <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
13
+ </head>
14
+ <body>
15
+ <header class="header"></header>
16
+ <div class="app">
17
+ <aside class="sidebar" id="sidebar"></aside>
18
+ <div class="sidebar-overlay" id="sidebarOverlay"></div>
19
+ <div class="content-wrap">
20
+ <main class="content">
21
+ <div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span>Research &amp; Memory</span></div>
22
+ <h1>Research &amp; Memory</h1>
23
+ <p class="section-subtitle">Clew provides a built-in deep research system and cross-session semantic memory — both designed to work with local files, web sources, and a persistent knowledge store.</p>
24
+
25
+ <h2>Research System</h2>
26
+ <p>The research system lives in <code>src/research/</code> and supports deep, source-grounded research across local files, wiki content, and memory:</p>
27
+ <ul>
28
+ <li><strong>Citation extraction</strong> — Automatic extraction of citations from research sources</li>
29
+ <li><strong>Claim verification</strong> — Fact-check claims against multiple sources</li>
30
+ <li><strong>Dossier generation</strong> — Structured reports with source attribution</li>
31
+ <li><strong>Truth checking</strong> — Cross-reference claims for accuracy</li>
32
+ <li><strong>Source ranking</strong> — Prioritize authoritative sources</li>
33
+ </ul>
34
+
35
+ <h3>Research Commands</h3>
36
+ <table>
37
+ <tr><th>Command</th><th>Description</th></tr>
38
+ <tr><td><code>/research</code></td><td>Deep source-grounded research across local files, wiki, and memory</td></tr>
39
+ </table>
40
+
41
+ <h2>Memory System</h2>
42
+ <p>The memory system lives in <code>src/memory/</code> and provides cross-session persistent knowledge storage with SQLite FTS5 search:</p>
43
+ <ul>
44
+ <li><strong>SQLite FTS5 search</strong> — Find relevant memories using FTS5 similarity</li>
45
+ <li><strong>Cross-lingual</strong> — Search across languages using FTS5 indexing</li>
46
+ <li><strong>Memory age tracking</strong> — Automatically prune old memories</li>
47
+ <li><strong>Auto-memory capture</strong> — Automatically save important information</li>
48
+ <li><strong>Token-aware chunking</strong> - 3000-token chunks with word-boundary splitting</li>
49
+ <li><strong>Secret redaction</strong> - Strips API keys and tokens before indexing</li>
50
+ </ul>
51
+
52
+ <h3>Memory Commands</h3>
53
+ <table>
54
+ <tr><th>Command</th><th>Description</th></tr>
55
+ <tr><td><code>/memory</code></td><td>Edit Claude memory files</td></tr>
56
+ <tr><td><code>/memory-search</code></td><td>Search memories using SQLite FTS5 search (cross-lingual)</td></tr>
57
+ </table>
58
+
59
+ <h2>Architecture Files</h2>
60
+ <table>
61
+ <tr><th>Path</th><th>Role</th></tr>
62
+ <tr><td><code>src/research/</code></td><td>Deep research, dossier generation, truth checking, source ranking</td></tr>
63
+ <tr><td><code>src/memory/</code></td><td>SQLite FTS5 memory search (14 files, no embeddings)</td></tr>
64
+ </table>
65
+
66
+ <footer class="footer">
67
+ <span>Clew Code v0.2.7 — Open Source</span>
68
+ <div class="footer-links">
69
+ <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
70
+ <a href="https://github.com/ClewCode/ClewCode/issues">Issues</a>
71
+ </div>
72
+ </footer>
73
+ </main>
74
+ <nav class="toc-sidebar"></nav>
75
+ </div>
76
+ </div>
77
+ <script src="js/main.js"></script>
78
+ </body>
79
+ </html>
80
+
81
+
82
+
package/docs/research-memory.th.html CHANGED
@@ -1,71 +1,72 @@
1
- <!DOCTYPE html>
2
- <html lang="th">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>วิจัยและหน่วยความจำ — Clew</title>
7
- <meta name="description" content="ระบบวิจัยเชิงลึกและหน่วยความจำเชิงความหมาย — การสกัดคำอ้างอิง, การตรวจสอบข้อกล่าวอ้าง, การสร้างรายงาน, การค้นหาหน่วยความจำข้ามภาษา">
8
- <link rel="preconnect" href="https://fonts.googleapis.com">
9
- <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
10
- <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&family=Noto+Sans+Thai:wght@400;500;600;700&display=swap" rel="stylesheet">
11
- <link rel="stylesheet" href="css/styles.css">
12
- <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
13
- </head>
14
- <body>
15
- <header class="header"></header>
16
- <div class="app">
17
- <aside class="sidebar" id="sidebar"></aside>
18
- <div class="sidebar-overlay" id="sidebarOverlay"></div>
19
- <div class="content-wrap">
20
- <main class="content">
21
- <div class="breadcrumbs"><a href="index.th.html">หน้าแรก</a><span class="sep">/</span><span>วิจัยและหน่วยความจำ</span></div>
22
- <h1>วิจัยและหน่วยความจำ</h1>
23
- <p class="section-subtitle">Clew มีระบบวิจัยเชิงลึกในตัวและหน่วยความจำเชิงความหมายข้ามเซสชัน — ทั้งสองออกแบบมาให้ทำงานกับไฟล์ท้องถิ่น, แหล่งเว็บ, และคลังความรู้ถาวร</p>
24
-
25
- <h2>ระบบวิจัย</h2>
26
- <p>ระบบวิจัยอยู่ใน <code>src/research/</code> และรองรับการวิจัยเชิงลึกจากแหล่งที่มาในไฟล์ท้องถิ่น, เนื้อหา wiki, และหน่วยความจำ:</p>
27
- <ul>
28
- <li><strong>การสกัดคำอ้างอิง</strong> — การสกัดคำอ้างอิงอัตโนมัติจากแหล่งวิจัย</li>
29
- <li><strong>การตรวจสอบข้อกล่าวอ้าง</strong> — ตรวจสอบข้อเท็จจริงกับหลายแหล่ง</li>
30
- <li><strong>การสร้างรายงาน</strong> — รายงานมีโครงสร้างพร้อมการระบุแหล่งที่มา</li>
31
- <li><strong>การตรวจสอบความจริง</strong> — อ้างอิงข้ามข้อกล่าวอ้างเพื่อความถูกต้อง</li>
32
- <li><strong>การจัดอันดับแหล่งที่มา</strong> — จัดลำดับความสำคัญของแหล่งที่มาน่าเชื่อถือ</li>
33
- </ul>
34
-
35
- <h3>คำสั่งวิจัย</h3>
36
- <table>
37
- <tr><th>คำสั่ง</th><th>คำอธิบาย</th></tr>
38
- <tr><td><code>/research</code></td><td>วิจัยเชิงลึกจากแหล่งที่มาในไฟล์ท้องถิ่น, wiki, และหน่วยความจำ</td></tr>
39
- </table>
40
-
41
- <h2>ระบบหน่วยความจำ</h2>
42
- <p>ระบบหน่วยความจำอยู่ใน <code>src/memdir/</code> และให้การจัดเก็บความรู้ถาวรข้ามเซสชันด้วยการค้นหาเชิงความหมาย:</p>
43
- <ul>
44
- <li><strong>การค้นหาเชิงความหมาย</strong> — ค้นหาหน่วยความจำที่เกี่ยวข้องโดยใช้ความคล้ายคลึงของข้อความฝัง</li>
45
- <li><strong>ข้ามภาษา</strong> — ค้นหาข้ามภาษาด้วย semantic embeddings</li>
46
- <li><strong>การติดตามอายุหน่วยความจำ</strong> — อายุและตัดหน่วยความจำเก่าโดยอัตโนมัติ</li>
47
- <li><strong>การบันทึกหน่วยความจำอัตโนมัติ</strong> — บันทึกข้อมูลสำคัญโดยอัตโนมัติ</li>
48
- <li><strong>การเรียกคืนแบบผสม</strong> — รวมการค้นหา embedding ในเครื่องกับการเรียกคืนผ่าน LLM</li>
49
- </ul>
50
-
51
- <h3>คำสั่งหน่วยความจำ</h3>
52
- <table>
53
- <tr><th>คำสั่ง</th><th>คำอธิบาย</th></tr>
54
- <tr><td><code>/memory</code></td><td>แก้ไขไฟล์หน่วยความจำ</td></tr>
55
- <tr><td><code>/memory-search</code></td><td>ค้นหาหน่วยความจำด้วยการค้นหาเชิงความหมาย (ข้ามภาษา)</td></tr>
56
- </table>
57
-
58
- <footer class="footer">
59
- <span>Clew Code v0.2.4 — โอเพนซอร์ส</span>
60
- <div class="footer-links">
61
- <a href="https://github.com/JonusNattapong/ClewCode">GitHub</a>
62
- <a href="https://github.com/JonusNattapong/ClewCode/issues">ปัญหา</a>
63
- </div>
64
- </footer>
65
- </main>
66
- <nav class="toc-sidebar"></nav>
67
- </div>
68
- </div>
69
- <script src="js/main.js"></script>
70
- </body>
71
- </html>
1
+ <!DOCTYPE html>
2
+ <html lang="th">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>วิจัยและหน่วยความจำ — Clew</title>
7
+ <meta name="description" content="ระบบวิจัยเชิงลึกและหน่วยความจำเชิงความหมาย — การสกัดคำอ้างอิง, การตรวจสอบข้อกล่าวอ้าง, การสร้างรายงาน, การค้นหาหน่วยความจำข้ามภาษา">
8
+ <link rel="preconnect" href="https://fonts.googleapis.com">
9
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
10
+ <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&family=Noto+Sans+Thai:wght@400;500;600;700&display=swap" rel="stylesheet">
11
+ <link rel="stylesheet" href="css/styles.css">
12
+ <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
13
+ </head>
14
+ <body>
15
+ <header class="header"></header>
16
+ <div class="app">
17
+ <aside class="sidebar" id="sidebar"></aside>
18
+ <div class="sidebar-overlay" id="sidebarOverlay"></div>
19
+ <div class="content-wrap">
20
+ <main class="content">
21
+ <div class="breadcrumbs"><a href="index.th.html">หน้าแรก</a><span class="sep">/</span><span>วิจัยและหน่วยความจำ</span></div>
22
+ <h1>วิจัยและหน่วยความจำ</h1>
23
+ <p class="section-subtitle">Clew มีระบบวิจัยเชิงลึกในตัวและหน่วยความจำเชิงความหมายข้ามเซสชัน — ทั้งสองออกแบบมาให้ทำงานกับไฟล์ท้องถิ่น, แหล่งเว็บ, และคลังความรู้ถาวร</p>
24
+
25
+ <h2>ระบบวิจัย</h2>
26
+ <p>ระบบวิจัยอยู่ใน <code>src/research/</code> และรองรับการวิจัยเชิงลึกจากแหล่งที่มาในไฟล์ท้องถิ่น, เนื้อหา wiki, และหน่วยความจำ:</p>
27
+ <ul>
28
+ <li><strong>การสกัดคำอ้างอิง</strong> — การสกัดคำอ้างอิงอัตโนมัติจากแหล่งวิจัย</li>
29
+ <li><strong>การตรวจสอบข้อกล่าวอ้าง</strong> — ตรวจสอบข้อเท็จจริงกับหลายแหล่ง</li>
30
+ <li><strong>การสร้างรายงาน</strong> — รายงานมีโครงสร้างพร้อมการระบุแหล่งที่มา</li>
31
+ <li><strong>การตรวจสอบความจริง</strong> — อ้างอิงข้ามข้อกล่าวอ้างเพื่อความถูกต้อง</li>
32
+ <li><strong>การจัดอันดับแหล่งที่มา</strong> — จัดลำดับความสำคัญของแหล่งที่มาน่าเชื่อถือ</li>
33
+ </ul>
34
+
35
+ <h3>คำสั่งวิจัย</h3>
36
+ <table>
37
+ <tr><th>คำสั่ง</th><th>คำอธิบาย</th></tr>
38
+ <tr><td><code>/research</code></td><td>วิจัยเชิงลึกจากแหล่งที่มาในไฟล์ท้องถิ่น, wiki, และหน่วยความจำ</td></tr>
39
+ </table>
40
+
41
+ <h2>ระบบหน่วยความจำ</h2>
42
+ <p>ระบบหน่วยความจำอยู่ใน <code>$c = $c.replace('src/memdir/', 'src/memory/')</code> และให้การจัดเก็บความรู้ถาวรข้ามเซสชันด้วยการค้นหาเชิงความหมาย:</p>
43
+ <ul>
44
+ <li><strong>การค้นหาเชิงความหมาย</strong> — ค้นหาหน่วยความจำที่เกี่ยวข้องโดยใช้ความคล้ายคลึงของข้อความฝัง</li>
45
+ <li><strong>ข้ามภาษา</strong> — ค้นหาข้ามภาษาด้วย semantic embeddings</li>
46
+ <li><strong>การติดตามอายุหน่วยความจำ</strong> — อายุและตัดหน่วยความจำเก่าโดยอัตโนมัติ</li>
47
+ <li><strong>การบันทึกหน่วยความจำอัตโนมัติ</strong> — บันทึกข้อมูลสำคัญโดยอัตโนมัติ</li>
48
+ <li><strong>การเรียกคืนแบบผสม</strong> — รวมการค้นหา embedding ในเครื่องกับการเรียกคืนผ่าน LLM</li>
49
+ </ul>
50
+
51
+ <h3>คำสั่งหน่วยความจำ</h3>
52
+ <table>
53
+ <tr><th>คำสั่ง</th><th>คำอธิบาย</th></tr>
54
+ <tr><td><code>/memory</code></td><td>แก้ไขไฟล์หน่วยความจำ</td></tr>
55
+ <tr><td><code>/memory-search</code></td><td>ค้นหาหน่วยความจำด้วยการค้นหาเชิงความหมาย (ข้ามภาษา)</td></tr>
56
+ </table>
57
+
58
+ <footer class="footer">
59
+ <span>Clew Code v0.2.7 — โอเพนซอร์ส</span>
60
+ <div class="footer-links">
61
+ <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
62
+ <a href="https://github.com/ClewCode/ClewCode/issues">ปัญหา</a>
63
+ </div>
64
+ </footer>
65
+ </main>
66
+ <nav class="toc-sidebar"></nav>
67
+ </div>
68
+ </div>
69
+ <script src="js/main.js"></script>
70
+ </body>
71
+ </html>
72
+
package/docs/skills.html CHANGED
@@ -1,116 +1,117 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Skills — Clew</title>
7
- <meta name="description" content="Reusable task instructions and workflows in Clew — create, use, and share skills across projects.">
8
- <link rel="preconnect" href="https://fonts.googleapis.com">
9
- <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
10
- <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
11
- <link rel="stylesheet" href="css/styles.css">
12
- <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
13
- </head>
14
- <body>
15
- <header class="header"></header>
16
- <div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
17
- <div class="content-wrap"><main class="content">
18
- <div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span>Skills</span></div>
19
- <h1>Skills</h1>
20
- <p class="section-subtitle">Skills are reusable prompt-type commands — markdown files that provide structured instructions to the AI model. They are loaded from bundled, user, project, and plugin directories.</p>
21
-
22
- <h2>Overview</h2>
23
- <p>Skills are commands of type <code>prompt</code> — they expand to text that is sent to the model. Unlike plugins (which provide JavaScript code), skills are purely instructional. They bridge the gap between ad-hoc prompts and full plugin development.</p>
24
-
25
- <h2>Skill Locations</h2>
26
- <p>Skills are loaded from four sources (order: bundled user project plugin):</p>
27
- <table>
28
- <tr><th>Source</th><th>Path</th><th>Scope</th></tr>
29
- <tr><td>Bundled</td><td>Ships with Clew</td><td>All users</td></tr>
30
- <tr><td>User</td><td><code>~/.claude/skills/&lt;name&gt;/SKILL.md</code></td><td>Personal</td></tr>
31
- <tr><td>Project</td><td><code>.claude/skills/&lt;name&gt;/SKILL.md</code></td><td>Team (in-repo)</td></tr>
32
- <tr><td>Plugin</td><td>Inside plugin directories</td><td>Plugin users</td></tr>
33
- </table>
34
-
35
- <h2>Skill Structure</h2>
36
- <pre><code>my-skill/
37
- SKILL.md # Skill instructions (required)
38
- assets/ # Optional: scripts, references, examples</code></pre>
39
-
40
- <p>The <code>SKILL.md</code> file uses frontmatter for metadata and markdown for instructions. Skills are registered as <code>prompt</code>-type commands and can be invoked by the model via the <code>SkillTool</code>.</p>
41
-
42
- <h2>Managing Skills</h2>
43
- <pre><code>/skill # List available skills or show skill details
44
- /skills # List available skills
45
- /skill-name # Invoke a specific skill directly</code></pre>
46
-
47
- <h2>Skill Frontmatter</h2>
48
- <p>Skills support YAML frontmatter for metadata and configuration:</p>
49
- <pre><code>---
50
- name: my-skill
51
- description: Does focused text work
52
- allowed-tools:
53
- - Read
54
- - Grep
55
- disallowed-tools:
56
- - Bash
57
- - Edit
58
- hooks:
59
- PreToolUse:
60
- - matcher: Bash
61
- hooks:
62
- - type: command
63
- command: echo "About to run bash"
64
- model: claude-sonnet-4-6
65
- effort: high
66
- user-invocable: true
67
- context: fork
68
- ---</code></pre>
69
- <p>Key frontmatter fields:</p>
70
- <ul>
71
- <li><code>allowed-tools</code> — Restrict which tools the model can use while this skill is active</li>
72
- <li><code>disallowed-tools</code> — Explicitly block tools (e.g., <code>Bash</code>, <code>Edit</code>) for read-only skills</li>
73
- <li><code>hooks</code> — Register PreToolUse, PostToolUse, or MessageDisplay hooks for the skill</li>
74
- <li><code>model</code> — Override the model used when this skill runs</li>
75
- <li><code>effort</code> — Set effort level (low, medium, high, xhigh, max)</li>
76
- <li><code>context</code> — <code>inline</code> (default) expands into current conversation; <code>fork</code> runs as sub-agent</li>
77
- </ul>
78
-
79
- <h2>Creating a Skill</h2>
80
- <pre><code>mkdir -p ~/.claude/skills/my-skill
81
- touch ~/.claude/skills/my-skill/SKILL.md
82
- # Edit SKILL.md with frontmatter and instructions</code></pre>
83
- <p>Or use the <code>skillify</code> plugin to create a skill from an existing workflow.</p>
84
-
85
- <h2>Project-Level Skills</h2>
86
- <p>Place skills in <code>.claude/skills/</code> inside your repository to share with your team:</p>
87
- <pre><code>.claude/
88
- skills/
89
- code-review/
90
- SKILL.md
91
- migration-workflow/
92
- SKILL.md</code></pre>
93
- <p>Project skills are automatically available to everyone working in the repository.</p>
94
-
95
- <h2>Dynamic Skills</h2>
96
- <p>Skills can be discovered dynamically during file operations. When a skill file is created or modified, it's automatically added to the available command list without restarting. Use <code>clearCommandMemoizationCaches()</code> to refresh the skill index.</p>
97
-
98
- <div class="callout callout-info">
99
- <strong>Skills vs. Plugins</strong>
100
- Skills are instruction-only (markdown), no code required. Plugins provide executable JavaScript — commands, hooks, agents, MCP servers. Use skills to standardize AI behavior; use plugins for custom tooling.
101
- </div>
102
-
103
- <footer class="footer">
104
- <span>Clew Code v0.2.4 — Open Source</span>
105
- <div class="footer-links">
106
- <a href="https://github.com/JonusNattapong/ClewCode">GitHub</a>
107
- <a href="https://github.com/JonusNattapong/ClewCode/issues">Issues</a>
108
- </div>
109
- </footer>
110
- </main>
111
- <nav class="toc-sidebar"></nav>
112
- </div>
113
- </div>
114
- <script src="js/main.js"></script>
115
- </body>
116
- </html>
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Skills — Clew</title>
7
+ <meta name="description" content="Reusable task instructions and workflows in Clew — create, use, and share skills across projects.">
8
+ <link rel="preconnect" href="https://fonts.googleapis.com">
9
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
10
+ <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
11
+ <link rel="stylesheet" href="css/styles.css">
12
+ <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
13
+ </head>
14
+ <body>
15
+ <header class="header"></header>
16
+ <div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
17
+ <div class="content-wrap"><main class="content">
18
+ <div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span>Skills</span></div>
19
+ <h1>Skills</h1>
20
+ <p class="section-subtitle">Skills are reusable prompt-type commands — markdown files that provide structured instructions to the AI model. They are loaded from bundled, user, project, and plugin directories.</p>
21
+
22
+ <h2>Overview</h2>
23
+ <p>Skills are commands of type <code>prompt</code> — they expand to text that is sent to the model. Unlike plugins (which provide JavaScript code), skills are purely instructional. They bridge the gap between ad-hoc prompts and full plugin development.</p>
24
+
25
+ <h2>Skill Locations</h2>
26
+ <p>Skills are loaded from four sources (order: bundled user project plugin):</p>
27
+ <table>
28
+ <tr><th>Source</th><th>Path</th><th>Scope</th></tr>
29
+ <tr><td>Bundled</td><td>Ships with Clew</td><td>All users</td></tr>
30
+ <tr><td>User</td><td><code>~/.claude/skills/&lt;name&gt;/SKILL.md</code></td><td>Personal</td></tr>
31
+ <tr><td>Project</td><td><code>.claude/skills/&lt;name&gt;/SKILL.md</code></td><td>Team (in-repo)</td></tr>
32
+ <tr><td>Plugin</td><td>Inside plugin directories</td><td>Plugin users</td></tr>
33
+ </table>
34
+
35
+ <h2>Skill Structure</h2>
36
+ <pre><code>my-skill/
37
+ SKILL.md # Skill instructions (required)
38
+ assets/ # Optional: scripts, references, examples</code></pre>
39
+
40
+ <p>The <code>SKILL.md</code> file uses frontmatter for metadata and markdown for instructions. Skills are registered as <code>prompt</code>-type commands and can be invoked by the model via the <code>SkillTool</code>.</p>
41
+
42
+ <h2>Managing Skills</h2>
43
+ <pre><code>/skill # List available skills or show skill details
44
+ /skills # List available skills
45
+ /skill-name # Invoke a specific skill directly</code></pre>
46
+
47
+ <h2>Skill Frontmatter</h2>
48
+ <p>Skills support YAML frontmatter for metadata and configuration:</p>
49
+ <pre><code>---
50
+ name: my-skill
51
+ description: Does focused text work
52
+ allowed-tools:
53
+ - Read
54
+ - Grep
55
+ disallowed-tools:
56
+ - Bash
57
+ - Edit
58
+ hooks:
59
+ PreToolUse:
60
+ - matcher: Bash
61
+ hooks:
62
+ - type: command
63
+ command: echo "About to run bash"
64
+ model: claude-sonnet-4-6
65
+ effort: high
66
+ user-invocable: true
67
+ context: fork
68
+ ---</code></pre>
69
+ <p>Key frontmatter fields:</p>
70
+ <ul>
71
+ <li><code>allowed-tools</code> — Restrict which tools the model can use while this skill is active</li>
72
+ <li><code>disallowed-tools</code> — Explicitly block tools (e.g., <code>Bash</code>, <code>Edit</code>) for read-only skills</li>
73
+ <li><code>hooks</code> — Register PreToolUse, PostToolUse, or MessageDisplay hooks for the skill</li>
74
+ <li><code>model</code> — Override the model used when this skill runs</li>
75
+ <li><code>effort</code> — Set effort level (low, medium, high, xhigh, max)</li>
76
+ <li><code>context</code> — <code>inline</code> (default) expands into current conversation; <code>fork</code> runs as sub-agent</li>
77
+ </ul>
78
+
79
+ <h2>Creating a Skill</h2>
80
+ <pre><code>mkdir -p ~/.claude/skills/my-skill
81
+ touch ~/.claude/skills/my-skill/SKILL.md
82
+ # Edit SKILL.md with frontmatter and instructions</code></pre>
83
+ <p>Or use the <code>skillify</code> plugin to create a skill from an existing workflow.</p>
84
+
85
+ <h2>Project-Level Skills</h2>
86
+ <p>Place skills in <code>.claude/skills/</code> inside your repository to share with your team:</p>
87
+ <pre><code>.claude/
88
+ skills/
89
+ code-review/
90
+ SKILL.md
91
+ migration-workflow/
92
+ SKILL.md</code></pre>
93
+ <p>Project skills are automatically available to everyone working in the repository.</p>
94
+
95
+ <h2>Dynamic Skills</h2>
96
+ <p>Skills can be discovered dynamically during file operations. When a skill file is created or modified, it's automatically added to the available command list without restarting. Use <code>clearCommandMemoizationCaches()</code> to refresh the skill index.</p>
97
+
98
+ <div class="callout callout-info">
99
+ <strong>Skills vs. Plugins</strong>
100
+ Skills are instruction-only (markdown), no code required. Plugins provide executable JavaScript — commands, hooks, agents, MCP servers. Use skills to standardize AI behavior; use plugins for custom tooling.
101
+ </div>
102
+
103
+ <footer class="footer">
104
+ <span>Clew Code v0.2.7 — Open Source</span>
105
+ <div class="footer-links">
106
+ <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
107
+ <a href="https://github.com/ClewCode/ClewCode/issues">Issues</a>
108
+ </div>
109
+ </footer>
110
+ </main>
111
+ <nav class="toc-sidebar"></nav>
112
+ </div>
113
+ </div>
114
+ <script src="js/main.js"></script>
115
+ </body>
116
+ </html>
117
+