workshop-creator

name: workshop-creator description: AWS Workshop Studio 프로젝트 구조 생성 및 콘텐츠 작성 스킬. "워크샵 만들어", "workshop init", "랩 작성" 요청 시 활성화 invocation: /workshop-creator model: sonnet allowed-tools: - Read - Write - Bash

Workshop Creator Skill

AWS Workshop Studio 형식의 워크샵 프로젝트를 생성하고 콘텐츠를 작성합니다.

Usage

Directory Layout

workshop-name/
├── contentspec.yaml              # Workshop Studio 설정
├── content/
│   ├── index.ko.md              # 홈페이지 (한국어)
│   ├── index.en.md              # 홈페이지 (영어)
│   ├── introduction/
│   │   └── index.en.md
│   ├── module1-topic/           # 모듈 1
│   │   ├── index.en.md          # 모듈 인덱스
│   │   └── subtopic1/
│   │       └── index.en.md
│   └── summary/
│       └── index.en.md
├── static/
│   ├── images/module-N/         # 모듈별 이미지
│   ├── code/                    # 코드 샘플
│   └── iam-policy.json
└── assets/                      # S3 에셋

Naming Conventions

Front Matter

---
title: "페이지 제목"
weight: 10
---

주의: chapter 속성은 Workshop Studio에서 지원하지 않습니다.

상세: references/front-matter.md

Workshop Studio Directives

Workshop Studio는 자체 Directive 문법을 사용합니다. Hugo shortcode는 사용 금지.

Alert

::alert[This action cannot be undone]{type="warning"}

:::alert{header="Prerequisites" type="warning"}
Before starting:
1. AWS account with admin access
2. AWS CLI installed
:::

상세: references/alert-reference.md

Code

:::code{language=bash showCopyAction=true}
kubectl get pods -n vllm
:::

:::code{language=yaml highlightLines=4-6}
apiVersion: v1
kind: Service
metadata:
  name: my-service
:::

상세: references/code-reference.md

Tabs

코드 포함 시 콜론 개수 증가 필요 (중첩 수준에 따라 :::::tabs).

상세: references/tabs-reference.md

Image

:image[Architecture]{src="/static/images/diagrams/arch.png" width=800}

상세: references/image-reference.md

Mermaid

```mermaid
graph LR
    A[Component] --> B[Service]
    style A fill:#e1f5fe

### Expand

```markdown
::::expand{header="자세히 보기"}
숨겨진 내용
::::

상세: references/directives-complete.md

Best Practices

DO

1. Mermaid 다이어그램 — 아키텍처 시각화
2. 복사 가능한 코드 — showCopyAction=true
3. 단계별 검증 — 각 단계 후 확인 방법 제공
4. Key Takeaways — 모든 섹션 끝에 요약
5. 네비게이션 링크 — 명확한 이전/다음 링크

DON'T

1. Hugo shortcode 사용 금지: {{% notice %}}
2. chapter: true 속성 사용 금지
3. 하드코딩된 계정 ID 금지
4. 검증 없는 단계 작성 금지
5. 긴 코드를 heredoc으로 작성 금지

Infrastructure

워크샵 인프라는 CloudFormation으로 프로비저닝합니다.

static/
├── workshop.yaml       # CloudFormation 템플릿
└── iam-policy.json     # 참가자 IAM 정책

검증:

cfn-lint static/workshop.yaml
cfn_nag_scan --input-path static/workshop.yaml

상세: references/infrastructure-guide.md, references/cloudformation-reference.md

Workflow

1. /workshop-creator init my-workshop — 프로젝트 초기화
2. contentspec.yaml 설정 — 리전, IAM, 파라미터
3. CloudFormation 템플릿 작성 — static/workshop.yaml
4. Homepage 작성 — Mermaid 다이어그램 포함
5. 모듈별 콘텐츠 작성 — 단계별 hands-on
6. 이미지/스크린샷 추가
7. cfn-lint / cfn_nag 검증
8. workshop-review-agent로 콘텐츠 검토

Output Format

워크샵 생성 시 다음 구조를 출력합니다:

[workshop-name]/
├── contentspec.yaml
├── content/
│   ├── index.en.md
│   ├── introduction/
│   ├── module1-[topic]/
│   │   ├── index.en.md
│   │   └── [subtopics]/
│   └── summary/
└── static/
    ├── workshop.yaml
    ├── iam-policy.json
    └── images/

각 파일은 Workshop Studio 형식을 준수하며, contentspec.yaml에 정의된 로케일별로 .ko.md / .en.md 파일을 생성합니다.

Reference Documents