contacts

Name: contacts
Author: Soul-Brews-Studio

109stars55forks

How to install contacts?

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

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

Installs into the current project.

Summary

Manage Oracle contacts — add, list, remove agents with their transport info (maw, inbox, thread). Use when user says "contacts", "add contact", "register agent", "who can I talk to", "list contacts". Do NOT trigger for sending messages (use /talk-to) or family registry (use /orac

Files · 1

View on GitHub

SKILL.md

1	# /contacts - Oracle Contact Registry
2
3	Manage contacts for `/talk-to` routing. Stored in repo at `ψ/contacts.json` — committable, shareable.
4
5	## Step 0: Ground (date-stamp + root capture)
6
7	Run before any mode — current-time reference for the AI (#301) plus absolute
8	`$PSI` so announce-mode writes show clickable paths (CONVENTIONS.md).
9
10	```bash
11	date "+🕐 %H:%M %Z (%A %d %B %Y)"
12	ORACLE_ROOT=$(git rev-parse --show-toplevel 2>/dev/null \|\| pwd)
13	PSI="$ORACLE_ROOT/ψ"
14	CONTACTS_FILE="$PSI/contacts.json"
15	```
16
17	## File Location
18
19	```
20	ψ/contacts.json
21	```
22
23	If `ψ/` doesn't exist, use `.oracle/contacts.json` as fallback.
24
25	## Schema
26
27	```json
28	{
29	"contacts": {
30	"peter": {
31	"maw": "peter-oracle",
32	"thread": "channel:peter",
33	"inbox": "/home/peter/Code/peter-oracle/ψ/inbox",
34	"repo": "laris-co/peter-oracle",
35	"notes": "Frontend dev, available weekdays"
36	},
37	"pulse": {
38	"maw": "pulse-oracle",
39	"thread": "channel:pulse",
40	"inbox": null,
41	"repo": "laris-co/pulse-oracle",
42	"notes": "PM bot"
43	}
44	},
45	"updated": "2026-03-23T22:30:00Z"
46	}
47	```
48
49	## Usage
50
51	```
52	/contacts # list all
53	/contacts list # same
54	/contacts add peter # interactive — ask transports one by one
55	/contacts add peter --maw peter-oracle --inbox /path/ψ/inbox
56	/contacts remove peter # remove (with confirmation)
57	/contacts show peter # show details for one contact
58	```
59
60	---
61
62	## Mode 1: List (default)
63
64	Read `ψ/contacts.json`. Display:
65
66	```
67	📇 Contacts (4)
68
69	# Name maw repo inbox
70	── ────────────── ──────────────── ─────────────────────── ──────
71	1 peter peter-oracle laris-co/peter-oracle ✓
72	2 pulse pulse-oracle laris-co/pulse-oracle ✗
73	3 hermes hermes-oracle laris-co/hermes-oracle ✓
74	4 neo neo-oracle laris-co/neo-oracle ✓
75	```
76
77	If no contacts file exists:
78
79	```
80	📇 No contacts yet.
81
82	/contacts add <name> — register a new contact
83	```
84
85	---
86
87	## Mode 2: Add
88
89	### `/contacts add <name>`
90
91	Ask each transport one by one. User can skip any with Enter.
92
93	```
94	📇 Register: peter
95
96	1. maw name? (for `maw hey <name>`)
97	→ peter-oracle
98
99	2. Thread channel? (for Oracle threads)
100	→ channel:peter [default: channel:{name}]
101
102	3. Inbox path? (for direct ψ/inbox/ writes)
103	→ /home/peter/Code/peter-oracle/ψ/inbox
104	(Enter to skip — not all agents have accessible inbox)
105
106	4. Repo? (org/repo on GitHub)
107	→ laris-co/peter-oracle [default: guess from maw name]
108
109	5. Notes? (optional)
110	→ Frontend dev, Thai timezone
111	```
112
113	### With flags
114
115	```
116	/contacts add peter --maw peter-oracle --inbox /path/ψ/inbox
117	```
118
119	Skip interactive for provided flags. Still ask for missing ones.
120
121	### Save
122
123	```bash
124	# Read existing — $CONTACTS_FILE comes from Step 0 (absolute, via $PSI).
125	mkdir -p "$(dirname "$CONTACTS_FILE")"
126
127	# If file doesn't exist, create empty
128	if [ ! -f "$CONTACTS_FILE" ]; then
129	echo '{"contacts":{},"updated":""}' > "$CONTACTS_FILE"
130	fi
131	```
132
133	Use `jq` or Write tool to update the JSON. Set `updated` to current ISO timestamp.
134
135	### Commit
136
137	After adding, ask:
138
139	```
140	✅ Added peter. Commit? [Y/n]
141	```
142
143	If yes:
144	```bash
145	git add ψ/contacts.json
146	git commit -m "contacts: add peter"
147	```
148
149	---
150
151	## Mode 3: Remove
152
153	### `/contacts remove <name>`
154
155	Show the contact details, ask confirmation:
156
157	```
158	Remove peter?
159	maw: peter-oracle
160	thread: channel:peter
161	inbox: /home/peter/.../ψ/inbox
162
163	[Y/n]
164	```
165
166	If yes, remove from JSON, save, optionally commit.
167
168	---
169
170	## Mode 4: Show
171
172	### `/contacts show <name>`
173
174	```
175	📇 peter
176
177	maw: peter-oracle
178	thread: channel:peter
179	inbox: /home/peter/Code/peter-oracle/ψ/inbox
180	repo: laris-co/peter-oracle
181	notes: Frontend dev, Thai timezone
182	```
183
184	---
185
186	## Integration with /talk-to
187
188	`/talk-to` should read `ψ/contacts.json` before routing:
189
190	1. Parse agent name from arguments
191	2. Check `ψ/contacts.json` → found? Use registered transports
192	3. Not found? → Ask: "I don't know {name}. Run /contacts add {name}?"
193	4. After registration → retry the message
194
195	---
196
197	ARGUMENTS: $ARGUMENTS

People who liked this also viewed

6 picks

Type

contacts

109stars55forks

View on GitHub

How to install contacts?

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

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

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# /contacts - Oracle Contact Registry
2
3	Manage contacts for `/talk-to` routing. Stored in repo at `ψ/contacts.json` — committable, shareable.
4
5	## Step 0: Ground (date-stamp + root capture)
6
7	Run before any mode — current-time reference for the AI (#301) plus absolute
8	`$PSI` so announce-mode writes show clickable paths (CONVENTIONS.md).
9
10	```bash
11	date "+🕐 %H:%M %Z (%A %d %B %Y)"
12	ORACLE_ROOT=$(git rev-parse --show-toplevel 2>/dev/null \|\| pwd)
13	PSI="$ORACLE_ROOT/ψ"
14	CONTACTS_FILE="$PSI/contacts.json"
15	```
16
17	## File Location
18
19	```
20	ψ/contacts.json
21	```
22
23	If `ψ/` doesn't exist, use `.oracle/contacts.json` as fallback.
24
25	## Schema
26
27	```json
28	{
29	"contacts": {
30	"peter": {
31	"maw": "peter-oracle",
32	"thread": "channel:peter",
33	"inbox": "/home/peter/Code/peter-oracle/ψ/inbox",
34	"repo": "laris-co/peter-oracle",
35	"notes": "Frontend dev, available weekdays"
36	},
37	"pulse": {
38	"maw": "pulse-oracle",
39	"thread": "channel:pulse",
40	"inbox": null,
41	"repo": "laris-co/pulse-oracle",
42	"notes": "PM bot"
43	}
44	},
45	"updated": "2026-03-23T22:30:00Z"
46	}
47	```
48
49	## Usage
50
51	```
52	/contacts # list all
53	/contacts list # same
54	/contacts add peter # interactive — ask transports one by one
55	/contacts add peter --maw peter-oracle --inbox /path/ψ/inbox
56	/contacts remove peter # remove (with confirmation)
57	/contacts show peter # show details for one contact
58	```
59
60	---
61
62	## Mode 1: List (default)
63
64	Read `ψ/contacts.json`. Display:
65
66	```
67	📇 Contacts (4)
68
69	# Name maw repo inbox
70	── ────────────── ──────────────── ─────────────────────── ──────
71	1 peter peter-oracle laris-co/peter-oracle ✓
72	2 pulse pulse-oracle laris-co/pulse-oracle ✗
73	3 hermes hermes-oracle laris-co/hermes-oracle ✓
74	4 neo neo-oracle laris-co/neo-oracle ✓
75	```
76
77	If no contacts file exists:
78
79	```
80	📇 No contacts yet.
81
82	/contacts add <name> — register a new contact
83	```
84
85	---
86
87	## Mode 2: Add
88
89	### `/contacts add <name>`
90
91	Ask each transport one by one. User can skip any with Enter.
92
93	```
94	📇 Register: peter
95
96	1. maw name? (for `maw hey <name>`)
97	→ peter-oracle
98
99	2. Thread channel? (for Oracle threads)
100	→ channel:peter [default: channel:{name}]
101
102	3. Inbox path? (for direct ψ/inbox/ writes)
103	→ /home/peter/Code/peter-oracle/ψ/inbox
104	(Enter to skip — not all agents have accessible inbox)
105
106	4. Repo? (org/repo on GitHub)
107	→ laris-co/peter-oracle [default: guess from maw name]
108
109	5. Notes? (optional)
110	→ Frontend dev, Thai timezone
111	```
112
113	### With flags
114
115	```
116	/contacts add peter --maw peter-oracle --inbox /path/ψ/inbox
117	```
118
119	Skip interactive for provided flags. Still ask for missing ones.
120
121	### Save
122
123	```bash
124	# Read existing — $CONTACTS_FILE comes from Step 0 (absolute, via $PSI).
125	mkdir -p "$(dirname "$CONTACTS_FILE")"
126
127	# If file doesn't exist, create empty
128	if [ ! -f "$CONTACTS_FILE" ]; then
129	echo '{"contacts":{},"updated":""}' > "$CONTACTS_FILE"
130	fi
131	```
132
133	Use `jq` or Write tool to update the JSON. Set `updated` to current ISO timestamp.
134
135	### Commit
136
137	After adding, ask:
138
139	```
140	✅ Added peter. Commit? [Y/n]
141	```
142
143	If yes:
144	```bash
145	git add ψ/contacts.json
146	git commit -m "contacts: add peter"
147	```
148
149	---
150
151	## Mode 3: Remove
152
153	### `/contacts remove <name>`
154
155	Show the contact details, ask confirmation:
156
157	```
158	Remove peter?
159	maw: peter-oracle
160	thread: channel:peter
161	inbox: /home/peter/.../ψ/inbox
162
163	[Y/n]
164	```
165
166	If yes, remove from JSON, save, optionally commit.
167
168	---
169
170	## Mode 4: Show
171
172	### `/contacts show <name>`
173
174	```
175	📇 peter
176
177	maw: peter-oracle
178	thread: channel:peter
179	inbox: /home/peter/Code/peter-oracle/ψ/inbox
180	repo: laris-co/peter-oracle
181	notes: Frontend dev, Thai timezone
182	```
183
184	---
185
186	## Integration with /talk-to
187
188	`/talk-to` should read `ψ/contacts.json` before routing:
189
190	1. Parse agent name from arguments
191	2. Check `ψ/contacts.json` → found? Use registered transports
192	3. Not found? → Ask: "I don't know {name}. Run /contacts add {name}?"
193	4. After registration → retry the message
194
195	---
196
197	ARGUMENTS: $ARGUMENTS

People who liked this also viewed

6 picks

Type