Persistent Context Skills

Agent-agnostic context preservation workflow for Claude Code, Codex, OpenCode, and other AI coding agents.

Overview

This project provides a set of AI agent skills that enable persistent context across different AI coding agents. Never lose your work context again when switching between sessions or agents.

Features

• Agent-Agnostic: Works with Claude Code, Codex, OpenCode, and any agent supporting the skill system
• Three-Layer Memory System:
  1. Auto Memory (agent built-in)
  2. Work Logs (docs/memory/YYYY-MM-DD.md)
  3. Status Snapshot (docs/progress.md)
• Four Core Workflows:
  • init-workflow: Initialize context workflow in a new project
  • recap-context: Restore project context at session start
  • checkpoint-progress: Archive current progress
  • postmortem-review: Post-incident review and lessons learned

Installation

Option 1: Using npx skills (Recommended)

Install directly from GitHub using the skills CLI:

npx skills add alexcdever/persistent-context-skills

Install to specific agents:

npx skills add alexcdever/persistent-context-skills -a opencode -a claude-code

Install globally (available across all projects):

npx skills add alexcdever/persistent-context-skills -g

Option 2: Manual Installation

# Clone the repository
git clone https://github.com/alexcdever/persistent-context-skills.git

# Install skills
./install.sh

Or manually copy skills to your agent's skill directory:

# For OpenCode/Codex
cp -r skills/* ~/.agents/skills/persistent-context/

# For Claude Code
cp -r skills/* ~/.claude/skills/persistent-context/

Usage

In OpenCode

# List available skills
/skills

# Use specific skill
/skill init-workflow
/skill recap-context
/skill checkpoint-progress
/skill postmortem-review

Natural Language

You can also use natural language:

• "init-project" - Initialize workflow
• "recap" - Restore context
• "checkpoint" - Save progress
• "postmortem" - Review incident

Project Structure

persistent-context-skills/
├── README.md
├── LICENSE
├── install.sh
└── skills/
    ├── init-workflow/
    │   ├── SKILL.md
    │   └── templates/
    ├── recap-context/
    │   └── SKILL.md
    ├── checkpoint-progress/
    │   └── SKILL.md
    └── postmortem-review/
        └── SKILL.md

How It Works

1. Initialize: Run init-workflow to set up the directory structure
2. Work: Code as usual
3. Checkpoint: Run checkpoint-progress before ending session
4. Resume: Run recap-context at next session start

Inspired By

This workflow is inspired by 卢灿伟同学的 Claude Code 工作流.

License

MIT