Skip to Content
Skip to Content
Skill 관리

Skill 관리

조직에서 접근 가능한 Skill을 찾고, 라이브러리의 Skill을 복제하거나 로컬 파일로 등록할 수 있습니다. 조직 공용 Skill의 관리와 GitHub 연동은 AI Operator 권한이 필요합니다.

Skill 찾기

aipctl skill list aipctl skill list --search "보고서" aipctl skill get SKILL_ID

목록에서 ID를 확인한 뒤 get으로 상세 정보를 조회합니다. 상세 화면의 파일 목록은 최대 10개이므로 Skill에 포함된 전체 파일이 표시되지 않을 수 있습니다.

라이브러리에서 복제하기

aipctl skill library --search "보고서" aipctl skill clone SKILL_ID

라이브러리에서 선택한 Skill을 현재 조직으로 복제합니다. 한 번에 최대 5개 ID를 전달할 수 있습니다. 여러 개를 복제했다면 항목별 성공 여부와 새 ID를 확인하세요.

기본 제공 Skill을 조회하고 복제하려면 AI Operator 권한으로 실행합니다.

aipctl skill built-in --search "보고서" aipctl skill clone-built-in BUILT_IN_SKILL_ID

로컬 파일 등록하기

aipctl skill upload ./report-skill.zip aipctl skill list --search "report"

.zip 또는 .skill 파일을 지원합니다. 업로드가 완료되면 출력된 ID로 상세 정보를 확인하세요. 일반 Skill 명령과 조직 공용 Skill 관리 명령은 등록·접근 범위가 다르므로 목적에 맞는 명령을 선택합니다.

이름이 같은 Skill이 있으면 등록이 거절됩니다. 기존 내용을 교체하려는 경우에만 다시 실행합니다.

aipctl skill upload ./report-skill.zip --overwrite

파일로 다운로드하기

다운로드할 수 있는 조직 Skill의 ID를 사용합니다. 목록에서 조회된다는 이유만으로 모든 Skill을 다운로드할 수 있는 것은 아닙니다.

aipctl skill download SKILL_ID -o ./downloads/report-skill.zip

CLI 다운로드는 최대 128 MiB·10분 범위에서 처리합니다. 크기나 시간 제한을 넘으면 파일을 성공적으로 받았다고 가정하지 말고, 오류 안내를 확인한 뒤 웹에서 다운로드하세요.

지정한 경로에 파일이 있으면 덮어씁니다. -o를 생략하면 현재 디렉터리에 원래 파일명으로 저장하므로 같은 이름의 파일이 없는지 먼저 확인하세요.

조직 공용 Skill 관리하기

AI Operator는 admin skill로 조직 공용 Skill을 조회·등록하고 라이브러리 공개 여부를 변경합니다.

aipctl admin skill list --search "보고서" aipctl admin skill get SKILL_ID aipctl admin skill upload ./report-skill.zip aipctl admin skill download SKILL_ID -o ./downloads/report-skill.zip aipctl admin skill publish SKILL_ID aipctl admin skill unpublish SKILL_ID

publish는 라이브러리에 공개하고, unpublish는 공개를 해제합니다. 변경 후 상세 정보에서 상태를 확인하세요.

조직 관리 명령에서도 기본 제공 Skill을 조회하고 복제할 수 있습니다.

aipctl admin skill built-in --search "보고서" aipctl admin skill clone-built-in BUILT_IN_SKILL_ID aipctl admin skill list

skill built-in·skill clone-built-in과 마찬가지로 AI Operator 권한이 필요합니다. 복제는 한 번에 최대 5개 ID를 받으며, 결과에서 항목별 성공 여부와 새 Skill ID를 확인합니다.

GitHub에서 가져오기

AI Operator는 저장소 또는 Skill 폴더 주소로 조직 Skill을 가져올 수 있습니다. 아래 GITHUB_URL을 실제 주소로 바꿉니다.

aipctl admin skill github inspect GITHUB_URL aipctl admin skill github import GITHUB_URL aipctl admin skill list

먼저 inspect로 저장소 정보를 확인한 뒤 import를 실행합니다. 같은 이름을 교체할 때만 import에 --overwrite를 추가하세요.

등록 후 GitHub의 변경 사항을 확인하고 반영할 수 있습니다.

aipctl admin skill github sync SKILL_ID aipctl admin skill github sync SKILL_ID --apply

첫 번째 명령은 변경 사항만 확인합니다. 실제로 업데이트하려면 --apply가 필요합니다. 반영 후 get으로 Skill을 다시 확인하세요.

비공개 저장소에 PAT가 필요하면 토큰이 들어 있는 환경 변수의 이름을 전달합니다.

aipctl admin skill github inspect GITHUB_URL --pat-env GITHUB_PAT aipctl admin skill github import GITHUB_URL --pat-env GITHUB_PAT

먼저 사용하는 셸에서 GITHUB_PAT 환경 변수를 설정하세요. --pat-env에는 토큰 원문이 아닌 변수 이름을 입력합니다. 토큰이 포함된 명령·화면·로그는 공유하지 마세요.

GitHub 인증정보 변경·삭제하기

비공개 저장소에서 가져온 Skill을 나중에도 동기화하려면 해당 Skill에 사용할 PAT를 저장할 수 있습니다. 이 작업도 AI Operator 권한이 필요합니다.

aipctl admin skill github credentials set SKILL_ID --pat-env GITHUB_PAT aipctl admin skill get SKILL_ID --json aipctl admin skill github sync SKILL_ID

SKILL_ID에는 GitHub에서 가져온 조직 Skill의 ID를 넣습니다. 환경 변수 GITHUB_PAT에는 실제 저장소를 읽을 수 있는 토큰을 준비하세요. set은 해당 Skill에 저장된 인증정보를 변경합니다. get의 GitHub 정보에서 PAT 설정 여부를 확인하고, sync로 변경 조회가 되는지 확인합니다. 토큰 원문은 조회 결과로 확인하지 않습니다.

저장된 PAT를 더 이상 사용하지 않으려면 삭제합니다.

aipctl admin skill github credentials clear SKILL_ID aipctl admin skill get SKILL_ID --json

clear는 해당 Skill에 저장된 PAT만 제거하며 Skill 자체를 삭제하지 않습니다. GitHub에서 토큰을 폐기하는 작업은 별도로 진행해야 합니다. 인증정보를 지운 뒤 비공개 저장소를 동기화하려면 유효한 PAT를 다시 저장해야 할 수 있습니다.

Skill 삭제하기

상세 정보로 대상을 확인한 뒤 삭제합니다. 조직 공용 Skill은 admin skill delete를 사용합니다.

aipctl skill get SKILL_ID aipctl skill delete SKILL_ID --force

조직 공용 Skill을 삭제할 때는 다음 명령을 사용합니다.

aipctl admin skill get SKILL_ID aipctl admin skill delete SKILL_ID --force aipctl admin skill list

--force는 삭제하겠다는 명시적 확인입니다. 다른 작업에서 사용하는 Skill인지 확인한 뒤 실행하세요. 명령이 중단되어 결과를 알 수 없다면 목록을 다시 조회한 후 재실행 여부를 판단합니다.

Last updated on