gaebalai

API 인증/인가(Authorization) 설계를 리뷰하고, 권한 체크 누락·스코프 설계 미흡·권한 상승 리스크를 탐지한다. 접근 통제의 안전성을 검증한다.

API 이용자를 위한 SDK 릴리스 노트 및 마이그레이션 가이드를 생성한다. 변경 사항을 클라이언트 관점에서 정리하고, 구체적인 전환 절차를 제공한다.

요구사항으로부터 RESTful API 엔드포인트를 설계한다. 네이밍 규칙, 리소스 단위, 에러 처리, 응답 구조를 일관되게 정의한다.

API 에러 코드 체계와 에러 응답 계약(Contract)을 설계한다. 일관된 에러 핸들링 규칙을 정의한다.

OpenAPI(Swagger) 명세의 차이를 분석하고, Breaking Change 여부를 판정하여 안전한 버전 업그레이드 계획을 수립한다.

API 리스트 엔드포인트의 페이지네이션·필터링·정렬 구현을 분석하고, 통일된 표준 규격을 수립한다.

API 메이저 버전 전환(v1 → v2)을 위한 단계적 마이그레이션 계획을 수립한다.

버그의 최소 재현 절차를 확립한다. 재현 조건·환경·절차를 구조화하여 기록한다.

Save session context to agent configuration files or create full checkpoint files. Supports three modes: session history (default), full checkpoint (--full), and skill analysis (--full --analyze) for extracting reusable patterns.

PROACTIVELY consult Codex CLI, your highly capable supporter with exceptional reasoning and task completion abilities. Codex is a trusted expert you should ALWAYS consult BEFORE making decisions on: design choices, implementation approaches, debugging strategies, refactoring plans, or any non-trivial problem. When uncertain, consult Codex. Don't hesitate - Codex provides better analysis. Explicit triggers: "think deeper", "analyze", "second opinion", "consult codex".

PROACTIVELY track and document project design decisions without being asked. Activate automatically when detecting architecture discussions, implementation decisions, pattern choices, library selections, or any technical decisions. Also use when user explicitly says "記録して", "設計どうなってる", "record this". Do NOT wait for user to ask - record important decisions immediately.

PROACTIVELY consult Gemini CLI for research, large codebase comprehension, and multimodal data processing. Gemini excels at: massive context windows (1M tokens), Google Search grounding, video/audio/PDF analysis, and repository-wide understanding. Use for pre-implementation research, documentation analysis, and multimodal tasks. Explicit triggers: "research", "investigate", "analyze video/audio/PDF", "understand codebase".

Analyze project structure and update AGENTS.md with detected tech stack, commands, and configurations.

Create a detailed implementation plan for a feature or task. Use when user wants to plan before coding.

Research a library and create comprehensive documentation in .claude/docs/libraries/.

Simplify and refactor code while preserving functionality and library constraints.

매일 외부 자료 5 건을 검색·요약해 vault/02_wiki/digests/YYYY-MM-DD.md 로 저장하고 Slack 통지(선택). vault/positioning.md (사용자 관심사·금기) + 기존 topics 를 컨텍스트로 사용. 수동 호출은 "/daily-digest" 또는 daily-digest routine (매일 07:00 KST) 만. 자동 발사 금지.

vault/02_wiki/ 전체를 검사해 SCHEMA.md 위반·orphan·stale·반각공백·끊긴 wikilink·duplicate id 를 검출하고 리포트를 vault/02_wiki/_lint/YYYY-MM-DD.md 에 저장한다. 사용자가 "lint 해줘", "위키 검사해줘" 같은 요청을 하거나 weekly-lint routine이 호출할 때 발동한다.

vault/02_wiki/topics/ 의 reviewed/published 페이지 1건 또는 .claude/queue/graph.txt 의 누적 변경분을 Neo4j 그래프에 upsert 한다. services/graph/ingest_graph.py 를 호출하며 dry-run 옵션 지원. PostToolUse hook 이 큐를 채우고 sleep-maintenance routine 또는 사용자가 명시적으로 호출했을 때 발동한다. graph_synced_at frontmatter 를 갱신한다.

