내 글 먼저 읽어 주는 AI 독자: 퍼스트 리더 설치법

2026년 10월 18일 업데이트

영상 속 스킬은 퍼스트 리더(first-reader)예요. 가상의 독자 두 명이 내 글을 한 문단씩만 받아 읽으면서 어디서 관심이 생기고 어디서 지루해져 나가는지 적어요. 다 읽은 뒤에는 기억 테스트를 하고, 내 글 옆에 독자 메모를 붙인 결과 페이지를 만들어 줘요. 글은 한 줄도 고치지 않아요.

GitHub의 awesome-llm-apps에 있는 오픈소스(Apache-2.0)예요. 파이썬 기본 기능만 쓰고, 글은 내 컴퓨터 밖으로 보내지 않아요. 블로그·뉴스레터 같은 글은 물론, 이미지로 된 스마트스토어 상세페이지도 읽힐 수 있어요.

1. 시작 전에 알아둘 것

  • 붙일 곳은 코덱스나 클로드 코드의 로컬 작업창이에요. 터미널에서 codex나 claude를 실행한 창, 또는 데스크톱 앱처럼 내 PC 폴더를 다룰 수 있는 곳이어야 해요. 챗GPT·클로드 웹 채팅창에서는 쓸 수 없어요.
  • 필요한 것: 코덱스 또는 클로드 코드 로그인, 설치용 Node.js, 실행용 Python 3. 없으면 아래 요청문이 확인하고 설치를 안내해요.
  • 독자는 AI가 따로 띄운 보조 에이전트예요. 그래서 한 번 돌릴 때 내 요금제 사용량이 평소 질문보다 많이 들어요. 맥스 PC에서 상세페이지 하나에 5~11분 걸렸어요.
  • 독자 반응은 실제 소비자 조사가 아니에요. 사람에게 보여 주기 전에 어디서 막히는지 먼저 찾아보는 용도로 쓰세요.

2. 설치 요청문 (맥)

붙일 곳: Mac에서 실행 중인 코덱스 또는 클로드 코드. 리뷰할 글을 모아 둘 폴더에서 열어 주세요.

텍스트
지금 작업 폴더에 first-reader 스킬을 설치해 줘.

공식 원본: https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/agent_skills/first-reader

1. node -v 로 Node.js가 있는지, python3 --version 으로 Python 3가 있는지 확인해. 없으면 nodejs.org 공식 LTS나 python.org 공식 설치를 준비하고, 설치 승인만 내가 직접 하게 안내해.
2. 이 폴더에서 아래 명령으로 설치해. 코덱스용(.agents/skills)과 클로드 코드용(.claude/skills)에 같이 들어가.
   npx -y skills add https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/agent_skills/first-reader -a codex -a claude-code -y --copy
3. .agents/skills/first-reader/SKILL.md 와 .claude/skills/first-reader/SKILL.md 가 생겼는지, scripts 폴더에 feed.py·room.py가 있는지 확인해.
4. python3 .agents/skills/first-reader/scripts/feed.py --help 가 오류 없이 도는지 확인해.

끝나면 설치된 위치와 확인 결과를 짧게 알려 주고, 새 창을 열어야 스킬이 보인다고 알려 줘. 결제·API 키 입력은 하지 마.

설치가 끝나면 코덱스나 클로드 코드를 껐다가 같은 폴더에서 새로 켜 주세요. 새 창부터 스킬이 보여요.

3. 설치 요청문 (윈도우)

붙일 곳: Windows에서 실행 중인 코덱스 또는 클로드 코드. PowerShell 기준이에요.

텍스트
지금 작업 폴더에 first-reader 스킬을 설치해 줘. 이 PC는 Windows야.

공식 원본: https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/agent_skills/first-reader

1. node -v 로 Node.js가 있는지 확인해. 없으면 nodejs.org 공식 LTS 설치 파일을 준비하고 설치 승인만 내가 직접 하게 안내해. 설치 뒤 새 PowerShell에서 npm.cmd -v 가 되는지 확인해.
2. Python 3는 py -3 --version, python --version 순서로 확인해. 둘 다 안 되면 python.org 공식 설치 파일을 준비하고, 설치 화면에서 "Add python.exe to PATH"를 켜라고 안내해. 스킬 설명서의 python3 명령은 이 PC에서 되는 명령(py -3 또는 python)으로 바꿔서 실행해.
3. 이 폴더에서 아래 명령으로 설치해. 코덱스용(.agents\skills)과 클로드 코드용(.claude\skills)에 같이 들어가.
   npx.cmd -y skills add https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/agent_skills/first-reader -a codex -a claude-code -y --copy
