reflect-codex-skills
Generate reflections for past Codex session histories using the Reflection CLI. Use when asked to summarize or reflect on previous Codex conversations, list projects/sessions, filter by date or session id, or refresh cached reflections from ~/.codex/sessions.
Best use case
reflect-codex-skills is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Generate reflections for past Codex session histories using the Reflection CLI. Use when asked to summarize or reflect on previous Codex conversations, list projects/sessions, filter by date or session id, or refresh cached reflections from ~/.codex/sessions.
Teams using reflect-codex-skills 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
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/reflect-codex-skills/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How reflect-codex-skills Compares
| Feature / Agent | reflect-codex-skills | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Generate reflections for past Codex session histories using the Reflection CLI. Use when asked to summarize or reflect on previous Codex conversations, list projects/sessions, filter by date or session id, or refresh cached reflections from ~/.codex/sessions.
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
# Reflect Codex Sessions ## When to use this skill - Summarize or reflect on past Codex session histories. - List projects, session counts, or filter by date/session id. - Retrieve/Refresh cached reflections or pull extra metadata for auditing. ## Interpretation guidance (important) - Treat reflection content as heuristics, not facts or ideas from a user. Use it as a starting point. - Surface only non-niche, broadly useful themes and repeated patterns and confirm with the user before acting on a pattern. - Avoid over-indexing on one-offs; ask for confirmation when a pattern is uncertain. ## Quick start - Run commands from `scripts/` inside this skill directory. - Default: `python3 reflect_sessions.py --output -`. - Use `--output-style human` when replying in chat; use JSON for downstream parsing. - Ensure the shell command timeout is at least 120000 ms (2 minutes) so runs are not cut off. - Use Python 3.11+ (the CLI relies on features not present in Python 3.9). ## Workflow 1. **Choose scope**: `--project`, `--since`, `--until`, `--session-id(s)`, `--limit`. Note: the most recent session is skipped unless `--include-most-recent`. 2. **Generate reflections**: `python3 reflect_sessions.py ...` and adjust `--refresh-mode`, `--prompt-preset`, `--prompt-text`, `--prompt-file`, or Codex flags only when asked. 3. **Respond carefully**: highlight repeated, non-niche patterns and keep claims tentative unless the user confirms them. ## Prompt presets Default preset: `reflection`. Available presets: - `reflection`: Full reflection on repetition, friction, and skill ideas (default). - `summary`: Concise summary of goals, actions, outputs, and decisions. - `bloat`: Bloat/dead ends/cleanup opportunities introduced during the session. - `incomplete`: Open loops and tasks left unfinished. - `decisions`: Key decisions, alternatives, and rationale. - `next_steps`: Concrete follow-up actions, tests, and validations. Use `--prompt-preset <name>` to select one, `--prompt-text "<prompt>"` for inline prompts, or `--prompt-file /path/to/prompt.md` for a custom prompt file. ## References - `references/cli.md` for the command catalog and full flag list. - `references/README.md` for system behavior, cache semantics, and output schema. - `references/examples.md` for an end-to-end example from ExampleProject.
Related Skills
using-skills
Provides sub agents important information on how to use skills
use-skills-npm-package
CLI tool for discovering, installing, and managing reusable agent skills across multiple coding agents. Enables efficient skill discovery from repositories, local sources, and community repositories. Essential resource for discovering new Flutter/Dart skills.
tooluniverse-install-skills
Detect and auto-install missing ToolUniverse research skills by checking common client skill directories and cloning from GitHub if absent. Use when ToolUniverse specialized skills are not installed, when setting up a new project, or when the tooluniverse router skill needs to bootstrap its sub-skills before routing.
sync-skills
Use when syncing skills from local folders, GitHub URLs, or skillsmp.com pages to multiple AI coding tool directories
skills-scaffolding
Guide for creating effective Claude Code skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
self-learning-skills
Memory sidecar for agent work: recall before tasks, record learnings after tasks, review recommendations, optional backport bundles.
sc-pull-request-skills
GitHub PR workflow automation including fetching unresolved comments, resolving review threads, and parallel comment resolution. Use this skill when working with PR reviews, addressing reviewer feedback, or automating PR comment workflows.
portable-skills-and-rules
Defines SKILL.md structure, valid frontmatter fields, and cross-tool setup for Claude Code, Cursor, OpenCode, and Cline. ALWAYS read before creating or editing any SKILL.md file. This skill should be used when "writing a skill", "creating a skill", "editing a skill", "skill frontmatter", "SKILL.md format", "AGENTS.md", "CLAUDE.md", or setting up skills across multiple AI tools.
investigation-codex-vscode-extension
This skill should be used when investigating why the Codex VS Code extension fails to spawn or connect to a local Codex agent, especially after updates or CLI changes.
hap-skills-updater
HAP Skills Collection 技能更新和维护技能。当用户提到"更新技能"、"维护技能"、"更新 hap-skills"、"更新 skill"等需求时使用。帮助用户更新和维护 HAP Skills Collection 中的 4 个核心技能。
developing-skills
MUST be loaded before working with any Skill. Covers creating, building, reviewing, assessing, checking, auditing, evaluating, updating, modifying, and improving skills. Invoke PROACTIVELY before writing or changing any SKILL.md file. Provides structure, workflows, and validation for skill development. Supports both personal skills and standalone distributable skills (GitHub repos). (user)
codex-code-review
Perform comprehensive code reviews using OpenAI Codex CLI. This skill should be used when users request code reviews, want to analyze diffs/PRs, need security audits, performance analysis, or want automated code quality feedback. Supports reviewing staged changes, specific files, entire directories, or git diffs.