session-recovery-codex

Use when recovering a Codex session, especially if the user provides a Codex session id or wants recent Codex sessions listed before resuming work.

167 stars

Best use case

session-recovery-codex is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Use when recovering a Codex session, especially if the user provides a Codex session id or wants recent Codex sessions listed before resuming work.

Teams using session-recovery-codex should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/session-recovery-codex/SKILL.md --create-dirs "https://raw.githubusercontent.com/cnfjlhj/ai-collab-playbook/main/skills/full/session-recovery-codex/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/session-recovery-codex/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How session-recovery-codex Compares

Feature / Agentsession-recovery-codexStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Use when recovering a Codex session, especially if the user provides a Codex session id or wants recent Codex sessions listed before resuming work.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# Session Recovery (Codex)

## 使用流程

### 分支 A:用户已经提供 session id

当用户消息里已经包含形如 `019b6d01-790f-7a32-9d75-932700db98a4` 的 session id 时:

1) 直接运行统一入口脚本:

`python3 ~/.codex/skills/session-recovery-codex/scripts/recover-session.py --id "<session_id>" --cwd "$PWD"`

2) 向用户展示脚本输出,并据此复述:
- 最后的任务请求
- 未完成事项
- 涉及文件与关键操作
- 最近报错或关键工具输出

3) 询问用户:

`我的理解是否正确?你想继续哪部分?`

### 分支 B:用户没有提供 session id

1) 运行统一入口脚本扫描当前项目最近会话:

`python3 ~/.codex/skills/session-recovery-codex/scripts/recover-session.py --cwd "$PWD" --limit 5`

2) 将脚本输出的最近 5 个会话概览展示给用户,并让用户输入要恢复的序号(1–5)。

3) 用户选择后,拿到对应 session id,再运行统一入口脚本做精确恢复:

`python3 ~/.codex/skills/session-recovery-codex/scripts/recover-session.py --id "<session_id>" --cwd "$PWD"`

4) 向用户展示:
- 最后的任务请求
- 未完成事项(TODO)(若能从 `update_plan` 记录恢复)
- 涉及的文件(若能从工具输出恢复)
- 关键决策与注意事项(从最后几条 assistant 输出提炼)

5) 询问用户:“我的理解是否正确?你想继续哪部分?”并在用户确认后继续执行任务。

## 注意事项

- 不要使用任何“压缩/精简会话”的方式替代恢复;优先用本 skill 从 `~/.codex/sessions` 恢复事实记录。
- 本 skill 现在同时覆盖“按 id 精确恢复”和“列出最近会话后再选择”两种入口。

Related Skills

collaborating-with-codex

167
from cnfjlhj/ai-collab-playbook

Use when you explicitly want a second Codex CLI session to prototype, debug, or review code, while your current session remains the primary owner of the final result.

writing-anti-ai

167
from cnfjlhj/ai-collab-playbook

This skill should be used when the user asks to "remove AI writing patterns", "humanize this text", "make this sound more natural", "remove AI-generated traces", "fix robotic writing", or needs to eliminate AI writing patterns from prose. Supports both English and Chinese text. Based on Wikipedia's "Signs of AI writing" guide, detects and fixes inflated symbolism, promotional language, superficial -ing analyses, vague attributions, AI vocabulary, negative parallelisms, and excessive conjunctive phrases.

Content & Documentation

xhs-note-creator

167
from cnfjlhj/ai-collab-playbook

小红书笔记素材创作技能。当用户需要创建小红书笔记素材时使用这个技能。技能包含:根据用户的需求和提供的资料,撰写小红书笔记内容(标题+正文),生成图片卡片(封面+正文卡片),以及发布小红书笔记。

xhs-longform-private-publisher

167
from cnfjlhj/ai-collab-playbook

This skill should be used when the user wants to publish an existing Markdown article to Xiaohongshu as a private longform post, keep the original wording and structure, insert inline images in order, use one-click layout, and verify the result in note manager.

timestamped-video-summary

167
from cnfjlhj/ai-collab-playbook

Generate a detailed, professional video content summary from timestamped subtitles/transcripts (e.g., lines starting with 00:00 / 1:23:45). Enforce strict per-segment structure (timestamp range + bold segment title + 2-paragraph body: first-person creator summary + expert 【导师评注】 critique with uncertainty handling). Use when the user provides time-coded subtitles and asks for a规范化纪要/内容纪要/逐段总结, and optionally wants a clean PDF export (do NOT include the full raw transcript in the PDF unless explicitly requested).

skills-governance

167
from cnfjlhj/ai-collab-playbook

Use when auditing a large local skill collection, identifying duplicate or imported skills, comparing skill roots, or deciding what to keep, disable, or archive across Codex and adjacent agent skill directories.

skill-governance-loop

167
from cnfjlhj/ai-collab-playbook

Use when the user asks to review a skill, analyze skill quality, update a skill version, or run a repeatable keep/disable/archive decision loop from real failures instead of abstract best practices.

skill-creator

167
from cnfjlhj/ai-collab-playbook

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.

research-lead-sidecar

167
from cnfjlhj/ai-collab-playbook

Use when the user wants multi-agent division of labor for research-led work and the lead should stay on the critical path while 1-2 bounded sidecars handle low-coupling tasks. Do not use this for tiny tasks, fully sequential debugging, or overlapping refactors.

question-refiner

167
from cnfjlhj/ai-collab-playbook

Use when a research question is still vague and must be clarified into a structured deep-research brief before actual literature research or execution. Skip this if the user already has a concrete paper draft or a ready-to-run research specification.

prompt-polisher

167
from cnfjlhj/ai-collab-playbook

Use when receiving messy, unstructured input like voice transcriptions, stream-of-consciousness notes, or rough document content that needs to be transformed into a polished, optimized prompt. Cleans up filler words, extracts intent, asks clarifying questions, applies Claude 4.x/Opus 4.5/Sonnet 4.5 best practices, and previews the polished prompt for approval before execution. Trigger phrases include "polish this", "clean this up", "turn this into a prompt", or when input is clearly rough/unstructured.

proactive-explorer

167
from cnfjlhj/ai-collab-playbook

落实 CLAUDE.md / AGENTS.md 中的“主动探索”原则,在向用户提问前自动使用 Grep、Read、Bash、WebSearch 等工具获取信息