Agent skill

Yida Export Conversation

by openyida in openyida/openyida

导出 AI 对话记录,生成结构化的 Markdown 文档。支持 Claude Code 自动检测,其他环境通过 --input 手动指定。适用于保存和回顾 AI 编程过程记录。

MITAuto-check passedDocuments & Office

Install Yida Export Conversation

skills CLI
$ npx skills add openyida/openyida --skill yida-export-conversation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install openyida/openyida yida-export-conversation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/openyida/openyida.git skills-src && mkdir -p .claude/skills && cp -r skills-src/yida-skills/skills/yida-export-conversation .claude/skills/yida-export-conversation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
yida-export-conversation
GitHub stars
220
Token cost
~562 tokens
SKILL.md length
165 words
Files
1
Skills in repo
58
Repo updated
First seen
Licence
MIT

At a glance

导出 AI 对话记录,生成结构化的 Markdown 文档。支持 Claude Code 自动检测,其他环境通过 --input 手动指定。适用于保存和回顾 AI 编程过程记录。

  • Works in 3 steps: 概要信息 → 关键步骤摘要 → 完整对话记录
  • Documents & Office work in your project
  • SKILL.md covers 严格禁止 (NEVER DO), 严格要求 (MUST DO), 适用场景 and 触发条件, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Yida Export Conversation is an agent skill from openyida/openyida. 导出 AI 对话记录,生成结构化的 Markdown 文档。支持 Claude Code 自动检测,其他环境通过 --input 手动指定。适用于保存和回顾 AI 编程过程记录。

Its SKILL.md is about 560 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office. The repository describes itself as: Your own personal YiDA AI assistant! The licence is MIT.

When your agent uses it

  • Documents & Office work in your project

Example prompts

  • “/yida-export-conversation”

Requirements

  • Node.js

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 概要信息
  2. 关键步骤摘要
  3. 完整对话记录

What it can do on your machine

Read from SKILL.md and the folder at commit 3dd4693. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Yida Export Conversation loads about 562 tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 165 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~29
When it runs · the whole SKILL.md, loaded when a task matches
~562

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from openyida/openyida at commit 3dd4693, republished under its MIT licence (© openyida). 165 words, ~562 tokens.

