hossam-skills

Claude Code 와 Codex CLI 가 같은 스킬·커맨드·지침을 쓰게 묶어 둔 저장소입니다. 한 컴퓨터에서 고치면 다른 컴퓨터의 두 도구가 다음 세션에 그대로 따라옵니다.

들어 있는 것

종류	내용	Claude Code	Codex
스킬 9개	분석·시각화 프로젝트 피드백, 복습 퀴즈, 슬라이드 제작, eli5, 코딩 지침, 환경 동기화	요청에 맞으면 자동	자동 또는 `$스킬이름`
커맨드 8개	스킬을 인자와 함께 바로 부르는 슬래시 명령	`/deck`, `/quiz`, `/env-sync`	`/prompts:deck`, `/prompts:quiz`
전역 지침	한국어·높임말, Karpathy 코딩 지침, Attention Span 출력 스타일	`~/.claude/CLAUDE.md`	`~/.codex/AGENTS.md`
공유 설정	출력 스타일·effort·테마·플러그인·SessionStart 훅	`settings.json` 병합	`config.toml`·`hooks.json`

동작 원리

→ 저장소가 원본, 컴퓨터는 링크. ~/.claude/skills, ~/.agents/skills 같은 폴더는 전부 이 저장소로 가는 심볼릭 링크입니다. 파일을 고치면 저장소가 바뀌고, push 하면 다른 컴퓨터가 받습니다.

→ 세션을 열 때마다 자동 pull. Claude Code 와 Codex 모두 SessionStart 훅이 sync.sh apply --quiet 를 돌립니다. 다른 컴퓨터가 올린 변경은 다음 세션을 열 때 이미 들어와 있습니다.

→ 공용은 한 벌만. 두 도구가 함께 쓰는 스킬은 common/skills/ 에 한 벌 있고, claude/skills/·codex/skills/ 에는 상대 링크만 있습니다. 한쪽 전용 스킬만 각자 폴더에 실제로 둡니다.

→ 자세한 구조는 동기화와 저장소 구조 에 있습니다.

빠른 시작

→ 한 줄이면 설치됩니다.

git clone git@github.com:leekh4232/hossam-skills.git ~/workspace/hossam-skills \
  && bash ~/workspace/hossam-skills/common/skills/env-sync/scripts/sync.sh apply

→ 끝나면 두 가지. Claude Code 와 Codex 를 다시 띄우고, Codex 안에서 /hooks 를 한 번 실행해 훅을 신뢰합니다. 단계별 절차는 새 컴퓨터 설치 에 있습니다.