agentleFS
greekr4greekr4/viruagent-cli/skills/va-tistory-publish/SKILL.md

va-tistory-publish

Skill39 starsChanged 8 months agoMITView on GitHub

Tistory: 블로그 글 발행 — 5종 포맷 템플릿 (story/howto/list/review/qa)

The file

Files
SKILL.md

va-tistory-publish — Tistory 글 발행

사용법

npx viruagent-cli publish \
  --provider tistory \
  --title "제목 (25~35자, 핵심 키워드 앞배치)" \
  --content "<h2>...</h2><p>...</p>" \
  --category <id> \
  --tags "tag1,tag2,tag3,tag4,tag5" \
  --visibility public \
  --related-image-keywords "keyword1 keyword2 keyword3" \
  --image-upload-limit 3 \
  --minimum-image-count 1

옵션

플래그설명기본값
--title글 제목(필수)
--contentHTML 콘텐츠-
--content-fileHTML 파일 경로 (절대)-
--category카테고리 ID-
--tags쉼표 구분 태그 (5개)-
--visibilitypublic / privatepublic
--related-image-keywords이미지 검색 키워드 (영어)-
--image-upload-limit최대 이미지 수3
--minimum-image-count최소 이미지 수1
--dry-run파라미터만 검증false

티스토리 SEO 핵심 원칙 (구글 기준)

  • 제목: 25~35자, 핵심 키워드를 앞쪽에 배치. 숫자/연도 포함 시 CTR +23%
  • 글자 수: 정보성 글 3,000~5,000자, 경쟁 키워드 5,000자 이상
  • H태그 계층: 블로그 타이틀이 h1 → 본문은 h2 → h3 → h4 순서. 본문에 h1 사용 금지
  • 소제목 간격: 6001,000자(약 300500단어)마다 h3 1개
  • 목차: 3개 이상 섹션이면 앵커 링크 목차 삽입 (Featured Snippet 진입 확률 상승)
  • 이미지 alt 태그: 반드시 핵심키워드 + 설명 형식으로 작성
  • 내부 링크: 실제 발행된 URL이 제공된 경우에만 삽입. URL 없으면 섹션 전체 생략 (가짜 링크 절대 금지)
  • E-E-A-T: 직접 경험 기반 문장, 데이터/출처 인용, 작성자 관점 명시

Tistory HTML 규칙

  • data-ke-* 속성 사용 — Tistory 에디터가 자동 처리하므로 일반 HTML로 작성
  • 이미지 삽입 후 alt 속성 추가 필수
  • <blockquote> 사용 가능 (티스토리가 스타일 자동 적용)

피해야 할 패턴

  • 본문에 <h1> 직접 사용 (블로그 타이틀과 중복)
  • <h2> 건너뛰고 <h3> 바로 사용
  • 균일한 3단락 공식 반복 — AI 탐지 위험
  • 이미지 alt 태그 비워두기 (이미지 SEO 가치 전체 손실)

서론 후킹 패턴 3종 (첫 3문장이 체류시간 결정)

패턴 A — 공감형 (범용, 정보성 글)

<p>[독자가 이미 겪고 있는 상황을 1문장으로 정확히 표현]</p>
<p>그런데 사실 그 이유는 생각보다 단순합니다. [반전 핵심 한 줄]</p>
<p>이 글에서는 [구체적 약속 — 읽으면 얻는 것]을 다룹니다.</p>

패턴 B — 손실 회피형 (경쟁 키워드, 클릭 유지)

<blockquote>[모르면 손해인 핵심 한 줄. 구체적 수치 포함]</blockquote>
<p>실제로 [통계나 사례 — 신뢰 부여]. 대부분은 이 차이를 모르고 넘어갑니다.</p>
<p>지금부터 [해결책 예고]를 정리해 드립니다.</p>

패턴 C — 질문형 (전문성 어필, 심화 콘텐츠)

<p>[독자가 검색창에 치는 질문을 그대로 첫 문장으로]</p>
<p>[데이터나 통계로 문제의 크기를 보여줌]. 저도 처음엔 이 답을 찾는 데 [시간]이 걸렸습니다.</p>
<p>지금부터 [핵심 내용 예고]합니다.</p>

목차 블록 (3개 이상 섹션이면 항상 삽입)

