fcakyon/claude-codex-settings

기술, 명령(commands), 훅(hooks), 하위 에이전트(subagents) 및 MCP 서버를 포함하여 제가 매일 실전에서 검증하며 사용하는 Claude Code/Desktop 및 OpenAI Codex 설정입니다.

"그들은 당신을 대신해 잘못된 가정을 하고, 확인도 없이 그대로 실행해 버립니다. 그들은 혼란을 관리하지 않고, 명확한 설명을 요구하지 않으며, 불일치를 드러내지 않고, 트레이드오프(tradeoffs)를 제시하지도 않습니다. 그들은 코드와 API를 과도하게 복잡하게 만드는 것을 정말 좋아하며, 추상화(abstractions)를 비대하게 만들고, 작업 후 데드 코드(dead code)를 정리하지도 않습니다."-- Andrej Karpathy

이 저장소의 가이드라인은 정확히 이러한 함정들을 해결하도록 구조화되어 있습니다.

플러그인(Plugins)은 AI 코딩 도구에 기술, 명령 및 자동화 기능을 추가합니다. 아래의 플러그인 목록에서 필요한 것만 설치하십시오.

사전 요구 사항: 설정 요구 사항은 INSTALL.md를 참조하십시오.

Claude Code

# 마켓플레이스 추가 (1회성)
/plugin marketplace add fcakyon/claude-codex-settings
# 이름을 통해 모든 플러그인 설치
...

Codex CLI

Codex는 직접적인 셸 설치 명령 대신 로컬 마켓플레이스에서 플러그인을 설치합니다.

• 이 저장소를 로컬에 클론(Clone)하고 Codex에서 엽니다.
• 이 저장소에는 이미 .agents/plugins/marketplace.json이 포함되어 있습니다.

. - 해당 파일을 추가하거나 변경했을 때 Codex가 이미 열려 있었다면, Codex를 재시작하십시오.

• Codex에서 /plugins를 엽니다.

. - Claude & Codex Settings를 선택하고 원하는 플러그인을 설치하십시오.

이 README는 이 마켓플레이스를 설치하는 내용만 다룹니다. 일반적인 Codex 마켓플레이스 예시 및 유지 관리자 문서는 CLAUDE.md를 참조하십시오.

Gemini CLI

gemini extensions install --path ./plugins/<plugin-name>

Cursor

cursor plugin install < plugin-name > @claude-settings

도구 간 호환성을 위한 심볼릭 링크(symlinks) 생성:

ln -sfn CLAUDE.md AGENTS.md
ln -sfn CLAUDE.md GEMINI.md

intelligent-compact - Claude Code가 긴 세션을 자동으로 요약할 때 파일 경로, 근본 원인(root causes) 및 미결 질문(open questions)을 잊어버리는 것을 방지합니다.

Claude Code	Codex CLI	Gemini CLI
/plugin install intelligent-compact@claude-settings	/plugins 열기 -> Claude & Codex Settings -> intelligent-compact 설치	gemini extensions install --path ./plugins/intelligent-compact

Claude Code가 긴 세션(session)을 자동으로 요약할 때, 기본 요약은 핵심 정보(highest-signal facts)를 습관적으로 누락합니다. 이 플러그인은 요약기(summarizer)가 다음 항목들을 유지하도록 지시합니다:

조사 중인 파일 경로 (File paths under investigation): 다음 턴(turn)에서 작업 중이던 위치를 다시 찾아내는 일을 방지합니다.
확인된 근본 원인 (Confirmed root causes): 이미 해결된 문제를 다시 디버깅하지 않도록 합니다.
미결 질문, 지표 및 ID (Open questions, metrics, and IDs): 일반적인 줄글 요약에서 대개 생략되어 버리는 정보들입니다.
비용이 많이 드는 하위 에이전트(subagent) 실행 결과: 수집하는 데 몇 분이 소요된 정보들입니다.

모든 /compact (수동) 실행 및 모든 자동 압축(auto compaction) 시 작동합니다. Claude Code 전용입니다. Codex, Cursor, Gemini CLI는 아직 이와 유사한 요약 훅(summary hook)을 제공하지 않습니다.

훅 (Hooks):

precompact_priorities.sh

• 압축 요약기(compaction summarizer)를 위한 우선순위 보존 지침

claude-telemetry-hooks - 단일 대시보드에서 기기별 Claude Code 사용량, 거절 사유(rejection reasons) 및 세션별 통계를 추적합니다.

Claude Code	Codex CLI	Gemini CLI
/plugin install claude-telemetry-hooks@claude-settings	해당 없음 (n/a)	gemini extensions install --path ./plugins/claude-telemetry-hooks

사용량 대시보드를 구동하는 데 필요한 Claude Code 텔레메트리(telemetry)의 누락된 두 가지 요소를 추가합니다:

프로젝트별 고정 세션 ID (Sticky session ID per project): 재개된 대화가 수십 개로 쪼개지지 않고 하나의 세션으로 유지됩니다.
범주화된 거절 사유 (Categorized rejection reasons) (비속어, 잘못된 대상, 범위 이탈, 재시도 등): Claude가 왜 거절하는지 차트로 나타냅니다.

