Communitygithub.com

워크스페이스 랜딩 페이지 편집기

워크스페이스의 랜딩 페이지 HTML(매거진 스타일 /w/:slug 페이지)을 편집, 업데이트, 또는 반복 작업할 때 사용합니다. 현재 HTML을 가져와서 타겟 변경을 수행한 후 다시 작성하는 증분 편집 방식을 지원합니다. 초기 생성에는 사용하지 마세요. 초기 생성은 `brief` 필드가 서버 측 LANDING_PAGE_PROMPT를 Gemini에 대해 실행합니다.

워크스페이스 랜딩 페이지 편집기란 무엇인가요?

이 스킬은 워크스페이스 랜딩 페이지(`/w/:slug`)의 HTML을 직접 편집하기 위한 것입니다. 개발자나 AI 에이전트가 페이지를 완전히 재생성하지 않고도 특정 요소(예: 텍스트, 레이아웃, 이미지 등)를 빠르게 수정할 수 있습니다. `astria` CLI를 사용하여 편집 워크플로우(가져오기 -> 수정하기 -> 쓰기)를 간소화하며, 변경 사항이 미미하거나 타겟팅된 경우에 적합합니다. 중요하게도, 페이지의 구조적 무결성을 유지하기 위해 따라야 하는 제약 조건(예: Tailwind CSS 사용, 특정 HTML 요소 생략, 이미지/비디오 URL의 신중한 처리)을 정의합니다. 이 스킬은 완전한 재설계를 위해 전체 페이지를 다시 생성하는 `brief` 제출과 증분 편집을 명확히 구분합니다.

지원 대상~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/astriaai/skills/tree/HEAD/landing-page-editor

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

미리보기

스킬 README에서

문서

워크스페이스 랜딩 페이지 편집기은(는) 무엇을 하나요?

워크스페이스 랜딩 페이지(/w/:slug에서 렌더링됨)는 workspace.landing_page_html에 저장된 단일 자체 포함 HTML 블롭입니다. brief가 제출될 때마다 서버 측 LANDING_PAGE_PROMPT에 의해 처음부터 생성됩니다. 이 경로는 HTML을 완전히 덮어씁니다.

전체 페이지를 다시 생성하지 않아야 하는 변경(예: 타이포그래피 조정, 레이아웃 편집, 섹션 추가, 카피 변경, 이미지 교체, 태그라인 수정)에는 HTML을 직접 편집하고 다시 작성하세요. 사용자가 전체 재생성을 원하지 않는 한 brief를 보내지 마십시오.

모든 명령은 astria CLI(astria-api 스킬 참조)를 사용합니다. -w <workspace_id>를 전달하여 워크스페이스를 대상으로 지정하세요.

LANDING_PAGE_PROMPT에서 이월된 제약 조건

편집 시 다음 불변 조건을 유지하세요. (실시간 /w/:slug 페이지가 이에 의존합니다):

  • 출력은 내부 body HTML입니다. <html>, <head>, <body> 또는 <!DOCTYPE> 태그가 없습니다.
  • 스타일링은 Tailwind 유틸리티 클래스를 사용합니다(이미 페이지에 로드됨). Tailwind가 표현할 수 없는 호버/애니메이션 효과에만 <style>을 사용하세요.
  • 팩 링크는 정확히 /p/{slug}입니다. 모델/참조 링크는 tunes JSON의 link 필드를 그대로 사용합니다(%5B/%5D를 다시 인코딩하지 마십시오).
  • 모든 이미지/비디오는 <a> 태그로 감싸져 있습니다.
  • 이미지 및 비디오 URL은 이미 존재하는 URL이어야 합니다. URL을 임의로 만들지 마십시오.
  • 비디오는 <video autoplay muted loop playsinline poster="POSTER_URL"><source src="VIDEO_URL" type="video/mp4"></video>를 사용합니다.
  • <script type="application/json" id="tunes-data">…</script> 내부의 문자열 __TUNES_JSON_PAYLOAD__는 서버 측 플레이스홀더입니다. 서버는 렌더링 시점에 이를 실시간 tunes JSON으로 대체합니다. 리터럴 JSON으로 절대 대체하지 마십시오. 그렇게 하면 캐스트가 고정되어 새로 추가된 tunes가 나타나지 않습니다.
  • 편집 스타일링: 세리프 헤드라인, 넉넉한 공백, 가는 구분선, 인물 이미지에 object-cover object-[center_top], 히어로 스프레드에 max-h-[70vh], 인물 컨테이너에 aspect-[4/5] 또는 aspect-[3/4]를 사용합니다.

워크플로우

1. 현재 랜딩 페이지 HTML 가져오기

astria landing get -w <workspace_id> --html > /tmp/landing_page.html

astria landing get -w <workspace_id> (--html 없이)는 전체 워크스페이스 JSON(title, slug, brief, url, public_at, unlisted_at)을 반환합니다. 이 값들이 필요할 때 사용합니다. 렌더링된 페이지는 /w/{slug}에서 미리보기 할 수 있습니다.

2. 워크스페이스 데이터 가져오기(편집 시 실제 팩/프롬프트/tunes를 참조해야 하는 경우)

astria packs list -w <workspace_id> --limit 100
astria tunes list -w <workspace_id> --limit 200            # 페이지에 렌더링된 "캐스트"
astria prompts list -w <workspace_id> --limit 100 --offset 0   # 빈 페이지가 나올 때까지 --offset 사용
astria prompts list -w <workspace_id> --pack-id <pack_id>      # 더 가볍게, 한 섹션씩

목록 엔드포인트는 --limit/--offset을 통해 페이지네이션됩니다(기본 정렬 id desc). 페이지가 비어서 반환될 때까지 --offset으로 반복합니다.

3. 증분 편집 수행

/tmp/landing_page.html을 로컬에서 편집합니다. 변경 사항을 최소한으로 유지하세요. 생성기는 수천 바이트의 레이아웃을 생성했으며 대부분은 그대로 두어야 합니다. 저장하기 전에 위의 제약 조건 섹션을 다시 읽으세요.

4. 페이지 다시 쓰기

astria landing set -w <workspace_id> --html-file /tmp/landing_page.html

여기서 --brief를 전달하지 마십시오. 그러면 편집 내용이 폐기되고 Gemini를 통해 처음부터 다시 생성됩니다.

5. 확인

/w/{slug}를 열고 변경 사항을 시각적으로 확인합니다. __TUNES_JSON_PAYLOAD__ 플레이스홀더는 렌더링 시 서버 측에서 대체됩니다. 렌더링된 페이지에 JSON 모양의 문자열이 계속 표시되면 플레이스홀더가 실수로 삭제되었거나 이름이 변경된 것입니다.

처음부터 다시 생성하기

사용자가 명시적으로 전체 재설계를 요청한 경우에만 brief를 제출하면 서버가 LANDING_PAGE_PROMPT를 Gemini에 대해 실행하여 HTML을 덮어씁니다:

astria landing set -w <workspace_id> \
  --brief "Editorial fashion lookbook, AW26, dark moody palette, emphasize the womenswear packs"

관련 스킬