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

Pi Share

by mitsuhiko in mitsuhiko/agent-stuff

Load and parse session transcripts from shittycodingagent.ai/buildwithpi.ai/buildwithpi.com/pi.dev (pi-share) URLs.

Apache-2.0Auto-check passed

Install Pi Share

skills CLI
$ npx skills add mitsuhiko/agent-stuff --skill pi-share -a claude-code

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

GitHub CLI
$ gh skill install mitsuhiko/agent-stuff pi-share --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/mitsuhiko/agent-stuff.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pi-share .claude/skills/pi-share && 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
pi-share
GitHub stars
3.2k
Token cost
~992 tokens
SKILL.md length
270 words
Files
2
Skills in repo
16
Repo updated
First seen
Licence
Apache-2.0

At a glance

Load and parse session transcripts from shittycodingagent.ai/buildwithpi.ai/buildwithpi.com/pi.dev (pi-share) URLs.

  • Works in 4 steps: Session exports are stored as GitHub Gists → The URL contains a gist ID after the ? → The gist contains a session.html file… → …
  • SKILL.md covers When to Use, How It Works, Usage and Human Summary, plus 2 more sections
  • Runs JavaScript scripts from its folder; calls node and jq; reaches pi.dev and shittycodingagent.ai

What it does

Pi Share is an agent skill from mitsuhiko/agent-stuff. Load and parse session transcripts from shittycodingagent.ai/buildwithpi.ai/buildwithpi.com/pi.dev (pi-share) URLs. Fetches gists, decodes embedded session data, and extracts conversation history.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

The repository describes itself as: These are commands I use with agents, mostly Claude. The licence is Apache-2.0.

Example prompts

  • “/pi-share”

Requirements

  • Node.js

Workflow steps

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

  1. Session exports are stored as GitHub Gists
  2. The URL contains a gist ID after the ?
  3. The gist contains a session.html file with base64-encoded session data
  4. The helper script fetches and decodes this to extract the full conversation

What it can do on your machine