기기별 데이터는 이미 Claude Code의 내장된 OpenTelemetry 스트림에 포함되어 있습니다. 대시보드 측면을 위해 openobserve-skills와 자연스럽게 결합됩니다.

훅 (Hooks):

session_start_chat_id.py

• 프로젝트별 고정 chat_id를 방출하는 SessionStart 훅

user_prompt_reject_feedback.py

• 도구 거절 사유를 범주화하는 UserPromptSubmit 훅

anthropic-office-skills - 공식 Anthropic PDF, Word, PowerPoint, Excel 스킬

Claude Code	Codex CLI	Gemini CLI
/plugin install anthropic-office-skills@claude-settings	Open /plugins -> Claude & Codex Settings -> anthropic-office-skills 설치	gemini extensions install --path ./plugins/anthropic-office-skills

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/anthropic-office-skills --skill '*'

anthropics/skills의 공식 오피스 문서 스킬.

Skill	Description	Install
pdf	PDF 처리 (읽기, 병합, 분할, 생성, OCR, 양식)
pptx	PowerPoint 프레젠테이션 구축 및 편집
xlsx	수식을 사용한 Excel 스프레드시트 처리
docx	Word 문서 생성 및 편집

openai-office-skills - 공식 OpenAI PDF, Word, PowerPoint, Excel 스킬

Claude Code	Codex CLI	Gemini CLI
/plugin install openai-office-skills@claude-settings	Open /plugins -> Claude & Codex Settings -> openai-office-skills 설치	gemini extensions install --path ./plugins/openai-office-skills

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/openai-office-skills --skill '*'

openai/skills의 공식 오피스 문서 스킬.

Skill	Description	Install
pdf	시각적 검토를 통한 PDF 생성 및 추출
slides	PptxGenJS를 사용한 슬라이드 덱 생성
spreadsheet	수식 및 서식을 사용한 스프레드시트 처리
doc	Word 문서 생성 및 편집

python-skills - PEP 8, Zen of Python, Google Style Guide, Effective Python의 Python 모범 사례

Claude Code	Codex CLI	Gemini CLI
/plugin install python-skills@claude-settings	Open /plugins -> Claude & Codex Settings -> python-skills 설치	gemini extensions install --path ./plugins/python-skills

권위 있는 출처를 기반으로 한 Python 코딩 가이드라인: PEP 8, PEP 20 (Zen of Python), Google Python Style Guide, 그리고 Brett Slatkin의 "Effective Python" (3rd ed.)을 준수합니다. 코드 통합, 관용적 패턴 (idiomatic patterns), YAGNI 반-추상화 (anti-abstraction) 규칙, Google 스타일의 독스트링 (docstrings), 그리고 18가지 전/후 코드 예제를 포함합니다.

Skills:

Skill	Description
python-guidelines	핵심 규칙, 셀프 테스트 및 참조 인덱스

Reference files:

zen-of-python.md

• 주석이 포함된 전체 PEP 20

google-style-guide.md

• 소스 URL이 포함된 선별된 섹션

idiomatic-patterns.md

• 전/후 코드가 포함된 18가지 패턴

effective-python-tips.md

• 3판의 핵심 팁

react-skills - 공식 React, Next.js 및 React Native 베스트 프랙티스 (best practices)

Claude Code	Codex CLI	Gemini CLI
/plugin install react-skills@claude-settings	/plugins 열기 -> Claude & Codex Settings -> react-skills 설치	gemini extensions install --path ./plugins/react-skills

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/react-skills --skill '*'

vercel-labs/agent-skills에서 제공하는 React 및 프론트엔드 베스트 프랙티스입니다.

Skills (claude.ai, Claude Code, Cursor, Codex, VS Code용 ZIP 파일):

Skill	Description	ZIP
composition-patterns	React 컴포지션 패턴: 컴파운드 컴포넌트 (compound components), 렌더 프롭스 (render props), 컨텍스트 (context)
react-best-practices	Vercel Engineering에서 제공하는 64가지 React/Next.js 성능 규칙
react-native-skills	성능 및 애니메이션을 위한 35개 이상의 React Native/Expo 규칙
react-view-transitions	페이지/라우트 애니메이션을 위한 View Transition API
web-design-guidelines	16가지 웹 인터페이스 가이드라인 카테고리에 따른 UI 리뷰

agent-browser - AI 에이전트를 위한 공식 브라우저 자동화 CLI

Claude Code	Codex CLI	Gemini CLI
/plugin install agent-browser@claude-settings	Open /plugins -> Claude & Codex Settings -> install agent-browser	gemini extensions install --path ./plugins/agent-browser

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/agent-browser --skill '*'

Playwright MCP 대신 CLI를 통한 브라우저 자동화. 전체 DOM 트리 덤프 대신 스냅샷과 요소 참조(element refs)를 사용하여 Playwright MCP 대비 컨텍스트 사용량을 93% 줄였습니다. vercel-labs/agent-browser에서 가져옴.

