A specialized utility to transform complex workflow definitions and execution logs into beautiful, interactive HTML reports.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install osop-report
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install osop-report using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OSOP Report Generator?
The OSOP Report Generator is a sophisticated technical utility designed to bridge the gap between raw YAML execution logs and human-readable documentation. By processing .osop and .osoplog.yaml files, it generates a self-contained HTML report that visualizes the entire lifecycle of an AI agent's workflow. This tool is a vital component for developers using Openclaw Skills who need to audit agent performance, track costs, and debug complex node executions without parsing raw data.
The generated reports are designed for high performance and portability, featuring zero external dependencies and a lightweight footprint under 15KB. With native support for dark mode and responsive design, it provides a professional interface for reviewing AI metadata, reasoning blocks, and tool usage across various node types.
OSOP Report Generator Use Cases
- Auditing AI agent execution paths and reasoning steps for quality assurance.
- Generating stakeholder-ready performance reports including cost and duration metrics.
- Debugging failed workflow nodes via the prominent error banner and status badges.
- Visualizing resource-intensive processes in CI/CD or data pipelines using Openclaw Skills.
How OSOP Report Generator Works
- The skill identifies the source files by reading the provided .osop file and optional .osoplog.yaml execution log.
- It parses the YAML data to extract workflow metadata, node types, and execution results.
- A self-contained HTML structure is built, embedding all necessary CSS for layout and color-coding.
- Logic is applied to categorize nodes into specific types (Human, Agent, API, CLI, etc.) with corresponding color schemes.
- The finalized report is saved with a -report.html suffix, ready for immediate browser viewing.
OSOP Report Generator Setup
To install and use this skill within your environment, ensure you have python3 and uv installed. Run the following to prepare the environment:
# The skill automatically manages dependencies via uv
uv pip install pyyaml
# Run the report generator
osop-report <file.osop> [file.osoplog.yaml]
OSOP Report Generator Data Schema & Taxonomy
The skill organizes workflow data into a structured visual taxonomy:
| Component | Description |
|---|---|
| Header | Contains workflow name, status, total duration, cost, and node count. |
| Node Cards | Expandable elements showing type (Agent, API, etc.), duration bars, and reasoning. |
| AI Metadata | Details on model usage, token counts, and tool calls. |
| Error Banner | High-visibility section listing all failed nodes for rapid troubleshooting. |
OSOP Report Generator Advanced Features
- Automatic discovery of the most recent execution logs in the sessions/ directory if no arguments are provided.
- Intelligent color-coding system to distinguish between human interaction, agent logic, and system commands.
- Native dark mode support using CSS prefers-color-scheme for comfortable developer viewing.
- High-density data visualization including duration bars and status badges for every workflow step.
SKILL.md
Loading
Related Openclaw Skills
OSOP Workflow Optimizer
A specialized tool that analyzes execution history to automatically improve the performance and reliability of OSOP workflows.
Wan 2.7 Video Generation & Editing
A powerful video generation and editing suite powered by Alibaba's Wan 2.7 models for high-fidelity 720P and 1080P cinematic content.
Debugging Assistant
A comprehensive debugging companion that automates log analysis, suggests strategic breakpoints, and maps execution flows to identify root causes.
Performance Analysis & Optimization
A comprehensive performance profiling and analysis tool designed to identify code bottlenecks and provide actionable optimization recommendations.
OSOP Workflow Reviewer
A specialized security audit tool designed to analyze AI agent workflow definitions and execution logs for risks, permission gaps, and destructive actions.
OSOP Session Logger
A specialized logging utility that generates structured OSOP workflow definitions and execution records for AI agent sessions.
Featured*
