스킬 작성 가이드

1. 개인 설정은 SKILL.md에 하드코딩하지 마세요

팀명·폴더 경로·결재선·양식 번호처럼 사람마다 다른 값이 SKILL.md 본문에 박혀 있으면, 동료가 설치한 뒤 일일이 고쳐 써야 하고 — 새 버전이 나오면 고친 게 전부 날아가요. 운영 중 가장 흔한 사고입니다.

# SKILL.md
보고서 상단에 "DX1팀 이상권"을
기재하고, 결과는
C:\Users\sklee\보고서\에
저장한다.

# SKILL.md
같은 폴더의 config.md에서
팀명·작성자·저장 경로를 읽어
보고서에 반영한다.

# config.md (개인 설정)
팀명: DX1팀
작성자: 이상권
저장 경로: C:\...\보고서\

이렇게 분리하면 동료는 config.md만 고쳐 쓰면 되고, 새 버전이 나와도 본체(SKILL.md)만 갱신되니 개인 설정이 살아남아요. 설치 스크립트도 업데이트 전 기존 폴더를 .octo-backups에 백업해 두니 이중 안전망이 됩니다.

2. 버전은 약속이에요

같은 이름으로 다시 올리면 버전이 올라가고, 설치한 동료들에게 알림이 가요. 버전 증가 폭은 받는 사람의 기대를 정합니다.

• major — 사용법이 달라져요. 동료가 쓰던 방식이 깨질 수 있을 때.
• minor — 기능이 추가되거나 좋아졌어요. 기존 사용법은 그대로.
• patch — 오타·사소한 수정. (변형 작성자에게는 알림이 가지 않아요)

변경 메모(changelog)를 꼭 적어주세요. “표 형식 출력 추가” 한 줄이면 동료가 업데이트할지 판단할 수 있어요.

3. 고쳐 쓰고 싶다면 — 변형(⑂)으로

남의 스킬을 내 상황에 맞게 크게 바꾸고 싶다면, 복사해서 따로 올리지 말고 상세 페이지의 ⑂ 변형 만들기를 쓰세요. 원본과 연결돼서:

• 원본이 업데이트되면 알림을 받아 내 변형에 반영할 수 있어요
• 원작자에게 +5pt가 가요 — 변형은 표절이 아니라 칭찬이에요
• 이름은 원본이름-내변형명 처럼 지으면 알아보기 좋아요 (권장이지 강제는 아니에요)
• 변형이 설치 10회를 달성하면 “검증된 변형” 보너스 +10pt

단, 오타 수정 수준이라면 변형 대신 원작자에게 알려주세요 — 원본이 좋아지는 게 모두에게 이득이에요.