Skills (claude.ai, Claude Code, Cursor, Codex, VS Code용 ZIP):

| Skill | Description | ZIP |
|---|---|
agent-browser | 브라우저 자동화: 탐색(navigation), 폼(forms), 클릭(clicking), 스크린샷(screenshots), 인증(auth), 세션(sessions) | |
electron | Electron 데스크톱 앱 자동화 (VS Code, Slack, Discord, Figma, Notion) |

CLI 도구: agent-browser - npm i -g agent-browser && agent-browser install을 통해 설치

frontend-design-skills - 공식 프론트엔드 디자인 스킬 (Anthropic + OpenAI)

Claude Code	Codex CLI	Gemini CLI
/plugin install frontend-design-skills@claude-settings	Open /plugins -> Claude & Codex Settings -> install frontend-design-skills	gemini extensions install --path ./plugins/frontend-design-skills

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/frontend-design-skills --skill '*'

anthropic/claude-plugins-official 및 openai/skills에서 가져온 프론트엔드 디자인 스킬.

| Skill | Description | Install |
|---|---|
openai-frontend-design | 구성 우선(Composition-first) 디자인: 절제된 레이아웃, 이미지 중심의 계층 구조, 세련된 모션 | |
anthropic-frontend-design | 대담한 미학적 방향성, 독특한 타이포그래피, 비범용적인 AI 미학 |

mongodb-skills - 스키마 디자인, 쿼리 튜닝 및 Atlas Search를 위한 공식 MongoDB 에이전트 스킬

클로드 코드	코덱스 CLI	제미나이 CLI
/plugin install mongodb-skills@claude-settings	/plugins 열기 -> Claude & Codex Settings -> mongodb-skills 설치	gemini extensions install --path ./plugins/mongodb-skills

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/mongodb-skills --skill '*'

스키마 디자인, 쿼리 튜닝, Atlas Search 및 연결을 위한 공식 MongoDB 에이전트 스킬. (출처: mongodb/agent-skills).

Skills (claude.ai, Claude Code, Cursor, Codex, VS Code용 ZIP):
| Skill | Description | ZIP |
|---|---|
atlas-stream-processing | Atlas 스트림 처리 패턴 | |
mongodb-connection | 연결 관리 | |
mongodb-mcp-setup | MCP 서버 설정 | |
mongodb-natural-language-querying | 자연어에서 쿼리로 변환 | |
mongodb-query-optimizer | 쿼리 성능 튜닝 | |
mongodb-schema-design | 스키마 디자인 패턴 | |
mongodb-search-and-ai | Atlas Search 및 AI 통합 |

supabase-skills - Supabase Postgres 모범 사례, JavaScript SDK 및 CLI 스킬

클로드 코드	코덱스 CLI	제미나이 CLI
/plugin install supabase-skills@claude-settings	/plugins 열기 -> Claude & Codex Settings -> supabase-skills 설치	gemini extensions install --path ./plugins/supabase-skills

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/supabase-skills --skill '*'

Supabase의 스킬로, supabase/agent-skills의 Postgres 쿼리/스키마 모범 사례, supabase/supabase-js의 JavaScript SDK 사용법, 그리고 supabase/cli의 CLI 워크플로우를 다룹니다.

Skills (claude.ai, Claude Code, Cursor, Codex, VS Code용 ZIP):

Skill	설명	ZIP
supabase-postgres-best-practices
8개 카테고리에 걸친 Postgres 성능 및 스키마 설계 (schema design)
supabase-js
인증 (auth), 데이터베이스 (database), 스토리지 (storage), 실시간 (realtime), 엣지 함수 (edge functions)를 위한 JavaScript SDK
supabase-cli
로컬 개발 (local dev), 마이그레이션 (migrations), 엣지 함수 (edge functions), 프로젝트 관리 (project management)를 위한 CLI

stripe-skills - 결제 (payments), 빌링 (billing), Connect, 그리고 API 업그레이드를 위한 공식 Stripe 에이전트 기술 (agent skills)

Claude Code	Codex CLI	Gemini CLI
/plugin install stripe-skills@claude-settings
/plugins 열기 -> Claude & Codex Settings -> stripe-skills 설치
gemini extensions install --path ./plugins/stripe-skills

Skills CLI

npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/stripe-skills --skill '*'

결제 통합 (payment integration)을 위한 공식 Stripe 에이전트 기술 (agent skills): API 선택, Connect 플랫폼 설정, 빌링/구독 (billing/subscriptions), Treasury, 그리고 SDK 업그레이드. stripe/ai 제공.

Skills (claude.ai, Claude Code, Cursor, Codex, VS Code용 ZIP):

Skill	설명	ZIP
stripe-best-practices
결제 (payments), 빌링 (billing), Connect, Treasury 통합 베스트 프랙티스 (best practices)
stripe-projects
Stripe Projects CLI 설정 및 스택 프로비저닝 (stack provisioning)
upgrade-stripe
Stripe API 버전 및 SDK 업그레이드 가이드