Agent skill

History Explorer

by clawdotnet in clawdotnet/openclaw.net

Inspect recent session conversation turns and meta-run history.

MITAuto-check passedAgent Workflows

Install History Explorer

skills CLI
$ npx skills add clawdotnet/openclaw.net --skill history-explorer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install clawdotnet/openclaw.net history-explorer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/clawdotnet/openclaw.net.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/OpenClaw.Gateway/skills/history-explorer .claude/skills/history-explorer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
history-explorer
GitHub stars
520
Token cost
~805 tokens
SKILL.md length
241 words
Files
2 (incl. scripts)
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

Inspect recent session conversation turns and meta-run history.

  • Asks about recent history
  • SKILL.md covers What It Does, Input Contract, Output Contract and When to Use, plus 1 more section
  • Runs Python scripts from its folder
  • Past tool usage

What it does

History Explorer is an agent skill from clawdotnet/openclaw.net. Inspect recent session conversation turns and meta-run history. Returns structured JSON summaries of turn counts, role distribution, tool usage, meta-skill executions, and co-occurrence patterns. Use this before running meta-skill-creator or when the user asks about recent history, past tool usage, or session activity.

Its SKILL.md is about 810 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/explore.py`).

It sits in Agent Workflows, covering Skill authoring. The repository describes itself as: Self-hosted Enterprise and Personal AI + agent runtime in .NET (NativeAOT-friendly). The licence is MIT.

When your agent uses it

  • Asks about recent history
  • Past tool usage
  • Session activity

Example prompts

  • “/history-explorer”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 2344435. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

History Explorer loads about 805 tokens when it runs. Until then it costs about 84 tokens; SKILL.md has 241 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~84
When it runs · the whole SKILL.md, loaded when a task matches
~805

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from clawdotnet/openclaw.net at commit 2344435, republished under its MIT licence (© clawdotnet). 241 words, ~805 tokens.

Download SKILL.mdSave it as .claude/skills/history-explorer/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
history-explorer
description
Inspect recent session conversation turns and meta-run history. Returns structured JSON summaries of turn counts, role distribution, tool usage, meta-skill executions, and co-occurrence patterns. Use this before running meta-skill-creator or when the user asks about recent history, past tool usage, or session activity.
provenance.origin
openclaw.net
provenance.license
MIT
entrypoint.command
python {baseDir}/scripts/explore.py
entrypoint.args
--query, {{ with.query | truncate(512) }}, --window-days, {{ with.window_days | default('30') }}, --include, {{ with.include | join(',') if with.include is…
entrypoint.parse
json
entrypoint.timeout
30

History Explorer

Read-only helper that inspects OpenClaw.NET session history for downstream workflows (especially meta-skill-creator).

What It Does

Parses a JSON session snapshot and returns structured analytics:

KeyDescription
turnsTurn count, role distribution (user vs assistant), time span, recent turn previews
toolsTool invocation frequency, top tools, tool co-occurrence in the same turn
meta_runsMeta-skill execution history: skill name, status, step counts, failure codes
co_occurrencesSkill/tool pairs that appear together across turns
placeholderEmitted when no session data is available; downstream workflows treat this as a signal to rely on user intent only

Input Contract

The script expects JSON session data on stdin. The calling agent should pipe a JSON object matching the Session schema — specifically:

json
{
  "id": "session-guid",
  "history": [
    { "role": "user", "content": "...", "timestamp": "..." },
    { "role": "assistant", "content": "...", "timestamp": "...", "toolCalls": [...] }
  ],
  "metaRunHistory": [
    {
      "runId": "...", "skillName": "...", "status": "completed",
      "startedAtUtc": "...", "completedAtUtc": "...",
      "stepResults": [
        { "id": "...", "kind": "...", "status": "...", "durationMs": 123 }
      ]
    }
  ]
}

Output Contract

Always returns a JSON object. When session data is available, includes the requested analytics keys. When unavailable or unparseable, returns a single placeholder key so downstream workflows degrade deterministically.

When to Use

  • Before running meta-skill-creator: feed co-occurrence and meta-usage data into the creator's proposal draft
  • When the user asks "what skills did I use recently" or "show my session history"
  • When debugging: inspect recent tool failures or meta-run error codes
  • When the agent needs to recall conversation context from earlier turns

Limitations

  • Read-only; never mutates session state
  • Depends on the agent passing session JSON via stdin; does not access the persistence layer directly
  • window_days filtering is best-effort on the timestamp field
  • Session snapshots may be truncated by the agent for token budget reasons

© clawdotnet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in src/OpenClaw.Gateway/skills/history-explorer of clawdotnet/openclaw.net.

  • SKILL.md
  • scripts/explore.py

Open the folder on GitHubat commit 2344435

Compare with similar skills

History Explorer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

History Explorer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
History Explorer this skillclawdotnet/openclaw.net520—~805Automated safety check: PassMIT
Skill CreatorAzure/azqr79589 repos~8.2kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Claude Code Command Developmentanthropics/claude-plugins-official38k10 repos~4.8kAutomated safety check: PassApache-2.0
Claude Code Plugin Structureanthropics/claude-plugins-official38k10 repos~3.4kAutomated safety check: PassApache-2.0

Similar skills

  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    795 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Plugin Structure

    anthropics/claude-plugins-official

    Official

    Explains the directory layout, plugin.json manifest and component organization of a Claude Code plugin, including auto-discovery and portable paths.

    38k GitHub starsUsed in 10 repos~3.4k tokens
    Agent WorkflowsAuto-check passed
  • Skill Release Gate

    rohitg00/ai-engineering-from-scratch

    Evaluates an Agent Skill bundle before release for structure, trigger quality, artifact improvement, script correctness, safety, installed-tree integrity and host portability.

    66k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from clawdotnet/openclaw.net

All 12 skills in this repo
  • Meta Skill Creator

    clawdotnet/openclaw.net

    Use this meta-skill instead of answering directly only when the current user explicitly asks to create, compose, synthesize, or propose a new meta-skill that orchestrates multiple existing skills.

    520 GitHub stars~4.8k tokensUpdated today
    Auto-check passed
  • Community Research Insight

    clawdotnet/openclaw.net

    Extract structured insight briefs from community research transcripts or notes.

    520 GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Docs Governance

    clawdotnet/openclaw.net

    Organizes repository documentation and keeps new docs in the correct location.

    520 GitHub stars~441 tokensUpdated today
    Auto-check passed
  • Summarize

    clawdotnet/openclaw.net

    Summarize, condense, or digest content into structured key points, details, and action items.

    520 GitHub stars~302 tokensUpdated today
    Auto-check passed
  • Daily News Digest

    clawdotnet/openclaw.net

    Produce a daily news brief (AI/security/dev) with links, key takeaways, and action items.

    520 GitHub stars~211 tokensUpdated today
    Auto-check passed
  • Data Analyst

    clawdotnet/openclaw.net

    Connects to databases, runs SQL queries, and analyzes datasets using code to provide actionable business insights.

    520 GitHub stars~291 tokensUpdated today
    Auto-check passed

Categories

Questions about History Explorer

What does History Explorer do?

Inspect recent session conversation turns and meta-run history. net. Inspect recent session conversation turns and meta-run history.

When should I use History Explorer?

History Explorer fits situations like: asks about recent history; past tool usage; session activity.

How do I install History Explorer in Claude Code?

Run `npx skills add clawdotnet/openclaw.net --skill history-explorer -a claude-code`. Or copy the skill folder (src/OpenClaw.Gateway/skills/history-explorer in clawdotnet/openclaw.net) into .claude/skills/history-explorer in your project. Claude Code loads it when a task matches its description.

How do I install History Explorer in Codex?

Run `npx skills add clawdotnet/openclaw.net --skill history-explorer -a codex`. Or copy the skill folder (src/OpenClaw.Gateway/skills/history-explorer in clawdotnet/openclaw.net) into .agents/skills/history-explorer in your project. Codex loads it when a task matches its description.

Can I use History Explorer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add clawdotnet/openclaw.net --skill history-explorer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/history-explorer, .gemini/skills/history-explorer, .github/skills/history-explorer and .opencode/skills/history-explorer in your project.

What does History Explorer need to run?

Going by SKILL.md and its folder, History Explorer needs Python for the scripts in its folder. Our summary lists: Python 3.

Does History Explorer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is History Explorer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does History Explorer use?

History Explorer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does History Explorer use?

About 805 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to History Explorer?

Skills that share tags, products or a category with History Explorer: Skill Creator (Azure/azqr, 795 stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars) and Claude Code Command Development (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains History Explorer?

clawdotnet (a GitHub organization) maintains it in clawdotnet/openclaw.net, which has 520 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 9, 2026.

Source: clawdotnet/openclaw.net on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.