Agent Skill
2/7/2026

skill-sync

팀 Private GitHub 저장소에서 스킬을 동기화합니다. 전체 또는 특정 스킬만 선택하여 가져올 수 있습니다. "스킬 동기화", "팀 스킬 가져와", "skill sync", "팀 저장소 동기화" 등의 요청 시 사용하세요.

F
fnf
1GitHub Stars
1Views
npx skills add fnf-ax-team/CC_ax_team

SKILL.md

Nameskill-sync
Description팀 Private GitHub 저장소에서 스킬을 동기화합니다. 전체 또는 특정 스킬만 선택하여 가져올 수 있습니다. "스킬 동기화", "팀 스킬 가져와", "skill sync", "팀 저장소 동기화" 등의 요청 시 사용하세요.

name: skill-sync description: | 팀 Private GitHub 저장소에서 스킬을 동기화합니다. 전체 또는 특정 스킬만 선택하여 가져올 수 있습니다. "스킬 동기화", "팀 스킬 가져와", "skill sync", "팀 저장소 동기화" 등의 요청 시 사용하세요.

Skill Sync - 팀 저장소 스킬 동기화 (선택적)

팀 Private GitHub 저장소(CC_ax_team)에서 최신 스킬을 가져와 team/ 폴더에 동기화합니다. 전체 동기화 또는 특정 스킬만 선택하여 가져올 수 있습니다. 기존 로컬 스킬은 그대로 유지되며, 팀 스킬과 분리 관리됩니다.

When to Use This Skill

다음과 같은 요청 시 이 스킬을 사용하세요:

  • "팀 스킬 동기화해줘"
  • "CC_ax_team에서 스킬 가져와"
  • "skill sync"
  • "팀 저장소 최신 스킬 받아줘"
  • "팀 스킬 업데이트해줘"
  • "특정 스킬만 가져와줘"

Configuration

TEAM_REPO_URL: https://github.com/davidcho0326/CC_ax_team.git
SKILLS_BASE_DIR: C:/Users/AC1059/.claude/skills/
TEAM_SKILLS_DIR: C:/Users/AC1059/.claude/skills/team/
TEMP_CLONE_DIR: C:/Users/AC1059/.claude/skills/.team_repo_temp/

Your Task

Step 1: 팀 저장소 동기화

  1. TEMP_CLONE_DIR 존재 확인

    # 폴더가 없으면 클론
    if [ ! -d "C:/Users/AC1059/.claude/skills/.team_repo_temp" ]; then
      git clone https://github.com/davidcho0326/CC_ax_team.git "C:/Users/AC1059/.claude/skills/.team_repo_temp"
    else
      # 폴더가 있으면 풀
      cd "C:/Users/AC1059/.claude/skills/.team_repo_temp" && git pull
    fi
    
  2. Git Credential Manager가 자동으로 인증 처리

    • Windows Credential Manager에 저장된 GitHub 자격증명 사용
    • 추가 로그인 없이 자동 진행

Step 2: 스킬 목록 파싱 ⭐

