---
title: "v2.2.x 릴리스 노트"
weight: 3
description: "마크다운 보고서를 단일 파일 HTML로 변환하는 html-report 신규 스킬. Thariq Shihipar의 'unreasonable effectiveness of HTML' 아키텍처 기반, 외부 의존성 0, 12-25KB 산출물."
geekdocBreadcrumb: true
---
**릴리스 날짜**: 2026-05-10
**버전**: v2.2.0 (최신, MINOR)
**업데이트 명령**: `/plugin marketplace update cowork-plugins`

```mermaid
flowchart LR
    A["마크다운 보고서"] --> B["html-report<br/>단일 파일 HTML"]
    B --> C["12-25KB<br/>외부 의존성 0"]

    style A fill:#eaeaea,stroke:#6e6e6e,color:#09110f
    style C fill:#e6f0ef,stroke:#144a46,color:#09110f
```

## Highlights

v2.2.0은 **마크다운 보고서를 단일 파일 HTML로 변환**하는 `moai-content:html-report` 스킬을 신규 도입하는 MINOR 릴리스입니다. Thariq Shihipar의 **"The Unreasonable Effectiveness of HTML"** 철학을 기반으로, 외부 의존성이 거의 없는(한글 웹폰트 CDN 1개만 예외) **12-25KB 자체 완결형 HTML**을 생성합니다.

6개 보고서 모드(status/incident/plan/explainer/financial/pr)와 6개 통합 테스트를 포함하며, 기존 보고서 워크플로우에 손쉽게 통합할 수 있습니다. 인쇄 친화, 6개 폰트 스택 지원, CSS 변수 8종 등 실용 기능을 모두 갖추고 있습니다.

이번 릴리스는 또한 **SEO/AGO 최적화**를 대거 완료했습니다 — GitHub repository description, homepage URL, topics 20개 등록, Discussions 활성화, README Hero 섹션 재구성, FAQ 추가, llms.txt 제공으로 LLM 학습 최적화까지. 이는 cowork-plugins를 Google 검색과 LLM 크롤러 모두에서 발견 가능하게 만드는 중요한 단계입니다.

마켓플레이스는 107 → **108 스킬**, 플러그인은 21개 그대로입니다. **Breaking change 없음** — 기존 워크플로우 그대로 동작하며, 새로운 `html-report` 스킬은 필요할 때 자연어로 호출하면 됩니다("주간 보고서 HTML로", "재무제표 HTML 변환" 등).

## What's New (추가)

### moai-content: html-report (마크다운 → 단일 파일 HTML 변환기)

**전체 경로**: `moai-content:html-report`

**한 줄 기능 요약**: 마크다운 보고서를 인라인 SVG + vanilla JS로 구성된 단일 파일 HTML로 변환. 외부 프레임워크 의존성 0, 12-25KB 초경량 산출물.

**주요 입출력 및 지원 범위**:
- **입력**: 마크다운 보고서 파일
- **출력**: 단일 파일 HTML (자체 완결형, 인라인 CSS/JS/SVG)
- **옵션**: `mode` (status/incident/plan/explainer/financial/pr), `slug`, `output_path`, `font_stack`, `dark_mode`

**6개 보고서 모드**:
- **status**: 주간 현황 / 태스크 리스트
- **incident**: 포스트모템 / 우발 대응
- **plan**: 구현 계획 / 사업 계획
- **explainer**: 기능 설명 / 개념 해설
- **financial**: 재무 보고 / 수익 동향
- **pr**: PR 서사 / 관계자 알림

**인라인 SVG + vanilla JS**:
- 12-25KB 산출물, 페이지 로딩 거의 무영향
- `<script>`, 이벤트 핸들러, 차트·테이블 인터랙션은 모두 inline
- **외부 JS/CSS 프레임워크 의존성 0**

**한글 폰트 매핑**:
- Pretendard (기본), Noto Serif KR (serif mode), Noto Sans KR (sans), 조선일보명조 (조선일보 수거), KoPubWorld 명조, JetBrains Mono (코드 블록)
- 모드별 자동 선택 또는 `font_stack` 오버라이드