4. .agents\skills\first-reader\SKILL.md 와 .claude\skills\first-reader\SKILL.md 가 생겼는지 확인하고, feed.py --help 가 오류 없이 도는지 확인해.

끝나면 설치된 위치, 이 PC에서 쓰는 파이썬 명령, 확인 결과를 짧게 알려 줘. 보안 설정을 전역으로 끄거나 결제·API 키 입력은 하지 마.

설치가 끝나면 코덱스나 클로드 코드를 껐다가 같은 폴더에서 새로 켜 주세요.

4. 블로그·뉴스레터 리뷰 요청문

글 파일(.md·.txt)을 설치한 폴더에 넣고, [ ] 부분만 바꿔서 붙여 넣으세요. 독자를 직함 말고 사람처럼 적을수록 반응이 구체적이에요.

텍스트
first-reader 스킬로 [파일 이름.md]를 리뷰해 줘.

독자: [예: 출근길 지하철에서 인스타 보다가 뉴스레터를 열어 보는 30대 1인 셀러. AI 도구는 써 봤지만 설정이 길어지면 바로 닫는 편]
읽는 상황: [예: 휴대폰으로, 3분 안에 훑어봄]
읽고 나서 기억하면 좋겠는 것 한 가지: [예: 결과가 별로면 다시 시키기 전에 도구부터 확인하자]

내 글은 고치지 마. 보고는 한국어로 해 주고, 결과 페이지(room.html)도 만들어서 경로 알려 줘.

5. 상세페이지 리뷰 요청문

스마트스토어 상세페이지는 대부분 이미지라서 독자에게 이미지를 어떻게 보여 줄지를 정해야 해요. 맥스가 같은 상세페이지로 두 방법을 다 돌려 봤어요.

먼저 상세페이지 이미지를 위에서부터 순서대로 한 폴더에 넣어 주세요(예: detail/01.jpg, detail/02.jpg…). 내 상품이면 디자이너에게 받은 원본 파일을 쓰면 돼요.

방법 ① 독자가 이미지를 직접 보기 (먼저 추천)

쇼핑 앱에서 내려 보듯 독자가 이미지를 한 장씩 열어 보고 반응해요. 이미지 속 그래프·배너·사진까지 읽어요.

텍스트
first-reader 스킬로 상세페이지를 리뷰해 줘. 상품: [상품 이름]

1. detail 폴더의 이미지를 파일 이름 순서대로, 한 줄에 하나씩 "[이미지 01 — detail/01.jpg]" 형식으로 적은 원고 detailpage.md를 만들어. 이미지 사이에 글이 있으면 그 자리에 그대로 넣어. 이미지 내용을 미리 글로 옮기지는 마.
2. 그 원고를 그대로 feed에 넣어. 독자 보조 에이전트 지시에 이걸 넣어: 받은 문단에 [이미지 NN — 경로] 줄이 있으면 그 이미지 파일을 직접 열어 보고 나서 반응할 것. 쇼핑 앱에서 화면을 내리다 마주친 것처럼 볼 것. 로그에는 실제로 본 이미지 속 글자나 장면을 한 가지 이상 적을 것.
3. 독자가 이미지를 못 열었으면 숨기지 말고 보고에 적어.

독자: [예: 네이버에서 수분크림을 검색해 여러 상품을 비교하다 이 상품을 눌러 휴대폰으로 내려 보는 20~30대. 속건조가 고민이고 비슷한 가격대 다른 크림과 고민 중]
읽고 나서 기억하면 좋겠는 것 한 가지: [예: 피부 pH를 약산성으로 맞춰야 수분이 차오른다 → 그래서 이 크림]

내 원고와 이미지는 고치지 마. 보고는 한국어로 해 주고, 결과 페이지도 만들어서 경로 알려 줘.

방법 ② 이미지를 글로 옮긴 뒤 읽기

AI가 이미지 속 글자와 그림을 먼저 글로 옮기고, 독자는 그 글만 읽어요. 시간은 더 걸리지만 문단이 잘게 나뉘어서 몇 번째 이미지에서 나갔는지가 더 정확하게 나와요.