<h2>목차</h2>
<ul>
  <li><a href="#section1">[섹션 1 제목]</a></li>
  <li><a href="#section2">[섹션 2 제목]</a></li>
  <li><a href="#section3">[섹션 3 제목]</a></li>
  <li><a href="#section4">[섹션 4 제목]</a></li>
</ul>
<p>&nbsp;</p>

포맷 5종 템플릿

글 성격에 맞는 포맷을 선택하세요. 기본 추천: story형 (체류시간 최고, AI 탐지 회피 최적).


1. story형 — 스토리텔링 (체류시간 최고, AI 탐지 낮음)

경험 후기, 사례 공유, 인사이트 전달에 적합.

<!-- 후킹: 패턴 A 또는 C -->
<blockquote>[임팩트 한 줄 — 독자의 상황을 대변하는 문장]</blockquote>
<p>&nbsp;</p>

<p>[독자 공감 + 내 경험으로 연결 — 3~5문장. "저도 그랬습니다" 식으로 시작]</p>
<p>[이 글에서 다룰 내용 예고 — 구체적으로]</p>
<p>&nbsp;</p>

<!-- 목차 삽입 -->
<h2>목차</h2>
<ul>
  <li><a href="#s1">[섹션 1]</a></li>
  <li><a href="#s2">[섹션 2]</a></li>
  <li><a href="#s3">[섹션 3]</a></li>
</ul>
<p>&nbsp;</p>

<h2 id="s1">[섹션 1 — 문제 상황 묘사]</h2>
<h3>[세부 관점 1]</h3>
<p>[직접 겪은 구체적 상황 — 날짜, 수치, 감정 포함. 3~5문장]</p>
<p>[그 상황에서 발견한 인사이트 — 독자가 몰랐던 관점]</p>
<p>&nbsp;</p>

<h2 id="s2">[섹션 2 — 전환점 또는 발견]</h2>
<h3>[세부 관점 1]</h3>
<p>[문제를 어떻게 바라보게 됐는지 — BAB 구조의 After 단계]</p>
<p>[구체적 수치나 결과 언급]</p>
<p>&nbsp;</p>
<h3>[세부 관점 2]</h3>
<p>[추가 설명 — 짧은 문장. 긴 문장과 섞어서]</p>
<p>&nbsp;</p>

<h2 id="s3">[섹션 3 — 실전 적용법]</h2>
<h3>[방법 1]</h3>
<p>[독자가 바로 쓸 수 있는 방법 — 단계보다 맥락 중심으로]</p>
<p>[예상 실패 포인트와 극복법 — 경험 기반으로]</p>
<p>&nbsp;</p>
<h3>[방법 2]</h3>
<p>[동일 구조]</p>
<p>&nbsp;</p>

<h2>[섹션 4 — 의외의 발견 또는 여담]</h2>
<p>[예상 못한 결과나 부가적 인사이트 — 이 섹션이 인간미를 만듦]</p>
<p>&nbsp;</p>

<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->

<p>[핵심 요약 1~2문장] [독자에게 구체적 행동 제안] [공유/댓글 유도]</p>

2. howto형 — 튜토리얼 (정보 쿼리 1위, 체류시간 높음)

설치법, 사용법, 단계별 가이드에 적합.

<!-- 후킹: 패턴 B -->
<blockquote>[이 글 하나로 [X]할 수 있습니다 — 구체적 약속]</blockquote>
<p>&nbsp;</p>

<p>[왜 이 방법이 필요한지 — 기존 방식의 문제점. 2~3문장]</p>
<p>[이 글을 끝까지 읽으면 얻는 것]</p>
<p>&nbsp;</p>

<!-- 목차 -->
<h2>목차</h2>
<ul>
  <li><a href="#prep">준비물</a></li>
  <li><a href="#step1">1단계 — [단계명]</a></li>
  <li><a href="#step2">2단계 — [단계명]</a></li>
  <li><a href="#step3">3단계 — [단계명]</a></li>
  <li><a href="#faq">자주 묻는 질문</a></li>
</ul>
<p>&nbsp;</p>

<h2 id="prep">시작 전 준비물</h2>
<p>[왜 필요한지 이유 포함]</p>
<ul>
  <li>[준비물 1] — [이유]</li>
  <li>[준비물 2] — [이유]</li>
</ul>
<p>&nbsp;</p>

