Communitygithub.com

ericforai/html-first-workflow

Claude Code / Codex 스킬: 산출 문서(스펙, PRD, 리뷰, 보고서)는 단일 파일 HTML로 전환하고, 채팅/코드는 마크다운을 유지합니다.

html-first-workflow란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Codex)에서 산출 문서를 생성할 때 마크다운 대신 단일 HTML 파일을 사용하도록 안내합니다. 스펙, PRD, 코드 리뷰, 보고서 등 공유 및 시각적 품질이 중요한 문서는 HTML로 작성하여 더 나은 렌더링과 일관된 포맷을 제공합니다. 반면, 채팅 대화나 코드 조각은 기존 마크다운을 그대로 사용하여 간결함을 유지합니다. 이를 통해 개발자는 문서의 목적에 따라 적절한 포맷을 선택할 수 있어, 협업 효율성과 문서 가독성을 높일 수 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add ericforai/html-first-workflow

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

html-first-workflow은(는) 무엇을 하나요?

Claude Code / Codex 스킬: 산출 문서(스펙, PRD, 리뷰, 보고서)는 단일 파일 HTML로 전환하고, 채팅/코드는 마크다운을 유지합니다.

개요

이 스킬은 AI 에이전트가 문서를 생성할 때, 공유와 시각적 표현이 중요한 산출물은 HTML로, 대화형 콘텐츠는 마크다운으로 작성하도록 지시합니다. HTML 파일은 단일 파일(인라인 CSS/JS 포함)로 생성하여 외부 의존성 없이 바로 열람 가능합니다.

지원 플랫폼

  • Claude Code
  • Codex

사용 방법

  1. @ericforai/html-first-workflow를 컨텍스트에 포함합니다.
  2. 문서 유형에 따라 AI 에이전트가 자동으로 적절한 포맷을 선택합니다.
    • HTML 사용: 스펙(spec), PRD, 디자인 리뷰, 정기 보고서
    • 마크다운 유지: 채팅 메시지, 코드 스니펫, 간단한 노트

예시

프롬프트 예시:

@ericforai/html-first-workflow 이번 스프린트의 PRD를 작성해줘.

그러면 AI는 단일 HTML 파일로 예쁘게 포맷된 PRD를 생성합니다.

참고

  • HTML 파일은 반드시 단일 파일이어야 하며, 외부 리소스를 참조하지 않습니다.
  • CSS는 인라인 또는 <style> 태그로 포함합니다.
  • JavaScript는 인라인으로 포함합니다.

이 스킬은 원본 저장소에서 확인할 수 있습니다.

관련 스킬