القائمة
NeuroSkill `search` and `compare` commands — ANN search for neurally similar EXG moments across all history, and A/B session comparison with metric deltas, trend directions, and UMAP enqueuing. Use when finding similar past brain states or comparing two recording sessions.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
NeuroSkill EXG data reference — all metric fields including band powers, EXG ratios and indices, core scores, complexity measures, PPG/HRV fields, motion and artifact markers, sleep stage codes, EXG correlate indices, and consciousness metrics. Use when looking up what a specific metric means or its value range.
NeuroSkill `label`, `search-labels`, and `interactive` commands — creating EXG text annotations, semantic vector search over labels, and cross-modal 4-layer graph search combining text and EXG similarity. Use when annotating EXG moments or searching for past states by description.
Full guided-protocol repertoire for neuroloop — 70+ mind-body practices organised by EXG metric signal. Covers attention, stress, emotions, relaxation, sleep, somatic, consciousness, cognitive performance, motor, neck, eyes, morning routines, workout/gym, hydration, bathroom breaks, emotions, music, social-media addiction, and dietary protocols. Loaded on-demand when protocol context is detected.
NeuroSkill use-case recipes and scripting patterns — shell snippets for focus and productivity monitoring, stress and anxiety tracking, sleep quality analysis, ADHD/cognitive-load queries, meditation tracking, cross-modal graph search, A/B session comparison, time-range queries, and automation with cron/Python/Node.js/HTTP. Use when looking for practical examples or building automation pipelines.
NeuroSkill `session` and `sessions` commands — per-session metric breakdowns with first/second-half trends, session listing across all days, and Unix timestamp helpers. Use when analysing a specific recording session or listing all available sessions.
NeuroSkill `sleep` and `umap` commands — EXG-based sleep stage classification (Wake/N1/N2/N3/REM) with efficiency and bout analysis, and 3D UMAP projection of session embeddings for spatial comparison. Use when analysing sleep quality or visualising neural state separation between sessions.
| name | neuroskill-search |
| description | NeuroSkill `search` and `compare` commands — ANN search for neurally similar EXG moments across all history, and A/B session comparison with metric deltas, trend directions, and UMAP enqueuing. Use when finding similar past brain states or comparing two recording sessions. |
search and compare Commandssearch — Neural Similarity SearchFind EXG moments from your entire history that are neurally similar to a query range. Uses approximate nearest-neighbor (ANN) search over the 5-second embedding HNSW index.
Auto-range: when no --start/--end flags are given, the CLI automatically uses your
most recent session and prints a rerun: line you can copy-paste.
npx neuroskill search # auto: last session, k=5
npx neuroskill search --k 10 # 10 nearest neighbors
npx neuroskill search --start 1740412800 --end 1740415500
npx neuroskill search --start 1740412800 --end 1740415500 --k 20
npx neuroskill search --json | jq '.result.results | length'
npx neuroskill search --json | jq '.result.results[0].neighbors[0]'
HTTP:
curl -s -X POST http://127.0.0.1:8375/ \
-H "Content-Type: application/json" \
-d '{"command":"search","start_utc":1740412800,"end_utc":1740415500,"k":5}'
{
"command": "search",
"ok": true,
"result": {
"query_count": 541,
"searched_days": ["20260224", "20260223"],
"analysis": {
"distance_stats": { "min": 0.0231, "mean": 0.1842, "max": 0.3901, "stddev": 0.0612 },
"time_span_hours": 744.3,
"neighbor_metrics": { "focus": 0.67, "relaxation": 0.43, "hr": 67.4 },
"temporal_distribution": { "8": 142, "9": 198 },
"top_days": [["20260222", 312], ["20260221", 289]]
},
"results": [
{
"timestamp_unix": 1740412800,
"neighbors": [
{
"distance": 0.0231,
"timestamp_unix": 1740320040,
"date": "20260222",
"device_name": "Muse-A1B2",
"labels": [{ "text": "morning focus block" }],
"metrics": { "focus": 0.73, "relaxation": 0.41, "hr": 66.2, "rel_alpha": 0.34 }
}
]
}
]
}
}
--full or --json)| Hidden field | Contents |
|---|---|
result.results[] | Full list of query epochs with complete neighbors[] arrays |
result.analysis.temporal_distribution | Hour-of-day match counts as raw numbers |
result.analysis.top_days | [["YYYYMMDD", count], …] |
npx neuroskill search --json | jq '.result.results | length'
npx neuroskill search --json | jq '.result.results[0].neighbors'
npx neuroskill search --json | jq '[.result.results[].neighbors[]] | sort_by(.distance) | .[0]'
npx neuroskill search --json | jq '.result.analysis.temporal_distribution'
compare — A/B Session ComparisonSide-by-side A/B comparison of two sessions. Returns averaged metrics for both ranges, delta values, and trend direction for every metric. Also enqueues a 3D UMAP projection.
Auto-range: uses your last two sessions as A (older) and B (newer).
npx neuroskill compare # auto: last 2 sessions
npx neuroskill compare --a-start 1740380100 --a-end 1740382665 \
--b-start 1740412800 --b-end 1740415510
npx neuroskill compare --json
npx neuroskill compare --json | jq '{a_focus: .a.focus, b_focus: .b.focus}'
npx neuroskill compare --json | jq '.insights.deltas.focus'
npx neuroskill compare --json | jq '.insights.improved'
npx neuroskill compare --json | jq '.insights.declined'
HTTP:
curl -s -X POST http://127.0.0.1:8375/ \
-H "Content-Type: application/json" \
-d '{
"command": "compare",
"a_start_utc": 1740380100, "a_end_utc": 1740382665,
"b_start_utc": 1740412800, "b_end_utc": 1740415510
}' | jq '{a_focus: .a.focus, b_focus: .b.focus}'
{
"ok": true,
"a": { "focus": 0.62, "relaxation": 0.45, "hr": 72.1, "n_epochs": 513 /* ... */ },
"b": { "focus": 0.71, "relaxation": 0.38, "hr": 68.4, "n_epochs": 541 /* ... */ },
"sleep_a": { "total_epochs": 0 /* ... */ },
"sleep_b": { "total_epochs": 0 /* ... */ },
"insights": {
"n_epochs_a": 513,
"n_epochs_b": 541,
"deltas": {
"focus": { "a": 0.62, "b": 0.71, "abs": 0.09, "pct": 14.5, "direction": "up" },
"relaxation": { "a": 0.45, "b": 0.38, "abs": -0.07, "pct": -15.6, "direction": "down" }
},
"improved": ["focus", "meditation", "engagement"],
"declined": ["relaxation", "hr"]
},
"umap": {
"queued": true,
"job_id": 5,
"estimated_secs": 14,
"n_a": 513,
"n_b": 541
}
}
| Hidden field | Contents |
|---|---|
a / b | All ~50 averaged metrics for each session |
sleep_a / sleep_b | Full sleep staging summary for each range |
insights.deltas | Full delta table for every metric |
umap | Enqueued job info — use with umap command |
npx neuroskill compare --json | jq '.a' # all metrics for A
npx neuroskill compare --json | jq '.b' # all metrics for B
npx neuroskill compare --json | jq '.insights.deltas' # every metric delta
npx neuroskill compare --json | jq '.insights.deltas | to_entries | sort_by(.value.pct) | reverse'
npx neuroskill compare --json | jq '.umap.job_id' # use with umap --json