{
  "markdown": "# Export Conversation - Claude Code Skill\n\n> 📝 Export your Claude Code conversation sessions to beautifully formatted markdown files with diagrams, statistics, and full conversation history.\n\n[![Claude Code](https://img.shields.io/badge/Claude-Code_Skill-5865F2?style=flat&logo=anthropic)](https://claude.ai/code)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n\n## Features\n\n✨ **Comprehensive Exports** - Captures complete conversation history with user messages, assistant responses, and all tool usage\n\n📊 **Visual Diagrams** - Automatically generates Mermaid diagrams for:\n- Code architecture and system design\n- Process flows and workflows  \n- Sequence diagrams for API calls\n- File structure trees\n- Git operations and branching\n- State machines and data flows\n\n📈 **Session Statistics** - Tracks files modified, commands executed, and key outcomes\n\n🎯 **Flexible Output** - Auto-timestamped files or custom naming\n\n🔒 **Privacy-Aware** - Sanitizes sensitive information (API keys, passwords)\n\n## Quick Start\n\n### Installation\n\n#### From Claude Code CLI (Recommended)\n\nOnce this plugin is available in a marketplace:\n\n```bash\n/plugin install export-conversation\n```\n\n#### Manual Installation\n\n1. **Clone or download this repository:**\n   ```bash\n   git clone https://github.com/akoserwal/export-conversation-skill.git\n   ```\n\n2. **Load the plugin:**\n   ```bash\n   # Test locally during development\n   claude --plugin-dir ./export-conversation-skill\n   \n   # Or install permanently by copying to plugins directory\n   cp -r export-conversation-skill ~/.claude/plugins/export-conversation\n   ```\n\n3. **Verify installation:**\n   ```bash\n   # In Claude Code session\n   /help\n   ```\n   \n   You should see `/export-conversation:export` listed under available skills.\n\n## Usage\n\n### Basic Usage\n\nExport current conversation with auto-generated timestamp:\n```bash\n/export-conversation:export\n```\nCreates: `conversation-export-2026-04-08-203940.md`\n\n### Custom Filename\n\nExport to a specific filename:\n```bash\n/export-conversation:export my-session\n```\nCreates: `my-session.md`\n\n### Custom Path\n\nExport to a specific directory:\n```bash\n/export-conversation:export docs/sessions/planning-session\n```\nCreates: `docs/sessions/planning-session.md`\n\n**Note:** Plugin skills are namespaced (`:export`) to prevent conflicts with other plugins.\n\n## What Gets Exported\n\nEach export includes:\n\n### 1. Session Metadata\n- Export timestamp\n- Working directory\n- Conversation summary (2-3 paragraph overview)\n\n### 2. Visual Overview (When Applicable)\nAutomatically generated Mermaid diagrams for:\n- **Architecture diagrams** - Component relationships and dependencies\n- **Sequence diagrams** - API calls, method invocations, request/response flows\n- **Flowcharts** - Process flows, decision trees, workflows\n- **File structure** - Directory trees and file organization\n- **Git graphs** - Branching strategies and commit history\n- **State diagrams** - State machines and UI states\n- **ER diagrams** - Database schemas and entity relationships\n\n### 3. Full Conversation History\n- Chronological message-by-message capture\n- User messages and assistant responses\n- All tool calls with descriptions (Bash, Read, Write, Edit, etc.)\n- Errors encountered and resolutions\n- Code snippets (when relevant)\n\n### 4. Session Statistics\n- Total message count\n- Files created and modified\n- Commands executed\n- Key outcomes and achievements\n\n### 5. File Change Log\nDetailed documentation for each file:\n- Action taken (Created/Modified/Deleted)\n- Description of changes\n- Relevant code snippets\n\n## Examples\n\n### Example 1: Simple Export\n\n```bash\n/export-conversation\n```\n\n**Output:**\n```\n✓ Conversation exported to: /Users/you/project/conversation-export-2026-04-08-143022.md\n\nThe export includes:\n- Full conversation history (12 messages)\n- 3 files modified\n- 8 commands executed\n- 0 Mermaid diagrams\n- Session summary and statistics\n```\n\n### Example 2: Export with Diagrams\n\nWhen you discuss architecture, the skill automatically includes relevant diagrams:\n\n```bash\n/export-conversation architecture-planning\n```\n\n**Output:**\n```\n✓ Conversation exported to: /Users/you/project/architecture-planning.md\n\nThe export includes:\n- Full conversation history (25 messages)\n- 8 files modified\n- 15 commands executed\n- 4 Mermaid diagrams\n- Session summary and statistics\n```\n\nThe export will contain diagrams like:\n\n```mermaid\ngraph TD\n    API[API Layer] --> Service[Service Layer]\n    Service --> Database[(Database)]\n    Service --> Cache[(Redis Cache)]\n```\n\n### Example 3: Review Session Export\n\n```bash\n/export-conversation code-review-session\n```\n\nPerfect for documenting:\n- Code review discussions\n- Bug investigation sessions\n- Architecture planning meetings\n- Feature development sessions\n- Debugging sessions\n\n## When to Use\n\n**Perfect for:**\n- 📚 **Documentation** - Create permanent records of important sessions\n- 🔍 **Code Reviews** - Export review discussions with full context\n- 🏗️ **Architecture Planning** - Capture design decisions with diagrams\n- 🐛 **Bug Investigations** - Document debugging sessions step-by-step\n- 📖 **Learning** - Save educational sessions for future reference\n- 🤝 **Team Sharing** - Share conversation context with team members\n- 📝 **Project History** - Build a knowledge base of project decisions\n\n## Diagram Support\n\nThe skill intelligently determines when to create diagrams based on conversation content:\n\n| Diagram Type | Use Case | Example |\n|--------------|----------|---------|\n| `graph TD/LR` | Architecture, dependencies, file trees | Component relationships |\n| `sequenceDiagram` | API calls, method flows | Request/response patterns |\n| `flowchart` | Processes, decision trees | Workflow logic |\n| `classDiagram` | OOP design, class relationships | Class hierarchies |\n| `stateDiagram-v2` | State machines, UI states | State transitions |\n| `gitGraph` | Git operations, branching | Branch strategies |\n| `erDiagram` | Database schemas | Entity relationships |\n\n### Diagram Quality Standards\n\nThe skill ensures diagrams are:\n- ✅ Focused on one concept per diagram\n- ✅ Using clear, descriptive labels\n- ✅ Showing actual names from your conversation\n- ✅ Indicating flow direction with arrows\n- ✅ Self-explanatory with context\n\n## Privacy & Security\n\n- **Automatic sanitization** - Sensitive data (API keys, passwords) replaced with `[REDACTED]`\n- **Local-only** - Exports are saved to your local filesystem\n- **No external uploads** - Your conversations stay on your machine\n\n## File Structure\n\n```\nexport-conversation-skill/\n├── SKILL.md                 # Skill definition and instructions\n├── README.md               # This file\n├── LICENSE                 # MIT License\n└── examples/               # Example exports\n    ├── simple-export.md\n    ├── with-diagrams.md\n    └── architecture-session.md\n```\n\n## Advanced Tips\n\n### 1. Create a Documentation Workflow\n\nAdd to your `.claude/CLAUDE.md`:\n```markdown\n# Project Documentation\nAfter completing significant features or architectural decisions, \nrun `/export-conversation feature-name` to document the session.\n```\n\n### 2. Combine with Git\n\n```bash\n# After a productive session\n/export-conversation feature-auth-implementation\n\n# Add to git\ngit add docs/sessions/feature-auth-implementation.md\ngit commit -m \"docs: Add session notes for auth implementation\"\n```\n\n### 3. Team Knowledge Base\n\nExport important sessions to a shared docs folder:\n```bash\n/export-conversation docs/team-sessions/2026-04-08-api-redesign\n```\n\n## Troubleshooting\n\n### Skill Not Found\n\nIf `/export-conversation` is not recognized:\n\n1. Verify installation:\n   ```bash\n   ls ~/.claude/skills/export-conversation/SKILL.md\n   ```\n\n2. Check file permissions:\n   ```bash\n   chmod 644 ~/.claude/skills/export-conversation/SKILL.md\n   ```\n\n3. Restart Claude Code CLI or reload your session\n\n### Exports Missing Diagrams\n\nDiagrams are only included when:\n- Code architecture or system design was discussed\n- Process flows or workflows were created\n- File/directory structure was modified\n- Component relationships were explained\n\nFor simple Q&A sessions without architectural discussion, no diagrams are generated.\n\n### Custom Diagram Requests\n\nIf you want to ensure diagrams are included, explicitly discuss architecture during your session:\n- \"Let's diagram the component architecture\"\n- \"Show me the flow of this process\"\n- \"What's the file structure we created?\"\n\n## Contributing\n\nContributions are welcome! Here's how:\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-improvement`\n3. Make your changes to `SKILL.md`\n4. Test thoroughly in a Claude Code session\n5. Commit with clear messages: `git commit -m 'feat: Add support for X'`\n6. Push to your fork: `git push origin feature/amazing-improvement`\n7. Open a Pull Request\n\n### Development Setup\n\n```bash\n# Clone your fork\ngit clone https://github.com/YOUR_USERNAME/export-conversation-skill.git\n\n# Create symlink for development\nln -s $(pwd)/export-conversation-skill ~/.claude/skills/export-conversation\n\n# Make changes to SKILL.md\n# Test in Claude Code with /export-conversation\n# Changes take effect immediately\n```\n\n## Changelog\n\n### v2.0.0 - 2026-04-08\n- ✨ Added comprehensive Mermaid diagram support\n- ✨ 7 diagram types: graph, sequence, flowchart, class, state, git, ER\n- 📝 Enhanced Visual Overview section\n- 📝 Diagram quality standards and guidelines\n- 🎯 Smart diagram inclusion based on conversation content\n\n### v1.0.0 - 2026-04-08\n- 🎉 Initial release\n- ✨ Basic conversation export functionality\n- ✨ Session statistics tracking\n- ✨ File change logging\n- ✨ Flexible output naming (timestamp or custom)\n- 🔒 Sensitive data sanitization\n\n## License\n\nMIT License - see [LICENSE](./LICENSE) file for details\n\n## Acknowledgments\n\nBuilt for [Claude Code](https://claude.ai/code) by Anthropic\n\n## Support\n\n- 🐛 [Report Issues](https://github.com/YOUR_USERNAME/export-conversation-skill/issues)\n- 💡 [Request Features](https://github.com/YOUR_USERNAME/export-conversation-skill/issues/new)\n- 📖 [Claude Code Documentation](https://docs.anthropic.com/claude/docs/claude-code)\n\n---\n\n**Made with ❤️ for the Claude Code community**\n",
  "bytes": 10195,
  "sha": "fd2cccf346dd00a48477878bdda6f35cf5a36a1de17831a6f058d260371c7884",
  "repo_slug": "akoserwal/export-conversation-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_akoserwal_export_conversation_skill_expo_2301d2f7/readme"
}