dvcrn chats-share
Share AI agent conversations as public web pages.
Supported Agents
| Agent | Profile |
|---|---|
| OpenClaw | references/platforms/openclaw.md |
| (unknown) | references/platforms/unknown.md — generic skill-based fallback |
| (new platform) | Add a file following references/platforms/TEMPLATE.md |
Core Workflow
1. Setup Check
- Detect agent type; load project dir + site URL using the agent profile
- If project not configured locally, ask the user:
- "Do you have an existing chats-share repo?"
- Yes → Existing Repo, New Environment
- No (Default) → First-Time Setup
2. Locate Session
- List sessions using agent profile discovery
- Show candidates → user confirms selection
3. Extract & Convert
Follow the Conversion section in the platform profile detected in Step 1.
Save the result to {projectDir}/chats/.tmp/{timestamp}.yaml.
4. Populate Metadata
The CLI auto-fills structural fields. The Skill's job is to fill in the human-facing metadata:
| Field | CLI default | Action |
|---|---|---|
date, sessionId, model, totalMessages, totalTokens, defaultShowProcess |
Auto-filled | Review only |
visibility |
private |
Update to public |
participants |
Generic role names (user, assistant) |
Ask user for display names → rename keys |
title |
'Session Export' (generic) |
Skim generated YAML → suggest → confirm |
description |
(absent) | Write one-sentence summary → confirm |
channel |
(absent) | Ask user — set to platform name (e.g. discord) if applicable; omit otherwise |
cover |
(absent) | Skip (user adds custom OG image URL manually later) |
tags |
(absent) | Skip (user adds manually later) |
5. Redact
Review and remove sensitive information:
- API keys, tokens, passwords
- File paths with usernames (
/Users/xxx→~) - Email addresses, phone numbers
- Internal URLs and private IPs
6. Confirm & Save
- Suggest filename:
{YYYYMMDD}-{topic}.yaml - Show preview → user confirms or modifies topic/filename
- Before moving the file, create a dedicated branch (see below — required even if the user does not publish yet):
cd {projectDir} git checkout -b chat/{YYYYMMDD}-{topic} - Move:
{projectDir}/chats/.tmp/{timestamp}.yaml→{projectDir}/chats/{YYYYMMDD}-{topic}.yaml - Stage and commit immediately so the file is isolated on its own branch:
git add chats/{YYYYMMDD}-{topic}.yaml git commit -m "docs: add {topic}"
Why create a branch here? Saving on the default branch risks mixing unrelated changes into a future PR. Always commit each chat file on its own dedicated branch.
Optional: Publish
Push the branch created in step 6 and open a PR. See references/publish.md. Only proceed after explicit user request.
Edge Cases
- First-time project setup → references/setup.md
- Large or complex sessions (unknown platforms) → references/large-file.md