Blog Generator

Execution Algorithm

Step 1: Parse Input

Extract the content source from user message:

Examples:

• /blog-generator ~/notes/rag-explained.md → Read file
• /blog-generator https://example.com/article → Fetch URL
• /blog-generator "RAG는 질문에 답하기 전에..." → Direct text
• Select text in editor + "블로그로 변환해줘" → IDE selection

If no content detected:

Ask user: "블로그로 변환할 내용을 제공해주세요. 파일 경로, URL, 또는 텍스트를 입력할 수 있습니다."

Step 2: Reader Interview

Ask the user 3 questions using a single AskUserQuestion call with all 3 questions:

AskUserQuestion(
    questions=[
        {
            "question": "Who is the target audience for this blog post?",
            "header": "Audience",
            "options": [
                {"label": "Beginner (Recommended)", "description": "입문자. 기본 개념부터 친절하게 설명"},
                {"label": "Intermediate", "description": "실무자. 핵심 개념은 알지만 깊이 있는 설명 필요"},
                {"label": "Advanced", "description": "시니어/전문가. 심화 내용과 트레이드오프 중심"}
            ],
            "multiSelect": false
        },
        {
            "question": "What tone and style should the blog post have?",
            "header": "Tone",
            "options": [
                {"label": "Tutorial (Recommended)", "description": "단계별 학습 가이드. 따라하기 쉬운 구성"},
                {"label": "Professional", "description": "기술 문서 스타일. 정확하고 간결한 톤"},
                {"label": "Conversational", "description": "대화체. 친근하고 읽기 편한 스타일"}
            ],
            "multiSelect": false
        },
        {
            "question": "Which language should the blog post be written in?",
            "header": "Language",
            "options": [
                {"label": "Korean (Recommended)", "description": "한국어로 작성. 기술 용어는 영문 병기"},
                {"label": "English", "description": "Written entirely in English"},
                {"label": "Mixed (Ko+En)", "description": "한영 혼용. 헤더는 영어, 본문은 한국어"}
            ],
            "multiSelect": false
        }
    ]
)

If config.yaml exists, show config defaults in the recommended labels. If user skips or selects defaults, use config values.

Step 3: Read Configuration

Read ~/.claude/skills/blog-generator/config.yaml:

output_dir: "~/Documents/blog/posts"
default_language: "ko"
default_audience: "intermediate"
default_tone: "tutorial"
auto_commit: false
auto_push: false

If config not found: Use these defaults and continue without asking. The output directory will be created automatically.

Apply interview answers: Override config defaults with user's interview selections.

Step 4: Analyze Content & Build Outline

Analyze the raw input to extract:

Generate an outline (internal, not shown to user):

1. Hook/Introduction angle: [what relatable scenario to start with]
2. Section breakdown:
   - Section A: [concept] → [explanation approach]
   - Section B: [concept] → [explanation approach]
   - ...
3. Code example placement: [where code fits in the narrative]
4. Conclusion angle: [how to wrap up with takeaways]

Step 5: Generate Blog Post

Write the blog post following this template structure. Adapt sections based on content — not every section is required for every post.

---