inbox

Name: inbox
Author: Soul-Brews-Studio

109stars55forks

How to install inbox?

soul-brews-studio/arra-oracle-skills-cli/inbox

$npx -y skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill inbox

Installs into the current project.

Summary

Read and write to Oracle inbox — notes, tasks, messages, handoffs. Use when user says "inbox", "leave a note", "write to inbox", "check inbox", "what's pending", or wants to read/write messages for self or other agents. Do NOT trigger for session handoffs (use /forward), schedule

Files · 1

View on GitHub

SKILL.md

1	# /inbox - Oracle Inbox
2
3	Read and write timestamped notes to `ψ/inbox/`.
4
5	## Usage
6
7	```
8	/inbox # List recent inbox items
9	/inbox read # List recent inbox items (alias)
10	/inbox read <topic> # Read specific item by topic keyword
11	/inbox write <topic> # Write new inbox item
12	/inbox ls # List all items (full)
13	/inbox clean # Archive old items (move to ψ/archive/inbox/)
14	```
15
16	## Directory
17
18	```
19	ψ/inbox/
20	├── handoff/ # Session handoffs (managed by /forward)
21	├── schedule.md # Schedule (managed by /schedule)
22	├── YYYY-MM-DD_HHMM_<topic>.md # ← inbox items live here
23	└── ...
24	```
25
26	## Filename Format
27
28	Every inbox item follows this pattern:
29
30	```
31	YYYYMMDD_HHMM_<topic-slug>_from_<sender>.md
32	```
33
34	Example: `20260323_2112_fix-auth-bug_from_peter.md`
35
36	Rules:
37	- Date: compact `YYYYMMDD` (no dashes)
38	- Topic slug: lowercase, hyphens, no spaces
39	- Sender: who wrote it (oracle name or human name)
40	- Timestamp: local time (from `date`)
41	- Always at root of `ψ/inbox/` (not in subdirectories)
42
43	---
44
45	## Mode 1: Read (default)
46
47	### `/inbox` or `/inbox read`
48
49	```bash
50	ROOT="$(pwd)"
51	INBOX="$ROOT/ψ/inbox"
52	```
53
54	List all `.md` files in `ψ/inbox/` (excluding `schedule.md` and `handoff/`):
55
56	```bash
57	ls -1t "$INBOX"/*.md 2>/dev/null \| grep -v schedule.md \| head -10
58	```
59
60	`$INBOX` is absolute (set as `$ROOT/ψ/inbox` in Mode 1 Step 0), so `ls` already prints absolute paths — clickable as-is.
61
62	For each file, show:
63	```
64	📥 20260323 21:12 — fix-auth-bug (from peter)
65	First 2 lines of content...
66	```
67
68	If MCP available, also run:
69	```
70	oracle_inbox(limit=10)
71	```
72
73	### `/inbox read <topic>`
74
75	Find and display the most recent file matching the topic:
76
77	```bash
78	ls -1t "$INBOX"/<topic>.md 2>/dev/null \| head -1
79	```
80
81	Read and display full content.
82
83	---
84
85	## Mode 2: Write
86
87	### `/inbox write <topic>`
88
89	```bash
90	TS=$(date +%Y%m%d_%H%M)
91	SLUG=$(echo "<topic>" \| tr ' ' '-' \| tr '[:upper:]' '[:lower:]' \| sed 's/[^a-z0-9-]//g')
92	FROM=$(echo "<sender>" \| tr ' ' '-' \| tr '[:upper:]' '[:lower:]' \| sed 's/[^a-z0-9-]//g')
93	FILE="$INBOX/${TS}_${SLUG}_from_${FROM}.md"
94	```
95
96	Ask the user: "What do you want to note?" (unless content is provided after topic)
97
98	Write the file:
99
100	```markdown
101	---
102	topic: <topic>
103	from: <current-oracle-name>
104	timestamp: YYYY-MM-DD HH:MM
105	---
106
107	<user's content>
108	```
109
110	If MCP available, also call:
111	```
112	oracle_handoff(content, slug)
113	```
114
115	This syncs to vault for cross-Oracle discovery.
116
117	### Confirm write (announce-mode — absolute paths required)
118
119	# announce-mode → absolute path (no ψ/, no ~/, no $VAR, no ...).
120	# Use: echo "marker: $RESOLVED_PATH" — bash substitutes. See CONVENTIONS.md.
121
122	```bash
123	echo "📥 Written: $FILE"
124	```
125
126	---
127
128	## Mode 3: List All
129
130	### `/inbox ls`
131
132	Same as read but show ALL items (no limit), with file sizes:
133
134	```bash
135	ls -lht "$INBOX"/*.md 2>/dev/null \| grep -v schedule.md
136	```
137
138	Also count handoffs:
139	```bash
140	echo "📁 Handoffs: $(ls "$INBOX/handoff/" 2>/dev/null \| wc -l) files"
141	```
142
143	---
144
145	## Mode 4: Clean
146
147	### `/inbox clean`
148
149	Move items older than 7 days to archive:
150
151	```bash
152	ARCHIVE="$ROOT/ψ/archive/inbox"
153	mkdir -p "$ARCHIVE"
154	find "$INBOX" -maxdepth 1 -name "*.md" -not -name "schedule.md" -mtime +7 -exec mv {} "$ARCHIVE/" \;
155	```
156
157	Report what was moved. Never delete — move to archive (Nothing is Deleted).
158
159	---
160
161	## Who Can Write?
162
163	Any Oracle, any skill, any agent. The only rule: timestamp before topic in filename.
164
165	\| Writer \| How \| Example \|
166	\|--------\|-----\|---------\|
167	\| `/inbox write` \| This skill \| `20260323_2112_idea_from_neo.md` \|
168	\| `/forward` \| Handoff \| `ψ/inbox/handoff/20260323_2112_session-forward.md` \|
169	\| Another Oracle \| `/talk-to` + write \| `20260323_2112_status-update_from_odin.md` \|
170	\| Agent directly \| `oracle_handoff()` MCP \| Same format \|
171
172	---
173
174	ARGUMENTS: $ARGUMENTS

