Community라이팅 & 에디팅github.com

reviewing-scripts

리뷰어가 브라우저 페이지에서 비디오 스크립트를 한 줄씩 검토하고, 줄이나 선택한 단어에 댓글을 달고, 줄을 직접 편집한 후 노트를 에이전트로 보내면 에이전트가 마크다운 파일을 수정합니다. 사용자가 브라우저에서 스크립트 초안을 검토, 댓글 작성, 승인을 원하거나, 스크립트 페이지나 목록을 요청하거나, 휴대폰이나 텔레프롬프터에서 스크립트를 원할 때, 또는 초안 작성 후 검토가 필요할 때 사용하세요.

reviewing-scripts란 무엇인가요?

이 스킬은 비디오 스크립트를 검토하고 수정하는 과정을 자동화합니다. 리뷰어는 로컬 브라우저 페이지에서 스크립트를 한 줄씩 읽고, 각 줄이나 선택한 단어에 댓글을 달고, 줄을 직접 편집할 수 있습니다. 에이전트는 리뷰어의 피드백을 받아 마크다운 파일을 최소한의 변경으로 수정하고, 승인 상태를 업데이트합니다. Python 3.9 이상에서 실행되며 추가 패키지 설치가 필요 없고, Tailscale을 통해 휴대폰에서도 접근할 수 있습니다. 이 스킬은 스크립트 초안 검토, 편집 제안 적용, 최종 승인 과정을 효율적으로 관리하는 데 유용합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kjmagnan1s/reviewing-scripts/tree/main/skills/reviewing-scripts

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

문서

스크립트 검토하기

각 스크립트는 하나의 마크다운 파일입니다. 리뷰어는 로컬 페이지에서 이를 읽고, 노트는 마크다운 형식으로 다시 전달됩니다. 모든 명령어는 python3 scripts/script_review.py <명령어> 형식이며, 경로는 이 스킬 폴더를 기준으로 합니다. Python 3.9 이상이 필요하며, 설치할 패키지는 없습니다.

검토 루프

  1. 스크립트 저장. 본문을 임시 파일에 쓰고 script_review.py new --title "<제목>" --body-file <파일> --status drafted를 실행합니다. 스크립트의 id, 파일 경로, 페이지 주소가 출력됩니다. 한 문장이나 비트를 각 줄에 배치하여 각 줄이 별도의 댓글을 받을 수 있도록 합니다.
  2. 페이지 시작. script_review.py up을 실행한 후 script_review.py open <id>를 실행합니다. 리뷰어에게 주소를 알려줍니다.
  3. 노트 대기. 백그라운드에서 script_review.py wait <id>를 실행합니다. 리뷰어가 노트 보내기를 클릭하면 노트를 출력하고, 2시간 동안 전송이 없으면 종료 코드 2로 종료됩니다.
  4. 노트 적용. 각 노트에 답하는 최소한의 변경으로 스크립트 파일을 편집합니다. 열린 페이지는 자동으로 새로고침되고 변경된 줄을 표시합니다.
  5. 3단계부터 반복 노트에 "좋아요."라고 표시될 때까지 진행합니다. 이 전송은 초안을 승인 상태로 이동시킵니다.

노트가 전송되었을 때 대기 중이 아니었다면 script_review.py inbox는 읽지 않은 모든 세트를 출력합니다.

수정 규칙

  • 리뷰어의 편집 내용을 그대로 유지합니다. "편집(이미 파일에 저장됨)" 아래에 나열된 줄은 리뷰어의 표현이며, 노트를 보기 전에 이미 파일에 있습니다. 노트에서 요청할 때만 변경합니다.
  • 노트가 다루는 내용만 변경합니다. 댓글이 없는 줄은 다시 작성하지 않습니다.
  • "적용되지 않은 편집"은 수동으로 적용합니다. 전송 전에 줄이 이동했으므로 파일이 변경되지 않았습니다.
  • 설정하지 않은 프론트매터 키는 그대로 둡니다. script_review.py status <id> <status>로 상태를 변경하고, 파일을 직접 편집하지 않습니다.
  • 리뷰어가 요청하지 않는 한 스크립트 파일을 삭제하지 않습니다.

파일 형식

---
type: script
id: 2026-01-15-three-prompt-habits
title: Three prompt habits
status: drafted
---

## 구술 스크립트

첫 번째 줄, 한 줄에 한 문장씩.
두 번째 줄.

## 대체 후크

후크 2 (질문): 촬영할 두 번째 오프닝 라인.

## 캡션

스크립트와 함께 보관하는 기타 모든 것.

읽기 복사는 페이지에서 Spoken Script 섹션을 한 단락으로 복사한 다음, 각 대체 후크를 후크 2부터 "둘째. <줄>"로 복사합니다. Spoken Script 섹션이 없는 파일은 전체가 읽힙니다. script_review.py read <id>는 동일한 텍스트를 출력합니다.

기타 명령어

  • list [--status <상태>] [--json]: 각 스크립트의 상태와 단어 수를 출력합니다.
  • status <id> <상태>: 상태를 설정합니다 (기본값: idea, drafted, ready, filmed, posted).
  • config: 사용 중인 설정과 설정 파일 경로를 출력합니다.
  • down: 페이지 서버를 중지합니다.

설정 (폴더, 포트, 섹션 이름, 상태, 리뷰어 이름) 및 Tailscale을 통한 휴대폰 접근에 대한 설명은 리포지토리 루트의 README에 있습니다.

관련 스킬