hooks

이름이 있는 hooks를 관리하고 각 Agent의 네이티브 설정에 동기화합니다. Dashboard의 Hooks에서 추가, 편집, 가져오기, 활성화／비활성화, 미리보기와 동기화를 할 수 있습니다. Targets, Projects, Sync, Settings → Backups에도 표시됩니다.

hook 행의 메뉴에서 각 대상의 네이티브 설정이나 코드, 스크립트 파일과 출력 경로를 확인할 수 있습니다. 이 읽기 전용 미리보기는 해당 hook의 내용만 표시하며 공유 파일의 다른 설정은 유지합니다. 비활성화된 hook도 확인할 수 있지만 게시하지 않습니다.

명령

skillshare hooks
skillshare hooks list --json
skillshare hooks add check --file ./check.yaml
skillshare hooks edit check --file ./updated-check.yaml --sync
skillshare hooks import --from claude --json
skillshare hooks import imported --from claude --file ./settings.json --dry-run
skillshare hooks disable check --sync
skillshare hooks enable check --sync
skillshare hooks sync --dry-run --json
skillshare hooks sync
skillshare hooks sync check --replace --dry-run
skillshare sync hooks --dry-run --json
skillshare sync hooks
skillshare hooks remove check --sync
skillshare hooks remove check --keep-files
skillshare hooks restore BACKUP_ID --dry-run
skillshare hooks restore BACKUP_ID

하위 명령이 없으면 entries를 나열합니다. add／edit는 --file의 Entry JSON/YAML을 읽습니다. 이름 없는 가져오기는 후보(Agent event 또는 파일마다 하나)를 나열하고 이름을 지정하면 저장합니다. 가져오기를 저장하면 읽은 등록을 그 자리에서 인수합니다. 다음 동기화는 --replace 없이 adopt하며, 가져오지 않은 event는 관리되지 않은 채 남습니다. 설정과 코드만 읽고 실행하지 않습니다. 추가, 편집, 가져오기, 활성화, 비활성화, 제거는 소스만 저장하며 --sync를 붙이면 동기화합니다. 동기화와 복원은 적용 전 다시 미리 봅니다.

Option	Meaning
`--file PATH`	추가／편집의 Entry JSON/YAML 또는 가져올 네이티브 설정／코드
`--from AGENT`	`codex-2` 계정 target도 지원. 가져올 Agent 또는 네이티브 형식
`--sync`	저장 후 동기화
`--keep-files`	`remove`와 함께 사용: hook 관리를 멈추고 네이티브 항목은 그대로 둡니다. `--sync`와 함께 쓸 수 없습니다. 아래 참고
`--replace`	기존 소스 entry 또는 해당 entry의 충돌 출력을 명시적으로 교체
`--dry-run, -n`	저장하거나 쓰지 않고 미리보기
`--json`	구조화된 출력
`--revision ID`	지정한 미리보기 revision과 일치 요구
`--global, -g`	global 설정
`--project, -p`	project 설정

hooks list --json으로 백업 ID와 전체 대상 경로를 확인합니다. 설정이 바뀌면 이전 미리보기가 무효가 되므로 저장／동기화 전 새로 확인하세요.

hook 관리 중단

skillshare hooks remove check --keep-files

소스에서 check를 제거하고, Skillshare가 이 hook을 위해 쓴 네이티브 등록과 파일을 더 이상 기억하지 않습니다. Agent 파일은 바뀌지 않습니다. 이후 그 항목은 사용자의 것이 되어, 동기화가 제거하거나 업데이트하지 않으며 hooks import에서 다시 후보로 나타납니다. --keep-files는 --sync와 함께 쓸 수 없습니다. 대시보드의 제거 대화상자는 Hooks 페이지와 프로젝트의 Hooks 탭에서 관리 중단으로 이 선택지를 제공합니다. 소스에서만 제거는 다릅니다. 다음 동기화 때 Agent 파일에서 해당 hook 항목을 삭제합니다.