Read from SKILL.md and the folder at commit 0865c84. 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 script files (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • jq

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • pi.dev
    • shittycodingagent.ai
    • buildwithpi.ai
    • buildwithpi.com

    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

Pi Share loads about 992 tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 270 words of instructions outside code blocks.

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

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 mitsuhiko/agent-stuff at commit 0865c84, republished under its Apache-2.0 licence (© mitsuhiko). 270 words, ~992 tokens.

Download SKILL.mdSave it as .claude/skills/pi-share/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
pi-share
description
Load and parse session transcripts from shittycodingagent.ai/buildwithpi.ai/buildwithpi.com/pi.dev (pi-share) URLs. Fetches gists, decodes embedded session data, and extracts conversation history.

pi-share / buildwithpi Session Loader

Load and parse session transcripts from pi-share URLs (shittycodingagent.ai, buildwithpi.ai, buildwithpi.com, pi.dev).

When to Use

Loading sessions: Use this skill when the user provides a URL like:

  • https://shittycodingagent.ai/session/?<gist_id>
  • https://buildwithpi.ai/session/?<gist_id>
  • https://buildwithpi.com/session/?<gist_id>
  • https://pi.dev/session/?<gist_id>
  • https://pi.dev/session/#<gist_id>
  • Or just a gist ID like 46aee35206aefe99257bc5d5e60c6121
  • Or hash-prefixed shorthand like #46aee35206aefe99257bc5d5e60c6121

Human summaries: Use --human-summary when the user asks you to:

  • Summarize what a human did in a pi/coding agent session
  • Understand how a user interacted with an agent
  • Analyze user behavior, steering patterns, or prompting style
  • Get a human-centric view of a session (not what the agent did, but what the human did)

The human summary focuses on: initial goals, re-prompts, steering/corrections, interventions, and overall prompting style.

How It Works

  1. Session exports are stored as GitHub Gists
  2. The URL contains a gist ID after the ?
  3. The gist contains a session.html file with base64-encoded session data
  4. The helper script fetches and decodes this to extract the full conversation

Usage

bash
# Get full session data (default)
node ~/.pi/agent/skills/pi-share/fetch-session.mjs "<url-or-gist-id>"

# Get just the header
node ~/.pi/agent/skills/pi-share/fetch-session.mjs <gist-id> --header

# Get entries as JSON lines (one entry per line)
node ~/.pi/agent/skills/pi-share/fetch-session.mjs <gist-id> --entries

# Get the system prompt
node ~/.pi/agent/skills/pi-share/fetch-session.mjs <gist-id> --system

# Get tool definitions
node ~/.pi/agent/skills/pi-share/fetch-session.mjs <gist-id> --tools

# Get human-centric summary (what did the human do in this session?)
node ~/.pi/agent/skills/pi-share/fetch-session.mjs <gist-id> --human-summary

Human Summary

The --human-summary flag generates a ~300 word summary focused on the human's experience:

  • What was their initial goal?
  • How often did they re-prompt or steer the agent?
  • What kind of interventions did they make? (corrections, clarifications, frustration)
  • How specific or vague were their instructions?

This uses claude-haiku-4-5 via pi -p to analyze the condensed session transcript.

Session Data Structure

The decoded session contains:

typescript
interface SessionData {
  header: {
    type: "session";
    version: number;
    id: string;           // Session UUID
    timestamp: string;    // ISO timestamp
    cwd: string;          // Working directory
  };
  entries: SessionEntry[];  // Conversation entries (JSON lines format)
  leafId: string | null;    // Current branch leaf
  systemPrompt?: string;    // System prompt text
  tools?: { name: string; description: string }[];
}

Entry types include:

  • message - User/assistant/toolResult messages with content blocks
  • model_change - Model switches
  • thinking_level_change - Thinking mode changes
  • compaction - Context compaction events

Message content block types:

  • text - Text content
  • toolCall - Tool invocation with toolName and args
  • thinking - Model thinking content
  • image - Embedded images

Example: Analyze a Session

bash
# Pipe entries through jq to filter
node ~/.pi/agent/skills/pi-share/fetch-session.mjs "<url>" --entries | jq 'select(.type == "message" and .message.role == "user")'

# Count tool calls
node ~/.pi/agent/skills/pi-share/fetch-session.mjs "<url>" --entries | jq -s '[.[] | select(.type == "message") | .message.content[]? | select(.type == "toolCall")] | length'

© mitsuhiko, Apache-2.0. 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 in skills/pi-share of mitsuhiko/agent-stuff.

  • SKILL.md
  • fetch-session.mjs

Open the folder on GitHubat commit 0865c84

Compare with similar skills

Pi Share 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.

Pi Share compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pi Share this skillmitsuhiko/agent-stuff3.2k—~992Automated safety check: PassApache-2.0
ShareClickHouse/ClickHouse50k—~558Automated safety check: NotesApache-2.0
Baoyu Youtube TranscriptJimLiu/baoyu-skills26k1 repos~2.4kAutomated safety check: PassMIT
Youtube Transcriptbrowser-act/skills6.1k—~2.1kAutomated safety check: PassMIT
Youtube Transcriptsickn33/agentic-awesome-skills47k1 repos~1.3kAutomated safety check: PassMIT
Transcription0xsline/OpenChatCut2.2k1 repos~1.1kAutomated safety check: PassAGPL-3.0

Similar skills

  • Share

    ClickHouse/ClickHouse

    Share a Claude Code session to pastila.nl and return a viewer link.

    50k GitHub stars~558 tokensUpdated today
    DatabasesAuto-check: notes

  • Baoyu Youtube Transcript

    JimLiu/baoyu-skills

    Downloads YouTube video transcripts/subtitles and cover images by URL or video ID.

    26k GitHub starsUsed in 1 repo~2.4k tokens
    Media & CreativeAuto-check passed

  • Youtube Transcript

    browser-act/skills

    YouTube transcript extraction and content reformatting: given a YouTube video URL, opens the video's transcript panel, extracts all timestamped segments, and transforms the raw transcript into…

    6.1k GitHub stars~2.1k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed

  • Youtube Transcript

    sickn33/agentic-awesome-skills

    Fetch YouTube transcripts through DeepAPI or local fallback tooling and save clean text output.

    47k GitHub starsUsed in 1 repo~1.3k tokens
    Knowledge ManagementAuto-check passed

  • Transcription

    0xsline/OpenChatCut

    A skill your agent uses when a video/audio task needs OpenChatCut transcription, captions, subtitles, subtitle styling, transcript search, transcript readiness checks, or enabling captions…

    2.2k GitHub starsUsed in 1 repo~1.1k tokens
    Media & CreativeAuto-check passed

  • Youtube Transcript Skills

    sickn33/agentic-awesome-skills

    Fetch YouTube video transcripts, search videos/channels, browse channels, and extract playlists via the getyoutubetranscript.com API - free tier, no card required.

    47k GitHub starsUsed in 1 repo~1.2k tokens
    Knowledge ManagementAuto-check passed

More from mitsuhiko/agent-stuff

All 16 skills in this repo

  • Anachb

    mitsuhiko/agent-stuff

    Austrian public transport (VOR AnachB) for all of Austria. An agent skill from mitsuhiko/agent-stuff.

    3.2k GitHub starsUsed in 2 repos~1.2k tokens
    Auto-check passed

  • Librarian

    mitsuhiko/agent-stuff

    Cache and refresh remote git repositories under ~/.cache/checkouts/<host/<org/<repo so future references can reuse a local copy.

    3.2k GitHub starsUsed in 1 repo~519 tokens
    Auto-check passed

  • Web Browser

    mitsuhiko/agent-stuff

    Automate and interact with web pages through Chrome or Chromium using the Chrome DevTools Protocol (CDP): navigate, click, fill forms, inspect content, take screenshots, and debug console or network…

    3.2k GitHub stars~1.5k tokensUpdated 12 days ago
    Auto-check: warnings

  • Google Workspace

    mitsuhiko/agent-stuff

    Access Google Workspace APIs (Drive, Docs, Calendar, Gmail, Sheets, Slides, Chat, People) via local helper scripts without MCP.

    3.2k GitHub stars~919 tokensUpdated 12 days ago
    Auto-check passed

  • Oebb Scotty

    mitsuhiko/agent-stuff

    Austrian rail travel planner (ÖBB Scotty). An agent skill from mitsuhiko/agent-stuff.

    3.2k GitHub stars~2.4k tokensUpdated 12 days ago
    Auto-check passed

  • Sentry

    mitsuhiko/agent-stuff

    Fetch and analyze Sentry issues, events, transactions, and logs.

    3.2k GitHub stars~1.8k tokensUpdated 12 days ago
    Auto-check passed

Questions about Pi Share

What does Pi Share do?

Load and parse session transcripts from shittycodingagent.ai/buildwithpi.ai/buildwithpi.com/pi.dev (pi-share) URLs. Pi Share is an agent skill from mitsuhiko/agent-stuff.dev (pi-share) URLs.

How do I install Pi Share in Claude Code?

Run `npx skills add mitsuhiko/agent-stuff --skill pi-share -a claude-code`. Or copy the skill folder (skills/pi-share in mitsuhiko/agent-stuff) into .claude/skills/pi-share in your project. Claude Code loads it when a task matches its description.

How do I install Pi Share in Codex?

Run `npx skills add mitsuhiko/agent-stuff --skill pi-share -a codex`. Or copy the skill folder (skills/pi-share in mitsuhiko/agent-stuff) into .agents/skills/pi-share in your project. Codex loads it when a task matches its description.

Can I use Pi Share 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 mitsuhiko/agent-stuff --skill pi-share -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pi-share, .gemini/skills/pi-share, .github/skills/pi-share and .opencode/skills/pi-share in your project.

What does Pi Share need to run?

Going by SKILL.md and its folder, Pi Share needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node and jq). Our summary lists: Node.js.

Does Pi Share access the network?

SKILL.md names 4 domains. In commands or code: pi.dev, shittycodingagent.ai, buildwithpi.ai and buildwithpi.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Pi Share 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 Pi Share use?

Pi Share is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pi Share use?

About 992 tokens (SKILL.md is roughly 4k 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 Pi Share?

Skills that share tags, products or a category with Pi Share: Share (ClickHouse/ClickHouse, 50k stars), Baoyu Youtube Transcript (JimLiu/baoyu-skills, 26k stars), Youtube Transcript (browser-act/skills, 6.1k stars) and Youtube Transcript (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pi Share?

mitsuhiko (a GitHub user) maintains it in mitsuhiko/agent-stuff, which has 3,179 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on September 27, 2026.

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