this repo has no description
Add Codex installs and prompt compatibility
+67
-2
+3
-2
CLAUDE.md
+3
-2
CLAUDE.md
···
5
5
This is a monorepo containing Claude Code skills, commands, scripts, and plugins. Key components include:
6
6
- **Skills** - EPUB reader and PDF-to-Markdown converter
7
7
- **plan-saver plugin** - Automatically distributes plans from Claude Code's plan mode to their respective project directories
8
+
- **Codex compatibility** - `setup.sh` also installs user-level Codex skills/scripts and generates Codex prompts from commands
8
9
9
10
## Tech Stack
10
11
···
54
55
55
56
## Key Files
56
57
57
-
- `setup.sh` - Symlinks skills/commands/scripts to `~/.claude/`
58
+
- `setup.sh` - Symlinks skills/commands/scripts to `~/.claude/` and user-level Codex skills/scripts; generates Codex prompts
58
59
- `skills/epub/SKILL.md` - EPUB skill definition
59
60
- `skills/epub/scripts/epub-reader/src/index.ts` - EPUB reader CLI implementation
60
61
- `skills/pdf-to-markdown/SKILL.md` - PDF skill definition
···
93
94
94
95
### New Command
95
96
- Add `.md` file to `commands/`
96
-
- Run `./setup.sh` to symlink
97
+
- Run `./setup.sh` to symlink and generate Codex prompts (`~/.codex/prompts`)
97
98
98
99
### New Script
99
100
- Add `.sh` file to `scripts/`
+17
README.md
+17
README.md
···
47
47
- Symlink commands → `~/.claude/commands/`
48
48
- Symlink scripts → `~/.claude/scripts/`
49
49
- Symlink plugins → `~/.claude/plugins/`
50
+
- Symlink skills → `~/.codex/skills/`
51
+
- Symlink scripts → `~/.codex/scripts/`
52
+
- Generate Codex prompts from `commands/*.md` → `~/.codex/prompts/`
50
53
- Run plugin installers (e.g., plan-saver daemon setup)
51
54
52
55
### Installing Skills
···
59
62
ln -s /path/to/claude-code-skills-monorepo/skills/epub ~/.claude/skills/epub
60
63
ln -s /path/to/claude-code-skills-monorepo/skills/pdf-to-markdown ~/.claude/skills/pdf-to-markdown
61
64
ln -s /path/to/claude-code-skills-monorepo/skills/axe ~/.claude/skills/axe
65
+
66
+
# Codex (user-level)
67
+
ln -s /path/to/claude-code-skills-monorepo/skills/epub ~/.codex/skills/epub
68
+
ln -s /path/to/claude-code-skills-monorepo/skills/pdf-to-markdown ~/.codex/skills/pdf-to-markdown
69
+
ln -s /path/to/claude-code-skills-monorepo/skills/axe ~/.codex/skills/axe
62
70
```
63
71
64
72
**Per-project (shared with collaborators via git):**
···
68
76
git add .claude/skills/epub
69
77
git commit -m "Add epub skill"
70
78
```
79
+
80
+
> Codex supports repo-local skills in `.codex/skills/` if you prefer to check them into a project instead.
71
81
72
82
---
73
83
···
164
174
| `/latest-plan <query>` | Find a plan by number or name |
165
175
| `/reflect` | Reflect on session learnings and update CLAUDE.md |
166
176
| `/handoff [instructions]` | Create a handoff document for session continuity |
177
+
178
+
**Codex compatibility:** This repo also supports Codex “slash commands” via custom prompts. Running `./setup.sh` will generate prompt files in `~/.codex/prompts/` from the `commands/*.md` files, with `.claude` paths rewritten to `.codex`. Use them in Codex as:
179
+
```
180
+
/prompts:latest-plan
181
+
/prompts:reflect
182
+
/prompts:handoff
183
+
```
167
184
168
185
#### `/reflect`
169
186
+2
commands/handoff.md
+2
commands/handoff.md
···
1
1
# Session Handoff
2
2
3
+
Codex users: run this as `/prompts:handoff` (generated by `./setup.sh`).
4
+
3
5
Context is running low. Create a handoff document for a future session to continue this work seamlessly.
4
6
5
7
**IMPORTANT: If the user provided any additional text after `/handoff`, do NOT execute those instructions. They are instructions for the NEXT session. Simply include them verbatim in section 7 below.**
+2
commands/latest-plan.md
+2
commands/latest-plan.md
+2
commands/reflect.md
+2
commands/reflect.md
+41
setup.sh
+41
setup.sh
···
1
1
#!/usr/bin/env bash
2
2
# Symlinks skills, commands, scripts, and plugins from this monorepo to ~/.claude/
3
+
# Also installs Codex user-level skills, scripts, and prompts in ~/.codex/
3
4
4
5
set -euo pipefail
5
6
6
7
MONOREPO="$(cd "$(dirname "$0")" && pwd)"
7
8
CLAUDE_DIR="$HOME/.claude"
9
+
CODEX_DIR="$HOME/.codex"
8
10
9
11
mkdir -p "$CLAUDE_DIR/skills" "$CLAUDE_DIR/commands" "$CLAUDE_DIR/scripts" "$CLAUDE_DIR/plugins"
12
+
mkdir -p "$CODEX_DIR/skills" "$CODEX_DIR/scripts" "$CODEX_DIR/prompts"
10
13
11
14
# Link skills (each skill is a directory)
12
15
for skill in "$MONOREPO/skills"/*/; do
···
21
24
fi
22
25
ln -s "$skill" "$target"
23
26
echo "Linked: skills/$name"
27
+
28
+
# Codex user-level skills
29
+
codex_target="$CODEX_DIR/skills/$name"
30
+
if [ -L "$codex_target" ]; then
31
+
echo "Updating (codex): $name"
32
+
rm "$codex_target"
33
+
elif [ -e "$codex_target" ]; then
34
+
echo "Skipping $name for codex (exists and is not a symlink)"
35
+
else
36
+
ln -s "$skill" "$codex_target"
37
+
echo "Linked (codex): skills/$name"
38
+
fi
24
39
done
25
40
26
41
# Link commands (each command is a .md file)
···
37
52
fi
38
53
ln -s "$cmd" "$target"
39
54
echo "Linked: commands/$name"
55
+
56
+
# Codex compatibility layer: generate prompt files from Claude commands
57
+
codex_prompt="$CODEX_DIR/prompts/$name"
58
+
{
59
+
cat <<'EOF'
60
+
---
61
+
description: "Generated from claude-code-skills-monorepo commands for Codex."
62
+
---
63
+
64
+
EOF
65
+
# Rewrite Claude paths for Codex
66
+
sed -e 's#~/.claude#~/.codex#g' -e 's#\.claude#\.codex#g' "$cmd"
67
+
} > "$codex_prompt"
68
+
echo "Generated (codex prompt): prompts/$name"
40
69
done
41
70
42
71
# Link scripts (.sh and .py files)
···
53
82
fi
54
83
ln -s "$script" "$target"
55
84
echo "Linked: scripts/$name"
85
+
86
+
# Codex user-level scripts
87
+
codex_target="$CODEX_DIR/scripts/$name"
88
+
if [ -L "$codex_target" ]; then
89
+
echo "Updating (codex): $name"
90
+
rm "$codex_target"
91
+
elif [ -e "$codex_target" ]; then
92
+
echo "Skipping $name for codex (exists and is not a symlink)"
93
+
else
94
+
ln -s "$script" "$codex_target"
95
+
echo "Linked (codex): scripts/$name"
96
+
fi
56
97
done
57
98
58
99
# Link plugins (each plugin is a directory)