메뉴
Hugo 블로그 글을 끝까지 작성하는 멀티스테이지 파이프라인. Research(자료·링크 검증) → Draft(blog-post-writing 준수) → QA(메타·Mermaid·링크) → PublishPrep(draft 해제 전 최종 확인) 순으로 한 세션에서 순차 실행한다. **한 세션에서 전체 사이클을 자동 진행**할 때 사용한다. 단계별 작성 규칙 자체가 필요하면 `blog-post-writing`을 참고한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
게시물 품질을 루브릭 점수로 채점하고, 임계값을 넘을 때까지(또는 최대 반복까지) 채점→수정→재채점을 반복하는 품질 개선 루프. blog-agent-pipeline의 순환 버전으로, quality-critic 서브에이전트(채점자)와 분리되어 동작하며 점수판(scoreboard)에 상태를 기록한다. draft 해제는 사람만 한다. 신규 초안 게이트·기존 게시글 재점검·야간 자율 실행에 사용한다.
컬렉션 글(content/collection/**/index.md, **/*.md)을 작성할 때 따르는 이론 중심 글쓰기 표준. 전문가 수준의 이론적 설명을 문단으로 먼저 서술하고 코드/표/다이어그램은 보충 자료로만 쓰도록 한다. 컬렉션 글 작성·보강, 기술 시리즈 글 작성 시 사용한다.
AI 보조 시리즈형 교육 글(컬렉션)의 본문 구성·깊이·slug·00 챕터·내용 완결성(석학/SME 기준: 오개념·개념 연결·1차 출처·과목별 필수 요소)·품질 체크리스트를 표준화한다. design-patterns, cleanarchitecture, optimization 시리즈, C++ 성능 트랙, 장문 기술 튜토리얼, 커리큘럼형 블로그 포스트를 작성·보강할 때 사용한다. blog-post-writing 스킬 및 rules-that-must-be-followed와 함께 적용한다.
42jerrykim.github.io Hugo 블로그의 모든 글쓰기·편집 작업에 적용되는 전역 필수 규칙. frontmatter(draft, tags, description, title), 날짜 확인, 본문 링크 검증, 독자용 본문 원칙, Mermaid 다이어그램 문법, 알고리즘 코드 주석 규칙, 직접 인용 검증을 포함한다. 글 작성·수정, 새 포스트 생성, 컬렉션 글 작업 시 항상 적용한다.
Hugo 블로그 포스트 작성을 위한 종합 가이드. 컬렉션/일반 포스트의 frontmatter 생성, 본문 구조 템플릿, SEO 최적화, 이미지/에셋 관리, 태그 선정(data/tags.yaml), 링크 검증, Mermaid 다이어그램, 한국어/영어 이중 언어 콘텐츠를 포함한다. 블로그 글 작성, 새 컬렉션 생성, 기술 블로그 포스트 작성 시 사용한다. Research→Draft→QA→PublishPrep 전체 파이프라인을 한 번에 진행하려면 `blog-agent-pipeline`을 참고한다.
content/post/ 하위 AI 도구·서비스 활용 글(Claude Code, ChatGPT, Cursor, AI 에이전트·플러그인·워크플로 가이드) 작성 가이드. 아키텍처/기능 설명·적용 시나리오·판단 기준·장단점 구조와 태그·체크리스트를 표준화한다. content/post/ 하위 AI 도구·서비스 소개·활용 가이드 글 작성 시 사용한다.
| name | blog-agent-pipeline |
| description | Hugo 블로그 글을 끝까지 작성하는 멀티스테이지 파이프라인. Research(자료·링크 검증) → Draft(blog-post-writing 준수) → QA(메타·Mermaid·링크) → PublishPrep(draft 해제 전 최종 확인) 순으로 한 세션에서 순차 실행한다. **한 세션에서 전체 사이클을 자동 진행**할 때 사용한다. 단계별 작성 규칙 자체가 필요하면 `blog-post-writing`을 참고한다. |
이 스킬은 한 세션에서 아래 네 단계를 순서대로 수행하도록 지시한다. 각 단계가 끝날 때마다 짧은 단계 요약(산출물, 미해결 이슈, 다음 단계 입력)을 사용자에게 보고한다.
관계: 전역 규칙은
rules-that-must-be-followed가 우선한다. 초안 구조·경로·태그 전략은blog-post-writing및reference.md를 따른다.
작업을 시작하기 전에 아래 스킬/파일을 확인한다 (이미 세션에 있으면 생략 가능).
| 적용 조건 | 스킬/파일 | 용도 |
|---|---|---|
| 항상 | rules-that-must-be-followed | draft, tags, description, title, 날짜, 링크 검증, Mermaid |
| 항상 | blog-post-writing | 경로, frontmatter, 본문 구조, 검증 체크리스트 |
| 항상 | reference.md | 제목·날짜·접두어, Hugo 내부 링크 |
| 항상 | data/tags.yaml | tags 25개 이상 선정 |
컬렉션 index.md 등 내부 링크 편집 시 | reference.md의 Hugo 컬렉션 내부 링크 절 | 내부 링크 형식 |
| 컬렉션 글 작성 시 | collection-writing-standards | 이론 중심 작성 표준 |
| optimization·designpattern 등 교육 시리즈 글 | educational-content-writing | 품질 3원칙, 안티패딩 |
| 대상 포스트가 속한 컬렉션 | 아래 컬렉션별 스킬 표 참고 | 컬렉션 전용 규칙 |
컬렉션별 작성 스킬 (content/collection/<컬렉션>/ 글일 때)
| 컬렉션 폴더 | 적용 스킬 |
|---|---|
Algorithm/ | algorithm-post-writing |
Vocabulary/ | vocabulary-post-writing |
Movies/ | movie-review-writing |
TV-Show/ | tv-series-review-writing |
bashshell/ / cmd/ | shell-command-post-writing |
일반 포스트 성격별 작성 스킬 (content/post/ 글일 때, 주제 성격으로 판단)
| 성격 | 적용 스킬 |
|---|---|
| 개발·프로그래밍 | dev-programming-post-writing |
| 시스템·인프라 | systems-infra-post-writing |
| AI·도구 활용 | ai-tools-post-writing |
| 교양·생활 | life-knowledge-post-writing |
목적: 주제에 맞는 근거·용어·참고 자료를 모으고, 본문에 넣을 URL만 남긴다.
입력: 사용자가 제공한 주제, 컬렉션 유형(또는 일반 포스트), 선택 키워드.
산출물
content/post/<연도>/ vs content/collection/<컬렉션>/<연도>/, 폴더명 YYYY-MM-DD-<slug> (컬렉션별 예외는 해당 스킬을 따름).체크리스트
Get-Date -Format "yyyy-MM-dd" 확인 예정임을 메모에 명시.단계 종료 보고: 검증 링크 개수, 메모 요약, 선택한 콘텐츠 경로.
목적: index.md 초안을 저장소에 생성하거나 갱신한다.
입력: Stage 1 산출물.
행동
date / lastmod에 사용.blog-post-writing의 Phase 2~4에 따라 폴더·index.md·에셋 생성.draft: true, title ≤70자, description ~150자, tags ≥50 (영·한, data/tags.yaml 기반), categories 등 컬렉션 요구 필드 반영.rules-that-must-be-followed 문법 준수.교육 시리즈·특수 컬렉션: educational-content-writing, 컬렉션별 작성 스킬(위 표) 등 적용 대상 스킬을 이 단계에서 함께 호출한다.
체크리스트 (초안 완료 시)
draft: truereference.md의 Hugo 컬렉션 내부 링크 규칙 준수단계 종료 보고: 생성·수정한 파일 경로 목록, 미완료 에셋(이미지·워드클라우드 등) 여부.
목적: 규칙 위반·누락을 수정한다. 새 주장·새 링크 대량 추가는 하지 않는다 (필요 시 Research로 되돌리라고 사용자에게 안내).
입력: Stage 2에서 확정한 index.md 경로.
행동
blog-post-writing § Phase 5 체크리스트를 전항목 점검.</br> 규칙 재확인.educational-content-writing §2.5).educational-content-writing §0/§4.4).체크리스트
educational-content-writing 구조·안티패딩·코드 컴파일 가능·수치 근거 요구 충족단계 종료 보고: 수정한 항목 요약, 남은 리스크(선택).
목적: 배포 직전 사람이 검토했다는 전제 하에 draft: false 전환만 안내하거나 수행한다.
원칙
draft: true를 유지한다.lastmod를 터미널 오늘 날짜로 갱신한다.체크리스트
draft: false단계 종료 보고: 최종 상태(draft 값), 권장 후속 작업(로컬 hugo 빌드 등).
post-quality-loop로 전환할 수 있다.