텍스트
first-reader 스킬로 상세페이지를 리뷰해 줘. 상품: [상품 이름]

1. detail 폴더의 이미지를 파일 이름 순서대로 하나씩 직접 열어 보고, 이미지마다 "이미지 NN" 제목 아래에 그 이미지에 적힌 글자를 그대로 옮기고, 글자가 아닌 것(제품 사진, 그래프, 전후 비교, 배지 등)은 한두 줄로 설명한 글 원고 detailpage-text.md를 만들어. 순서는 그대로 둬.
2. 그 detailpage-text.md를 first-reader 스킬로 리뷰해. 독자에게는 이 글 원고만 주고 이미지 파일은 주지 마.

독자: [위와 같은 방식으로]
읽고 나서 기억하면 좋겠는 것 한 가지: [한 문장]

보고는 한국어로 해 주고, 결과 페이지도 만들어서 경로 알려 줘.

6. 결과 보는 법

  • 보고: 독자가 어디서 관심을 가졌고 어디서 나갔는지, 기억 테스트에서 무엇이 남았는지, 나에게 던지는 질문 하나가 와요. 고칠 문장 목록은 일부러 안 줘요.
  • 결과 페이지(room.html): 내 글 옆에 문단마다 독자 메모가 붙고, 위쪽 띠에 문단별 관심 변화가 보여요. 코덱스·클로드 코드에 “결과 페이지 브라우저로 열어 줘”라고 하면 돼요.
  • 이어서 물어보기: “S한테 4번 문단에서 왜 나갔는지 물어봐”처럼 특정 독자에게 질문할 수 있어요. 독자는 자기 메모를 근거로 답하고, 대신 글을 써 주지는 않아요.
  • 고친 뒤 다시: 글을 고치고 “again”이라고 하면 같은 독자가 처음부터 다시 읽고, 이전 결과와 관심 변화를 나란히 보여 줘요.
  • 첫인상만: “quick read”라고 하면 훑어보는 독자만 돌아서 열어 볼지 두 문장으로 알려 줘요.
  • 결과는 원고 옆 .first-reader 폴더에 쌓여요. 같은 독자를 계속 쓰고 싶으면 .first-reader/audience.json에 저장해 달라고 하세요.

7. 직접 확인한 범위

2026-10-18에 맥스 Mac에서 원본(커밋 fba2c90)으로 직접 돌려 봤어요. 상세페이지는 네이버 브랜드스토어의 셀퓨전씨 「약산성 패리어 수분 크림」(이미지 26장)으로 시험했어요.

항목 확인한 것
맥 설치 명령 2번 요청문의 설치 명령으로 코덱스용·클로드 코드용 스킬 폴더에 함께 설치되는 것 확인
뉴스레터 리뷰 코덱스 CLI(Claude Opus 모델)로 6분 20초. 마케터 독자가 2번째 문단부터 훑어 읽기 시작, 기억 테스트에서 핵심 문장이 둘 다 안 남음
상세페이지 ① 이미지 직접 보기 코덱스 CLI(Claude Opus 모델) 6분 20초. 챗GPT 계정 코덱스(gpt-6.1-sol)로도 4분 53초에 끝났고, 독자 보조 에이전트가 이미지를 직접 열어 본 기록 확인
상세페이지 ② 글로 옮긴 뒤 읽기 코덱스 CLI(Claude Opus 모델) 11분 17초, 16문단으로 나눠 읽음
공통으로 나온 지적 첫 화면 할인·쿠폰 배너에서 훑기 시작, pH 그래프 반복, 끝까지 간 독자도 뒤쪽 비교표에서 헷갈려 결제 보류
윈도우·클로드 코드 윈도우 설치와 클로드 코드 실행은 직접 해 보지 않았어요. 막히면 오류 화면을 그대로 AI에게 보여 주세요

공식 안내: first-reader 원본 · awesome-llm-apps

같이 해요

  • YouTube

    AI로 업무 시스템을 만드는 과정과 실제 결과를 영상으로 전해요.

    채널 보기
  • 오픈채팅방

    꿀팁을 써 보며 생긴 질문을 나누는 방이에요.

    들어가기
  • 무료 키트 받기

    AI 자동화 키트(직접 돌려 본 자동화 레시피 3개 + 프롬프트 10개)를 PDF로 메일에 바로 보내드려요.

    준비 중