[에이전트] Claude로 블로그도 자동화하기

최근 들어 블로그를 자주 쓰는 편인데, 항상 같은 문제에 부딪혔다. 주제는 있고 내용도 알고 있는데, 막상 글을 쓰기 시작하면 귀찮다. 그리고 Claude한테 대신 써달라고 하면 말투가 너무 정중하거나, 설명이 너무 형식적이다.

결국 "Claude가 내 말투를 파악하고 알아서 쓰면 안 되나?"라는 생각으로 이어졌다.

그래서 블로그도 한 번 Claude가 할 수 있게 하네싱 해보기로 했다.

Claude Code의 Skills란

Claude Code에는 skills라는 기능이 있다. 쉽게 말하면, 특정 작업을 어떻게 수행할지 Claude에게 미리 가르쳐두는 문서다. gstack 환경 기준으로 `~/.claude/skills/` 디렉토리 아래에 마크다운 파일로 저장하면, `/skill-name` 처럼 슬래시 커맨드로 호출할 수 있다.

이 skills는 단순한 프롬프트 저장소가 아니다. 조건 분기, 서브 에이전트 생성, 파일 읽기/쓰기까지 가능하다. 그래서 꽤 복잡한 워크플로우도 구현할 수 있다.

사실 skills 자체는 이미 많이 활용하고 있었는데, 블로그 작성 전용 스킬은 없었다. 그래서 만들었다.

만드는 과정

말투를 어떻게 학습시키냐

가장 큰 고민이 이거였다. Claude가 내 말투를 알려면, 뭔가 레퍼런스가 있어야 한다. 그래서 `~/.claude/skills/blog-writer/reference/` 폴더를 만들고, 내가 직접 쓴 블로그 글들을 거기 넣어두기로 했다.

스킬이 실행되면 이 폴더의 글들을 읽어서 8가지 특성을 분석한다. 어조, 문장 길이, 단어 선택, 문단 구조, 시작 방식, 마무리 방식, 감정 표현, 특징적인 표현들. 이걸 `style-analysis.md`라는 파일에 저장해둔다.

style-analysis.md

캐싱이 중요한 이유

매번 레퍼런스 파일을 전부 다시 읽으면 토큰 낭비다. 그래서 한 번 분석한 결과를 캐시 파일에 저장해두고, 다음에 스킬을 호출할 땐 그 파일만 읽으면 된다.

아무래도 레퍼런스 파일이 바뀔 수도 있으니까, 캐시 파일에 "어떤 파일들을 분석했는지" 목록도 같이 저장해둔다. 현재 reference 폴더의 파일 목록이 달라졌으면 재분석, 그렇지 않으면 캐시 사용. 간단하지만 효과적이다.

팩트체크 서브 에이전트

이 부분이 가장 나중에 추가됐다. 글을 다 쓰고 나면 사실 확인이 필요한 경우가 있다. 기술적인 내용에서 개념을 잘못 설명하거나, 날짜나 수치가 틀리거나.

그래서 초안 완성 후 새로운 서브 에이전트를 하나 더 띄워서 팩트체크를 맡긴다. 이 에이전트는 세 가지만 본다.

1. 사실 관계가 맞는지 (원인/결과, 상관관계)
2. 수치, 날짜, 이름이 정확한지
3. 개념 설명이 도메인적으로 맞는지

중요한 건 문체는 건드리지 말라고 명시해뒀다는 거다. 어쨌든 내 말투를 유지하는 게 목적이니까.

실제 동작 흐름

스킬을 `/blog-writer 주제` 형태로 호출하면 다음 순서로 진행된다.

**Step 1 — 스타일 분석 로드**
`style-analysis.md`가 있으면 바로 읽고, 없으면 reference 폴더를 분석해서 만든다.

**Step 2 — 블로그 브리프 수집**
주제, 독자, 목적, 길이를 확인한다. 이미 주제를 넘겼으면 나머지만 물어본다.

**Step 3 — 초안 작성**
분석된 말투 지문대로 글을 쓴다. 이미지가 들어가면 좋을 위치에는 `📷 이미지 제안` 블록을 인라인으로 삽입한다. 이 단계에서는 파일을 저장하지 않는다.

**Step 4 — 팩트체크**
서브 에이전트가 초안을 검토하고 오류, 불확실한 내용을 보고한다.

**Step 5 — 유저 승인 후 저장**
팩트체크 결과를 보여주고, 어떤 수정을 반영할지 확인받은 뒤 `.md` 파일로 저장한다.

써보니까

굉장히 만족스럽다. 말투가 일치하는 건 물론이고, 이미지 위치 제안이 생각보다 유용하다. 직접 글 쓸 때는 어디에 이미지를 넣을지 고민을 많이 하는데, 알아서 표시해줘서 편하다.

팩트체크도 생각보다 꼼꼼하다. 이번 글처럼 Claude Code 기능 설명이 들어가면 미묘하게 틀릴 수 있는 부분을 잡아주더라.

결국 블로그 쓰는 데 드는 마찰이 많이 줄었다. 주제만 던지면 초안이 나오고, 팩트체크가 되고, 승인하면 파일이 생긴다. 뚝딱이다.

앞으로는 레퍼런스 파일을 조금 더 다양하게 넣어서 말투를 더 정확하게 잡아가야겠다.

 

https://github.com/codie0226/blog-writer

GitHub - codie0226/blog-writer