People who liked this also viewed

6 picks

Type

inbox

109stars55forks

View on GitHub

How to install inbox?

soul-brews-studio/arra-oracle-skills-cli/inbox

$npx -y skills add Soul-Brews-Studio/arra-oracle-skills-cli --skill inbox

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# /inbox - Oracle Inbox
2
3	Read and write timestamped notes to `ψ/inbox/`.
4
5	## Usage
6
7	```
8	/inbox # List recent inbox items
9	/inbox read # List recent inbox items (alias)
10	/inbox read <topic> # Read specific item by topic keyword
11	/inbox write <topic> # Write new inbox item
12	/inbox ls # List all items (full)
13	/inbox clean # Archive old items (move to ψ/archive/inbox/)
14	```
15
16	## Directory
17
18	```
19	ψ/inbox/
20	├── handoff/ # Session handoffs (managed by /forward)
21	├── schedule.md # Schedule (managed by /schedule)
22	├── YYYY-MM-DD_HHMM_<topic>.md # ← inbox items live here
23	└── ...
24	```
25
26	## Filename Format
27
28	Every inbox item follows this pattern:
29
30	```
31	YYYYMMDD_HHMM_<topic-slug>_from_<sender>.md
32	```
33
34	Example: `20260323_2112_fix-auth-bug_from_peter.md`
35
36	Rules:
37	- Date: compact `YYYYMMDD` (no dashes)
38	- Topic slug: lowercase, hyphens, no spaces
39	- Sender: who wrote it (oracle name or human name)
40	- Timestamp: local time (from `date`)
41	- Always at root of `ψ/inbox/` (not in subdirectories)
42
43	---
44
45	## Mode 1: Read (default)
46
47	### `/inbox` or `/inbox read`
48
49	```bash
50	ROOT="$(pwd)"
51	INBOX="$ROOT/ψ/inbox"
52	```
53
54	List all `.md` files in `ψ/inbox/` (excluding `schedule.md` and `handoff/`):
55
56	```bash
57	ls -1t "$INBOX"/*.md 2>/dev/null \| grep -v schedule.md \| head -10
58	```
59
60	`$INBOX` is absolute (set as `$ROOT/ψ/inbox` in Mode 1 Step 0), so `ls` already prints absolute paths — clickable as-is.
61
62	For each file, show:
63	```
64	📥 20260323 21:12 — fix-auth-bug (from peter)
65	First 2 lines of content...
66	```
67
68	If MCP available, also run:
69	```
70	oracle_inbox(limit=10)
71	```
72
73	### `/inbox read <topic>`
74
75	Find and display the most recent file matching the topic:
76
77	```bash
78	ls -1t "$INBOX"/<topic>.md 2>/dev/null \| head -1
79	```
80
81	Read and display full content.
82
83	---
84
85	## Mode 2: Write
86
87	### `/inbox write <topic>`
88
89	```bash
90	TS=$(date +%Y%m%d_%H%M)
91	SLUG=$(echo "<topic>" \| tr ' ' '-' \| tr '[:upper:]' '[:lower:]' \| sed 's/[^a-z0-9-]//g')
92	FROM=$(echo "<sender>" \| tr ' ' '-' \| tr '[:upper:]' '[:lower:]' \| sed 's/[^a-z0-9-]//g')
93	FILE="$INBOX/${TS}_${SLUG}_from_${FROM}.md"
94	```
95
96	Ask the user: "What do you want to note?" (unless content is provided after topic)
97
98	Write the file:
99
100	```markdown
101	---
102	topic: <topic>
103	from: <current-oracle-name>
104	timestamp: YYYY-MM-DD HH:MM
105	---
106
107	<user's content>
108	```
109
110	If MCP available, also call:
111	```
112	oracle_handoff(content, slug)
113	```
114
115	This syncs to vault for cross-Oracle discovery.
116
117	### Confirm write (announce-mode — absolute paths required)
118
119	# announce-mode → absolute path (no ψ/, no ~/, no $VAR, no ...).
120	# Use: echo "marker: $RESOLVED_PATH" — bash substitutes. See CONVENTIONS.md.
121
122	```bash
123	echo "📥 Written: $FILE"
124	```
125
126	---
127
128	## Mode 3: List All
129
130	### `/inbox ls`
131
132	Same as read but show ALL items (no limit), with file sizes:
133
134	```bash
135	ls -lht "$INBOX"/*.md 2>/dev/null \| grep -v schedule.md
136	```
137
138	Also count handoffs:
139	```bash
140	echo "📁 Handoffs: $(ls "$INBOX/handoff/" 2>/dev/null \| wc -l) files"
141	```
142
143	---
144
145	## Mode 4: Clean
146
147	### `/inbox clean`
148
149	Move items older than 7 days to archive:
150
151	```bash
152	ARCHIVE="$ROOT/ψ/archive/inbox"
153	mkdir -p "$ARCHIVE"
154	find "$INBOX" -maxdepth 1 -name "*.md" -not -name "schedule.md" -mtime +7 -exec mv {} "$ARCHIVE/" \;
155	```
156
157	Report what was moved. Never delete — move to archive (Nothing is Deleted).
158
159	---
160
161	## Who Can Write?
162
163	Any Oracle, any skill, any agent. The only rule: timestamp before topic in filename.
164
165	\| Writer \| How \| Example \|
166	\|--------\|-----\|---------\|
167	\| `/inbox write` \| This skill \| `20260323_2112_idea_from_neo.md` \|
168	\| `/forward` \| Handoff \| `ψ/inbox/handoff/20260323_2112_session-forward.md` \|
169	\| Another Oracle \| `/talk-to` + write \| `20260323_2112_status-update_from_odin.md` \|
170	\| Agent directly \| `oracle_handoff()` MCP \| Same format \|
171
172	---
173
174	ARGUMENTS: $ARGUMENTS

People who liked this also viewed

6 picks

Type