kit/plugins/social-media-tools/skills/export-session/SKILL.md
Exports a Claude Code session transcript to Markdown. Converts session JSONL into readable reference material in the plans directory. Use when asked to export or archive a session.
npx skillsauth add shawn-sandy/agentics export-sessionInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Convert a session JSONL transcript into a readable Markdown file under {plansDirectory}/sessions/.
Resolve the output directory. Read plansDirectory from .claude/settings.json (fall back to docs/plans if unset). Output dir is <plansDirectory>/sessions.
Locate the session transcript.
If the user passed a .jsonl path or a session ID, use it (session IDs resolve to ~/.claude/projects/<project-slug>/<session-id>.jsonl).
Otherwise default to the most recent transcript for this project:
ls -t ~/.claude/projects/"$(pwd | sed 's|[/.]|-|g')"/*.jsonl 2>/dev/null | head -1
If that directory doesn't exist (e.g. running from a worktree), list ~/.claude/projects/ and pick the entry matching the main repo path, then take its newest .jsonl.
Convert. Run the bundled script — do not read the JSONL into context yourself:
python3 "${CLAUDE_PLUGIN_ROOT}/skills/export-session/scripts/export_session.py" <transcript.jsonl> <plansDirectory>/sessions
The script extracts user/Claude turns (skipping tool results, sidechains, and system reminders), writes <date>-<slug>.md with YAML frontmatter, and prints the output path.
Report. Show the user the written file path and its title. If they asked to export multiple sessions, repeat step 3 per transcript.
session-id, date, source, type: session-export) so they can be indexed or converted later.development
Checks whether the branch's PR is ready and merges it when green. Runs the readiness gate, lint, and an approval prompt. Use when the user asks "merge?" or if a PR is ready to merge.
development
Implements a plan file that already exists. Walks its steps, ticks the spec, re-renders, and runs the completion gates. Use when asked to implement an existing plan.
development
Audits and optimizes CLAUDE.md project memory files. Checks adherence to Claude Code best practices and produces actionable fixes. Use when the user asks to audit, optimize, or diagnose a CLAUDE.md.
development
Converts an HTML artifact or Markdown file into a draft post for a static site. Scopes CSS to keep interactive blocks alive and escapes prose for MDX. Use when asked to turn an artifact into a post.