← All skills
session-to-guideline
80 / 100 · Low risk
Fine to try.
By BlackBeltTechnology/pi-agent-dashboard (GitHub) · productivity · 348 stars · scanned at commit e78b4c2
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, and how to reproduce the result faster. Use when: "document this session", "write up how we did X with the AI", "make a guideline from this session", "turn this session into a playbook/tutorial".
Works with any agent that supports SKILL.md skills.
What this skill can do
Downloads and installs other software
The author does not mention this.
Found in 14 places.
Show 11 more
- packages/authoring-toolkit/.pi/skills/session-to-guideline/SKILL.md, line 42
npx tsx scripts/list_sessions.ts --all --limit 30 # every project - packages/authoring-toolkit/.pi/skills/session-to-guideline/SKILL.md, line 56
npx tsx scripts/extract_session.ts <selector> --cwd "$(pwd)" --out-md "$FACTS" - packages/authoring-toolkit/.pi/skills/session-to-guideline/SKILL.md, line 149
npx tsx scripts/list_sessions.ts --cwd "$(pwd)" --limit 50 # or --all - packages/authoring-toolkit/.pi/skills/session-to-guideline/SKILL.md, line 186
| Latest session in this project (+ worktrees) | `npx tsx scripts/extract_session.ts latest --cwd "$(pwd)"` | - packages/authoring-toolkit/.pi/skills/session-to-guideline/SKILL.md, line 187
| Latest, project root only (no worktrees) | `npx tsx scripts/extract_session.ts latest --cwd "$(pwd)" --no-worktrees` | - packages/authoring-toolkit/.pi/skills/session-to-guideline/SKILL.md, line 188
| 2nd-most-recent | `npx tsx scripts/extract_session.ts latest --cwd "$(pwd)" --index 1` | - packages/authoring-toolkit/.pi/skills/session-to-guideline/SKILL.md, line 189
| A specific session by id | `npx tsx scripts/extract_session.ts 019ea8a9` | - packages/authoring-toolkit/.pi/skills/session-to-guideline/SKILL.md, line 190
| A session in another project | `npx tsx scripts/extract_session.ts latest --cwd /path/to/other` | - packages/authoring-toolkit/.pi/skills/session-to-guideline/SKILL.md, line 191
| An explicit file | `npx tsx scripts/extract_session.ts /abs/path/to/session.jsonl` | - packages/authoring-toolkit/.pi/skills/session-to-guideline/SKILL.md, line 202
- No third-party deps; TypeScript on Node built-ins (`fs`/`path`/`os`). Run with `npx tsx` - packages/authoring-toolkit/.pi/skills/session-to-guideline/scripts/list_sessions.ts, line 132
console.log("\nPick with: npx tsx scripts/extract_session.ts <id-or-'latest'> --cwd <dir>");
Runs commands on your computer
The author does not mention this.
Found in 3 places.
Install
Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.
if [ -e ~/.agents/skills/'session-to-guideline' ] || [ -L ~/.agents/skills/'session-to-guideline' ]; then echo 'A skill folder named session-to-guideline already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/BlackBeltTechnology/pi-agent-dashboard' "$d" && git -C "$d" checkout --quiet 'e78b4c2c0474a8ab04941e76942e5a5b9d92c2d6' -- 'packages/authoring-toolkit/.pi/skills/session-to-guideline' && mkdir -p ~/.agents/skills && cp -R "$d"/'packages/authoring-toolkit/.pi/skills/session-to-guideline' ~/.agents/skills/'session-to-guideline' && rm -rf "$d"; fi
Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'session-to-guideline' ~/.claude/skills/'session-to-guideline' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.
Badge for your README
The badge for BlackBeltTechnology/pi-agent-dashboard shows the score of its lowest-scoring skill.

[](https://zalavijaysinh.github.io/skilltrust/repos/BlackBeltTechnology/pi-agent-dashboard/)
Score history
| Date | Version | Score |
|---|
| 2026-11-13 | e78b4c2 | 80 |
| 2026-11-07 | 3cf8afe | 100 |