vault/02_wiki/_drafts/ 의 draft 1건을 사람 승인 후 vault/02_wiki/topics/ 또는 decisions/ 로 승급한다. 승급 전 lint 동등 검사를 수행해 ERROR 가 있으면 거부한다. status 를 draft → reviewed 로 갱신하고 index.md 에 등록하며 log.md 에 기록한다. 사용자가 명시적으로 "/compile <draft_path>" 라고 호출했을 때만 발동한다 (자동 호출 금지).

세션 종료(Stop hook) 시 자동 호출. 그 세션에서 vault/02_wiki/ 가 변경됐다면 모순 검사 (덮어쓴 결정·CONTRADICTS 신규 등) 수행. 모순 발견 시 exit 2 로 세션 종료 차단 (사람 검토 강제). log.md 에 정정 메모 1 줄 append. 사용자가 명시적으로 "/evening-reflect" 로 호출해도 발동.

vault/01_raw/ 의 새 파일 1건을 읽어 vault/02_wiki/_drafts/ 에 토론형 wiki draft 1개를 생성한다. raw는 절대 수정하지 않으며, 결과는 사람이 검토할 수 있도록 draft 상태로만 남긴다. raw에 새 파일이 추가됐거나 사용자가 명시적으로 "이거 ingest 해줘" 같은 요청을 한 경우에 발동한다.

사용자가 아침 인사 ("좋은 아침", "morning", "굿모닝") 또는 "/morning-brief" 로 호출하면 발동. vault 의 현재 상태를 한 화면 요약. drafts 미검토·overdue lint·신규 raw·어제 갱신한 topic 을 stdout 으로 보여준다. 부수효과 없음 (Read 만).

사용자 자연어 질의를 받아 의도를 분류하고 적절한 검색층으로 라우팅한다. lookup(키워드/의미)은 Grep + Dataview, 관계/경로 탐색은 services/graph/query_graph.py 의 고정 Cypher 템플릿. 자연어 → Cypher 자동 생성 절대 금지. 결과는 LLM 컨텍스트로 주입 가능한 요약 + 출처 wikilink 리스트. 사용자가 "찾아줘", "어디 있어", "관계가 뭐야", "/query <질문>" 같은 형태로 호출하면 발동.

자동차 이상 소음 진단용 PWA를 자동으로 스캐폴딩한다. 마이크 입력 FFT 스펙트로그램 + 라즈베리파이로부터 WebSocket으로 받은 CAN 데이터(RPM·속도·조향각·기어) 동시 시각화 + 녹음 정지 시 WAV+CSV ZIP 저장 + Service Worker 오프라인 동작까지 한 번에 만든다. 사용자가 "차량 진단 PWA 만들어줘", "OBD2 시각화 앱", "FFT 스펙트로그램 PWA", "마이크 + CAN 동시 기록 앱", "car-noise-pwa-builder" 같은 요청을 할 때 호출한다.

PWA가 내보낸 ZIP(audio.webm/wav + can.csv + metadata.json)을 입력받아 이상음 후보 구간을 자동 탐지하고 RPM·속도와의 상관관계를 분석한 리포트(MD + PNG 패널)를 생성한다. 음향 에너지 급증 구간, 특정 RPM에서만 나타나는 피크 주파수, 노면/속도와 무관한 정상 회전성 노이즈 분리 등을 다룬다. 사용자가 "이상음 분석해줘", "녹음 ZIP 분석", "주행 노이즈 리포트", "특정 RPM에서 나는 소리 찾아줘", "car-noise-report" 같은 요청에서 호출한다.

