← Back to Skills Marketplace
mariusfit

ops-journal

by mariusfit · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
557
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ops-journal
Description
Automates logging of deployments, incidents, changes, and decisions into a searchable ops journal with incident timelines and postmortem generation.
Usage Guidance
This skill appears to be a local ops journal and is internally consistent. Before installing or running: (1) review the script source (already included) and confirm you're comfortable with files being written to ~/.openclaw/workspace/ops-journal (or set OPS_JOURNAL_DIR to a different folder); (2) run it as a non-privileged user — it only needs file-system access to that directory; (3) if you plan integrations (infra-watchdog or others), verify hooks only post expected messages and do not expose sensitive data in entries; (4) if you require network isolation, note the tool itself performs no network operations but any integrations you add might. If you want stronger assurances, run it in a sandbox/container first.
Capability Analysis
Type: OpenClaw Skill Name: ops-journal Version: 1.0.0 The skill is classified as suspicious due to a potential arbitrary file write vulnerability in the `scripts/journal.py` file. The `cmd_export` function allows writing journal entries to an arbitrary file path specified by the `--output` argument (`with open(args.output, 'w') as f:`). While this functionality is plausible for an export feature, it presents a significant vulnerability if a malicious actor or a compromised agent could control the `args.output` path, potentially leading to overwriting critical system files or user configuration files. There is no evidence of intentional malicious behavior such as data exfiltration, backdoors, or prompt injection in `SKILL.md`.
Capability Assessment
Purpose & Capability
Name/description (ops-journal) match the contained code and CLI: the Python script implements logging, incident lifecycle, search, export, and writing markdown incident files. There are no unexpected external service credentials, packages, or binaries requested.
Instruction Scope
SKILL.md instructs running the included scripts and using local commands (init, log, incident, search, export). The script reads/writes only local files (SQLite DB and incident markdowns) and CLI args; it does not perform network calls or access unrelated system paths. Behavior stays within the stated purpose.
Install Mechanism
No install spec; this is instruction-only with an included Python script relying on the standard library. That is proportionate for a small CLI tool and keeps installation risk low.
Credentials
The code honors an optional OPS_JOURNAL_DIR environment variable to override the default storage path, but the skill's metadata did not declare any required env vars. This is benign functional behavior but is an undeclared env var the user may want to know about because it controls where data is stored.
Persistence & Privilege
The skill does not request permanent platform privileges (always: false) and does not modify other skills or global agent config. It creates files under the user's home workspace directory only.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ops-journal
  3. After installation, invoke the skill by name or use /ops-journal
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: structured ops logging with 6 categories, 4 severity levels, full incident management (open/resolve/timeline/postmortem), search, period summaries, export (markdown/JSON/CSV), statistics. SQLite backend, zero external dependencies.
Metadata
Slug ops-journal
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is ops-journal?

Automates logging of deployments, incidents, changes, and decisions into a searchable ops journal with incident timelines and postmortem generation. It is an AI Agent Skill for Claude Code / OpenClaw, with 557 downloads so far.

How do I install ops-journal?

Run "/install ops-journal" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ops-journal free?

Yes, ops-journal is completely free (open-source). You can download, install and use it at no cost.

Which platforms does ops-journal support?

ops-journal is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ops-journal?

It is built and maintained by mariusfit (@mariusfit); the current version is v1.0.0.

💬 Comments