Agent skill

Share

by ClickHouse in ClickHouse/ClickHouse

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

Apache-2.0Auto-check: notesDatabases

Install Share

skills CLI
$ npx skills add ClickHouse/ClickHouse --skill share -a claude-code

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

GitHub CLI
$ gh skill install ClickHouse/ClickHouse 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/ClickHouse/ClickHouse.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/share .claude/skills/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
share
GitHub stars
50k
Token cost
~558 tokens
SKILL.md length
246 words
Files
3
Skills in repo
24
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • Works in 2 steps: Run the bundled helper. It lives in the… → Report the URL the script prints to the…
  • The user asks to share
  • SKILL.md covers Steps and Notes
  • Runs Python scripts from its folder; calls python3

What it does

Share is an agent skill from ClickHouse/ClickHouse. Share a Claude Code session to pastila.nl and return a viewer link. Shares the current session by default, or a session specified as a transcript path, a session id, or a project. Use when the user asks to share, publish, or get a link to this conversation or to a session/transcript.

Its SKILL.md is about 560 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `pastila.py` and `share.py`).

It sits in Databases. The repository describes itself as: ClickHouse® is a real-time analytics database management system. The licence is Apache-2.0.

When your agent uses it

  • The user asks to share
  • Get a link to this conversation
  • A session/transcript

Example prompts

  • “/share”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash

Workflow steps

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

  1. Run the bundled helper. It lives in the same directory as this SKILL.md — use
  2. Report the URL the script prints to the user.

What it can do on your machine

Read from SKILL.md and the folder at commit cd023af. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.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

Share loads about 558 tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 246 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash

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 ClickHouse/ClickHouse at commit cd023af, republished under its Apache-2.0 licence (© ClickHouse). 246 words, ~558 tokens.

Download SKILL.mdSave it as .claude/skills/share/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
share
description
Share a Claude Code session to pastila.nl and return a viewer link. Shares the current session by default, or a session specified as a transcript path, a session id, or a project. Use when the user asks to share, publish, or get a link to this conversation or to a session/transcript.
allowed-tools
Bash
argument-hint
[session: path | session-id | project]
disable-model-invocation
false

Share a Claude session

Upload a Claude Code session transcript to pastila.nl (encrypted) and return a .claude.jsonl link that renders it like the viewer at https://github.com/ClickHouse/alexeyprompts

Steps

  1. Run the bundled helper. It lives in the same directory as this SKILL.md — use its absolute path (here this is .claude/skills/share/share.py):

    sh
    python3 <skill-dir>/share.py [session]
    • No argument → shares the current session (identified strictly by $CLAUDE_CODE_SESSION_ID). If that variable is unset or its transcript cannot be found, the script errors out and asks for an explicit argument rather than guessing — it never falls back to "the newest transcript", so it cannot publish an unrelated session by mistake.
    • [session] → shares another session, given as one of:
      • a path to a .jsonl transcript,
      • a session id (uuid), or
      • a project path or its ~/.claude/projects directory name (shares the newest session in it).
  2. Report the URL the script prints to the user.

The script delegates the upload to pastila.py (encryption + INSERT), so that logic is not duplicated; it then inserts the .claude.jsonl extension before the # key anchor to produce the viewer link.

Notes

  • The link contains the decryption key in its # fragment — anyone with the link can read the session. Share it only intentionally.
  • Sessions include tool calls and results (file fragments, command output). Take a quick look before sharing potentially sensitive ones.
  • pastila.py (the encryption + upload script from the pastila repo) is bundled next to share.py in this skill, so the skill is self-contained. It still needs the Python packages requests and cryptography installed.

© ClickHouse, 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 2 other files in .claude/skills/share of ClickHouse/ClickHouse.

  • SKILL.md
  • pastila.py
  • share.py

Open the folder on GitHubat commit cd023af

Compare with similar skills

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.

Share compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Share this skillClickHouse/ClickHouse50k—~558Automated safety check: NotesApache-2.0
Evolving The Data ModelTriliumNext/Trilium38k—~2.1kAutomated safety check: PassAGPL-3.0
Hybrid Cloud Outboxesgetsentry/sentry46k—~4.8kAutomated safety check: PassCustom licence
Adaptive Spin Waitmicrosoft/garnet12k—~1kAutomated safety check: PassMIT
Iptvnator Sqlite DB Worker4gray/iptvnator7.3k—~824Automated safety check: PassMIT
Replicate Video AdJingyi-Wu-Richael/replicate-video-ad1071 repos~1.6kAutomated safety check: PassNone

