스킬 묶음 만들고 게시하기

skills.parallax.kr 의 스킬 만들기에서 스킬 묶음을 만들어 게시할 수 있습니다. 로그인이 필요하고, 먼저 만드는 방식을 고릅니다.

• 직접 작성하기: 스킬을 한 개 이상 직접 써서 묶음으로 게시합니다.
• GitHub 에서 가져오기: 공개 저장소에 있는 SKILL.md 를 모두 읽어와 묶음으로 만듭니다.

직접 작성할 때 무엇을 입력하나요

묶음 정보와 스킬 목록을 채웁니다.

묶음 정보

• 이름(60자 이내), 한 줄 소개(120자 이내), 카테고리
• 태그 최대 10개
• 설명(마크다운 사용 가능, 5,000자 이내)
• 사용 방법(선택, 최대 3단계)
• 시작 문구 최대 4개
• 아이콘과 미리보기 이미지(PNG, JPG, WebP, 장당 5MB 이하, 미리보기는 최대 6장)
• 공개 범위(공개 또는 비공개)

스킬(묶음 하나에 1개 이상, 최대 50개)

• 이름: 영문 소문자, 숫자, 하이픈만 쓸 수 있고 64자 이내입니다. 하이픈을 연달아 쓰거나 맨 앞과 끝에 둘 수 없고, 묶음 안에서 이름이 겹치면 안 됩니다. 예: market-research-brief
• 언제 쓰는지: 1,024자 이내입니다. 채팅 모델이 이 설명을 보고 스킬을 불러올지 정하므로 어떤 요청에 쓰는지 구체적으로 적어 주세요.
• 지침(SKILL.md 본문): 20,000자 이내이며 마크다운을 쓸 수 있습니다.

지침 내용은 누구에게 보이나요

공개 묶음의 설명과 스킬 지침 전문은 묶음 페이지에서 누구나 볼 수 있고 복사할 수 있습니다. 비밀번호, API 키, 개인정보처럼 공개되면 안 되는 내용은 지침에 넣지 마세요.

GitHub 에서 가져오려면 어떻게 하나요

1. GitHub 에서 가져오기를 고릅니다.
2. 저장소 주소를 넣습니다. owner/repo, 저장소 URL, 또는 https://github.com/owner/repo/tree/main/skills 같은 폴더 URL 을 쓸 수 있습니다. 공개 저장소만 가져올 수 있습니다.
3. 등록 목적(내 스킬 공유 또는 제3자 스킬 소개)을 고르고 미리보기를 누릅니다.
4. 가져올 스킬과 제외된 스킬, 제외 사유, 라이선스를 확인합니다.
5. 묶음 정보를 보강한 뒤 게시합니다.

가져온 묶음에는 원 출처 저장소 링크와 가져온 시점의 커밋이 함께 저장되어 묶음 페이지에 표시됩니다.

가져올 수 있는 SKILL.md 는 어떤 형식인가요

지정한 경로 아래에 있는 모든 SKILL.md 파일을 스킬로 읽습니다. 파일 맨 위 frontmatter 에 다음 값이 있어야 합니다.

• name: 직접 작성할 때와 같은 이름 규칙(영문 소문자, 숫자, 하이픈, 64자 이내)
• description: 언제 쓰는지 설명(1,024자 이내)

다음 스킬은 미리보기에서 사유와 함께 제외됩니다.

• 이름이 규칙에 맞지 않거나 묶음 안에서 겹치는 스킬
• 설명이 없거나 frontmatter 를 읽을 수 없는 스킬
• metadata 에 internal: true 로 표시된 스킬
• 본문이 20,000자를 넘는 스킬
• 묶음당 50개를 넘는 스킬
• (제3자 소개만) 라이선스가 허용되지 않거나 확인되지 않는 스킬

스킬 폴더 안의 텍스트 파일(.md, .txt, .json, .yaml, .yml, .csv)은 참고 파일로 함께 가져옵니다. 파일당 100KB, 묶음 전체 2MB 까지이며 이를 넘는 파일은 가져오지 않습니다.

스킬 폴더에 scripts/ 가 있으면 스킬 내용은 가져오지만 스크립트는 Parallax 에서 실행되지 않습니다. 묶음 페이지에도 이 점이 표시됩니다.

원본 저장소가 바뀌면 자동으로 반영되나요

자동으로 반영되지 않습니다. 가져올 때의 커밋이 그대로 유지되고, 게시한 분이 묶음 편집 화면에서 다시 가져오기를 누를 때만 최신 커밋으로 갱신됩니다.