제거한 범위만 바뀝니다. global hook의 관리를 멈춰도 같은 이름의 프로젝트 hook은 계속 관리되며, 그 반대도 마찬가지입니다. 다시 관리하려면 가져오기(import)하세요.

소스 필드

선택한 Skillshare 설정의 hooks.entries에 선언합니다. 이름은 entry를 식별하며 bindings는 받을 Agent와 네이티브 정의를 지정합니다. 빈 bindings는 소스만 유지하고 게시하지 않습니다.

hooks:
  entries:
    check:
      description: Run the project's check after Claude finishes
      enabled: true
      bindings:
        claude:
          events:
            Stop:
              - hooks:
                  - type: command
                    command: "make check"
                    timeout: 120

hooks add check --file check.yaml 파일에는 Entry의 description, enabled, bindings만 포함하고 바깥쪽 hooks.entries는 넣지 않습니다.

Skillshare는 hooks 섹션을 들여쓴 block 형식으로 쓰며, 저장할 때마다 이전에 한 줄로 압축된 entry도 펼칩니다. Hooks 페이지의 config.yaml 버튼은 Settings → Files를 hooks: 섹션 위치에서 엽니다. hooks 키를 클릭하면 오른쪽 패널에 설명이 표시되고, 정리는 중첩된 한 줄 섹션을 펼칩니다. targets: [claude, codex] 같은 짧은 목록은 한 줄로 유지됩니다.

Option	Meaning
`description`	선택 설명
`enabled`	기본 true. false는 소스를 유지하고 다음 동기화에서 변경되지 않은 소유 출력을 제거
`bindings`	Agent ID별 네이티브 binding
`bindings.AGENT.events`	설정형 Agent의 네이티브 event map
`bindings.AGENT.code`	Pi, OMP, Amp, OpenCode의 네이티브 extension/plugin 소스
`bindings.AGENT.files`	상대 파일명을 key로 하는 선택 UTF-8 스크립트

Agent ID는 claude, codex, gemini, copilot, cursor, droid, qwen, antigravity, pi, omp, amp, opencode, git입니다. factory는 droid, antigravity-cli와 agy는 antigravity의 별칭입니다. event, matcher, handler type, command, timeout 단위와 payload는 원래 형식을 유지하고 자동 변환하지 않습니다. event 이름은 각 command Agent 문서의 event와 대조합니다. 알 수 없는 이름(예: 철자가 틀린 Stopp)은 미리보기와 plan의 warnings에 경고로 표시되지만, Agent가 event를 계속 추가하므로 동기화를 막지 않습니다. Pi, OMP, Amp, OpenCode 코드는 확인하지 않습니다. Pi, OMP, Amp, OpenCode의 코드와 imports는 설치된 버전에 맞춰 제공하며 전용 skillshare-NAME.ts에 기록됩니다. 공통 실행 엔진을 생성하지 않습니다. command binding 스크립트는 Agent 설정 디렉터리의 hooks/skillshare/NAME/에 저장하며 command의 macro／명시 경로를 변경하지 않습니다. 미리보기에서 전체 경로를 확인하세요. global binding에는 targets 아래 선언한 계정 target 이름도 사용할 수 있습니다.

Oh My Pi code bindings

설치된 OMP 버전의 extension API에 맞춰 bindings.omp.code를 사용하세요. Skillshare는 소스를 그대로 복사하며, shell event를 변환하거나 검증을 위해 extension을 실행하지 않습니다. OMP에는 project trust 확인이 없으므로, 동기화된 project extension은 다음 OMP 시작 시 실행될 수 있습니다.

OMP의 hooks/pre와 hooks/post factory는 관리되지 않는 추가 소스로 남습니다. 목록에는 표시되지만 extensions로 import되지 않습니다. import하면 같은 factory가 두 번 로드될 수 있기 때문입니다. 기존의 독립 extension을 import해도 원래 파일은 그대로 남으므로, 다른 사본을 동기화하기 전에 import 경고를 확인하세요.