Similar skills

  • Evolving The Data Model

    TriliumNext/Trilium

    A skill your agent uses when adding a DB migration or a new column/field to a Becca entity in Trilium ("add a migration", "new column on notes/attributes", "ALTER TABLE", "add a field to…

    38k GitHub stars~2.1k tokensUpdated today
    DatabasesAuto-check passed
  • Hybrid Cloud Outboxes

    getsentry/sentry

    Official

    Guide for creating and maintaining outbox-based eventually consistent operations in Sentry.

    46k GitHub stars~4.8k tokensUpdated today
    DatabasesAuto-check passed
  • Adaptive Spin Wait

    microsoft/garnet

    Official

    Selects Garnet spin-wait policies based on the slow-path cost.

    12k GitHub stars~1k tokensUpdated today
    DatabasesAuto-check passed
  • A skill your agent uses when changing Electron SQLite IPC, database-worker operations, request-scoped progress or cancellation, worker packaging, or runtime verification of non-EPG database work.

    7.3k GitHub stars~824 tokensUpdated today
    DatabasesAuto-check passed
  • Replicate Video Ad

    Jingyi-Wu-Richael/replicate-video-ad

    Analyze a reference video frame by frame and turn its visual grammar, story beats, dialogue, product reveal, proof sequence, and conversion structure into a production-ready ecommerce story-ad…

    107 GitHub starsUsed in 1 repo~1.6k tokens
    DatabasesAuto-check passed
  • Official

    A skill your agent uses when the operator wants a hero or meta image for a Prisma blog post; asks to create or generate a blog hero, cover, social card, Open Graph, or YouTube image; mentions cover…

    1.1k GitHub stars~6.9k tokensUpdated today
    DatabasesAuto-check passed

More from ClickHouse/ClickHouse

All 24 skills in this repo
  • Keeper Stress Analysis

    ClickHouse/ClickHouse

    Analyze ClickHouse Keeper stress-test results from play.clickhouse.com / keeperstresstests data warehouse.

    50k GitHub stars~4.7k tokensUpdated today
    Auto-check passed
  • Perf Comparison

    ClickHouse/ClickHouse

    Evaluate ClickHouse performance test results from existing CI/dashboard data or local perf.py runs.

    50k GitHub stars~3.9k tokensUpdated today
    Auto-check: notes
  • Patch Release Check

    ClickHouse/ClickHouse

    Check whether ClickHouse's supported versions (last 3 majors + latest LTS) have recent stable patch releases, diagnose why the scheduled AutoReleases pipeline failed, and identify which releases…

    50k GitHub stars~4k tokensUpdated today
    Auto-check: notes
  • Alloc Profile

    ClickHouse/ClickHouse

    Analyze a jemalloc (or other) allocation profile in collapsed stack format.

    50k GitHub stars~4.3k tokensUpdated today
    Auto-check passed
  • Bisect

    ClickHouse/ClickHouse

    Bisect a ClickHouse regression using pre-built master binaries from CI.

    50k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Clickhouse PR Description

    ClickHouse/ClickHouse

    Generate PR descriptions for ClickHouse/ClickHouse that match maintainer expectations.

    50k GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Categories

Questions about Share

What does Share do?

Share a Claude Code session to pastila.nl and return a viewer link. Share is an agent skill from ClickHouse/ClickHouse.nl and return a viewer link.

When should I use Share?

Share fits situations like: the user asks to share; get a link to this conversation; A session/transcript.

How do I install Share in Claude Code?

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

How do I install Share in Codex?

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

Can I use 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 ClickHouse/ClickHouse --skill 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/share, .gemini/skills/share, .github/skills/share and .opencode/skills/share in your project.

What does Share need to run?

Going by SKILL.md and its folder, Share needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash.

Does Share access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Share safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Share use?

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

About 558 tokens (SKILL.md is roughly 2.2k 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 Share?

Skills that share tags, products or a category with Share: Evolving The Data Model (TriliumNext/Trilium, 38k stars), Hybrid Cloud Outboxes (getsentry/sentry, 46k stars), Adaptive Spin Wait (microsoft/garnet, 12k stars) and Iptvnator Sqlite DB Worker (4gray/iptvnator, 7.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Share?

ClickHouse (a GitHub organization) maintains it in ClickHouse/ClickHouse, which has 50,288 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 8, 2026.

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