스킬

사용자 정의 기술 작성

Showly에 연결된 모든 상담원이 사용할 수 있도록 자체 워크플로를 래핑하세요.

공식 Showly 스킬은 표준 게시 루프를 다룹니다. 팀에는 브랜딩 QA, 콘텐츠 규정 준수 검사, 자동화된 현지화 등 스택에 특정한 _추가_ 워크플로가 있는 경우가 많습니다. Showly에 연결된 모든 에이전트가 선택할 수 있는 맞춤형 스킬로 이를 배송할 수 있습니다.

스킬을 작성하는 경우와 스크립트만 작성하는 경우

다음과 같은 경우 스킬을 작성하세요.

워크플로는 _의도적으로 트리거됩니다_(사용자가 "배포" 또는 "번역"이라고 말하면 상담원이 이를 알아야 함).
워크플로에는 인코딩할 가치가 있는 거부/안전 패턴이 있습니다(검사 없이 배송하지 말고 정지 중에 게시하지 마세요).
팀 구성원이나 프로젝트 전체에서 재사용이 가능합니다.

다음과 같은 경우에 스크립트를 작성하세요.

워크플로는 에이전트 대화가 아닌 CI에서 실행됩니다.
일회용품이니 버리세요.

Showly 인식 스킬의 분석

스킬은 매니페스트와 프롬프트를 더한 것입니다. 최소값:

name: my-publish-with-localize
description: |
  Use when the user wants to publish a Showly site that has
  user-facing strings. This skill localizes new/changed strings,
  runs `run_checks`, then proposes a publish.
trigger:
  intents:
    - "publish"
    - "ship"
    - "release"
mcp:
  required:
    - showly
    - localizer
prompt: |
  1. Call mcp__showly__get_site_context to read the change.
  2. Identify new/changed strings in any *.tsx files.
  3. Call mcp__localizer__translate for each new string.
  4. Apply translations via mcp__showly__apply_site_patch.
  5. Call mcp__showly__create_preview.
  6. Call mcp__showly__run_checks (include `i18n-coverage`).
  7. If checks pass, call mcp__showly__request_publish.
  8. Refuse to call request_publish if any check failed.

필드 참조

필드	유형	필수	메모
`name`	문자열	예	스킬 식별자입니다. 여러 버전에서 안정적입니다. 이름을 바꾸는 것은 획기적인 변화입니다.
`description`	문자열	예	에이전트가 이 스킬에 도달해야 하는 시기입니다. 최종 사용자가 아닌 상담원을 위해 작성되었으며 트리거 상황을 설명합니다.
`trigger.intents`	문자열 배열	아니	스킬을 나타내는 문구(예: `"publish"`, `"ship"`) 생략하면 에이전트는 `description`에만 의존하여 호출 시기를 결정합니다.
`mcp.required`	문자열 배열	아니	스킬을 실행하려면 연결되어야 하는 MCP 서버(예: `showly` 및 사용자 서버).
`prompt`	문자열	예	번호가 매겨진 단계로 작성된 상담원이 따르는 지침입니다.

prompt 단계는 Showly에 의해 실행되지 않습니다. 이는 에이전트에 전달되는 지침입니다. 에이전트는 이를 순서대로 읽고 명명된 MCP 도구 자체(예: mcp__showly__get_site_context, mcp__showly__apply_site_patch)를 호출하여 인코딩한 거부 확인을 적용합니다. 에이전트가 실제 도구를 호출할 수 있도록 MCP 도구 참조의 정확한 도구 식별자를 사용하세요. 라이브 사이트의 프로덕션 경로는 항상 request_publish이며, 사람이 게시를 완료하려면 webApprovalUrl를 반환합니다. 스킬은 자체적으로 프로덕션에 게시할 수 없습니다.

전체 매니페스트 스키마(공식 스킬 선박의 manifest.json 입력)를 보려면 스킬 설치를 참조하세요.

거절 패턴

유용한 스킬의 가장 어려운 부분은 _하지 말아야 할 것_을 인코딩하는 것입니다. 공식 Showly 스킬 예시:

최근 미리보기 없이는 게시할 수 없습니다: 이 대화에서 create_preview가 호출되지 않은 경우 request_publish를 거부하세요.
정지 중에는 게시하지 않음: 작업 영역 정책에 "병합 동결 활성"이라고 표시되면 동결 알림을 거부하고 연결합니다.
깨진 게시 없음: MCP에는 긴급 우회가 없습니다. 사용자가 수정이 긴급하다고 말하면 미리보기를 만들고 확인을 실행하고 승인을 요청하세요.

각 도구 호출 전에 상담원이 확인해야 하는 글머리 기호로 메시지에 이를 인코딩합니다.

분포

세 가지 옵션:

개인 — ~/.claude/skills/에 스킬을 추가합니다. 오직 당신만이 그것을 볼 수 있습니다.
작업 공간 — .showly/skills/ 아래의 Showly 사이트 저장소에 커밋합니다. 작업공간 액세스 권한이 있는 사람은 누구나 자동으로 설치합니다.
공개 — 스킬을 자체 패키지로 게시하고 공식 Showly 클라이언트가 설치된 것과 같은 방식으로 다른 사람들이 설치하도록 합니다: npx @showly/mcp-server install --to <claude-code|codex|stdout>. 이는 표준 설치 명령입니다. 작성자와 설치 프로그램이 동일한 경로에 있도록 동일한 모양을 따릅니다.

위의 설치 경로는 스킬 설치: 표준 명령은 npx @showly/mcp-server install(@showly/mcp-server 패키지, bin showly-mcp)과 일치합니다. 작성자와 설치자가 하나의 경로를 따르도록 사용자 정의 스킬에 동일한 모양을 사용하십시오.

버전 관리

기술은 semver를 따릅니다. 주요 변경 사항(의도 이름 바꾸기, 도구 단계 제거)은 새로운 주요 내용을 제공합니다. showly-mcp(@showly/mcp-server에서 제공한 저장소)를 실행하여 설치 및 업데이트합니다. 다시 실행하면 npx @showly/mcp-server install 최신 버전이 선택됩니다.

다음 읽을 곳

MCP 도구 참조 — 각 도구의 기능과 연결 방법.
스킬 모델 — 스킬이 존재하는 이유와 원시 도구와의 차이점.