Pi와 OMP는 모두 PI_CODING_AGENT_DIR을 따릅니다. binding이 같은 출력 파일로 해석되면 Skillshare는 쓰기 전에 계획을 차단합니다. 둘 다 관리할 때는 서로 다른 명시적 계정 디렉터리를 사용하세요.

네이티브 저장 위치

Agent	Global	Project	Format
Git	`$XDG_CONFIG_HOME/git/skillshare/hooks.gitconfig`	`<git-common-dir>/skillshare/hooks.gitconfig`	Git 2.54+ `hook.<name>`
Claude Code	`~/.claude/settings.json`	`.claude/settings.json`	`hooks` event map with matcher groups
Codex	`~/.codex/hooks.json`	`.codex/hooks.json`	Wrapped `hooks` event map
Gemini CLI	`~/.gemini/settings.json`	`.gemini/settings.json`	`hooks` event map
Copilot CLI	`~/.copilot/hooks/skillshare-NAME.json`	`.github/hooks/skillshare-NAME.json`	Version 1, `hooks` event map
Cursor	`~/.cursor/hooks.json`	`.cursor/hooks.json`	Version 1, native lowerCamelCase events
Factory Droid	`~/.factory/hooks.json`	`.factory/hooks.json`	Unwrapped event map
Qwen Code	`~/.qwen/settings.json`	`.qwen/settings.json`	`hooks` event map
Antigravity	`~/.gemini/config/hooks.json`	`.agents/hooks.json`	hook마다 하나의 이름 있는 블록
Pi	`~/.pi/agent/extensions/skillshare-NAME.ts`	`.pi/extensions/skillshare-NAME.ts`	Native extension code
Oh My Pi	`~/.omp/agent/extensions/skillshare-NAME.ts`	`.omp/extensions/skillshare-NAME.ts`	Native OMP extension code
Amp	`~/.config/amp/plugins/skillshare-NAME.ts`	`.amp/plugins/skillshare-NAME.ts`	Native plugin code
OpenCode	`~/.config/opencode/plugins/skillshare-NAME.ts`	`.opencode/plugins/skillshare-NAME.ts`	Supplied v1/v2 plugin code

계정 target의 config_dir을 가리키는 경우를 제외하고 global scope는 네이티브 설정 디렉터리 환경 변수 override를 사용합니다. project scope는 프로젝트에만 쓰며 global 경로로 대체하지 않습니다. Codex inline TOML 같은 다른 소스는 별도로 유지됩니다. Antigravity와 CLI(agy)는 같은 hooks.json을 읽습니다. 각 hook은 이름이 붙은 블록 하나이며 가져와도 이름이 유지됩니다. CLI의 ~/.gemini/antigravity-cli/settings.json에 있는 hooks는 별도로 유지됩니다. Droid의 독립 hooks 파일은 로딩 소스를 바꿀 수 있으므로 기존 inline hooks를 먼저 확인하세요. Copilot은 신뢰된 폴더에서만 .github/hooks의 프로젝트 hooks를 불러옵니다.

Droid inline hooks가 활성화된 경우 독립 파일 생성을 거부합니다. 가져와서 검토하고 원래 inline hooks를 제거한 뒤 동기화하세요.

Agent의 다른 계정

agent와 config_dir을 선언한 target은 자기 이름으로 hooks를 받을 수 있습니다. Claude, Codex, Pi, OMP 계정은 해당 Agent의 네이티브 binding 형식을 사용합니다. git 키는 항상 Git config hooks를 뜻하므로 git이라는 이름의 계정은 hooks를 받지 않으며, git binding을 사용하는 entry가 있으면 계획에 경고가 표시됩니다. 다른 이름을 사용하세요.

targets:
  codex-2:
    agent: codex
    config_dir: ~/.codex-2
    skills: {enabled: false}
hooks:
  entries:
    check:
      bindings:
        codex-2:
          events:
            Stop:
              - hooks:
                  - type: command
                    command: "echo checked"

계정의 Agent	네이티브 대상
`claude`	`<config_dir>/settings.json`
`codex`	`<config_dir>/hooks.json`
`pi`	`<config_dir>/extensions/skillshare-NAME.ts`
`omp`	`<config_dir>/extensions/skillshare-NAME.ts`

