New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Distill Session Knowledge

by BlackBeltTechnology in BlackBeltTechnology/pi-agent-dashboard

Offline-mine this project's pi session JSONL logs into reusable, verified knowledge: extracts faults, decisions, corrections, procedures and docs, promotes only recurring patterns, and routes…

MITAuto-check passed

Install Distill Session Knowledge

skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill distill-session-knowledge -a claude-code

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

GitHub CLI
$ gh skill install BlackBeltTechnology/pi-agent-dashboard distill-session-knowledge --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/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/distill-session-knowledge/.pi/skills/distill-session-knowledge .claude/skills/distill-session-knowledge && 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
distill-session-knowledge
GitHub stars
315
Token cost
~952 tokens
SKILL.md length
411 words
Files
1
Skills in repo
66
Repo updated
First seen
Licence
MIT

At a glance

Offline-mine this project's pi session JSONL logs into reusable, verified knowledge: extracts faults, decisions, corrections, procedures and docs, promotes only recurring patterns, and routes…

  • Works in 4 steps: Dry-run the miner (no writes) for this… → Review the routing plan. Each entry… → Apply once the plan looks right —… → …
  • SKILL.md covers When to use, Procedure, Guardrails and Verification
  • Calls npx and git

What it does

Distill Session Knowledge is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Offline-mine this project's pi session JSONL logs into reusable, verified knowledge: extracts faults, decisions, corrections, procedures and docs, promotes only recurring patterns, and routes artifacts into skillmanage, memory and docs. Use on "mine my sessions", "distill session knowledge", "extract lessons from logs", "turn my pi history into skills/memory".

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Real-time web dashboard for pi coding-agent sessions. Multi-session view, live chat mirroring, integrated terminal, diff viewer, pi-flows execution, and mobile-first remote… The licence is MIT.

Example prompts

  • “mine my sessions”
  • “distill session knowledge”
  • “extract lessons from logs”
  • “/distill-session-knowledge”

