Skill Usage History Analyzer

v20260903

history-explorer

This tool provides a read-only view over per-turn decision logs, aggregating data on skill co-occurrence patterns, meta-skill usage statistics, and router fixtures. It returns a structured JSON summary, making it ideal for analyzing historical skill usage, optimizing workflows, and feeding insights into downstream LLM models.

Python Logging Analysis LLM Skills History Data

Get Skill

75 downloads

Overview

History Explorer

Lightweight read-only view over ~/.opensquilla/logs/decisions-*.jsonl. Aggregates DecisionEntry.skills_invoked (SCHEMA_VERSION 10) into co-occurrence frequencies, joins with SkillLoader.list_meta_specs() for meta-skill usage stats, and surfaces the tests/test_skills/router_fixtures/ corpus.

Usage

uv run python {baseDir}/scripts/explore.py \
  --log-dir ~/.opensquilla/logs \
  --query "Co-occurring chains for PDF workflows" \
  --window-days 30 \
  --include co_occurrences,meta_usage,router_fixtures \
  --top-k 10

Output

JSON to stdout with keys co_occurrences, meta_usage, router_fixtures, and a placeholder string when the log is empty.

Fallback

If no decision-log exists, return an empty result with a placeholder string explaining "no history; downstream should rely on user intent only".

Info

Category Data Science

Name history-explorer

Version v20260903

Size 3.98KB

Source opensquilla/opensquilla

Updated At 2026-09-06