How do I install the Share Session skill?

Run npx skillmds@latest add majiayu000/share-session-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Share Session skill do?

Share Droid sessions as GitHub gists. Use when asked to "share session", "export session to gist", or "create gist from session". It is listed under Integrations & APIs on SkillMD.

Is Share Session safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Share Session?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Share Session free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Share Session?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Share Session by majiayu000 — Agent Skill

Name: Share Session
Rating: 4.666666666666667 (3 reviews)
Author: majiayu000

File contents

Share Session Skill

Export and share Droid CLI sessions via GitHub gists.

Usage

# List available sessions
./scripts/list.sh

# Share session with auto-generated title
./scripts/share.sh [session-id] "Title for the session"

# Export locally without uploading
node ./scripts/export-html.js <session.jsonl> [output.html]
node ./scripts/export-md.js <session.jsonl> [output.md]

If no session-id provided, uses most recent session.

Auto-naming Sessions

You must generate a title for every session you share.

Instructions:

Read the session JSONL file to find the first user message
Generate a short, descriptive title (5-8 words) that captures the main task
Pass the title as the second argument to share.sh

Title guidelines:

Be concise and descriptive
Focus on WHAT was accomplished, not HOW
No quotes, no special characters
Examples: "Setting up Cloudflare Tunnel for local dev", "Fix TypeScript build errors in API", "Add dark mode toggle to settings"

./scripts/share.sh "" "Your generated title here"

Formats

html - Self-contained HTML with syntax highlighting, collapsible tool calls, dark theme
md - Clean Markdown with collapsible details blocks
raw - Original JSONL file

Requirements

gh CLI installed and authenticated (gh auth login)
Node.js for HTML/MD export

Session Locations

Global: ~/.factory/sessions/
Project-local: .factory/sessions/

Frequently asked questions

Share Session