gws-slides

gws-slides 스킬 개요

gws-slides는 googleworkspace/cli 안에서 gws CLI를 통해 프레젠테이션을 읽고 쓰는 Google Slides 스킬입니다. 브라우저에서 Slides를 직접 손보지 않고도 덱을 확인하고, 새로 만들고, 구조화된 변경을 적용해야 하는 에이전트에게 가장 잘 맞습니다. “이 프레젠테이션을 프롬프트만으로 안전하게 업데이트해 달라”가 업무라면, gws-slides가 가장 적절한 출발점입니다.

gws-slides의 핵심 가치는, 일반적인 프롬프트가 올바른 요청 형태를 알아서 맞힐 거라고 가정하지 않고 Slides API를 명령 중심 워크플로로 노출한다는 데 있습니다. 프레젠테이션 업데이트는 종종 스키마에 민감하기 때문에 이 점이 중요합니다. 제목, ID, 페이지 리소스, 배치 작업은 유효한 파라미터가 있어야 하며, 그렇지 않으면 작업 전체가 실패할 수 있습니다. 또한 이 스킬은 전제 조건도 분명히 보여 줍니다. 인증, 전역 플래그, 보안 규칙을 위해 공유 gws-shared 설정이 반드시 필요합니다.

gws-slides가 필요한 경우

슬라이드 덱에 대해 API 기반 작업이 필요할 때 gws-slides를 사용하세요. 예를 들어 프레젠테이션을 만들거나, 현재 상태를 가져오거나, 페이지와 기타 프레젠테이션 리소스에 배치 업데이트를 적용하는 경우가 여기에 해당합니다. 일회성 카피라이팅보다 자동화, 반복 가능한 편집 워크플로, 에이전트 주도 유지보수 작업에 더 잘 맞습니다.

잘 맞는 상황

이미 Google Workspace CLI 생태계 안에서 작업하고 싶고, 구체적인 덱 ID나 제목, 혹은 편집 목표를 제공할 수 있다면 gws-slides 스킬을 선택하세요. 슬라이드 내용에 대한 제안만 필요한 것이 아니라, 결정론적인 변경이 필요할 때 특히 강한 선택입니다.

알아 두어야 할 주요 한계

이 스킬은 그 자체로 “처음부터 프레젠테이션을 디자인하는” 시스템은 아닙니다. 목표를 유효한 Slides API 요청으로 바꿔야 하며, 기본적인 조회를 넘어서는 작업이라면 실제로 실행하기 전에 메서드 스키마를 확인할 것으로 예상해야 합니다. 시각적 레이아웃 전략이 필요하고 API 실행이 목적이 아니라면, 일반적인 프롬프트 방식이 더 쉬울 수 있습니다.

gws-slides 스킬 사용법

gws-slides를 올바르게 설치하기

gws-slides 설치는 저장소의 CLI 패키지 흐름을 따르세요: npx skills add googleworkspace/cli --skill gws-slides. 설치 후에는 SKILL.md에 적힌 전제 조건을 확인해야 합니다. 인증과 공유 규칙을 위해 ../gws-shared/SKILL.md가 존재해야 합니다. 이 파일이 없으면 저장소에서는 gws generate-skills를 실행하라고 안내합니다.

먼저 올바른 파일부터 읽기

skills/gws-slides/SKILL.md부터 시작한 뒤, 그 파일이 참조하는 공유 스킬 파일을 읽으세요. 가장 빠른 순서는 다음과 같습니다.

1. SKILL.md에서 명령 형식과 리소스 목록 확인
2. ../gws-shared/SKILL.md에서 인증 및 보안 제약 확인
3. gws slides --help로 사용 가능한 리소스와 메서드 확인
4. 실제 요청을 만들기 전에 gws schema slides.<resource>.<method> 확인

이 순서는 가장 흔한 실패 모드인, 유효한 메서드에 잘못된 필드를 보내는 문제를 예방해 줍니다.

거친 목표를 쓸 수 있는 프롬프트로 바꾸기

