# Codex Plan Workflow Skills

Three Codex skills that enforce a plan-first workflow via explicit delegation.

- `cc-plan`: produce a concrete implementation plan
- `cc-explore`: collect evidence to support the plan
- `cc-task`: implement an approved plan

## Workflow

Use the skills in this order:

1. `$cc-plan`
2. If evidence is missing, `$cc-explore`
3. `$cc-task`

## Repository layout

```
skills/
  cc-plan/
    SKILL.md
    references/
      claude-plan-system-prompt.md
  cc-explore/
    SKILL.md
    references/
      claude-explore-system-prompt.md
  cc-task/
    SKILL.md
    references/
      claude-task-system-prompt.md
```

## Install

Codex supports repo-scoped and user-scoped skills. Choose one of the official options below.

### Option A: Repo-scoped (recommended)

Copy the three skill folders from this repo (`skills/cc-plan`, `skills/cc-explore`, `skills/cc-task`) into your target repository’s `.codex/skills/` directory:

```
.codex/skills/
  cc-plan/
  cc-explore/
  cc-task/
```

This makes the skills available to anyone who checks out the repo. Restart Codex to pick up new skills.

### Option B: User-scoped

Copy the three skill folders from this repo (`skills/cc-plan`, `skills/cc-explore`, `skills/cc-task`) into your user skills directory:

```
~/.codex/skills/
  cc-plan/
  cc-explore/
  cc-task/
```

This makes the skills available across all repositories for your user. Restart Codex to pick up new skills.

### Option C: Skill installer

Codex includes a built-in `$skill-installer` for installing curated skills (for example, `$skill-installer linear`). You can also prompt it to download skills from other repositories. If you use the installer, follow its prompts and then restart Codex after installation.

## Notes

- Source prompts are stored under each skill's `references/` directory (sourced from Piebald-AI/claude-code-system-prompts).
- Keep `SKILL.md` concise; put long prompt text or references into `references/`.