차량 OBD2/CAN 로그(.asc, .log, .blf, .csv)에서 RPM·차속·조향각·기어 같은 신호의 ID와 바이트 위치, 스케일·오프셋을 자동 추정하고 검증 그래프(PNG)와 DBC 초안을 생성한다. 사용자가 "CAN 로그 분석", "RPM ID 찾아줘", "0x202가 무슨 신호야", "조향각 ID 매핑", "DBC 만들어줘" 같은 요청을 할 때 호출한다. 제조사 비공개 신호를 빠르게 역엔지니어링할 때 쓰는 스킬.

라즈베리파이 4(Raspberry Pi OS Bookworm)에 OBD2/CAN 진단 환경을 한 번에 깔아주는 스킬. Node.js 18 LTS, Claude Code, python-can, socketcan, USB-CAN 어댑터(slcan/canable) udev 규칙, aiohttp 의존성, 스왑 확장(4GB 미만 모델용)까지 부트스트랩 스크립트로 자동화한다. 사용자가 "라즈베리파이에 Claude Code 깔아줘", "Pi에 CAN 환경 세팅", "OBD2 raspi 부트스트랩", "raspi-can-bootstrap" 같은 요청을 할 때 호출한다.

topics.json에서 중요도 상위 토픽을 선정해 60초 하이라이트 영상용 highlights.json을 생성합니다. 각 클립의 자막(caption/subCaption), 시작·종료 시각, src 경로를 결정하고 합계 60초를 정확히 맞춥니다. "60초 하이라이트 만들어줘", "highlights.json 만들어줘" 같은 표현에서 발동됩니다. cc-meeting-highlight 파이프라인의 Phase 4.

회의 받아쓰기(transcript.json)와 회의록 요약 텍스트(예: Gemini Meet 요약, Teams 요약, 네이버 웍스 요약)를 입력으로 받아, 회의에서 다뤄진 주요 토픽을 추출해 transcript의 word-level 타임스탬프와 매칭한 topics.json을 생성합니다. "회의 토픽 뽑아줘", "topics.json 만들어줘", "회의 요약과 받아쓰기 매칭해줘" 같은 표현에서 발동됩니다. cc-meeting-highlight 파이프라인의 Phase 3.

사용자가 쓴 Claude Code Skill / SlashCommand / 프롬프트를 별도 AI에 백지 dispatch 시켜 재현성을 객관 측정하는 메타 스킬. 자기 재독으로는 못 보는 불명확점·재량 보완·재시도를 정성+정량(tool_uses) 양면으로 수집해 1회 1테마로 정련. 트리거 - "내 스킬 평가해줘", "프롬프트 재현성 검증", "skill 튜닝", "SKILL.md 다듬어줘", "암묵지 빼줘", "empirical prompt tuning". 단순 윤문은 humanize-korean, 다분야 토론 리뷰는 start로 분기.

채널 통계(구독자·총 조회수·영상 수·TOP5 영상)를 출력하고 1년치 로그를 누적한다. 사용자가 "채널 통계 봐줘", "이번 주 리포트", "/youtube-analytics" 같이 요청할 때 발동.

YouTube BGM Auto 시스템의 셋업 상태를 진단한다. .env.local, client_secret.json, token.pickle, ffmpeg, venv, 필수 환경변수, API 키 유효성을 점검하고 누락된 항목별 해결 절차를 출력한다. 사용자가 "환경 점검해줘", "셋업 확인", "/youtube-doctor", "왜 안 돼" 같이 요청할 때 발동.

판타지 음원 큐(마법사 도서관, 중세 술집, 마법의 숲 등)에서 다음 1편을 자동으로 게시한다. 매번 호출 시 큐의 다음 항목으로 진행. 사용자가 "판타지 다음 거 올려줘", "/youtube-fantasy" 같이 요청할 때 발동.

채널의 모든 영상에서 답글이 없는 댓글에 자동 답글을 단다. REPLY_PROVIDER 환경변수에 따라 키워드 템플릿/GPT-5-nano/Claude Sonnet 4.5 중 하나를 사용. 사용자가 "댓글 답글 돌려줘", "/youtube-reply" 같이 요청할 때 발동. "--dry-run" 옵션 가능.