Requirements

  • Node.js

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Dry-run the miner (no writes) for this project
  2. Review the routing plan. Each entry shows signal -> sink [action] conf=…
  3. Apply once the plan looks right — persists the watermark + below-threshold
  4. Execute the routed writes from the plan, using your tools (this is the

What it can do on your machine

Read from SKILL.md and the folder at commit e23e533. 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

    Shell commands in SKILL.md call:

    • npx
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use npx and git, which can reach the network depending on how they are called.

    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

Distill Session Knowledge loads about 952 tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 411 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from BlackBeltTechnology/pi-agent-dashboard at commit e23e533, republished under its MIT licence (© BlackBeltTechnology). 411 words, ~952 tokens.

Download SKILL.mdSave it as .claude/skills/distill-session-knowledge/SKILL.md (or your agent's skills folder).
name
distill-session-knowledge
description
Offline-mine this project's pi session JSONL logs into reusable, verified knowledge: extracts faults, decisions, corrections, procedures and docs, promotes only recurring patterns, and routes artifacts into skill_manage, memory and docs. Use on "mine my sessions", "distill session knowledge", "extract lessons from logs", "turn my pi history into skills/memory".

distill-session-knowledge

Offline miner. Turns past pi session traces into durable artifacts. No new infrastructure — routes into skill_manage, the memory tool, and docs/ (indexed by context-mode FTS5). Dry-run by default; nothing is written until you review the plan and explicitly apply.

Engine: the published @blackbelt-technology/pi-dashboard-session-distiller package, invoked through its distill-session-knowledge bin (this skill package declares it as a runtime dependency).

When to use

  • "Mine / distill my pi sessions", "what recurring mistakes do I keep making", "extract reusable procedures from my history", "turn session logs into skills".
  • After a stretch of work, to harvest verified lessons before they decay.

Procedure

  1. Dry-run the miner (no writes) for this project:

    bash
    npx --no distill-session-knowledge --cwd "$(git rev-parse --show-toplevel)"

    Add --n <k> to change the recurrence threshold (default 3). Add --json to emit the full routing plan as JSON for programmatic review.

  2. Review the routing plan. Each entry shows signal -> sink [action] conf=…:

    • procedure -> skill_manage — candidate reusable SKILL.md.
    • fault -> memory(failure/tool-quirk) — a wrong-way→right-way tool fix.
    • user_correction -> memory(failure/correction) — +AGENTS.md flag means it establishes a rule and should also patch the relevant AGENTS.md row.
    • ask_user_decision -> memory(project/convention) — a recorded human decision.
    • documentation -> docs — a recurring how-to summary.
    • STALE flag = confidence below floor; skip or prune, do not write.

  3. Apply once the plan looks right — persists the watermark + below-threshold candidates store and prints the final plan:

    bash
    npx --no distill-session-knowledge --cwd "$(git rev-parse --show-toplevel)" --apply --json

  4. Execute the routed writes from the plan, using your tools (this is the haiku-class subagent distillation step). For each non-stale entry:

    • skill_manage → mcp__pi__skill_manage create/patch (query existing first).
    • memory → mcp__pi__memory add with the entry's target + category (memory_search first to dedup; merge into a match instead of duplicating).
    • docs → delegate the write to a docs subagent in caveman style per the Documentation Update Protocol, then ctx_index the new doc so it is FTS5-searchable (task 5.2).
    • +AGENTS.md entries → patch the relevant AGENTS.md rule via the docs subagent (≤200 chars/row, caveman style) in addition to the memory write.
Show full SKILL.md (105 more words)Show less

Guardrails

  • Dedup before every write — re-running over the same corpus must create zero duplicates (the planner marks merge when a sink already holds the artifact; still query the live sink, the planner's exists is conservative).
  • Never write a STALE artifact.
  • Stay within this project's sessions (the miner already scopes to the cwd dir).
  • Respect the doc protocol: main agent orchestrates, a subagent writes under docs/.

Verification

  • npx --no distill-session-knowledge --cwd "$(pwd)" prints a routing plan and mutates nothing (dry-run default; no watermark advance).
  • Re-running the dry-run over the same corpus yields the same plan (idempotent).
  • After apply + routed writes, ctx_search returns a freshly distilled doc.

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

Files

Just SKILL.md in packages/distill-session-knowledge/.pi/skills/distill-session-knowledge of BlackBeltTechnology/pi-agent-dashboard.

Open the folder on GitHubat commit e23e533

Compare with similar skills

Distill Session Knowledge 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.

Distill Session Knowledge compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Distill Session Knowledge this skillBlackBeltTechnology/pi-agent-dashboard315—~952Automated safety check: PassMIT
Paperclip Distillpaperclipai/paperclip99k—~2.8kAutomated safety check: PassMIT
Rules Distillationaffaan-m/ECC275k2 repos~2.3kAutomated safety check: PassMIT
Taste Distillationaffaan-m/ECC275k—~2.3kAutomated safety check: PassMIT
Rules Distillaffaan-m/ECC275k—~1.5kAutomated safety check: PassMIT
Rules Distillaffaan-m/ECC275k1 repos~1.3kAutomated safety check: PassMIT

Similar skills

  • Paperclip Distill

    paperclipai/paperclip

    A skill your agent uses when an operation issue is a Paperclip cursor-window, distill, or backfill.

    99k GitHub stars~2.8k tokensUpdated today
    Productivity & AutomationAuto-check passed

  • Rules Distillation

    affaan-m/ECC

    Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.

    275k GitHub starsUsed in 2 repos~2.3k tokens
    Agent WorkflowsAuto-check passed

  • Taste Distillation

    affaan-m/ECC

    Measure a set of reference videos into a reusable style pack - colour grade as a 3D LUT, cut rhythm as a shot-length distribution, hero stills, screen-blend overlay plates, and a text spec for a…

    275k GitHub stars~2.3k tokensUpdated 3 days ago
    Auto-check passed

  • Rules Distill

    affaan-m/ECC

    スキルをスキャンしてドメイン横断的な原則を抽出し、ルールに蒸留する——既存のルールファイルへの追記、修正、または新規作成

    275k GitHub stars~1.5k tokensUpdated 3 days ago
    Auto-check passed

  • Rules Distill

    affaan-m/ECC

    扫描技能以提取跨领域原则并将其提炼为规则——追加、修订或创建新的规则文件

    275k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed

  • Pua Offline

    tanweai/pua

    PUA offline alias for Codex. An agent skill from tanweai/pua.

    20k GitHub stars~143 tokensUpdated 29 days ago
    Auto-check passed

More from BlackBeltTechnology/pi-agent-dashboard

All 66 skills in this repo

  • Browser

    BlackBeltTechnology/pi-agent-dashboard

    Browser automation via the agent-browser CLI. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    315 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed

  • Pi Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Monitor and control the pi-dashboard server. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    315 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

  • CI Troubleshoot

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose failed GitHub Actions runs for pi-agent-dashboard: the 11-file workflow taxonomy, affected-test selection, the release pipeline, known failure modes, and how to read gh run logs and…

    315 GitHub stars~3.5k tokensUpdated today
    Auto-check passed

  • Debug Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose problems in the running pi-agent-dashboard system: server.log, /api/health, bridge WebSocket connectivity, vitest triage, known-issue FAQ entries.

    315 GitHub stars~1.6k tokensUpdated today
    Auto-check passed

  • Implement

    BlackBeltTechnology/pi-agent-dashboard

    Disciplined implementation in pi-agent-dashboard: the rebuild matrix (extension→reload, server→restart, client→build+restart, openspec-apply→full rebuild) plus the project's code discipline rules.

    315 GitHub stars~2k tokensUpdated today
    Auto-check passed

  • Session To Guideline

    BlackBeltTechnology/pi-agent-dashboard

    Turn a pi session into a Markdown "how-we-did-it" collaboration guideline: reads the session's JSONL transcript and synthesizes a reusable playbook of which prompts worked, what had to be steered…

    315 GitHub stars~3.2k tokensUpdated today
    Auto-check passed

Questions about Distill Session Knowledge

What does Distill Session Knowledge do?

Offline-mine this project's pi session JSONL logs into reusable, verified knowledge: extracts faults, decisions, corrections, procedures and docs, promotes only recurring patterns, and routes…. Distill Session Knowledge is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Offline-mine this project's pi session JSONL logs into reusable, verified knowledge: extracts faults, decisions, corrections, procedures and docs, promotes only recurring patterns, and routes artifacts into skillmanage, memory and docs.

How do I install Distill Session Knowledge in Claude Code?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill distill-session-knowledge -a claude-code`. Or copy the skill folder (packages/distill-session-knowledge/.pi/skills/distill-session-knowledge in BlackBeltTechnology/pi-agent-dashboard) into .claude/skills/distill-session-knowledge in your project. Claude Code loads it when a task matches its description.

How do I install Distill Session Knowledge in Codex?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill distill-session-knowledge -a codex`. Or copy the skill folder (packages/distill-session-knowledge/.pi/skills/distill-session-knowledge in BlackBeltTechnology/pi-agent-dashboard) into .agents/skills/distill-session-knowledge in your project. Codex loads it when a task matches its description.

Can I use Distill Session Knowledge 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 BlackBeltTechnology/pi-agent-dashboard --skill distill-session-knowledge -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/distill-session-knowledge, .gemini/skills/distill-session-knowledge, .github/skills/distill-session-knowledge and .opencode/skills/distill-session-knowledge in your project.

What does Distill Session Knowledge need to run?

Going by SKILL.md and its folder, Distill Session Knowledge needs the command-line tools its instructions call (npx and git). Our summary lists: Node.js.

Does Distill Session Knowledge access the network?

SKILL.md contains no URLs. Its commands use npx and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Distill Session Knowledge 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. Review the folder before installing.

What licence does Distill Session Knowledge use?

Distill Session Knowledge 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 Distill Session Knowledge use?

About 952 tokens (SKILL.md is roughly 3.8k 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 Distill Session Knowledge?

Skills that share tags, products or a category with Distill Session Knowledge: Paperclip Distill (paperclipai/paperclip, 99k stars), Rules Distillation (affaan-m/ECC, 275k stars), Taste Distillation (affaan-m/ECC, 275k stars) and Rules Distill (affaan-m/ECC, 275k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Distill Session Knowledge?

BlackBeltTechnology (a GitHub organization) maintains it in BlackBeltTechnology/pi-agent-dashboard, which has 315 GitHub stars. The repository holds 66 skills in this directory. The repository was last updated on October 8, 2026.

Source: BlackBeltTechnology/pi-agent-dashboard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.