convez.ai
Skill
Wangnov

chatgpt-skill

Wangnov/chatgpt-skill

Ver no GitHub
InicialPluginScore · de 0 a 100

使用 Claude Code / Codex 操作 ChatGPT 的 Skill|Skill for controlling ChatGPT with Claude Code / Codex

Instalação

$npx convez-ai Wangnov/chatgpt-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
8
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
v0.8.0
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.


🇨🇳 中文

chatgpt-skill 是一个手册式 Skill 集合 —— 不是 CLI、不是 wrapper,而是两份给不同执行器看的 ChatGPT.com 操作手册。

Skill适用执行器浏览器接入
claude-chatgpt-skillClaude Codeclaude-in-chrome MCP
codex-chatgpt-skillCodexCodex Chrome Extension

共同目标:复用你已经登录的 ChatGPT 网页来完成咨询委托、深度研究、对话管理、内容落盘。两条接入都不发起独立浏览器 profile、不接触 cookie / session / API key。

Host 范围:Claude 版保留原始 claude-in-chrome MCP + watcher 异步等待;Codex 版使用 Codex Chrome Extension + 当前回合轮询 / Deep Research heartbeat(automation 优先,spawn agent fallback)/ Pull fallback。两版按 npx skills add -s <name> -a <agent> 分开安装。

✨ 特性

  • 📦 零依赖 —— 一份 Markdown Skill,npx skills add 一键装好
  • 🌐 复用浏览器登录态 —— 你在 Chrome 已登录的 ChatGPT 订阅 + 已连接的 Apps(Drive / GitHub / Gmail / Linear / Canva),全部直接可用
  • ⚡ Claude watcher 异步等待 —— 主 Claude Agent({ run_in_background: true, model: 'haiku' }) 起一个后台 watcher 轮询页面,主 Sonnet 全程沉默,watcher 完成才通知(实测 21 分钟 Pro 任务,主 Sonnet 0 次被打扰,watcher 消耗 ~86k Haiku token)
  • 🧩 Codex Chrome Extension 适配 —— Codex 版已实测复用 ChatGPT tab、读取页面、上传文件、发送带附件 prompt、启动 Deep Research、挂 heartbeat 并取回完成报告
  • 🐢 Deep Research 异步任务 —— Claude 版长 DR 默认 Pull;Codex 版优先挂 heartbeat(automation / spawn agent fallback),两者都不让主会话干等
  • 💾 聊天记录落盘 —— 3 档分流:普通 message 走 get_page_text + Markdown;DR / Canvas artifact 走 artifact 自带的"导出到 Markdown";图片走"分享此图片→下载"
  • 🛠️ ChatGPT 管理面全覆盖 —— 对话级(删 / 归档 / 分享 / 置顶 / 移项目)、项目级(创建 / 指令 / 知识库 / 删除)、Memory、库、共享链接撤销,每个操作都标注了 GUI 易踩的坑
  • 🛡️ 安全优先 —— 不绕 OAuth / 不替用户授权 / 不存 session / 不替用户回答 clarification / 破坏性操作要用户口头确认
  • 📚 手册式而非工程式 —— 不写 selector / 不写状态机 / 不写 manifest schema,全部靠 LLM 当场视觉判断;遇到 ChatGPT UI 漂移时 agent 能自适应

🚀 快速开始

查看可安装 Skill:

npx skills add Wangnov/chatgpt-skill -l

安装 Claude Code 版:

npx skills add Wangnov/chatgpt-skill \
  -g \
  -s claude-chatgpt-skill \
  -a claude-code \
  -y

安装 Codex 版:

npx skills add Wangnov/chatgpt-skill \
  -g \
  -s codex-chatgpt-skill \
  -a codex \
  -y

安装 Claude Cowork 版:

Claude Cowork 目前需要手动上传 Skill 包,不走 npx skills add。到 GitHub Releases(发布页) 下载 claude-chatgpt-skill.skill,然后在 Claude Cowork 里直接拖入 / 上传。

Claude Cowork 的文件要求:

  • 单个 .md 文件必须在 YAML frontmatter(YAML 元数据头)里包含 Skill name 和 description
  • .zip 或 .skill 包必须在压缩包根目录包含 SKILL.md

用法 —— 直接对 Claude Code 或 Codex 说:

