Agent skill

RuView Deployment Configuration

by ruvnet in ruvnet/RuView

Tunes a deployed RuView WiFi-sensing system without changing code: firmware sdkconfig variants, NVS provisioning over serial, channel and MAC filtering, edge processing tiers and mesh slotting.

MITAuto-check: notesDevOps & Cloud

Install RuView Deployment Configuration

skills CLI
$ npx skills add ruvnet/RuView --skill ruview-configure -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ruvnet/RuView ruview-configure --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ruvnet/RuView.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ruview/skills/ruview-configure .claude/skills/ruview-configure && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ruview-configure
GitHub stars
97k
Token cost
~1.7k tokens
SKILL.md length
559 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Tunes a deployed RuView WiFi-sensing system without changing code: firmware sdkconfig variants, NVS provisioning over serial, channel and MAC filtering, edge processing tiers and mesh slotting.

  • Works in 7 steps: Firmware build-time config (sdkconfig) → Runtime device config (NVS via… → Sensing server flags → …
  • Switching a RuView node's firmware build between the 8MB, 4MB or Heltec variants
  • SKILL.md covers 1. Firmware build-time config…, 2. Runtime device config (NVS…, 3. Sensing server flags and 4. Edge intelligence modules…, plus 4 more sections
  • Calls cargo, python and node

What it does

The skill covers two configuration layers. Firmware build-time config picks an sdkconfig variant file, such as the 8MB default with real WiFi CSI, a 4MB variant for the ESP32-S3 SuperMini with the display disabled and dual OTA slots, or a Heltec N16R2 variant, copied into place before a rebuild; it warns never to test in mock mode because a fall-threshold Kconfig bug only appeared with real CSI data.

Runtime device config is written to the csi_cfg NVS namespace over the serial port by provision.py, whose flags cover WiFi credentials and the aggregator's UDP sink, TDM mesh slot and total node count for multi-node setups, an edge-processing tier (0 off, 1 stats, 2 vitals), detection thresholds for presence and fall sensitivity, vitals window and subcarrier count, channel selection or multi-frequency hopping, MAC filtering, and Cognitum Seed integration with a seed URL, token and zone.

When your agent uses it

  • Switching a RuView node's firmware build between the 8MB, 4MB or Heltec variants
  • Provisioning a new ESP32 node's WiFi, mesh slot and detection thresholds over serial
  • Reducing false fall-detection alerts in a high-traffic deployment
  • Connecting a node to Cognitum Seed for a given zone

Example prompts

  • “Switch this node to the 4MB sdkconfig variant and rebuild.”
  • “Provision the node on COM8 with our WiFi credentials and a fall threshold of 20000.”
  • “Set up multi-frequency channel hopping across channels 1, 6 and 11 for this node.”

Requirements

  • Python, to run provision.py
  • An ESP32-S3 device connected over serial
  • Pre-approved tools (allowed-tools): Bash, Read, Write, Edit, Glob, Grep

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Firmware build-time config (sdkconfig)
  2. Runtime device config (NVS via provision.py)
  3. Sensing server flags
  4. Edge intelligence modules (ADR-041)
  5. Multi-node mesh
  6. Cognitum Seed integration ($140 total BOM)
  7. App-level config

What it can do on your machine

Read from SKILL.md and the folder at commit 0ef6b96. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • Edit
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • cargo
    • python
    • node
    • docker

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use docker, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

RuView Deployment Configuration loads about 1.7k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 559 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~78
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, Edit, Glob, Grep

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ruvnet/RuView at commit 0ef6b96, republished under its MIT licence (© ruvnet). 559 words, ~1,651 tokens.

Download SKILL.mdSave it as .claude/skills/ruview-configure/SKILL.md (or your agent's skills folder).
name
ruview-configure
description
Configure RuView — ESP32 sdkconfig variants, NVS provisioning, WiFi channel / MAC filter overrides (ADR-060), edge intelligence modules (ADR-041), sensing-server flags, multi-node mesh, and Cognitum Seed integration. Use when adjusting how a deployed RuView system behaves without changing code.
allowed-tools
Bash, Read, Write, Edit, Glob, Grep

RuView Configuration

Everything you can tune in a RuView deployment, from a one-line provision flag to a full mesh + Cognitum Seed setup.

1. Firmware build-time config (sdkconfig)

VariantFileWhen
8MB (default)firmware/esp32-csi-node/sdkconfig.defaults.templateESP32-S3 8MB, full feature set, real WiFi CSI
4MBfirmware/esp32-csi-node/sdkconfig.defaults.4mbESP32-S3 SuperMini 4MB — display disabled, dual OTA slots (partitions_4mb.csv, ~1.856 MB each)
Heltec N16R2firmware/esp32-csi-node/sdkconfig.defaults.heltec_n16r2Heltec boards

Switch: cp firmware/esp32-csi-node/sdkconfig.defaults.<variant> firmware/esp32-csi-node/sdkconfig.defaults, then rebuild (see ruview-hardware-setup). Never test in mock mode — the Kconfig fall-threshold bug only showed up with real CSI.

2. Runtime device config (NVS via provision.py)

provision.py writes the csi_cfg NVS namespace over the serial port. Run python firmware/esp32-csi-node/provision.py --help for the authoritative flag list (on Windows force PYTHONUTF8=1 PYTHONIOENCODING=utf-8 — the help text contains non-ASCII and crashes under cp1252).

bash
python firmware/esp32-csi-node/provision.py --port COM8 \
  --ssid "WiFi" --password "secret" \
  --target-ip 192.168.1.20 --target-port 5005 \   # aggregator UDP sink (port default 5005)
  --node-id 1 \                                   # 0-255
  --channel 6 --filter-mac AA:BB:CC:DD:EE:FF       # ADR-060: pin channel + filter transmitter
Flag groupFlagsNotes
WiFi / sink--ssid --password --target-ip --target-port (5005) --node-id--node-id 0-255
TDM mesh--tdm-slot --tdm-total0-based slot index + total node count — this is how multi-node mesh is slotted
Edge processing--edge-tier {0,1,2}0=off, 1=stats, 2=vitals (ADR-041)
Detection thresholds--pres-thresh (50) --fall-thresh (15000 → 15.0 rad/s²)raise --fall-thresh to cut false falls in high-traffic areas (issue #263)
Vitals--vital-win (300 frames) --vital-int (1000 ms) --subk-count (32, top-K subcarriers)
Channel / hopping--channel (1-14 / 36-177, overrides AP auto-detect) --filter-mac --hop-channels (1,6,11) --hop-dwell (200 ms)omit --channel + set --hop-channels for ADR-061 multi-freq hopping; omit --filter-mac to capture all transmitters
Cognitum Seed--seed-url (http://10.1.10.236) --seed-token (Bearer, from pairing) --zone (lobby)
Swarm--swarm-hb (30 s) --swarm-ingest (5 s)heartbeat + vector ingest intervals
Mode--dry-run (build NVS bin, don't flash) --baud (460800) --force-partial

⚠️ NVS namespace is replaced wholesale (issue #391). Flashing rewrites the entire csi_cfg namespace — any key you don't pass on the CLI is erased. Always pass the full set you want, or use --force-partial knowingly. Read the device's current values off the serial boot log first (adaptive_ctrl / csi_collector lines) if you're unsure.

  • NVS partition images for fleet provisioning: scripts/generate_nvs_matrix.py (subprocess-first — the esp_idf_nvs_partition_gen API changed across versions).

3. Sensing server flags

bash
cd v2
cargo run -p wifi-densepose-sensing-server -- --help

# Common modes:
cargo run -p wifi-densepose-sensing-server                                  # live sink, default port
cargo run -p wifi-densepose-sensing-server -- --pretrain --dataset data/csi/ --pretrain-epochs 50
cargo run -p wifi-densepose-sensing-server -- --train --dataset data/mmfi/ --epochs 100 --save-rvf model.rvf
cargo run -p wifi-densepose-sensing-server -- --model model.rvf --embed
cargo run -p wifi-densepose-sensing-server -- --model model.rvf --build-index env

wifiscan server (multi-BSSID, ADR-022): cargo run -p wifi-densepose-sensing-server consumes wifi-densepose-wifiscan output; use neighbour APs as free radar illuminators.

Show full SKILL.md (221 more words)Show less

4. Edge intelligence modules (ADR-041)

Small Rust/WASM programs that run on the ESP32 itself — no internet, instant response. See docs/edge-modules/ and docs/adr/ADR-041-*. Each module declares its CSI feature inputs (8-dim feature vectors) and an RVF store target (Cognitum Seed). Configure which modules ship in a build via the firmware component config; configure their thresholds via NVS keys.

Helper scripts that mirror edge-module logic on the host (useful for tuning before flashing): scripts/apnea-detector.js, gait-analyzer.js, material-classifier.js, passive-radar.js, mincut-person-counter.js, device-fingerprint.js, mesh-graph-transformer.js, material-detector.js.

5. Multi-node mesh

  • 2+ nodes give real spatial resolution. Each node provisioned to the same --target-ip sink.
  • TDM protocol + channel hopping coordinated by wifi-densepose-hardware (v2/crates/wifi-densepose-hardware/src/esp32/).
  • Cross-viewpoint fusion combines nodes — see ruview-advanced-sensing.

6. Cognitum Seed integration ($140 total BOM)

ESP32 streams CSI → bridge forwards to a Cognitum Seed for persistent RVF memory, kNN over environments, and an Ed25519 witness chain.

bash
node scripts/rf-scan.js --port 5006              # live RF room scan → Seed
node scripts/snn-csi-processor.js --port 5006    # SNN real-time learning on-Seed

See docs/tutorials/cognitum-seed-pretraining.md and ADR-028 (capability audit + witness verification).

7. App-level config

  • API: wifi-densepose-api (Axum) — config via wifi-densepose-config crate; see example.env / pyproject.toml for the v1 Python service.
  • Docker: docker run -p 3000:3000 ruvnet/wifi-densepose:latest (env-var overrides documented in README.md / docker/).
  • Dashboard: served on :3000; nvsim dashboard (ADR-092) is separate.

Reference

  • docs/adr/ (96 ADRs) — esp. ADR-022 (wifiscan), ADR-028 (capability audit), ADR-041 (edge modules), ADR-060 (channel/MAC override), ADR-061 (QEMU + mesh), ADR-081 (adaptive CSI mesh kernel)
  • CLAUDE.md / CLAUDE.local.md — crate map, build env, QEMU CI fixes
  • example.env, Makefile, firmware/esp32-csi-node/

© ruvnet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/ruview/skills/ruview-configure of ruvnet/RuView.

Open the folder on GitHubat commit 0ef6b96

Compare with similar skills

RuView Deployment Configuration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

RuView Deployment Configuration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
RuView Deployment Configuration this skillruvnet/RuView97k—~1.7kAutomated safety check: NotesMIT
Embedded Iot Mentoralirezarezvani/claude-skills28k—~2.6kAutomated safety check: PassMIT
Esp32 Firmware Engineeralxv2016/folloup-sticky1161 repos~3.8kAutomated safety check: PassGPL-3.0
Embedded DebugFastLED/FastLED7.5k—~1.4kAutomated safety check: PassMIT
Embedded DebuggerAdancurusul/embedded-debugger-mcp202—~1.4kAutomated safety check: PassMIT
Auto EmbeddedDunCanYounG-1/MICU-auto-embedded253—~1.6kAutomated safety check: PassCC-BY-NC-4.0

Similar skills

  • Embedded Iot Mentor

    alirezarezvani/claude-skills

    Mentor for embedded and IoT hardware projects. An agent skill from alirezarezvani/claude-skills.

    28k GitHub stars~2.6k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Esp32 Firmware Engineer

    alxv2016/folloup-sticky

    ESP32 firmware engineering for ESP-IDF projects. An agent skill from alxv2016/folloup-sticky.

    116 GitHub starsUsed in 1 repo~3.8k tokens
    DevelopmentAuto-check passed
  • Embedded Debug

    FastLED/FastLED

    Firmware crash analysis, stack trace decoder, and register dump interpreter for ESP32/ARM/AVR platforms.

    7.5k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Embedded Debugger

    Adancurusul/embedded-debugger-mcp

    Embedded hardware debugging workflow for probe-rs targets using embedded-debugger-mcp.

    202 GitHub stars~1.4k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Auto Embedded

    DunCanYounG-1/MICU-auto-embedded

    全平台嵌入式 AI 开发框架(对标 Trellis):把 RIPER-5 五阶段协议 + 四文件记忆 + 分层架构门禁 + Scout/Builder/Verifier 多 Agent + 24 个工具调用技能(build/flash/debug/serial/can/modbus/visa/static/memory/rtos/scons),做成『装进工程、项目级 hook…

    253 GitHub stars~1.6k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Embedded Cpp14 Misra

    BlueAndi/Pixelix

    A skill your agent uses when writing, reviewing, or refactoring C/C++ firmware code in this repository (src/, lib/, test/) — creating or editing .h/.hpp/.cpp files, applying MISRA-oriented and…

    443 GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed

More from ruvnet/RuView

All 24 skills in this repo
  • Reference for RuView's research-grade WiFi sensing features: multistatic fusion, cross-viewpoint geometry, persistent field models, RF tomography, intention signals and mesh security.

    97k GitHub stars~1.2k tokensUpdated today
    Auto-check: notes
  • Runs RuView's WiFi sensing applications: presence, vital signs, activity and fall detection, pose estimation, sleep monitoring and environment mapping.

    97k GitHub stars~1.1k tokensUpdated today
    Auto-check: notes
  • Covers the RuView `wifi-densepose` command line binary, its Axum REST API and the WebAssembly builds for browsers and ESP32, for embedding or scripting RuView.

    97k GitHub stars~1.2k tokensUpdated today
    Auto-check: notes
  • Drives a web browser through the agent-browser CLI, using compact accessibility snapshots with element refs in place of the full DOM to keep context small.

    97k GitHub starsUsed in 4 repos~1.3k tokens
    Auto-check passed
  • Brings a RuView CSI sensing node online by building ESP32-S3 or ESP32-C6 firmware, flashing the board, provisioning WiFi and checking the serial output.

    97k GitHub stars~1.8k tokensUpdated today
    Auto-check: notes
  • Sets up and runs 60 GHz and 24 GHz mmWave radar sensing on ESP32 boards in RuView, alone or fused with WiFi CSI.

    97k GitHub stars~907 tokensUpdated today
    Auto-check: notes

Works with

Categories

Questions about RuView Deployment Configuration

What does RuView Deployment Configuration do?

Tunes a deployed RuView WiFi-sensing system without changing code: firmware sdkconfig variants, NVS provisioning over serial, channel and MAC filtering, edge processing tiers and mesh slotting. The skill covers two configuration layers. Firmware build-time config picks an sdkconfig variant file, such as the 8MB default with real WiFi CSI, a 4MB variant for the ESP32-S3 SuperMini with the display disabled and dual OTA slots, or a Heltec N16R2 variant, copied into place before a rebuild; it warns never to test in mock mode because a fall-threshold Kconfig bug only appeared with real CSI data.

When should I use RuView Deployment Configuration?

RuView Deployment Configuration fits situations like: switching a RuView node's firmware build between the 8MB, 4MB or Heltec variants; provisioning a new ESP32 node's WiFi, mesh slot and detection thresholds over serial; reducing false fall-detection alerts in a high-traffic deployment; connecting a node to Cognitum Seed for a given zone.

How do I install RuView Deployment Configuration in Claude Code?

Run `npx skills add ruvnet/RuView --skill ruview-configure -a claude-code`. Or copy the skill folder (plugins/ruview/skills/ruview-configure in ruvnet/RuView) into .claude/skills/ruview-configure in your project. Claude Code loads it when a task matches its description.

How do I install RuView Deployment Configuration in Codex?

Run `npx skills add ruvnet/RuView --skill ruview-configure -a codex`. Or copy the skill folder (plugins/ruview/skills/ruview-configure in ruvnet/RuView) into .agents/skills/ruview-configure in your project. Codex loads it when a task matches its description.

Can I use RuView Deployment Configuration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ruvnet/RuView --skill ruview-configure -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ruview-configure, .gemini/skills/ruview-configure, .github/skills/ruview-configure and .opencode/skills/ruview-configure in your project.

What does RuView Deployment Configuration need to run?

Going by SKILL.md and its folder, RuView Deployment Configuration needs the command-line tools its instructions call (cargo, python, node and docker). Our summary lists: Python, to run provision.py; An ESP32-S3 device connected over serial. Its frontmatter pre-approves these tools: Bash, Read, Write, Edit, Glob, Grep.

Does RuView Deployment Configuration access the network?

SKILL.md contains no URLs. Its commands use docker, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is RuView Deployment Configuration safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does RuView Deployment Configuration use?

RuView Deployment Configuration is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does RuView Deployment Configuration use?

About 1.7k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to RuView Deployment Configuration?

Skills that share tags, products or a category with RuView Deployment Configuration: Embedded Iot Mentor (alirezarezvani/claude-skills, 28k stars), Esp32 Firmware Engineer (alxv2016/folloup-sticky, 116 stars), Embedded Debug (FastLED/FastLED, 7.5k stars) and Embedded Debugger (Adancurusul/embedded-debugger-mcp, 202 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains RuView Deployment Configuration?

ruvnet (a GitHub user) maintains it in ruvnet/RuView, which has 96,981 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 9, 2026.

Source: ruvnet/RuView on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.