• 내 스킬 공유로 가져온 묶음: 저장소의 최신 내용으로 스킬을 덮어씁니다. Parallax 에서 편집한 스킬 내용은 사라지므로 화면에서 먼저 경고합니다.
• 제3자 스킬 소개 묶음: 원본 저장소의 최신 커밋으로 스킬을 갱신합니다. 허용되지 않는 라이선스로 바뀐 스킬은 빠지고, 남는 스킬이 하나도 없으면 다시 가져오기가 거절되며 기존 내용이 유지됩니다.

저장소에서 사라진 스킬은 다시 가져올 때 묶음에서도 빠집니다.

내 스킬 공유와 제3자 스킬 소개는 무엇이 다른가요

	내 스킬 공유	제3자 스킬 소개
대상	내가 만들었거나 기여한 스킬	다른 사람이 공개한 대중적인 스킬
만드는 방식	직접 작성 또는 GitHub 가져오기	GitHub 가져오기만
공개 화면의 표시	작성자로 내 이름	내 이름 대신 원 출처(GitHub 소유자와 저장소)
라이선스	확인하지 않음(본인 선언)	허용형 라이선스의 스킬만 가져옴
스킬 내용 편집	모두 편집 가능	원본에 잠겨 편집 불가
같은 출처 중복	막지 않음	이미 공개된 출처는 다시 소개 불가

직접 작성한 묶음은 언제나 내 스킬 공유입니다. 등록 목적은 게시한 뒤에 바꿀 수 없습니다.

제3자 스킬 소개에는 어떤 규칙이 있나요

허용되는 라이선스: MIT, Apache-2.0, BSD-2-Clause, BSD-3-Clause, ISC, 0BSD, Unlicense, CC0-1.0, CC-BY-4.0 입니다. 스킬마다 SKILL.md 의 license 값, 스킬 폴더의 LICENSE 파일, 저장소 라이선스 순으로 확인합니다. 독점(proprietary) 라이선스이거나 라이선스를 확인할 수 없는 스킬은 제외되고, 가져올 수 있는 스킬이 하나도 없으면 가져오기가 거절됩니다.

같은 출처는 한 번만: 같은 출처가 이미 갤러리에 공개되어 있으면 제3자 소개로 다시 등록할 수 없고, 미리보기에서 기존 묶음 링크를 안내합니다. 비공개로 둔 제3자 소개 묶음을 공개로 바꿀 때도 같은 검사를 합니다. 내 스킬 공유로 가져오는 것은 막지 않습니다.

등록한 사람은 표시되지 않습니다: 카드, 묶음 페이지, 크리에이터 페이지에는 원 출처가 표시되고, 등록한 분의 이름은 본인의 내 스킬 화면에만 보입니다. 제3자 소개 묶음은 크리에이터 페이지와 추천 크리에이터 집계에도 포함되지 않습니다.

편집할 수 있는 항목과 잠긴 항목: 묶음 이름과 설명, 스킬의 이름, 설명, 지침, 참고 파일은 원본에 잠겨 있습니다. 묶음 이름과 설명은 가져온 내용을 바탕으로 자동으로 정해집니다. 한 줄 소개, 카테고리, 태그, 사용 방법, 시작 문구, 이미지, 공개 범위는 편집할 수 있습니다.

공개와 비공개는 어떻게 다른가요

• 공개: 누구나 갤러리에서 찾아 추가할 수 있습니다.
• 비공개: 본인만 보고 사용할 수 있습니다. 본인이 추가해 켜 두면 본인의 채팅에서는 사용됩니다. 편집 화면에서 언제든 공개로 바꿀 수 있습니다.

하루에 몇 개까지 만들 수 있나요

최근 24시간 동안 20개까지 만들 수 있습니다. 직접 작성, GitHub 가져오기, 복제가 모두 포함되고, 만든 뒤 삭제한 묶음도 셉니다.

다른 사람의 스킬을 고쳐서 쓰고 싶어요

묶음 페이지의 복제하기를 누르면 편집할 수 있는 비공개 사본이 내 스킬로 만들어집니다. 사본에는 원본 출처가 함께 표시됩니다. 원하는 대로 고친 뒤 비공개로 쓰거나 공개하실 수 있습니다.

게시한 묶음을 고치거나 삭제하려면

내 스킬 > 게시한 스킬에서 편집 또는 삭제를 누릅니다. 편집 화면에서도 삭제할 수 있습니다.

삭제한 묶음은 갤러리에서 사라지고, 이 묶음을 추가해 둔 분들의 채팅에서도 더 이상 쓰이지 않습니다. 삭제는 되돌릴 수 없습니다.

도움이 필요하면

1:1 문의를 남겨 주세요. 서비스는 Skills 를 선택하시고, 묶음 페이지 주소(skills.parallax.kr/s/...), GitHub 가져오기라면 입력한 저장소 주소와 고른 등록 목적, 화면에 표시된 오류 문구나 제외 사유를 함께 적어 주세요.