"问问 ChatGPT Pro 怎么看这件事"
"让 Thinking 模式分析一下这个 PR"
"用 @Google 云端硬盘 列一下我的文件"
"提交个 deep research,列五家竞品"
"在 DSE 数学项目里问 X"
"把这个对话存下来"
"删了那个对话"
"清掉我的 Memory"

执行器会按对应 Skill 手册流程操作 ChatGPT 网页 + 等待 + 取回结果。

🧠 模型矩阵

ChatGPT 模型推荐等待策略实测典型耗时用例
Instant(默认)20–30 秒< 30 秒简单咨询、画图、单段写作
Thinking · 深入30–60 秒1–3 分钟中等推理、issue 检索、归纳
Pro · 进阶60 秒5–10 分钟(最长实测 21m)PR 评审、长 PDF 推理、深度分析
Deep ResearchClaude Pull / Codex heartbeat3 分钟 – 几小时多源调研报告 + 引用

模型名是漂移的(5.5 → 5.6 → "进阶专业" 等),Skill 靠可见文本和 ARIA 标签判断,不硬编码列表。

🎯 设计原则

  1. 手册式而非工程式 —— 写"看到 X 就做 Y",不写"点击 button[aria-label='Send']"。UI 漂移时 LLM 自适应
  2. 信任 LLM 当场判断 —— 不堆 if-else 状态机,给原则不给脚本
  3. 异步原生 —— Claude watcher、Codex heartbeat、Pull fallback,分别覆盖"几分钟"和"几小时"两个时间尺度
  4. 安全优先 —— 8 条安全总则(详见 claude-chatgpt-skill/references/manage-actions.md 和 Codex 版同名 reference)
  5. 失败做减法 —— failed run 比 success run 更值得写进文档。3 次实测 watcher 误判直接驱动了 v0.6 用 get_page_text 取代 read_page 的修复

🗂️ 项目结构

claude-chatgpt-skill/
  SKILL.md
  agents/openai.yaml
  scripts/heartbeat.sh
  references/
  examples/

codex-chatgpt-skill/
  SKILL.md
  agents/openai.yaml
  references/
  examples/

assets/                        # 项目视觉资产(logo / banner)
CHANGELOG.md                   # v0.2 → v0.8.0 完整演进

✅ 实测覆盖

Claude 版实测均在 Claude Code + claude-in-chrome MCP 上完成;Codex 版已完成 Chrome smoke test(2026-05-31):

场景模型实测结果
@Google 云端硬盘 列文件 + 归纳Thinking14 秒完成
@Google 云端硬盘 推断工作轨迹Pro5m 25s
@GitHub PR 评审Pro + watcher5m 7s,主 Sonnet 0 次被打扰
@GitHub rust-silk 全仓库 reviewPro + watcher16m 14s,6 P1 + 9 P2 + 落地顺序
@GitHub codex-asr 全仓库 reviewPro + watcher18m 56s(两轮),6 P1 + 10 P2 + 4 阶段路线图
DSE 数学项目知识库(10+ PDF)Pro 项目内21m 5s,watcher 累计 19 分钟
Deep Research 横向竞品对比DR55 分钟,22 source、279 网页搜索
Instant 生成图片 + 保存Instant30 秒,PNG 自动落 ~/Downloads/
ChatGPT 给的 PDF 链接下载—浏览器原生通道,~/Downloads/
聊天记录档 A 落盘(19.5KB / 399 行 .md)—YAML frontmatter + 完整对话历史
删除对话 / 归档 / 项目创建 / Memory 管理 / 共享链接撤销—全部端到端跑通
Codex 复用 ChatGPT tab + 页面读取InstantdomSnapshot / <main> 文本 / screenshot / visible DOM 全部可用
Codex 文件上传闭环Instant + file chooser上传本地 txt → ChatGPT 读取第一行 → Codex 取回回答
Codex 菜单控制—模型菜单、文件菜单、app 菜单、草稿附件移除均已跑通
Codex Deep ResearchPro + heartbeat计划卡 → 开始 → 3m 完成,3 次引用,68 个搜索;报告在 internal://deep-research iframe

⚠️ 已知限制

1. file_upload 在 Claude Code 里暂不可用;Claude Cowork 可用