<h2 id="step1">1단계 — [단계명]</h2>
<h3>무엇을 하는 단계인가</h3>
<p>[맥락 제공 — 왜 이 단계가 필요한지]</p>
<h3>실행 방법</h3>
<p>[구체적 방법 — 이미지 직후 텍스트 설명]</p>
<p>[이 단계에서 흔히 하는 실수와 예방법]</p>
<p>&nbsp;</p>

<h2 id="step2">2단계 — [단계명]</h2>
<h3>무엇을 하는 단계인가</h3>
<p>[맥락 제공]</p>
<h3>실행 방법</h3>
<p>[방법 + 주의사항]</p>
<p>&nbsp;</p>

<h2 id="step3">3단계 — [단계명]</h2>
<p>[동일 구조]</p>
<p>&nbsp;</p>

<h2 id="faq">자주 묻는 질문</h2>
<h3>[가장 흔한 질문]</h3>
<p>[구체적 답변]</p>
<h3>[두 번째 질문]</h3>
<p>[구체적 답변]</p>
<p>&nbsp;</p>

<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->

<p>[완료 축하 + 다음 단계 제안]</p>

3. list형 — 리스트 정리 (CTR 높음, 초기 트래픽 확보)

"베스트 N", "추천 N선", 비교 정리글에 적합.

<!-- 후킹: 패턴 B -->
<blockquote>[N가지 중 실제로 쓸 만한 건 [X]개입니다 — 기대 역전]</blockquote>
<p>&nbsp;</p>

<p>[선별 기준 명시 — "제가 직접 [기간] 동안 사용/테스트한 기준"]</p>
<p>[이 글에서 다루는 범위]</p>
<p>&nbsp;</p>

<!-- 목차 -->
<h2>목차</h2>
<ul>
  <li><a href="#item1">1. [항목명]</a></li>
  <li><a href="#item2">2. [항목명]</a></li>
  <li><a href="#compare">한눈에 비교</a></li>
  <li><a href="#conclusion">상황별 추천</a></li>
</ul>
<p>&nbsp;</p>

<h2 id="item1">1. [항목명] — [핵심 특징 한 줄]</h2>
<h3>왜 1위인가</h3>
<p>[단순 설명이 아닌 직접 경험 기반 이유]</p>
<h3>장단점</h3>
<p>[장점 — 구체적 수치나 사례]</p>
<p>[단점 솔직하게 1~2줄 — 없으면 신뢰도 하락]</p>
<p>&nbsp;</p>

<h2 id="item2">2. [항목명] — [핵심 특징 한 줄]</h2>
<h3>특징과 실사용 경험</h3>
<p>[앞 항목과 차별점 명시]</p>
<p>&nbsp;</p>

<!-- 3~N개 동일 패턴 -->

<h2 id="compare">한눈에 비교</h2>
<p>[표 또는 항목별 비교 요약]</p>
<p>&nbsp;</p>

<h2 id="conclusion">결론 — 상황별 추천</h2>
<h3>[상황 A]에는 [항목 X]</h3>
<p>[이유]</p>
<h3>[상황 B]에는 [항목 Y]</h3>
<p>[이유]</p>
<p>&nbsp;</p>

<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->

<p>[내 개인 픽 + 이유] [댓글 유도 — "여러분이 써본 것 중 좋았던 건?"]</p>

4. review형 — 분석/리뷰 (전문성 최고, AI 탐지 낮음)

도구 분석, 서비스 리뷰, 책/영상 리뷰에 적합.

<!-- 후킹: 패턴 C -->
<blockquote>결론부터 말하면: [한 줄 평가 — 긍정/부정 명확하게]</blockquote>
<p>&nbsp;</p>

<p>[어떤 계기로 사용/분석하게 됐는지 — 배경 스토리. 2~3문장]</p>
<p>[리뷰 관점/기준 명시 — "저는 [직군/상황]의 입장에서 평가했습니다"]</p>
<p>&nbsp;</p>

<!-- 목차 -->
<h2>목차</h2>
<ul>
  <li><a href="#summary">한줄 요약</a></li>
  <li><a href="#feature1">[분석 1]</a></li>
  <li><a href="#feature2">[분석 2]</a></li>
  <li><a href="#vs">경쟁 제품과 비교</a></li>
  <li><a href="#recommend">이런 분께 추천</a></li>
</ul>
<p>&nbsp;</p>

<h2 id="summary">한줄 요약</h2>
<p>[장점 2~3가지 + 단점 1~2가지 솔직하게]</p>
<p>&nbsp;</p>