Download SKILL.mdSave it as .claude/skills/yida-export-conversation/SKILL.md (or your agent's skills folder).
name
yida-export-conversation
description
导出 AI 对话记录,生成结构化的 Markdown 文档。支持 Claude Code 自动检测,其他环境通过 --input 手动指定。适用于保存和回顾 AI 编程过程记录。

导出 AI 对话记录

严格禁止 (NEVER DO)

  • 不要在非 Claude Code 环境下省略 --input 参数(其他环境无法自动检测对话文件)

严格要求 (MUST DO)

  • 导出前确认当前环境(openyida env),Claude Code 环境可自动检测,其他环境需 --input 手动指定
  • 导出前必须确认输出路径有写权限,避免导出失败
  • 导出完成后必须告知用户文件路径和文件大小,方便用户确认
  • 遇到对话文件格式不支持时,必须明确告知用户支持的格式(.jsonl)
  • 本技能不读写 memory:对话记录导出为本地 Markdown 文件,不依赖跨会话的 memory 状态

适用场景

用户需要"导出对话记录"、"保存 AI 对话"、"生成开发文档"时使用。 无需登录宜搭,为纯本地操作。

触发条件

正向触发:

  • "导出对话记录"、"保存 AI 对话"
  • "生成开发文档"、"导出本次对话"
  • "把对话记录存下来"

注意:本技能为一次性导出,不支持实时同步。非 Claude Code 环境需通过 --input 手动指定对话文件。


将 AI 对话记录导出为结构化的 Markdown 文档,方便分享和存档。

命令

bash
openyida export-conversation [options]
选项说明
--output <path>指定输出文件路径(默认 project/conversation-export.md)
--input <file>手动指定对话记录文件(覆盖自动检测)
--latest仅导出最近一次对话(默认行为)
--list列出可用的对话记录供选择

支持的 AI 工具环境

环境支持方式
Claude Code自动检测并读取对话记录
其他环境通过 --input 手动指定对话文件

输出格式

生成的 Markdown 文档包含以下内容:

  1. 概要信息

    • 应用名称
    • AI 工具环境
    • 导出时间
    • 对话轮次
    • 工具调用次数
  2. 关键步骤摘要

    • 从工具调用中自动提取的操作步骤
  3. 完整对话记录

    • 用户消息
    • AI 回复
    • 工具调用及执行结果

使用示例

bash
# 导出最近一次对话(自动检测环境)
openyida export-conversation

# 导出到指定文件
openyida export-conversation --output ./my-conversation.md

# 从指定文件导入对话记录
openyida export-conversation --input ./conversation.jsonl

# 列出可用的对话记录
openyida export-conversation --list

前置条件

  • 无需登录宜搭(对话导出是本地操作)
  • Node.js ≥ 18

注意事项

  1. 目前 MVP 版本主要支持 Claude Code 的对话记录自动检测
  2. 其他 AI 工具环境请使用 --input 手动指定对话文件

异常处理

异常场景处理方式
自动检测失败(非 Claude Code 环境)使用 --input 手动指定对话文件路径
输出文件路径无写权限使用 --output 指定有写权限的路径
对话文件格式不支持确认文件格式为 .jsonl,其他格式暂不支持
导出内容为空确认对话记录文件存在且非空,使用 --list 查看可用记录

Agent 错误处理策略

当 Agent 执行本技能遇到错误时,必须遵循以下默认行为:

错误类型默认处理策略
命令执行失败停止执行,向用户展示错误信息,询问是否重试或调整参数
环境检测失败提示用户使用 --input 手动指定对话文件路径
文件写入失败提示用户使用 --output 指定有写权限的路径,或检查磁盘空间
对话文件不存在使用 --list 列出可用记录,引导用户选择正确文件
网络超时本技能为纯本地操作,无网络依赖,检查文件系统权限
未知错误停止执行,完整展示错误信息,建议用户反馈问题

© openyida, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in yida-skills/skills/yida-export-conversation of openyida/openyida.

Open the folder on GitHubat commit 3dd4693

Compare with similar skills

Yida Export Conversation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Yida Export Conversation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yida Export Conversation this skillopenyida/openyida220—~562Automated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills26k7 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    26k GitHub starsUsed in 7 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated today
    Documents & OfficeAuto-check passed

More from openyida/openyida

All 58 skills in this repo
  • Yida Canvas Custom Page

    openyida/openyida

    宜搭自定义页面开发规范,使用 YidaCodeCanvas 组件实现现代 React18 自定义页面。用于官网、看板、工作台、列表、详情、门户壳、可视化、hooks 交互、表单入口,以及需要门户组件、数据管理视图、成员、部门或上传组件的场景;发布层自动注入 yida/utils window 桥。

    220 GitHub stars~4.3k tokensUpdated 8 days ago
    Auto-check passed
  • Openyida Release

    openyida/openyida

    快速发布 OpenYida npm 正式版或测试版。用户说“发布正式版”“发布测试版”“发 beta”或要求按当天日期生成版本 tag 时使用;不用于宜搭应用或自定义页面发布。

    220 GitHub stars~520 tokensUpdated 8 days ago
    Auto-check passed
  • Yida Design Plan

    openyida/openyida

    Plan 模式的视觉设计分支。基于需求选择视觉方向,再结合业务页面规划维护 build-plan.json 的 visualStyle,供 CLI 派生 design.md。

    220 GitHub stars~756 tokensUpdated 8 days ago
    Auto-check passed
  • Prevent stale local OpenYida custom page source from overwriting live designer edits.

    220 GitHub stars~1.2k tokensUpdated 8 days ago
    Auto-check passed
  • Codemap

    openyida/openyida

    Generate, update, or drift-check agent-facing CodeMaps as progressive code terrain indexes for projects, features, capabilities, functions, modules, or bug chains.

    220 GitHub stars~1k tokensUpdated 8 days ago
    Auto-check passed
  • Sdd Riper One Light

    openyida/openyida

    面向 GPT-5.5 等强模型和熟练用户的轻量 AI Agent Harness / checkpoint-driven coding skill。默认用户已经把任务切到基本可执行的最小混沌单元;模型自行分解、探索与推进,人类通过最终目标、最小 spec、复述、checkpoint、证据验证与回写来低干扰控盘。

    220 GitHub stars~1.5k tokensUpdated 8 days ago
    Auto-check passed

Questions about Yida Export Conversation

What does Yida Export Conversation do?

导出 AI 对话记录,生成结构化的 Markdown 文档。支持 Claude Code 自动检测,其他环境通过 --input 手动指定。适用于保存和回顾 AI 编程过程记录。. Yida Export Conversation is an agent skill from openyida/openyida.

When should I use Yida Export Conversation?

Yida Export Conversation fits situations like: documents & Office work in your project.

How do I install Yida Export Conversation in Claude Code?

Run `npx skills add openyida/openyida --skill yida-export-conversation -a claude-code`. Or copy the skill folder (yida-skills/skills/yida-export-conversation in openyida/openyida) into .claude/skills/yida-export-conversation in your project. Claude Code loads it when a task matches its description.

How do I install Yida Export Conversation in Codex?

Run `npx skills add openyida/openyida --skill yida-export-conversation -a codex`. Or copy the skill folder (yida-skills/skills/yida-export-conversation in openyida/openyida) into .agents/skills/yida-export-conversation in your project. Codex loads it when a task matches its description.

Can I use Yida Export Conversation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add openyida/openyida --skill yida-export-conversation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/yida-export-conversation, .gemini/skills/yida-export-conversation, .github/skills/yida-export-conversation and .opencode/skills/yida-export-conversation in your project.

What does Yida Export Conversation need to run?

SKILL.md names no scripts, command-line tools or credentials: Yida Export Conversation is instructions for the agent only. Our summary lists: Node.js.

Does Yida Export Conversation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Yida Export Conversation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Yida Export Conversation use?

Yida Export Conversation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Yida Export Conversation use?

About 562 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Yida Export Conversation?

Skills that share tags, products or a category with Yida Export Conversation: Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yida Export Conversation?

openyida (a GitHub organization) maintains it in openyida/openyida, which has 220 GitHub stars. The repository holds 58 skills in this directory. The repository was last updated on September 30, 2026.

Source: openyida/openyida on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.