Install
npx skills@latest add warpdotdev/common-skills --skill '*' --agent warp --global누구에게 맞나
재사용 가능한 대리 워크플로, 약속, 조작 절차가 있고 여러 저장소에서 쓸모 있어 단일 저장소에 묶지 않고 공유 위치에 두어야 할 때 이 저장소를 쓴다. 두는 것은 「저장소 횡단 공통」 agent skills이며 어떤 프로젝트의 사적 스크립트가 아니다.
전제: 현재 대리는 설명대로 Warp다. 권장 설치 명령은 --agent warp --global을 단다. 이 명령을 지명하지 않은 다른 대리용으로 바꾸지 말 것. 스킬은 정말 둘 이상 저장소에 쓸모 있어야 한다. 한 저장소만 필요하면 이 공유 라이브러리에 억지로 넣지 말 것.
작성 측: 각 스킬은 .agents/skills/ 아래 디렉터리 하나를 독점한다. 필수 파일은 YAML frontmatter가 있는 SKILL.md다. 적어도 kebab-case name과, 무엇을 하는지·언제 쓸지를 쓰는 description. 다른 필수 필드를 만들지 말 것.
3분 만에 첫 시도 끝내기
공식 페이지:
https://github.com/warpdotdev/common-skills
권장 설치(--global은 이 기기 전역 스킬을 바꾼다. 저장소와 --agent warp를 확인한 뒤 실행):
npx skills@latest add warpdotdev/common-skills --skill '*' --agent warp --global
설명은 npx가 디스크의 어느 디렉터리에 넣는지를 쓰지 않았다. 설치 후 Warp로 돌아가 이 common skills를 고를 수 있는지 본다. 저장소 안의 .agents/skills/를 당신 기기의 설치 경로로 보지 말 것.
처음에는 공유 스킬 내용을 바꾸지 말고 fork도 하지 말 것. 위험 낮은 읽기 전용 작업 하나를 고르고, Warp가 설치된 스킬의 description으로 쓸지 판단하게 한다.
성공 신호: Warp에서 방금 설치한 스킬이 보이고, 보조는 description으로 호출 여부를 정한다. 명령이 실패하면 멈춘다. --agent warp를 빼지 말고 나타나지 않은 설치기로 바꾸지 말 것.
사용 사례
사례 1: Warp 전역에 common skills 전부 넣기. 위의 add ... --skill '*' --agent warp --global를 실행한다. --skill '*'는 이 공유 라이브러리의 스킬 집합이다. 설치 후 Warp가 고를 수 있는지만 대조한다. 동시에 지명하지 않은 사본을 한 벌 더 넣지 말 것.
사례 2: 나중에 설치된 Warp 스킬 업데이트. 설명의 명령은:
npx skills@latest update --global --agent warp
역시 전역 쓰기다. 현재 Warp 환경을 확인한 뒤 실행하고 스킬을 여전히 고를 수 있는지 본다. 공유 스킬에 저장소 특례가 필요하면 설명은 공유 스킬을 fork하지 말고 작은 local companion skill을 더하라고 한다. 변경이 모든 저장소에 쓸모 있는 경우는 제외. 첫 업데이트에서는 fork하지 말 것.
사용 경계
주 경로 근거는 Warp뿐이다. add와 update 모두 --agent warp --global을 단다. 다른 대리에 씌우지 말 것.
저장소 안 배치 근거는 .agents/skills/와 SKILL.md의 name / description까지다. 그 디렉터리를 npx의 로컬 설치 위치로 쓰지 말 것.
저장소가 정말 필요한 스킬만 우선 복제한다. 특례는 local companion. 쉽게 fork하지 말 것.
설명에 언어 범위, 가격, 다른 대리 설치 명령은 없다. 근거 없는 항목은 모름으로 둔다.