From 1c0ec84d510c5157d3afbb3c6266dda3d243e9ab Mon Sep 17 00:00:00 2001
From: dawn <90008@klbr.net>
Date: Thu, 3 Sep 2026 17:55:31 +0900
Subject: [PATCH] docs: add python kernel skill API to README

---
 README.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/README.md b/README.md
index 2cceafd..30e5437 100644
--- a/README.md
+++ b/README.md
@@ -53,6 +53,8 @@ restart Prime, or run `/reload` in a running session.
 
 ## use
 
+### for users (slash commands)
+
 ```text
 /threads                     list open and closed threads
 /threads done <id>           explicit user acceptance -> done
@@ -63,6 +65,17 @@ restart Prime, or run `/reload` in a running session.
 /threads reconcile           run the observer now
 ```
 
+### for agents (python skill)
+
+agents can inspect and control threads programmatically from the python REPL using the bundled `threads` skill:
+
+```python
+await threads.list()                                # list open and closed threads
+await threads.complete("t1", reason="done in test") # mark thread complete
+await threads.dismiss("t2", reason="obsolete")     # dismiss unwanted thread
+await threads.reopen("t3")                          # reopen a closed thread
+```
+
 nothing is hidden: every thread the model tracks is visible and correctable here.
 
 ### environment variables
-- 
2.51.2