2026-05-31 用户用 codex 反编译 Claude app 确认了根因:

  • Claude app 的 validateLocalFileAccess 要求 session id 以 local_ 开头才放行
  • Claude Code 的 session 是普通 UUID(c9cf...),目前过不了这关 —— 不是 bug 是产品边界;除非 Claude Code 后续改 session 模式,否则 file_upload 暂不可用
  • Claude Cowork 的 local-agent-mode 使用 local_* session,已确认可用,但仍受上传目录白名单约束
  • 错误信息 only files the user has shared with this session can be uploaded 是误导性的 —— 它不区分"session 类型不对" vs "路径没共享"
Hostsession 模式file_upload
Claude Code普通 UUID(c9cf...)❌ 暂不可用,让用户自己拖文件到浏览器
Claude Cowork(local-agent-mode)local_*✅ 可用,但路径限 local-agent-mode-sessions/.../uploads/ 或 userSelectedFolders
Codex + Codex Chrome ExtensionChrome file chooser✅ 已实测 添加文件等 → 添加照片和文件 → setFiles(...)
其他 host(Cursor / Cline / …)未测取决于各自浏览器接入和文件选择器能力

Claude Code 当前可行方案:让用户自己在浏览器里上传(点 + 或拖图进 composer),主 Claude 接管后续:read_page 验证 chip 出现 → 写 prompt → send → spawn watcher。

Claude Cowork 方案:从 GitHub Releases 下载 claude-chatgpt-skill.skill,在 Claude Cowork 里直接拖入 / 上传。若自行打包,.zip / .skill 根目录必须包含 SKILL.md;若上传单个 .md,必须在 YAML frontmatter 里包含 Skill name 和 description。

Codex 版走 Codex Chrome Extension 的原生 file chooser,不受 Claude app 的 session id 限制。

详细诊断见 CHANGELOG.md v0.7.1 章节。

2. Watcher 异步等待是 Claude Code 专属

Watcher 模式用的是 Agent({ run_in_background: true, subagent_type: 'general-purpose', model: 'haiku', prompt: ... }),这是 Claude Code 的 Agent tool API。Codex 版不使用 Claude watcher,改为当前回合轮询和 Deep Research heartbeat(先找 automation / wakeup,找不到就 spawn agent fallback,最后才 Pull)。其他 MCP host(Cursor 等)装上这个 Skill 后,operational 流程读得到,但 watcher / heartbeat 段需要 host 各自的后台执行等价物。

📜 Changelog

完整演进历史见 CHANGELOG.md:

  • v0.8.0 —— 双 Skill 分发:Claude Code 版 + Codex 版;Codex Chrome 文件上传与 Deep Research heartbeat 跑通
  • v0.7.3 —— Logo / banner 重设计(机器人操控 ChatGPT)+ CSS 动画 banner + README 口径更正
  • v0.7.2 —— 自制 logo / 动画 banner / 双语 README 重写
  • v0.7.1 —— file_upload 根因从 "bug" 修正为 "session 类型边界"
  • v0.7 —— 聊天记录落盘 3 档分流
  • v0.6 —— Deep Research Pull 模式 + DR UI 状态信号
  • v0.6 —— watcher 用 get_page_text 取代 read_page(避免 max_chars 截断)
  • v0.5 —— 产物下载(PDF / 图片)
  • v0.4 —— ChatGPT 管理操作手册
  • v0.3 —— Watcher subagent + 错误处理 reference
  • v0.2 —— SKILL.md 主指令 + heartbeat fallback + 5 examples

📄 License

MIT © 2026 wangnov


🇬🇧 English

chatgpt-skill is a manual-style Skill collection — not a CLI, not a wrapper — with two installable playbooks for operating ChatGPT.com from your coding agent.

SkillHostBrowser bridge
claude-chatgpt-skillClaude Codeclaude-in-chrome MCP
codex-chatgpt-skillCodexCodex Chrome Extension

Both variants reuse your already-logged-in ChatGPT subscription for consultations, deep research, conversation management, and saving outputs to disk. They do not create a separate browser profile, extract cookies, persist sessions, or ask for an API key.

Host scope: the Claude variant keeps the original claude-in-chrome + watcher flow. The Codex variant uses Codex Chrome Extension, current-turn polling, Deep Research heartbeat (automation first, spawn-agent fallback), and Pull fallback instead of Claude Code's background Agent(...) API.

