iot-witness-verify

Verify witness chain integrity and detect provenance gaps for Cognitum Seed IoT devices.

70.1k|8.4k|Updated Jun 2, 2025
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill iot-witness-verify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iot-witness-verify
Source: https://github.com/ruvnet/claude-flow/tree/main/plugins/ruflo-iot-cognitum/skills/iot-witness-verify
Command: npx skills add https://github.com/ruvnet/claude-flow --skill iot-witness-verify

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @claude-flow/plugin-iot-cognitum.

What problem does it solve?

IoT device provenance records can silently break when witness chain epochs are missing or hash links are corrupted, leaving no trustworthy audit trail. This Skill verifies the witness chain for a Cognitum Seed device and surfaces integrity gaps before they undermine trust in device data.

Core Features & Use Cases

  • Witness Chain Verification: Runs the cognitum-iot witness verify command against a specific device ID to validate the full chain.
  • Gap and Break Detection: Checks for epoch gaps and hash chain breaks, then reports an integrity score from 0.0 to 1.0.
  • Audit Trail Persistence: Stores detected gaps in shared memory under the iot-audit namespace for later review.
  • Use Case: A fleet operator suspects a sensor's telemetry history was tampered with, so they verify the device's witness chain, receive an integrity score, and automatically log any epoch gaps for compliance auditing.

Quick Start

Verify the witness chain integrity for device DEVICE_ID and report any epoch gaps or hash chain breaks.

Frequently Asked Questions about iot-witness-verify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify the witness chain of a Cognitum Seed IoT device?

Run the witness verify command with the device ID: npx -y -p @claude-flow/plugin-iot-cognitum@latest cognitum-iot witness verify DEVICE_ID. The Skill then checks for epoch gaps and hash chain breaks and reports an integrity score.

What does the witness chain integrity score mean?

The integrity score ranges from 0.0 to 1.0 and reflects how intact the device's witness chain is. Lower scores indicate epoch gaps or hash chain breaks that compromise the provenance record.

What happens when a witness chain gap is detected?

Detected gaps are stored in shared memory using the ruflo memory_store tool under the iot-audit namespace, keyed as iot-witness-gap-DEVICEID with the affected epoch range. This creates a persistent audit trail for later review.

Does witness verification require any tools to be installed?

No local installation is required. The verification runs through npx, which fetches the @claude-flow/plugin-iot-cognitum package on demand, and gap storage uses the ruflo MCP memory tool.

When should I run witness chain verification on IoT devices?

Run it when onboarding new devices, after suspected tampering or connectivity loss, and periodically for compliance auditing. Devices with long offline periods are most likely to show epoch gaps.