share-session

Generates a session recap card from Claude Code session JSONL and git history.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/shawn-sandy/agentics-kit --skill share-session-shawn-sandy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: share-session
Source: https://github.com/shawn-sandy/agentics-kit/tree/main/kit/plugins/social-media-tools/skills/share-session
Command: npx skills add https://github.com/shawn-sandy/agentics-kit --skill share-session-shawn-sandy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a Claude Code coding session into a shareable social media recap requires manually summarizing work, gathering token and git statistics, and formatting a card — this Skill automates that entire pipeline. ## Core Features & Use Cases - Session Data Gathering: Reads the session JSONL transcript via session_usage.py for token counts, cache hit rate, duration, and model info, plus git history for commit and file-change counts. - Security Scrub Gate: Runs the full narrative through a security-scrub skill before sharing; a BLOCKED result hard-stops the workflow to prevent leaking secrets. - Card Generation & Delivery: Populates an HTML template, saves it to docs/media/social/, screenshots it with Playwright, and delivers platform-specific copy (LinkedIn, Twitter/X, Bluesky, Substack) with a takeaway-first narrative. - Use Case: After finishing a feature branch, ask for a session recap and receive a dark-mode PNG card plus ready-to-post copy summarizing what was built, with token and commit stats as supporting detail. ## Quick Start Ask the assistant to share a recap of what you worked on in this session, optionally specifying a platform and tone.

Frequently Asked Questions about share-session

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a recap of my Claude Code session?▼

Invoke the share-session skill and it reads the session JSONL transcript and git history, drafts a narrative with accomplishments, and produces a recap card image plus platform-specific post copy. You can pass --platform and --tone flags to skip the prompts.

How does the skill prevent secrets from being shared?▼

The full narrative and accomplishments are written to a temp file and scanned by the security-scrub skill before drafting. A BLOCKED or CANCELLED gate result stops the workflow entirely, and a missing gate result is treated as a failure.

Which social platforms does the session recap support?▼

The skill drafts copy for LinkedIn, Twitter/X, Bluesky, and Substack using per-platform character limits and tone defaults defined in the plugin's platforms.md reference. Each format leads with a takeaway rather than metrics.

What happens if the session transcript cannot be found?▼

If session_usage.py exits non-zero or returns an error, the skill stops and tells you to set the CLAUDE_CODE_SESSION_ID environment variable or pass --session=<path> explicitly to locate the transcript.

Does the recap card show cost or dollar amounts?▼

No. The card displays token counts, cache hit rate, duration, commits, and files changed only. Dollar amounts and cost figures are explicitly prohibited anywhere on the card or in the drafted copy.