좋은 gws-slides 요청은 리소스, 메서드, 결과를 분명하게 적습니다. “슬라이드를 고쳐줘” 대신, 예를 들어 “abc123 덱의 presentations.get 출력을 gws-slides로 확인한 다음, 제목을 바꾸고 첫 페이지 텍스트를 업데이트하는 batchUpdate 계획을 제안해 달라”처럼 말하세요. 덱 식별자, 정확한 변경 내용, 그리고 기존 레이아웃 유지나 내용 삭제 방지 같은 제약도 함께 넣어야 합니다.

스키마에서 명령으로 옮기기

이 스킬의 워크플로는 스키마 우선입니다. gws schema로 필수 파라미터, 객체 형태, 기본값을 확인한 다음, 의도한 변경을 CLI 플래그나 요청 본문으로 옮기세요. 특히 batchUpdate에서는 여러 작업이 함께 검증되며, 하나라도 잘못되면 배치 전체가 취소되므로 이 과정이 매우 중요합니다.

gws-slides 스킬 FAQ

gws-slides는 고급 사용자만 쓰나요?

아닙니다. 스키마를 읽고 그다음 행동하는 흐름을 따라갈 수 있다면 초보자도 사용할 수 있습니다. 일반 프롬프트보다 구조화되어 있지만, 바로 그 구조가 실수를 줄여 줍니다.

gws-slides는 일반 프롬프트와 어떻게 다른가요?

일반 프롬프트는 프레젠테이션이 어떤 모습이어야 하는지 설명할 수 있습니다. 반면 gws-slides는 실제로 프레젠테이션 리소스를 조회하고 gws를 통해 API 기반 변경을 실행할 수 있습니다. 그래서 실제 편집에는 더 적합하지만, 그만큼 유효한 식별자와 메서드 수준의 세부 정보를 반드시 제공해야 합니다.

언제 gws-slides를 쓰지 않아야 하나요?

창의적인 슬라이드 아이디어, 대략적인 카피, 비기술적 개요만 필요하다면 gws-slides를 쓰지 마세요. Google Workspace CLI 환경에 접근할 수 없거나 필요한 공유 인증 설정이 없다면 이 스킬은 잘 맞지 않습니다.

설치 전에 무엇을 확인해야 하나요?

작업 흐름이 Google Slides API 작업에 의존하는지, 그리고 전제 조건인 gws-shared 파일을 지원할 수 있는지 확인하세요. 저장소나 환경이 그 의존성을 만족하지 못하면 gws-slides를 안정적으로 쓰기 어렵습니다.

gws-slides 스킬 개선 방법

에이전트에게 정확한 덱 맥락을 주기

가장 강력한 gws-slides 프롬프트에는 프레젠테이션 ID, 대상 리소스, 의도한 작업이 들어갑니다. 새 덱이라면 새 덱이라고 명시하고, 이미 존재하는 덱이라면 현재 슬라이드, 순서, 발표자 노트를 보존해야 하는지 밝혀 주세요. 이렇게 하면 추측이 줄고 첫 번째 명령이 유효할 가능성이 높아집니다.

결과만이 아니라 API 메서드도 함께 요청하기

이 스킬은 presentations.get이나 presentations.batchUpdate처럼 예상하는 작업을 이름으로 지정할 때 가장 잘 작동합니다. 단순히 “덱을 업데이트해 줘”라고만 하면 에이전트가 메서드를 추론해야 하고, 그 결과 경로가 불완전해질 수 있습니다. 메서드를 분명히 적는 요청이 더 나은 gws-slides 사용으로 이어집니다.

첫 조회 후 반복적으로 다듬기

실용적인 흐름은 먼저 덱을 확인하고, 반환된 구조를 바탕으로 요청을 좁혀 가는 것입니다. 첫 결과를 받은 뒤에는 바꾸고 싶은 정확한 페이지, 필드, 배치 작업을 중심으로 프롬프트를 더 구체화하세요. 모든 슬라이드 세부사항을 처음부터 한 번에 적는 것보다 대개 더 효과적입니다.

batchUpdate 검증 실패를 조심하기

gws-slides에서 가장 흔한 실패 모드는 배치 안의 요청 객체가 잘못된 경우입니다. 이를 피하려면 작은 배치부터 만들고, gws schema로 파라미터 이름을 확인한 뒤, 각 작업이 유효하다고 확인된 다음에만 함께 묶으세요.