history-explorer
GitHub分析决策日志中的技能共现模式、元技能使用统计及路由器测试集。支持按时间窗口查询,返回JSON摘要,适用于回顾近期高频技能使用情况或为元技能创建器提供数据支撑。
Trigger Scenarios
Install
npx skills add opensquilla/opensquilla --skill history-explorer -g -y
SKILL.md
Frontmatter
{
"name": "history-explorer",
"metadata": {
"requires": {
"anyBins": [
"python",
"python3"
]
}
},
"entrypoint": {
"args": [
"--query",
"{{ with.query | truncate(512) }}",
"--window-days",
"{{ with.window_days | default('30') }}",
"--include",
"{{ with.include | join(',') if with.include is sequence and with.include is not string else with.include | default('co_occurrences,meta_usage,router_fixtures') }}",
"--top-k",
"10"
],
"parse": "json",
"command": "python {baseDir}\/scripts\/explore.py",
"timeout": 30
},
"provenance": {
"origin": "opensquilla-original",
"license": "Apache-2.0"
},
"description": "Query the per-turn DecisionEntry log for skill co-occurrence patterns, meta-skill usage stats, and the router fixture corpus. Returns a JSON summary suitable for downstream LLM consumption. Used by meta-skill-creator's harvest step but also useful standalone for 'which skills did I use most this week?'"
}
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".
Version History
- 7f72a32 Current 2026-07-05 18:38