세로형 60초 YouTube Shorts 1편을 자동 생성·게시한다. 사용자가 "Shorts 올려줘", "쇼츠 만들어줘", "/youtube-shorts" 같이 요청할 때 발동.

YouTube BGM Auto 메인 업로드. 환경음 1시간·8시간 영상 2편을 생성해 자동 업로드하고 재생목록에 분류한다. 사용자가 "오늘 BGM 영상 올려줘", "환경음 업로드 돌려줘", "/youtube-upload" 같이 요청할 때 발동.

라이브러리 정보를 확인하기 위한 스킬이다. Next.js, shadcn, 기타 라이브러리에 대해 적절한 MCP 서버를 사용해 최신 문서와 사용 방법을 조회한다.

git worktree를 활용해 분리된 작업 환경을 자동으로 구축한다. 기본 브랜치에서 최신 코드를 가져와 `.git-worktrees/` 디렉터리에 새로운 worktree를 생성하고, `.env`, Serena memories, npm 의존성을 자동으로 설정한다. 브랜치명에 포함된 `/`는 자동으로 `-`로 변환된다. 이미 존재하는 worktree가 있을 경우 재사용한다.

코드 변경 사항을 적절한 git 커밋 전략으로 git commit한다. 기본적으로는 기존 git 커밋에 squash 전략을 적용하며, 필요에 따라 브랜치 전체의 git 커밋 히스토리를 재구성한다. 구현 완료 시점이나 사용자가 git commit을 요청했을 때 사용한다.

GitHub PR에서 아직 대응되지 않은 코멘트를 조회한다. GraphQL API를 사용해 (1) 코드의 특정 라인에 연결된 미해결 Review thread(Resolve 가능)와 (2) 코드 블록을 포함한 Issue comment(대화 탭, Resolve 불가)를 모두 가져와 JSON 형식으로 출력한다. PR 정보(번호, 제목, URL, 상태, 작성자, 리뷰어)도 함께 포함된다.

GitHub PR의 미해결 Review thread를 일괄 Resolve한다. GraphQL API를 사용해 미해결 Review thread(코드 특정 라인에 대한 코멘트)를 조회한 뒤, resolveReviewThread mutation으로 모두 자동 Resolve한다. Issue comment(대화 탭)는 원래 Resolve 기능이 없으므로 대상에서 제외된다. 각 스레드의 Resolve 결과를 출력한다.

gemini 명령어를 사용한 고급 Web 검색 스킬이다. Web 검색을 수행할 때는 Claude Code의 기본 Web Search 도구보다 이 스킬을 우선적으로 사용한다.

블로그 URL 1개를 받아 60초 9:16 숏폼 영상(mp4)을 자동 생성하는 파이프라인. 한국 블로그 4종(티스토리/네이버/벨로그/브런치)에서 본문·이미지를 추출하고, shortform-script-generator로 2인 대화 대본을 만든 뒤, ElevenLabs TTS와 GPT Image 2(gpt-image-2)로 음성·이미지를 생성해 Remotion v4로 합성한다. "블로그 URL로 숏폼 만들어줘", "이 글로 릴스 영상 만들어줘", "blog to shortform", "blog-url-to-shortform" 같은 요청에서 발동한다.

.claude 하네스 설정을 시각화 HTML 로 직관적으로 편집하고, JSON 차분을 실제 파일에 반영한다. TRIGGER when 사용자가 /harness-edit 또는 /harness-edit:harness-edit 를 실행하거나, '하네스 편집', '설정을 직관적으로 바꾸고 싶다'고 요청한 때. DO NOT TRIGGER when 단발의 자명한 설정 변경 (직접 편집 / update-config 로 충분).

UI 스타일 비교용 단일 HTML 을 생성한다. 프리셋 10 종 / 색 / 폰트 / 형상을 전환하고, 컴포넌트 클릭으로 코드를 복사할 수 있다. TRIGGER when 사용자가 /ui-style-lab 또는 /ui-style-lab:ui-style-lab 를 실행하거나, 「UI 스타일 비교」 「테마 비교 도구」 「컬러 코드 비교 HTML」 이라고 요청한 때. DO NOT TRIGGER when 특정 페이지의 구현 (frontend-design), 기존 LP 개선 (unicorn-lp).