**인쇄 친화**:
- `@media print` 자동 적용
- 페이지 나누기 최적화
- 하이퍼링크 유지

**CSS 변수 계약**:
- `--ivory`, `--slate`, `--clay`, `--oat`, `--olive`, `--sans`, `--serif`, `--mono` 8개
- 모드별 기본값 포함

**P1 컨슈머 4종 호환성 검증**:
- executive-summary, financial-statements, sbiz365-analyst, daily-briefing 모두 4/5 호환성 통과

**6개 템플릿** + **6개 통합 테스트** + **design-tokens.md** (CSS 변수 명세) + **fonts.md** (폰트 매핑·CDN)

**관련 링크**:
- [SKILL.md](https://github.com/modu-ai/cowork-plugins/blob/v2.2.0/moai-content/skills/html-report/SKILL.md)
- [Thariq Shihipar "The Unreasonable Effectiveness of HTML"](https://thariq.substack.com/p/the-unreasonable-effectiveness-of)

**권장 체인**:
```
[텍스트 스킬] → moai-core:ai-slop-reviewer → moai-content:humanize-korean → moai-content:html-report mode=<X>
```

### SEO/AGO 최적화 자산 대거 추가

**GitHub 메타데이터**:
- **Repository description**: "Claude Cowork / MoAI-ADK — 스킬·플러그인·에이전트 생태계. 21 plugins · 108 skills covering SEO, content, office, media, finance, design, business, research, legal, and more."
- **Homepage URL**: https://cowork.mo.ai.kr
- **Topics 20개 신규 등재**: anthropic, claude-skills, claude-cowork, moai-adk, korean-skills, markdown, office, content-creation, media-generation, finance, design, business, research, legal, seo, llms-txt, coworking, ai-agents, plugin-ecosystem, korea

**README 최적화**:
- **Hero 섹션 재구성**: 30초 표 + 핵심 가치 제안
- **FAQ 섹션 추가**: 10개 자주 묻는 질문
- **llms.txt 제공**: LLM 크롤러 학습 최적화

**Discussions 활성화**:
- 카테고리 6개: 공지/Q&A/Ideas/Show&Tell/한국어/English (UI 설정 필요)

## Changed (변경)

### 버전 동기화 (130지점)
- `.claude-plugin/marketplace.json`: `metadata.version` 2.1.0 → **2.2.0**
- 모든 plugin.json (21개): `version` → **2.2.0**
- 모든 SKILL.md frontmatter (108개): `version: 2.1.0` → `version: 2.2.0`
- 총 **130 지점** 동기화 완료

### README 갱신
- **루트 README.md**: Version 배지 2.2.0, Skills 배지 108, v2.2.0 하이라이트 섹션 추가
- **moai-content/README.md**: 10개 → **11개** 스킬 표기, html-report 행 추가

### Marketplace
- **moai-content description**: html-report 관련 키워드 추가

## 사용 예시 프롬프트

1. "주간 보고서 마크다운을 HTML로 변환해줘"
2. "재무제표를 단일 파일 HTML로 만들어줘"
3. "포스트모템을 인쇄 친화적인 HTML로 변환해줘"

## 비교표

| 기존 방식 | html-report 사용 |
|---------|-----------------|
| 마크다운 그대로 공유 | HTML 단일 파일로 배포 |
| 외부 뷰어 필요 | 브라우저에서 바로 열기 |
| 인쇄 최적화 미흡 | `@media print` 자동 적용 |
| 폰트·스타일 제한 | 6개 폰트 스택 지원 |
| 용량 큰 PDF | 12-25KB 초경량 HTML |

## Migration

**사용자 조치**: `/plugin marketplace update cowork-plugins` 후 플러그인 상세 재진입

**Breaking change 없음** — 기존 워크플로우 그대로 동작합니다. 새로운 `html-report` 스킬은 필요할 때 자연어로 호출하면 됩니다.

## Attribution

**Thariq Shihipar "The Unreasonable Effectiveness of HTML"**: 이 스킬의 핵심 아키텍처 아이디어는 Thariq Shihipar의 블로그 포스트에서 영감을 받았습니다. — https://thariq.substack.com/p/the-unreasonable-effectiveness-of