✨ Features

  • 📦 Zero dependencies — Markdown skills, install with npx skills add
  • 🌐 Reuse browser login — your already-signed-in Chrome ChatGPT + connected Apps (Drive / GitHub / Gmail / Linear / Canva) all work out of the box
  • ⚡ Claude watcher for async waits — main Claude spawns a background Haiku watcher (Agent({ run_in_background: true, model: 'haiku' })) that polls the page silently; main Sonnet stays quiet until the watcher returns
  • 🧩 Codex Chrome support — the Codex variant can claim ChatGPT tabs, read the page, upload files, submit attached prompts, start Deep Research, run heartbeat, and retrieve the completed report
  • 🐢 Deep Research async tasks — Claude uses Pull for long DR; Codex uses heartbeat first (automation or spawn-agent fallback), with Pull only when no background path is available
  • 💾 Conversation save-to-disk — 3 tiers: plain chat via get_page_text + Markdown; DR / Canvas artifacts via the artifact's built-in export; images via "share-image → download"
  • 🛠️ Full ChatGPT management surface — conversation level (delete / archive / share / pin / move-to-project), project level (create / instructions / sources / delete), Memory, library, share-link revocation, with every GUI footgun documented
  • 🛡️ Safety-first — never bypass OAuth, never authorize on the user's behalf, never persist session, never answer clarifications for the user, destructive ops require verbal confirmation
  • 📚 Manual-style, not engineered — no selectors / no state machines / no manifest schemas; the LLM decides on-screen. When ChatGPT's UI drifts, the agent adapts.

🚀 Quick start

# List installable skills
npx skills add Wangnov/chatgpt-skill -l

# Install the Claude Code variant
npx skills add Wangnov/chatgpt-skill \
  -g \
  -s claude-chatgpt-skill \
  -a claude-code \
  -y

# Install the Codex variant
npx skills add Wangnov/chatgpt-skill \
  -g \
  -s codex-chatgpt-skill \
  -a codex \
  -y

For Claude Cowork, download claude-chatgpt-skill.skill from the latest GitHub Release, then drag/upload it into Claude Cowork manually. Cowork package requirements: a single .md file must include YAML frontmatter with skill name and description; a .zip or .skill archive must include a root-level SKILL.md.

Then just talk to Claude Code or Codex:

"Ask ChatGPT Pro to review this PR"
"Use Thinking to summarize my unread GitHub issues via @GitHub"
"Submit a deep research on Q3 competitors"
"Save that conversation to disk"
"Delete that chat and clean its Memory"

🧠 Model matrix

ChatGPT modelRecommended wait strategyTypical wall-clockUse case
Instant (default)20–30s< 30sQuick Q&A, image gen, short writing
Thinking30–60s1–3 minMid-depth reasoning, search, summarization
Pro60s5–10 min (max observed 21m)PR review, long-PDF inference, deep analysis
Deep ResearchClaude Pull / Codex heartbeat3 min – several hoursMulti-source research with citations

Model names drift (5.5 → 5.6 → "进阶专业" etc.). The skill matches on visible text and ARIA labels, never hardcoded names.

⚠️ Known limitations

1. Claude Code file upload is temporarily unavailable; Claude Cowork works

Root cause confirmed 2026-05-31 by reverse-engineering Claude app with codex:

  • Claude app's validateLocalFileAccess requires the session id to begin with local_
  • Claude Code sessions are plain UUIDs (c9cf...) and currently cannot pass this gate — this is a product boundary, not a bug
  • Claude Cowork local-agent-mode uses local_* sessions and can use file upload, still limited by its allowed upload directories
  • The error message only files the user has shared with this session can be uploaded is misleading: it does not distinguish "wrong session type" from "path not shared"

For Claude Code, have the user manually drag/drop in the browser. For Claude Cowork, upload the released claude-chatgpt-skill.skill package manually; if building your own package, keep SKILL.md at the archive root. The Codex variant uses the Codex Chrome Extension file chooser flow and has been smoke-tested successfully. Full Claude diagnosis is in CHANGELOG.md v0.7.1.

2. Watcher async-wait is Claude-Code-specific

The watcher pattern uses Claude Code's Agent({ run_in_background: true, subagent_type: 'general-purpose', model: 'haiku', … }) API. The Codex variant does not use that Claude watcher; it uses current-turn polling and Deep Research heartbeat (automation first, spawn-agent fallback, Pull last). Other MCP hosts need their own background execution equivalent for watcher/heartbeat-style async waits.

📄 License

MIT © 2026 wangnov

Ver o original no GitHub

Bom para

Relacionados