v2.2.x 릴리스 노트

릴리스 날짜: 2026-05-10 버전: v2.2.0 (최신, MINOR) 업데이트 명령: /plugin marketplace update cowork-plugins

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

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

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 변환” 등).

전체 경로: 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
• Thariq Shihipar “The Unreasonable Effectiveness of HTML”

권장 체인:

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

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 설정 필요)

• .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.md: Version 배지 2.2.0, Skills 배지 108, v2.2.0 하이라이트 섹션 추가
• moai-content/README.md: 10개 → 11개 스킬 표기, html-report 행 추가

• moai-content description: html-report 관련 키워드 추가

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

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

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

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