command 스크립트는 <config_dir>/hooks/skillshare/NAME/에 기록됩니다. 계정은 global에서만 지원합니다. 모든 계정이 같은 프로젝트 파일을 읽으므로 project 설정과 hooks.projects에서는 Agent 자체를 지정합니다. config_dir이 없으면 경고하고 건너뛰며 계정 홈을 만들지 않습니다.

CODEX_HOME, CLAUDE_CONFIG_DIR, PI_CODING_AGENT_DIR이 선언한 계정 디렉터리를 가리키면 일반 Agent binding은 내장 기본 홈을 사용하고 plan에 경고를 표시합니다. 각 계정은 자기 config_dir을 사용합니다. 다른 override는 기존대로 적용됩니다. symlink를 포함해 같은 디렉터리로 해석되는 두 binding key를 한 번에 동기화할 수 없습니다.

target이 삭제되거나 홈이 이동하거나 계정 홈이 없으면 관리 중인 출력과 소유권 기록을 그대로 두고 경고합니다. target이나 디렉터리를 복원하면 다시 관리할 수 있습니다. 파일을 바꾸지 않고 특정 항목의 보류된 소유권을 해제하려면 skillshare hooks sync NAME --replace -g를 미리 보고 실행하세요. target 제거 시 binding이 여전히 그 이름을 쓰면 경고합니다. 다음 hooks 동기화 전에 binding도 제거하세요.

skillshare hooks import --from codex-2 -g --json으로 계정에서 가져옵니다. 대시보드는 **codex-2 (Codex)**로 표시하고 Codex event와 편집기를 사용합니다. 각 Codex 홈에서 변경된 hooks를 /hooks로 검토하고 신뢰해야 합니다. 동기화는 신뢰를 바꾸거나 hooks를 실행하지 않습니다.

Git hooks

bindings.git.commands는 Git 2.54+의 이름 있는 config hook을 선언합니다. 각 이름에 events: [pre-commit], 한 줄 command, 선택적 parallel (Git 2.55+)을 지정합니다. 이름은 Git event 이름과 달라야 하며 영숫자로 시작하는 영숫자·_·-·. 128자 이내입니다. ..와 끝의 .는 허용하지 않습니다. 같은 대상의 활성 entry 사이에서 이름이 중복되면 충돌합니다. 알 수 없는 event는 경고입니다.

Git은 event 인수를 command 뒤에 붙이고 각 hook에 전체 stdin을 제공합니다. 복합 셸 로직은 UTF-8 files에 넣고 command: "{files}/check.sh"로 참조하세요. {files}는 각 머신의 따옴표 처리된 절대 helper 경로로 확장되며 파일은 LF와 실행 권한으로 출력됩니다. fi, done, esac, }, )로 끝나는 command는 거부합니다. Dashboard는 전체 Git binding을 YAML로 편집합니다. 순서는 entry 이름 다음 hook 이름입니다.

global 출력은 $XDG_CONFIG_HOME/git/skillshare/hooks.gitconfig (기본 ~/.config/git/…)입니다. include 대상은 절대 경로 GIT_CONFIG_GLOBAL, 기존 ~/.gitconfig, 기존 XDG git/config, 새 ~/.gitconfig 순입니다. project 출력은 <git-common-dir>/skillshare/hooks.gitconfig이며 common config에 include합니다. linked worktree는 대상을 공유하므로 common directory마다 root 하나를 선언하세요. root는 bare가 아닌 repository의 최상위여야 합니다.

쓰기 가능한 일반 config만 native lock으로 수정합니다. symlink를 통해 쓰지 않습니다. include가 없으면 inactive와 수동으로 추가할 정확한 행을 표시합니다. 오래된 Git도 inactive이며 fallback dispatcher를 만들지 않습니다. Git이나 root가 없으면 출력을 건너뛰고 소유권 기록을 보존합니다. 수동 include와 includeIf는 사용자 소유이며 조건을 넓히지 않습니다. conditional include가 있다는 사실만으로 활성화를 증명할 수 없습니다. hooks list -g --json의 git과 projectGit에서 capability, include, core.hooksPath를 확인하세요.

