스킬

Showly 스킬

상담원 기능에 대한 사용자에게 표시되는 인터페이스로서의 기술입니다.

Showly는 작업 지향 프롬프트로 MCP 서버를 래핑하는 공식 Claude Code 스킬을 게시합니다. 스킬은 에이전트에서 Showly를 사용하는 가장 쉬운 방법입니다. 스킬을 설치하면 에이전트는 Showly 도구를 호출할 시기를 자동으로 인식하고 프롬프트는 이미 게시 루프 규칙을 인코딩합니다.

스킬이 필요한 이유

원시 MCP 서버는 에이전트 도구를 제공합니다. 스킬은 상담원에게 스킬을 사용해야 하는 _언제_와 _이유_를 가르쳐줍니다. Showly 스킬에는 다음이 포함됩니다.

  • 의도에 따라 실행되는 설명('배포', '게시', '미리보기', '표시').
  • create_change_plan → apply_site_patch → create_preview → run_checks → request_publish를 연결하는 내부 스크립트이므로 에이전트가 그럴 필요가 없습니다.
  • 미리보기 URL을 읽고 다시 보고하는 확인 단계입니다.
  • 에이전트가 자체적으로 수행해서는 안 되는 작업에 대한 거부 패턴(프로덕션 게시는 항상 승인 게이트를 통해 사람에게 전달됩니다).

공식 스킬 설치

Claude Code(또는 Codex)에서:

npx @showly/mcp-server install --to claude-code   # or --to codex

이는 @showly/mcp-server 패키지에서 설치되고 Showly MCP 서버를 등록합니다. 설정할 토큰이 없습니다. Showly 도구를 처음 호출하면 에이전트가 브라우저 탭을 열어 로그인하고 액세스를 승인하고 Showly 범위가 지정된 토큰을 에이전트에게 직접 발급합니다(표준 MCP OAuth). 전체 핸드셰이크 및 브라우저 없는 폴백에 대해서는 스킬 설치를 참조하세요.

스킬이 하는 일이 원시 MCP에서는 할 수 없는 일입니다

  • 저장소의 GitHub 원격을 Showly 작업 공간의 사이트와 일치시켜 현재 작업 디렉토리에서 활성 사이트를 자동 검색합니다.
  • Playwright MCP도 설치된 경우 mcp__playwright_browser_take_screenshot의 스크린샷과 함께 미리보기 인라인을 렌더링합니다.
  • 최근 통과된 미리보기 없이 게시 요청을 거부합니다. 프로덕션 게시는 항상 request_publish 및 사람의 승인을 거쳐야 합니다.

자동 검색

체크아웃된 저장소 내에서 에이전트를 실행하면 스킬은 저장소의 origin 원격을 읽고 작업 공간에서 repositoryUrl가 일치하는 사이트를 찾습니다. 일치하는 사이트의 siteId는 get_site_context, apply_site_patch, create_preview 및 나머지 루프의 대상이 되므로 직접 사이트 이름을 지정할 필요가 거의 없습니다.

리모컨과 일치하는 사이트가 없으면 스킬은 추측하는 대신 하나를 선택하거나 생성하도록 요청합니다. 여러 사이트에서 리모컨을 공유하는 경우 명확하게 하라는 메시지가 표시됩니다.

가드레일 게시

프로덕션은 에이전트에서 직접 게시되지 않습니다. 게시를 요청하기 전에 Skill은 다음을 확인합니다.

  • 사이트에 대한 최근 ready 미리보기 배포가 있습니다.
  • run_checks가 해당 미리보기에 대해 통과되었습니다.

해당 값이 유지되면 스킬이 request_publish를 호출하여 webApprovalUrl 딥 링크를 반환합니다. 관리자 권한이 있는 사람이 웹 UI에서 요청을 승인합니다. 에이전트는 승인 상태만 폴링합니다. 인간의 단계 없이 프로덕션으로 승격되는 에이전트 경로는 없습니다.

다음