gieok 의 대화형 셋업 가이드. `/setup-guide` 로 기동. 각 단계의 의미와 의도를 설명하면서, 사용자 환경에 맞춰 설치 작업을 순서대로 진행한다. 처음 쓰는 사용자도 헤매지 않도록 설계되어 있다.

현재 프로젝트 전체를 망라적으로 탐색하여, 설계 판단·기술 선택·아키텍처·패턴·실패 사례를 gieok Wiki 에 일괄 투입한다. `/wiki-ingest-all` 로 기동. 기존 프로젝트의 backfill (Wiki 에 아직 기록되지 않은 과거 지식을 1회로 수집) 이 주 용도. 신규 프로젝트를 처음으로 Wiki 에 올릴 때도 사용할 수 있다. 토큰 소비를 신경 쓰지 않고 깊이 탐색하는 전제.

특정 파일·디렉터리, 또는 최근 git 변경을 gieok Wiki 에 수집하는 경량판 ingest. `/wiki-ingest <path>` 로 경로 지정, `/wiki-ingest` 인수 없음으로 최근 커밋 차분을 대상으로 한다. 일상적인 단발 ingest 용도. 프로젝트 전체를 일괄 투입하고 싶을 때는 `/wiki-ingest-all` 을 사용한다.

Safety hooks for Claude Code — 772 pre-built hooks that prevent file deletion, credential leaks, git disasters, and token waste during autonomous AI coding sessions. 9,228+ tests. Install with npx @gaebalai/cc-guard.

Safety hooks for Claude Code — 695 pre-built hooks that prevent file deletion, credential leaks, git disasters, and token waste during autonomous AI coding sessions. Install with npx @gaebalai/cc-guard.

다분야 전문가를 동적으로 선정해 구조화된 토론으로 다각적 평가·제언을 정리합니다. "전문가에게 묻고 싶다", "리뷰해줘", "다각적으로 평가해줘", "토론해줘" 등의 표현에서 발동됩니다. 웹사이트, 코드, 사업 전략, 디자인, 조직 설계 등 모든 도메인에 대응합니다.

AI(ChatGPT·Claude·Gemini 등)가 쓴 한글 텍스트를 "사람이 쓴 글처럼" 윤문한다. 번역투·영어 인용 과다·기계적 병렬·관용구·피동태 남용·접속사 남발·리듬 균일성·이모지/불릿 과다 등 10대 카테고리 40+ AI 티 패턴을 탐지·분류해 내용은 한 글자도 건드리지 않고 문체·리듬·표현만 자연스러운 한국어로 재작성한다. 4단계(탐지→윤문→내용 감사→자연스러움 리뷰)를 순차 수행한다. 트리거 — "AI 티 없애줘", "AI 같은 글 자연스럽게", "GPT/ChatGPT 문체", "AI 번역투 고쳐", "사람이 쓴 것처럼 윤문", "AI 윤문", "ChatGPT 티 제거", "한글 AI 탐지·윤문", "AI 글 사람처럼", "번역투 제거", "영어 인용 많은 글 윤문", "AI 글 티 안 나게", "휴머나이저", "humanize Korean". 후속 — "특정 카테고리만 다시", "윤문 강도 조정", "장르 바꿔서", "이 문단만", "2차 윤문", "내용은 그대로 두고 톤만". 단순 맞춤법 교정·번역·내용 추가를 동반한 재작성은 제외.

PLAUD NotePin 녹음을 Plaud Web에서 자동 수집하고 로컬 faster-whisper로 음성 인식해 Obsidian Vault의 날짜별 Markdown에 저장하는 파이프라인. 사용자가 "plaud 가져와", "오늘 녹음 정리해줘", "녹음 처리해", "/plaud-daily" 같은 요청을 하면 발동. macOS 전용.