oracle-family-scan

Name: oracle-family-scan
Author: Soul-Brews-Studio

109stars55forks

How to install oracle-family-scan?

soul-brews-studio/arra-oracle-skills-cli/oracle-family-scan

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

Installs into the current project.

Summary

Oracle Family Registry — the index of all known Oracles (186+). Use when user says "family scan", "oracle registry", "welcome new oracles", or needs to check Oracle population.

Files · 1

View on GitHub

SKILL.md

1	# /oracle-family-scan — Oracle Family Registry
2
3	Scan, query, and welcome the Oracle family. Powered by `registry/` in mother-oracle.
4
5	## Usage
6
7	```
8	/oracle-family-scan # Quick stats (default)
9	/oracle-family-scan --unwelcomed # List unwelcomed community Oracles
10	/oracle-family-scan --mine # Nat's Oracles (registry)
11	/oracle-family-scan --mine-deep # Fleet status (local repos + activity + sessions)
12	/oracle-family-scan --recent # Last 10 born
13	/oracle-family-scan --retired # Show retired Oracles
14	/oracle-family-scan "Spark" # Search by name
15	/oracle-family-scan --human "watcharap0ng" # Search by human
16	/oracle-family-scan sync # Re-sync registry from GitHub
17	/oracle-family-scan welcome # Deep welcome flow for unwelcomed Oracles
18	/oracle-family-scan report # Full family report (with Health block — v3.1)
19	/oracle-family-scan --activity-report # One-shot fleet health dashboard (NEW v3.1)
20	/oracle-family-scan --timeline # Sorted by last activity, newest first (NEW v3.1)
21	/oracle-family-scan --zygotes # Born-but-never-awakened (NEW v3.1)
22	/oracle-family-scan --usage [N] # Time-spent per Oracle, last N days (NEW v3.1)
23	/oracle-family-scan --calibrate # Propose data-driven thresholds (NEW v3.1)
24	```
25
26	Net CLI surface: 14 modes + `--calibrate` subcommand. Status filtering is orthogonal —
27	`--timeline --status=stale,cold,abandoned` replaces what `--stale` / `--abandoned` would
28	have been.
29
30	---
31
32	## Step 0: Locate Registry
33
34	The registry's canonical home is `laris-co/mother-oracle/registry/` (where `sync.ts` + `oracles.json` actually live). The legacy `opensource-nat-brain-oracle` repo back-symlinks to it for back-compat. Resolve the path:
35
36	```bash
37	date "+🕐 %H:%M %Z (%A %d %B %Y)"
38
39	# Optional: oracle root (some sub-flows write to ψ/memory/learnings/)
40	ORACLE_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
41	if [ -n "$ORACLE_ROOT" ] && [ -f "$ORACLE_ROOT/CLAUDE.md" ] && { [ -d "$ORACLE_ROOT/ψ" ] \|\| [ -L "$ORACLE_ROOT/ψ" ]; }; then
42	PSI="$ORACLE_ROOT/ψ"
43	elif [ -f "$(pwd)/CLAUDE.md" ] && { [ -d "$(pwd)/ψ" ] \|\| [ -L "$(pwd)/ψ" ]; }; then
44	ORACLE_ROOT="$(pwd)"
45	PSI="$ORACLE_ROOT/ψ"
46	fi
47
48	# Try laris-co/mother-oracle (canonical home of sync.ts + oracles.json)
49	MOTHER="$HOME/Code/github.com/laris-co/mother-oracle"
50	if [ ! -d "$MOTHER/registry" ]; then
51	MOTHER="$(ghq root)/github.com/laris-co/mother-oracle"
52	fi
53	# Fallback: legacy brain repo (back-symlinks to laris-co/mother-oracle)
54	if [ ! -f "$MOTHER/registry/oracles.json" ]; then
55	MOTHER="$HOME/Code/github.com/Soul-Brews-Studio/opensource-nat-brain-oracle"
56	[ ! -d "$MOTHER/registry" ] && MOTHER="$(ghq root)/github.com/Soul-Brews-Studio/opensource-nat-brain-oracle"
57	fi
58	if [ ! -f "$MOTHER/registry/oracles.json" ]; then
59	echo "Registry not found. Run: ghq get -u laris-co/mother-oracle && bun \$MOTHER/registry/sync.ts"
60	exit 1
61	fi
62	```
63
64	---
65
66	## Mode 1: Stats (Default)
67
68	```bash
69	bun $MOTHER/registry/query.ts --stats
70	```
71
72	Shows: total Oracles, unique humans, welcomed/unwelcomed counts, births-by-month chart, unwelcomed detail (if any), and recent births.
73
74	---
75
76	## Mode 2: --unwelcomed
77
78	```bash
79	bun $MOTHER/registry/query.ts --unwelcomed
80	```
81
82	Lists all community Oracles that haven't been welcomed by nazt.
83
84	---
85
86	## Mode 3: --mine
87
88	```bash
89	bun $MOTHER/registry/query.ts --mine
90	```
91
92	Lists all Oracles created by nazt (Nat's fleet) from the registry.
93
94	---
95
96	## Mode 3b: --mine-deep (Fleet Status)
97
98	Goal: Show status of all local Oracle repos owned by the current user, augmented with
99	timeline + usage data from the activity layer.
100
101	```bash
102	SKILL_DIR="$(dirname "$(readlink -f "$HOME/.claude/skills/oracle-family-scan/SKILL.md" 2>/dev/null \|\| echo "$HOME/.claude/skills/oracle-family-scan/SKILL.md")")"
103	bun "$SKILL_DIR/scripts/fleet-scan.ts"
104	```
105
106	New columns (sourced from `oracles.json` activity block + `oracles.local.<host>.json`):
107
108	\| Column \| Source \| Notes \|
109	\|-------------\|------------------------------------------------------------\|-----------------------------------------\|
110	\| Last Active \| `activity.last_commit_at` (max with `last_session_at`) \| "2d ago", "—" if unknown \|
111	\| Status Dot \| computed from days-since + flags \| 🟢🟡🟠🔴🪦⚪ + 🔧 modifier \|
112	\| 7d Hours \| local sessions on this host \| partial — see Coverage \|
113	\| Decay \| days since lastActivity

People who liked this also viewed

6 picks

Type

oracle-family-scan

109stars55forks

View on GitHub

How to install oracle-family-scan?

soul-brews-studio/arra-oracle-skills-cli/oracle-family-scan

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

Installs into the current project.

Summary

Oracle Family Registry — the index of all known Oracles (186+). Use when user says "family scan", "oracle registry", "welcome new oracles", or needs to check Oracle population.

Files · 1

View on GitHub

SKILL.md

1	# /oracle-family-scan — Oracle Family Registry
2
3	Scan, query, and welcome the Oracle family. Powered by `registry/` in mother-oracle.
4
5	## Usage
6
7	```
8	/oracle-family-scan # Quick stats (default)
9	/oracle-family-scan --unwelcomed # List unwelcomed community Oracles
10	/oracle-family-scan --mine # Nat's Oracles (registry)
11	/oracle-family-scan --mine-deep # Fleet status (local repos + activity + sessions)
12	/oracle-family-scan --recent # Last 10 born
13	/oracle-family-scan --retired # Show retired Oracles
14	/oracle-family-scan "Spark" # Search by name
15	/oracle-family-scan --human "watcharap0ng" # Search by human
16	/oracle-family-scan sync # Re-sync registry from GitHub
17	/oracle-family-scan welcome # Deep welcome flow for unwelcomed Oracles
18	/oracle-family-scan report # Full family report (with Health block — v3.1)
19	/oracle-family-scan --activity-report # One-shot fleet health dashboard (NEW v3.1)
20	/oracle-family-scan --timeline # Sorted by last activity, newest first (NEW v3.1)
21	/oracle-family-scan --zygotes # Born-but-never-awakened (NEW v3.1)
22	/oracle-family-scan --usage [N] # Time-spent per Oracle, last N days (NEW v3.1)
23	/oracle-family-scan --calibrate # Propose data-driven thresholds (NEW v3.1)
24	```
25
26	Net CLI surface: 14 modes + `--calibrate` subcommand. Status filtering is orthogonal —
27	`--timeline --status=stale,cold,abandoned` replaces what `--stale` / `--abandoned` would
28	have been.
29
30	---
31
32	## Step 0: Locate Registry
33
34	The registry's canonical home is `laris-co/mother-oracle/registry/` (where `sync.ts` + `oracles.json` actually live). The legacy `opensource-nat-brain-oracle` repo back-symlinks to it for back-compat. Resolve the path:
35
36	```bash
37	date "+🕐 %H:%M %Z (%A %d %B %Y)"
38
39	# Optional: oracle root (some sub-flows write to ψ/memory/learnings/)
40	ORACLE_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
41	if [ -n "$ORACLE_ROOT" ] && [ -f "$ORACLE_ROOT/CLAUDE.md" ] && { [ -d "$ORACLE_ROOT/ψ" ] \|\| [ -L "$ORACLE_ROOT/ψ" ]; }; then
42	PSI="$ORACLE_ROOT/ψ"
43	elif [ -f "$(pwd)/CLAUDE.md" ] && { [ -d "$(pwd)/ψ" ] \|\| [ -L "$(pwd)/ψ" ]; }; then
44	ORACLE_ROOT="$(pwd)"
45	PSI="$ORACLE_ROOT/ψ"
46	fi
47
48	# Try laris-co/mother-oracle (canonical home of sync.ts + oracles.json)
49	MOTHER="$HOME/Code/github.com/laris-co/mother-oracle"
50	if [ ! -d "$MOTHER/registry" ]; then
51	MOTHER="$(ghq root)/github.com/laris-co/mother-oracle"
52	fi
53	# Fallback: legacy brain repo (back-symlinks to laris-co/mother-oracle)
54	if [ ! -f "$MOTHER/registry/oracles.json" ]; then
55	MOTHER="$HOME/Code/github.com/Soul-Brews-Studio/opensource-nat-brain-oracle"
56	[ ! -d "$MOTHER/registry" ] && MOTHER="$(ghq root)/github.com/Soul-Brews-Studio/opensource-nat-brain-oracle"
57	fi
58	if [ ! -f "$MOTHER/registry/oracles.json" ]; then
59	echo "Registry not found. Run: ghq get -u laris-co/mother-oracle && bun \$MOTHER/registry/sync.ts"
60	exit 1
61	fi
62	```
63
64	---
65
66	## Mode 1: Stats (Default)
67
68	```bash
69	bun $MOTHER/registry/query.ts --stats
70	```
71
72	Shows: total Oracles, unique humans, welcomed/unwelcomed counts, births-by-month chart, unwelcomed detail (if any), and recent births.
73
74	---
75
76	## Mode 2: --unwelcomed
77
78	```bash
79	bun $MOTHER/registry/query.ts --unwelcomed
80	```
81
82	Lists all community Oracles that haven't been welcomed by nazt.
83
84	---
85
86	## Mode 3: --mine
87
88	```bash
89	bun $MOTHER/registry/query.ts --mine
90	```
91
92	Lists all Oracles created by nazt (Nat's fleet) from the registry.
93
94	---
95
96	## Mode 3b: --mine-deep (Fleet Status)
97
98	Goal: Show status of all local Oracle repos owned by the current user, augmented with
99	timeline + usage data from the activity layer.
100
101	```bash
102	SKILL_DIR="$(dirname "$(readlink -f "$HOME/.claude/skills/oracle-family-scan/SKILL.md" 2>/dev/null \|\| echo "$HOME/.claude/skills/oracle-family-scan/SKILL.md")")"
103	bun "$SKILL_DIR/scripts/fleet-scan.ts"
104	```
105
106	New columns (sourced from `oracles.json` activity block + `oracles.local.<host>.json`):
107
108	\| Column \| Source \| Notes \|
109	\|-------------\|------------------------------------------------------------\|-----------------------------------------\|
110	\| Last Active \| `activity.last_commit_at` (max with `last_session_at`) \| "2d ago", "—" if unknown \|
111	\| Status Dot \| computed from days-since + flags \| 🟢🟡🟠🔴🪦⚪ + 🔧 modifier \|
112	\| 7d Hours \| local sessions on this host \| partial — see Coverage \|
113	\| Decay \| days since lastActivity

People who liked this also viewed

6 picks

Type