팀 레포에서 사용 가능한 스킬 목록을 조회합니다.

  1. 스킬 폴더 목록 조회

    ls "C:/Users/AC1059/.claude/skills/.team_repo_temp/skills/"
    
  2. 각 스킬의 설명 추출 각 스킬 폴더의 SKILL.md 파일에서 description 필드를 읽어 사용자에게 보여줄 정보를 수집합니다.

    # 예시: 스킬별 설명 추출
    for skill_dir in C:/Users/AC1059/.claude/skills/.team_repo_temp/skills/*/; do
      skill_name=$(basename "$skill_dir")
      echo "- $skill_name"
    done
    
  3. 스킬 목록 정리 파싱된 정보를 테이블 형식으로 정리:

    스킬명설명
    ceo-ppt회장님 보고용 PPT 자동 생성
    kpop-snsK-pop SNS 계정 검색
    llm-api-docsLLM API 문서 수집
    session-summary세션 요약 생성
    skill-push스킬 GitHub 푸시
    skill-sync팀 스킬 동기화

Step 3: 사용자 선택 요청 ⭐

AskUserQuestion 도구를 사용하여 사용자에게 동기화할 스킬을 선택받습니다.

중요: 반드시 AskUserQuestion 도구를 호출하여 사용자의 선택을 받아야 합니다.

질문: "어떤 스킬을 동기화할까요?"
헤더: "스킬 선택"
멀티셀렉트: true (여러 스킬 선택 가능)

옵션:
1. "전체 동기화 (Recommended)" - 팀 레포의 모든 스킬을 가져옵니다
2. "ceo-ppt" - 회장님 보고용 PPT
3. "kpop-sns" - K-pop SNS 검색
4. "llm-api-docs" - LLM API 문서 수집
5. "session-summary" - 세션 요약 생성
6. "skill-push" - 스킬 GitHub 푸시
7. "skill-sync" - 팀 스킬 동기화

AskUserQuestion 도구 호출 예시:

{
  "questions": [{
    "question": "어떤 스킬을 동기화할까요?",
    "header": "스킬 선택",
    "multiSelect": true,
    "options": [
      {"label": "전체 동기화 (Recommended)", "description": "팀 레포의 모든 스킬을 가져옵니다"},
      {"label": "ceo-ppt", "description": "회장님 보고용 PPT"},
      {"label": "kpop-sns", "description": "K-pop SNS 검색"},
      {"label": "llm-api-docs", "description": "LLM API 문서 수집"},
      {"label": "session-summary", "description": "세션 요약 생성"},
      {"label": "skill-push", "description": "스킬 GitHub 푸시"},
      {"label": "skill-sync", "description": "팀 스킬 동기화"}
    ]
  }]
}

Step 4: 선택된 스킬 복사

사용자의 선택에 따라 스킬을 복사합니다.

  1. team/ 폴더 생성 확인

    mkdir -p "C:/Users/AC1059/.claude/skills/team/"
    
  2. 선택에 따른 복사 실행

    "전체 동기화" 선택 시:

    cp -r "C:/Users/AC1059/.claude/skills/.team_repo_temp/skills/"* "C:/Users/AC1059/.claude/skills/team/"
    

    특정 스킬 선택 시 (예: ceo-ppt, kpop-sns):

    cp -r "C:/Users/AC1059/.claude/skills/.team_repo_temp/skills/ceo-ppt" "C:/Users/AC1059/.claude/skills/team/"
    cp -r "C:/Users/AC1059/.claude/skills/.team_repo_temp/skills/kpop-sns" "C:/Users/AC1059/.claude/skills/team/"
    
  3. 복사 결과 확인

    ls -la "C:/Users/AC1059/.claude/skills/team/"
    

Step 5: 결과 리포트 출력

다음 형식으로 결과를 사용자에게 보고:

## ✅ 팀 스킬 동기화 완료

- **동기화 일시**: YYYY-MM-DD HH:MM:SS
- **저장소**: CC_ax_team (Private)
- **브랜치**: main
- **동기화 모드**: 전체 / 선택적 (선택한 스킬 수)

### 동기화된 스킬
| 스킬 | 상태 | 설명 |
|------|------|------|
| ceo-ppt | ✅ 동기화됨 | 회장님 보고용 PPT |
| kpop-sns | ✅ 동기화됨 | K-pop SNS 검색 |
| ... | ... | ... |

### 디렉토리 구조
- **로컬 스킬**: ~/.claude/skills/ (루트)
- **팀 스킬**: ~/.claude/skills/team/

### 스킬 호출 방법
- 로컬 스킬: `/ceo-ppt` 또는 "PPT 만들어"
- 팀 스킬: `/team:ceo-ppt` 또는 "팀 ceo-ppt로 PPT 만들어"

Error Handling

인증 실패

Git 인증에 실패했습니다.
해결 방법:
1. Windows 자격 증명 관리자에서 GitHub 항목 확인
2. `git credential-manager` 설정 확인
3. GitHub 토큰 만료 여부 확인

네트워크 오류

네트워크 연결에 실패했습니다.
- 인터넷 연결 상태 확인
- VPN 연결 상태 확인 (회사 네트워크인 경우)

저장소 없음

저장소를 찾을 수 없습니다.
- 저장소 URL 확인: https://github.com/davidcho0326/CC_ax_team
- 저장소 접근 권한 확인

Important Notes

  1. 로컬 스킬은 절대 덮어쓰지 않음

    • 루트 폴더의 기존 스킬은 그대로 유지
    • 팀 스킬은 항상 team/ 폴더에만 저장
  2. 충돌 없음

    • 같은 이름의 스킬이 루트와 team/에 동시에 존재 가능
    • 루트 스킬이 우선, team: 접두사로 팀 버전 호출
  3. 자동 인증

    • Git Credential Manager가 설정되어 있으면 추가 인증 없이 진행
    • Private 저장소도 자동 접근 가능
  4. 선택적 동기화

    • 전체 동기화 또는 특정 스킬만 선택 가능
    • 사용자가 명시적으로 선택해야 복사 진행
    • "Other" 옵션으로 직접 스킬명 입력도 가능
Skills Info
Original Name:skill-syncAuthor:fnf