<h2 id="feature1">[분석 섹션 1 — 가장 중요한 특징]</h2>
<h3>[세부 항목 1]</h3>
<p>[특징 설명 → 실제 사용 경험 → 내 평가 순서]</p>
<p>[수치나 비교 대상 포함]</p>
<h3>[세부 항목 2]</h3>
<p>[동일 구조]</p>
<p>&nbsp;</p>

<h2 id="feature2">[분석 섹션 2]</h2>
<p>[동일 구조]</p>
<p>&nbsp;</p>

<h2 id="vs">경쟁 제품/서비스와 비교</h2>
<h3>[어떤 상황에서 이게 나은가]</h3>
<p>[이유]</p>
<h3>[어떤 상황에서 다른 게 나은가]</h3>
<p>[솔직하게]</p>
<p>&nbsp;</p>

<h2 id="recommend">이런 분께 추천합니다</h2>
<h3>추천하는 경우</h3>
<p>[타겟 명확히]</p>
<h3>추천하지 않는 경우</h3>
<p>[맞지 않는 상황도 언급 — 신뢰도 상승]</p>
<p>&nbsp;</p>

<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->

<p>[최종 점수나 별점 + 총평 1~2문장]</p>

5. qa형 — Q&A (Featured Snippet 최적, 롱테일 키워드)

개념 설명, FAQ, "~가 뭔가요?" 쿼리에 적합.

<!-- 후킹: 패턴 C -->
<p>[가장 많이 검색되는 질문을 첫 문장으로 — 검색창 그대로]</p>
<p>[이 질문이 중요한 이유 + 이 글에서 다룰 범위]</p>
<p>&nbsp;</p>

<!-- 목차 -->
<h2>목차</h2>
<ul>
  <li><a href="#q1">[질문 1]</a></li>
  <li><a href="#q2">[질문 2]</a></li>
  <li><a href="#q3">[질문 3]</a></li>
  <li><a href="#q4">[질문 4 — 심화]</a></li>
  <li><a href="#summary">핵심 정리</a></li>
</ul>
<p>&nbsp;</p>

<h2 id="q1">[핵심 질문 1]</h2>
<p>[직접 답변 — 첫 문장에 핵심 답 먼저. 구글 스니펫 추출 고려]</p>
<h3>더 자세히</h3>
<p>[부연 설명 — 왜 그런지, 어떤 경우에 해당하는지]</p>
<p>[실제 사례나 예시]</p>
<p>&nbsp;</p>

<h2 id="q2">[핵심 질문 2]</h2>
<p>[답 먼저, 설명 나중]</p>
<h3>예시</h3>
<p>[구체적 예시]</p>
<p>&nbsp;</p>

<h2 id="q3">[핵심 질문 3]</h2>
<p>[동일 구조]</p>
<p>&nbsp;</p>

<h2 id="q4">[심화 질문 — 독자가 생각 못 했던 질문]</h2>
<p>[이 섹션이 전문성 어필 포인트]</p>
<p>&nbsp;</p>

<h2 id="summary">핵심 정리</h2>
<ul>
  <li>[Q1 핵심 답 — 한 줄]</li>
  <li>[Q2 핵심 답 — 한 줄]</li>
  <li>[Q3 핵심 답 — 한 줄]</li>
  <li>[Q4 핵심 답 — 한 줄]</li>
</ul>
<p>&nbsp;</p>

<!-- 내부 링크: 실제 발행된 URL만 사용. 모르면 섹션 전체 생략 -->

<p>[추가 궁금한 점은 댓글로 — 독자 참여 유도]</p>

포맷 선택 가이드

글 주제추천 포맷
도구/서비스 소개, 경험 공유story
설치법, 사용법, 단계별 방법howto
추천 목록, 비교 정리list
심층 분석, 솔직 리뷰review
개념 설명, 자주 묻는 질문qa

이미지 규칙

  • --related-image-keywords에 영어 키워드 2~3개
  • --image-upload-limit 3, --minimum-image-count 1 기본값
  • 이미지는 설명 단락 위에 배치 — "시각 → 텍스트" 순서
  • 이미지 alt 태그: 핵심키워드 + 설명 형식 필수

발행 후 검증

npx viruagent-cli list-posts --provider tistory --limit 1

See Also

va-tistory, va-tistory-draft, va-shared

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.