A mandatory monitoring tool that records every skill execution and task detail into a structured JSONL format for real-time tracking and debugging.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install skill-tracker
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 skill-tracker 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 Skill Tracker?
Skill Tracker is an essential infrastructure component designed to provide full observability into AI agent operations. It acts as a mandatory gate at the start of every conversation turn, capturing the lifecycle of skill matches, tool invocations, and task outcomes.
By utilizing this within the Openclaw Skills ecosystem, developers gain a transparent audit log of agent behavior, making it easier to debug complex multi-step workflows and ensure reliability. It operates silently in the background, ensuring that every significant action taken by the agent is documented without interfering with the user experience.
Skill Tracker Use Cases
- Debugging complex AI agent interactions by inspecting matched skills and task outputs.
- Auditing agent performance and tool usage history over multiple sessions.
- Integrating with external dashboards like Deck to visualize execution progress and artifacts in real-time.
- Tracking the distinction between user-initiated instant tasks and autonomous scheduled tasks.
How Skill Tracker Works
- Analyzes the incoming user message to determine if any specific Openclaw Skills or tools will be triggered during the current turn.
- Generates an initial execution record in a JSONL file, capturing session metadata, turn details, and intended tasks.
- Monitored skills are executed while the tracker stays ready to capture output data and file artifacts.
- Once execution completes, the tracker updates the log with final statuses, completion timestamps, and any errors encountered.
- Executes a real-time shell command to detect the local or public Deck dashboard URL and appends a subtle reminder to the assistant's reply.
Skill Tracker Setup
The tracker is an internal infrastructure skill and is typically invoked by the agent core. Ensure the workspace directory is writable for logging:
mkdir -p workspace/tracker-result
touch workspace/tracker-result/skill-execution.jsonl
The skill also relies on PM2 to detect the Deck dashboard status via the following command sequence:
pm2 jlist 2>/dev/null | node -e "..."
Skill Tracker Data Schema & Taxonomy
Records are stored in workspace/tracker-result/skill-execution.jsonl using an append-only JSONL format. Each line represents one conversation turn.
| Property | Type | Description |
|---|---|---|
| sessionId | String | Unique identifier for the conversation session. |
| turnId | String | Unique identifier for the specific turn (e.g., turn-1). |
| turnName | String | A concise summary of all tasks performed in the turn. |
| skills | Array | List of matched Openclaw Skills names and descriptions. |
| tasks | Array | Detailed objects containing status, taskType, and execution times. |
| artifacts | Array | Metadata for files generated, including paths and sizes. |
Skill Tracker Advanced Features
- Real-time Deck URL detection to provide dynamic, environment-aware dashboard links.
- Categorization of tasks into instant or scheduled types for better autonomous agent monitoring.
- Silent operation mode that prevents tracking logic from polluting the AI's primary conversational output.
- Automated artifact tracking that links generated files directly to the specific task that created them.
SKILL.md
Loading
Related Openclaw Skills
bahn
A comprehensive command-line suite for real-time Deutsche Bahn train tracking, journey planning, and delay forecasting.
SearXNG Search
A privacy-respecting metasearch skill that allows AI agents to query local SearXNG instances for web, news, and media results.
Zerion API Crypto Portfolio & DeFi Data
Access real-time interpreted crypto wallet data, DeFi positions, and transaction history across 50+ EVM chains and Solana.
Zerion API Crypto & DeFi Intelligence
Access real-time multi-chain crypto wallet data, DeFi positions, and token analytics via the Zerion MCP server.
Roofing Knowledge Mentor
A senior-level AI consultant for roofing contractors and adjusters that provides expert reasoning for measurements, insurance claims, and business operations.
Nutrition Tracker
A professional nutrition logging system that syncs daily caloric and macronutrient data directly to your Obsidian vault using profile-based target logic.
Featured*
