← Back to Skills Marketplace
34
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install somnia
Description
Run overnight skill health reviews, replay-case availability checks, feedback triage, and proposal-only maintenance reports for OpenClaw agents. Use when the...
README (SKILL.md)
Somnia
Overview
Somnia is the sleep-cycle maintenance layer for OpenClaw skills. It provides a repeatable review workflow that checks installed skills during quiet hours, summarizes health risks, and writes proposal artifacts without silently mutating runtime skills.
Current version: v0.4.3 "Standalone Safety".
Trigger Cues
Use this skill when the user mentions:
nightly skill reviewsleep-time maintenanceskill health reportskill bug scanningreplay regression checkfeedback-driven upgradeproposal-based updateSomnia
Default Workflow
- Confirm the review scope: managed skills, feedback-related skills, or all installed skills.
- Run lightweight package validation, feedback summary, and replay-case availability checks for each selected skill.
- Write JSON and Markdown health reports under the configured learning/report directory.
- Write proposal artifacts only when feedback or quality gates justify the change.
- Hand proposal artifacts to Skill Forge or a human maintainer before any install decision.
- Keep simulated evaluation details hidden from user-facing reports.
Output Contract
The final answer or artifact should include:
- Review scope and schedule assumption
- Skills checked and health summary
- Issues found, grouped by skill
- Update candidates proposed or blocked
- Replay and hidden-evaluation pass/fail summary
- Next action: no-op, review proposal, approve install, or adjust schedule
Quality Gates
- Never auto-install skill changes; Somnia writes proposals and reports only.
- Keep hidden evaluation and replay case details out of user-facing Telegram reports.
- Redact feedback-derived content before it becomes a replay case or report item.
- Prefer proposal files and manifests over direct mutation of installed skills.
- Keep Somnia self-contained; do not execute out-of-package Skill Forge code.
Resources
References:
references/somnia-architecture.mdreferences/schedule-and-policy.md
Scripts:
scripts/nightly_skill_review.pyscripts/schedule_nightly_review.py
Usage Guidance
Before installing or scheduling Somnia, keep the review scope narrow, avoid enabling feedback-driven proposals until skill-name path validation is fixed, and only use --apply or Telegram reporting after reviewing the generated plist and destination chat. Inspect the full installed scripts if possible, because the provided nightly review source was partially truncated in the review artifact.
Capability Analysis
Type: OpenClaw Skill
Name: somnia
Version: 0.4.3
The Somnia skill bundle is a maintenance utility designed for scheduled health reviews and reporting of OpenClaw skills. It includes scripts for validating skill metadata, generating health reports, and scheduling recurring tasks on macOS via LaunchAgents (scripts/schedule_nightly_review.py). While the tool can send data to a Telegram bot (scripts/nightly_skill_review.py), this behavior is documented, requires user-provided environment variables, and is restricted to health summaries. The bundle explicitly follows a 'proposal-only' model to prevent unauthorized code execution or auto-updates, showing no signs of malicious intent or hidden exfiltration.
Capability Assessment
Purpose & Capability
The stated purpose is coherent: it reviews OpenClaw skills, feedback, and replay availability, then writes reports/proposals rather than installing changes.
Instruction Scope
The workflow asks to confirm scope and says not to auto-install, but supported scopes include feedback-driven and all-skill review, which can cover broad local OpenClaw workspace data.
Install Mechanism
There is no install spec, but included helper scripts can be run manually; the scheduler is macOS LaunchAgent-specific despite no OS restriction in metadata.
Credentials
The visible code uses feedback-derived skill identifiers directly in paths, which can escape the intended skill/proposal directories if stored feedback is malformed or poisoned.
Persistence & Privilege
A scheduled LaunchAgent can be installed only with an explicit --apply flag and KeepAlive is false, but enabling it means the review script runs later without per-run approval.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install somnia - After installation, invoke the skill by name or use
/somnia - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.4.3
Make Somnia standalone and proposal-only: no out-of-package runtime execution, no auto-install modes, and clearer report-only boundaries.
v0.4.2
Initial companion preview for overnight skill health review, replay-aware maintenance reports, and proposal-based Skill Forge updates.
Metadata
Frequently Asked Questions
What is Somnia?
Run overnight skill health reviews, replay-case availability checks, feedback triage, and proposal-only maintenance reports for OpenClaw agents. Use when the... It is an AI Agent Skill for Claude Code / OpenClaw, with 34 downloads so far.
How do I install Somnia?
Run "/install somnia" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Somnia free?
Yes, Somnia is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Somnia support?
Somnia is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Somnia?
It is built and maintained by SheepXu (@sheepxux); the current version is v0.4.3.
More Skills