생성 파일 전체를 소유합니다. --replace는 백업 후 전체 파일을 다시 생성하며 외부 편집을 덮어씁니다. 이름이 충돌하는 외부 hook은 쓰기 가능한 일반 대상 config 안에서만 교체할 수 있습니다. system/include 파일의 충돌과 다른 config의 활성 소유권은 교체할 수 없습니다. enabled=false는 경고입니다. preview와 section backup에는 관련 없는 private config가 없습니다. 삭제/비활성화 동기화는 소유 출력과 include를 지우고 수동 include와 관련 없는 설정을 보존합니다. restore는 이후의 관련 없는 편집을 유지하며 source를 변경하지 않습니다. 공유 파일 때문에 Git binding의 --keep-files는 거부합니다.

config hook과 hookdir script가 모두 실행될 수 있습니다. 이동 전에 중복을 직접 확인하세요. Git import, hookdir 인식, script mode, 구조화 editor, doctor는 후속 phase입니다. Windows 형식 경로는 생성하지만 Windows 실행은 검증하지 않았습니다.

전역과 프로젝트 명령에도 서로 다른 이름을 사용하세요. Git은 두 범위를 병합합니다. 비활성 상위 조건 아래의 중첩 include도 조건을 유지합니다. 읽을 수 없거나 지나치게 깊은 include 선언은 안전을 위해 동기화를 중단합니다.

plan은 실제 add, update, remove, unchanged 동작을 유지하고 실행할 수 없는 이유를 inactiveReason으로 따로 표시합니다. 동기화된 inactive 출력은 대기 중인 쓰기로 세지 않습니다.

프로젝트, 충돌과 복원

global 설정의 hooks.projects는 절대 프로젝트 경로를 같은 Entry 형식의 entries에 연결합니다. Projects → Hooks에서 관리합니다. 자체 .skillshare/config.yaml이 있는 프로젝트는 project scope로 관리하고, 프로젝트 동기화는 해당 루트만 적용합니다.

관련 없는 설정과 소유하지 않은 hooks는 유지합니다. 내용이 같다고 소유권을 부여하지 않습니다. 소유 출력이 외부에서 편집되면 비활성화, 제거, 복원도 충돌로 보고합니다. 명시적 교체는 선택한 entry에만 적용됩니다. 공유 파일의 plan 각 행에는 entry가 추가(+), 업데이트(~), 제거(−)하는 event가 표시되며 JSON plan의 events에도 포함됩니다. update는 entry가 그 파일에 등록을 남긴다는 뜻이고, remove는 파일에서 완전히 빠진다는 뜻입니다. 편집은 파일의 형식(압축 또는 들여쓰기)을 유지하며, Skillshare가 추가한 hooks 키는 마지막 hook이 빠질 때 함께 제거합니다. Skillshare가 만든 파일은 다른 내용이 남지 않으면 삭제하며, 만들었다가 비게 된 폴더도 함께 삭제합니다. 미리보기에는 파일 삭제로 표시됩니다. 원래 있던 파일과 폴더, 그리고 사용자가 추가한 내용은 유지됩니다.

백업은 이후의 관련 없는 변경을 유지하며 네이티브 출력을 복원하고 소스 정의는 바꾸지 않습니다. Settings → Backups → Hooks 또는 hooks restore로 미리 보고 복원하세요.

Synced는 Skillshare가 설정을 기록했다는 뜻입니다. Agent 절차에 따라 다시 시작／로딩하세요. 신뢰, hooks 활성화와 코드 호환성은 Agent가 제어합니다. 관리 작업은 hook command를 실행하거나 네이티브 신뢰를 자동 변경하지 않습니다.

명령​

hook 관리 중단​

소스 필드​

Oh My Pi code bindings​

네이티브 저장 위치​

Agent의 다른 계정​

Git hooks​

프로젝트, 충돌과 복원​

명령