convez.ai
SkillDesenvolvimento WebAvançado
coreline-ai

Adaptive HTML Final

coreline-ai/skills-html-showcase

Gerador HTML adaptativo multi-modo com 17 roteamentos, 8 temas, zero-JS

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que transforma URLs, PDFs, textos e repositórios GitHub em HTML profissional em coreano, roteando inputs entre 17 modos especializados (análise de repositório, guias, artigos, checklists). Inclui 8 temas CSS, 3 perfis visuais (widget/diagrama/automático), zero JavaScript externo e pipeline de qualidade estática.

Instalação

$npx convez-ai coreline-ai/skills-html-showcase

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Converter documentação técnica e READMEs em artigos estruturados
  • Gerar dashboards SEO, comparativas e case studies a partir de análise de repositório
  • Transformar conteúdo educacional (vídeos, manuais) em módulos de aprendizado
  • Criar HTMLs auto-contidos com validação estática de qualidade e acessibilidade

Veredito

Skill robusto e opinado para geração de HTML estruturado em escala, com ênfase em determinismo cross-agent e qualidade estática. Vencimento: domínio específico (coreano) e complexidade multi-modo podem dificultar adaptação para outros idiomas, mas arquitetura é solidamente engineered.

README

A tradução para o português deste README ainda está na fila.

🎨 Adaptive HTML Final

skill version modes profiles themes libraries svg→html lang external JS cross-agent python

입력 자료를 17개 모드로 라우팅해 전문가급 한국어 HTML 콘텐츠를 만드는 단일 통합 스킬 — GitHub 저장소 실사·GitHub 기능/도입 가이드·YouTube 영상·매뉴얼 분석, 8-테마, 비주얼 프로파일(위젯형·도식형·자동) 선택

URL·PDF·텍스트·메모·기술 문서·블로그 초안·SKILL.md/.skill·GitHub 저장소 URL·YouTube URL/자막·제품 매뉴얼을 받아 학습자료, 전문가 리포트, 저장소/영상/매뉴얼 분석, 아티클, 교육 모듈, 블로그 원고, SEO 대시보드, 플랫폼 변환, 스킬 감사, 레퍼런스, 비교, 케이스 스터디, 랜딩, 체크리스트로 변환합니다.

Overview · 최근 업데이트 · 모드 · 비주얼 프로파일 · 쇼케이스 갤러리 · 스킬 구조 · 사용법


📖 Overview

adaptive-html-final은 html-for-beginners → adaptive-html-blog-writer → adaptive-html-learning-ultimate 계열을 하나로 합친 최종 통합본입니다. 단순 HTML 변환기가 아니라, 입력을 분석해 목적별 정보 구조로 재구성하는 파이프라인을 실행합니다.

┌──────────┐   ┌─────────────────────┐   ┌────────────┐   ┌──────────┐
│ 입력 분석 │ ─▶│ 사실/해석/추론/확인필요 │ ─▶│ 독자 수준 판단 │ ─▶│ 모드 선택 │
└──────────┘   └─────────────────────┘   └────────────┘   └────┬─────┘
                                                                │
   ┌────────────┐   ┌──────────────────┐   ┌────────────┐   ┌──▼───────┐
   │ 파일/링크 제시 │◀─ │ 품질 게이트 검수    │◀─ │ editorial 렌더 │◀─ │ 레이아웃 선택 │
   └────────────┘   └──────────────────┘   └────────────┘   └──────────┘
원칙내용
사실성확인되지 않은 최신 정보·수치·가격·날짜는 단정하지 않고 확인 필요로 표시
무 JS외부/동작 JavaScript 미사용 (JSON-LD 메타데이터만 허용)
단일 HTML코어 CSS(theme·components·visual-components·layouts·print)와 조건부 자산을 inline으로 포함한 자기완결 HTML + 합본 해시 마커
8-테마#ahf-light/#ahf-light2/#ahf-white/#ahf-dark/#ahf-dark2/#ahf-blue/#ahf-skyblue/#ahf-sepia 라디오 세그먼트 스위처 기반 CSS-only 테마
비주얼 프로파일기동 시 widget(인터랙티브 위젯) / diagram(SVG→HTML 도식) / auto(둘 다, 기본) 선택 — 코어 공유, 프로파일이 라이브러리만 게이트
두 위젯 라이브러리CSS 뷰 위젯 wg-01~20(인터랙션) + SVG→HTML 템플릿 vt- 21종(본문 삽입 도식), 둘 다 무 JS·네임스페이스 격리
크로스-에이전트 결정론루트 AGENTS.md가 결정론 진입점 — Claude Code·Codex·Gemini가 동일 인자로 동일 출력. 정적 게이트 validate_output.py --profile
접근성lang="ko" · skip link(#main) · 단일 h1 · :focus-visible · prefers-reduced-motion · AA 대비
editorial DNA오프화이트 배경, Pretendard 단일 sans 스택(외부 세리프 폰트 금지, v5.9.2), 의미 박스, h2 빨간 원번호

🆕 최근 업데이트

v5.10.0 (2026-06-09) — 17번째 모드 github_feature_usage 추가 (GitHub 기능·도입 가이드)

전략 한 줄 결론: github_analysis가 "도입해도 되나?(실사·리스크·투자판단)"라면, github_feature_usage는 **"무엇을 해주나·어떻게 쓰나·어디에 맞나"**를 실제 화면(스크린샷) 중심으로 보여주는 도입 가이드다. 어조·형식이 달라 독립 레이아웃으로 분리했다.

영역변경 내용
신규 모드github_feature_usage 추가 — 전체 라우터 17모드. 트리거 tie-breaker로 github_analysis(실사)와 분리
레이아웃assets/layouts/github-feature-usage.html + .layout-github-feature CSS. github의 카드/그리드 어휘(repo-evidence-grid·repo-signal-grid·repo-action-grid·code-tour)를 공유 + 기능 지도·스크린샷 갤러리(feature-screens-grid) 추가
섹션 모델positioning → overview(hero) → feature toc → 기능 지도 → 핵심 기능(wg-14) → 기술스택 → 아키텍처 → 디렉토리 → 실제 화면 → 사용자/관리자 기능 → 시작 방법 → 적합성 → 도입 전 확인 → 최종 판단
검증 게이트MODE_TEMPLATE_CONTRACTS에 layout-github-feature 등록 + github_feature_usage_contract_gate(섹션 카드·body-icon·기능지도/실제화면·출처 한계) 신설. \blayout-github\b가 layout-github-feature까지 오탐하던 경계 버그 수정
전략 문서references/github-feature-usage-system.md(섹션 모델·스크린샷 계약·실사와의 차이) 추가
거버넌스test_governance_gates.py 신규 게이트 테스트 3종 → 80/80 통과

v5.8.x~v5.9.x 누적: youtube/manual 깊이 계약 + 넓고-얇음 게이트(5.8), 시각 정본 게이트 3종·examples 재인라인(5.9.0), wg-10 데모 섹션 한정 full-width(5.9.1), 외부 세리프 폰트 금지·vt-02 정합·toc-map/manual 회귀 방지(5.9.2).

v5.9.2 (2026-06-08) — 폰트·decision-tree·toc-map 회귀 방지

영역변경 내용
폰트 정합성외부 세리프 폰트 링크/스택/과거 세리프 토큰 금지, pull-quote를 Pretendard 굵은 sans 톤으로 통일
시각 템플릿vt-02 decision-tree 3카드 정합성, h3 마진 보정, 본문 title spacing 회귀 방지
공식 목차toc-map chip-nav 목차 계약을 layout·validator에 반영해 구형 목차 회귀 차단
운영 기준manifest.json 기준 현행 버전은 5.9.2이며, 생성/검증 시 manifest와 source snapshot을 우선 확인

v5.7.0 (2026-06-07) — YouTube Analysis + Manual Analysis 15·16번째 모드 추가

전문가 전략 한 줄 결론: YouTube 분석은 “영상 요약”이 아니라 타임스탬프 근거·댓글 신호·주장 위험·재사용 전략을 분리하는 콘텐츠 실사 리포트이고, Manual 분석은 “문서 요약”이 아니라 역할별 첫 성공 경로·안전 조건·트러블슈팅·운영 런북으로 재배열하는 실행 매뉴얼입니다.

영역변경 내용
신규 모드youtube_analysis, manual_analysis 추가 — 전체 라우터 16모드
레이아웃assets/layouts/youtube-analysis.html, assets/layouts/manual-analysis.html, .layout-youtube/.layout-manual CSS 추가
전략 문서references/youtube-analysis-system.md, references/manual-analysis-system.md, 전용 recipe 2종 추가
검증 게이트validate_output.py에 YouTube evidence/source limits/no-embed 계약과 Manual role/safety/troubleshooting/source limits 계약 추가
예제/스모크examples/15_youtube_vibecoding_gap.html, examples/16_manual_product_runbook.html, 신규 output 2종 게이트 OK

최신 스모크 산출물:

v5.3.0 (2026-06-06) — GitHub Analysis 14번째 모드 추가

전문가 전략 한 줄 결론: GitHub 저장소 분석은 README 재요약이 아니라 “이 저장소를 이해·실행·채택·감사해도 되는가?”를 판단하게 만드는 실사 리포트다. github_analysis는 verdict, quickstart, repo health, file tour, security/license, risk matrix, next actions를 질문 중심 목차로 재구성한다.

영역변경 내용
신규 모드github_analysis — GitHub 저장소 URL/owner/repo 입력을 사용자 질문 중심 HTML 리포트로 변환
레이아웃assets/layouts/github-analysis.html, .layout-github CSS, repo signal/grid/card 클래스 추가
결정표SKILL.md §0.6, AGENTS.md §3, references/mode-selection.md를 14모드로 동기화
시각 매핑vt 1순위 hero-map, 보강 quality-gate·file-tour·risk-matrix·timeline·decision-tree; wg 보강 wg-11·wg-04·wg-14·wg-16
전략 문서references/github-analysis-system.md, recipes/github-analysis.prompt.md, 개발 계획 dev-plan/implement_20260606_003800.md 추가

기존 output/adaptive-html-final-13-topics-20260605_083433/는 v5.2.3 기준 13-topic 캐노니컬 산출물로 유지합니다. 14-mode 신규 쇼케이스 재생성은 후속 작업입니다.

v5.2.1 → v5.2.3 (2026-06-05) — 캐노니컬 산출물 정련 + 전문가 팀 콘텐츠 보강 + 가독성 승격

전문가 리뷰 한 줄 결론: 스킬 본체(13모드·3프로파일·무 JS·정적 게이트 3층)는 그대로 견고하고, 이번 차수는 게이트를 완전 통과하는 단일 캐노니컬 산출물(13-topics)을 디자인·접근성·콘텐츠 모든 면에서 출시 등급으로 끌어올렸다. 결함은 본체가 아니라 "전시 자산"에 몰려 있었고, 그 적자를 해소했다.

1) 스킬 자산 승격 (v5.2.0 → v5.2.1)

자산변경
assets/body-icons.css:has() 기반 icon+text 정렬 규칙 — .label/h1/h2/h3가 body-icon을 직접 자식으로 가지면 왼쪽 아이콘 + 세로중앙 + 일정 간격으로 정렬(무 JS)
assets/theme.css.header 48rem 단일측정 캡 해제 → 헤더가 컨테이너 폭(아래 섹션과 동일)으로 정렬
버전/이력manifest.json·SKILL.md·CHANGELOG.md 5.2.1 동기화, 코어 해시 78f7c0… → 3b4887…

2) 13-topics 캐노니컬 산출물 정련 (게이트 OK 유지)

  • 콘텐츠: 13명 전문가 에이전트(아키텍트·에디터·DB 교육설계자·SEO 전략가·SRE·보안 레퍼런스 작성자 등)가 모든 얕은 섹션을 보강 — 페이지당 표(전부 <caption>)·카드그리드·코드 예시·콜아웃·체크리스트를 대폭 확충(각 191–204KB).
  • 아이콘: 번호 헤딩 130개 전부 아이콘 보유(누락 43개 맥락 배정 보강), 헤딩 아이콘 42px, 라이트/화이트/다크 테마 적응 박스.
  • 레이아웃: 모든 콘텐츠 섹션을 카드 뷰로 통일, 이중 박스/그라데이션 정리, a11y·impact 카드 간격·표 첫 열 줄바꿈 등 미세 가독성 보정.
  • 검증: validate_output.py OK, test_governance_gates.py 25/25, 14개 HTML 전부 h1 1개·표 caption 100%·HTTP 200.

3) 문서 정리 (저장소 위생)

  • 루트의 v4~v5.0 시점 고정 리뷰/분석/계획 6종을 docs/archive/로 이관(SUPERSEDED 배지 + 색인).
  • 루트는 현행 3종만 유지: README.md · AGENTS.md(머신 고정 절대경로 → 저장소 루트 상대경로로 정정) · Guide.md(v5.2.1 전면 재작성).

4) 추가 스킬 승격 (v5.2.2·v5.2.3 — 조건부 자산만, 코어 해시 불변)

13-topics에서 반복 적용하던 보편적 개선을 스킬 기본값으로 올려, 향후 모든 출력에 자동 적용되게 했습니다.

버전자산승격 내용
v5.2.2body-icons.css아이콘 박스 배경 테마 적응(white=순백/dark=카드 표면) — 다크에서 흰 박스로 떠 보이던 보편 결함 해소. .lede-note 컨텍스트 라벨 아이콘 정렬
v5.2.3editorial-patterns.css가독성 승격 — .a11y-grid/.a11y-card/.a11y-points 줄·카드 간격 확대, .impact-card 아이콘 하단 여백

갤러리 취향·출력 전용 디자인(헤더 kicker 폰트·전 섹션 카드 뷰·core-insight 재배경 등)은 전역 기본값화 시 모든 출력 모양이 바뀌므로 의도적으로 13-topics page-local로만 유지했습니다.

⚠️ 알려진 한계: 본 저장소는 정적 게이트가 매우 엄격하지만 CI(GitHub Actions)가 아직 없어 과거 output/·examples/ 다수는 코어 CSS 진화로 해시가 드리프트해 현재 게이트에서 FAILED가 납니다. 신뢰 기준선은 항상 13-topics 산출물입니다.


adaptive-html-final은 2026-06-05 기준 v5.2.0으로 갱신되었습니다. 핵심은 "기존 13모드/3프로파일 구조는 유지하면서, 실제 브라우저 캡처에서 발견된 가독성·레이아웃 회귀를 스킬 자산에 직접 반영"한 것입니다.

영역변경 내용
3-테마 시스템assets/theme-dark.css에 라이트(크림 기본)·화이트(순백)·다크(proper-black) 토큰을 통합하고, #theme-toggle 체크박스를 name="ahf-theme" 라디오 3-세그먼트로 교체. 전부 :has() 기반 무 JS
모바일 테마바모바일에서는 .ahf-themebar를 문서 흐름 안의 static 컨트롤로 전환해 표·체크리스트·메타 칩을 가리지 않도록 보정
CSS 무결성출력 폴더의 sources/assets/*.css, sources/css-integrity.json, sources/adaptive-html-final-manifest.json을 현재 스킬 자산과 동기화. 코어 해시 3b4887c281115b3c7a5ade783cd05464c14c043e8f888615b4c069fce0029b09 (v5.2.2·v5.2.3은 조건부 자산만 변경 → 코어 해시 불변)
검증기 강화scripts/validate_output.py가 source manifest 내용 불일치, stale CSS snapshot, legacy #theme-toggle, 외부/동작 JS, table caption, h1/#main 구조를 더 엄격히 검사
실제 화면 검증Playwright 기준 390px 모바일 / 1440px 데스크톱, 라이트·화이트·다크 조합으로 주요 페이지를 재촬영하고 가로 넘침·텍스트 대비·테마 컨트롤 겹침을 확인

이번 회귀 수정 내역

대상수정
wg-01 three-code-approaches카드 가로 넘침과 코드 줄 잘림을 막도록 코드 블록 wrapping/overflow 규칙 보강
wg-12 postmortem timelineSEV-2 칩 대비를 --link-on-dark 배경 + dark text로 보정, 표 body row header가 전역 th 다크 스타일을 먹어 검은 칸으로 튀는 문제 수정
wg-16 implementation-plan출시 계획 표 row header 텍스트가 안 보이던 문제를 background:var(--card)/테마 추종 스타일로 보정
vt-02 decision-tree3카드 + 2화살표 구조를 5컬럼으로 고정해 comparison 모드의 의사결정 트리가 깨지던 문제 수정
vt-21 soft-workflow-map다크모드에서 카드 제목·본문 대비가 낮아지는 케이스를 보정
.try final actioncomparison/case 모드의 마지막 실행 섹션이 라이트/화이트에서도 검은 패널로 보이던 문제를 테마 추종 카드로 조정
.table-scroll모바일 표 폭이 문서 전체를 밀어내지 않도록 max-width:100%와 수평 스크롤 래퍼 규칙 추가

최신 로컬 산출물

이번 점검의 최신 13개 주제 산출물은 output/adaptive-html-final-13-topics-20260605_083433/에 있으며, 웹 라이브 갤러리는 쇼케이스 갤러리에서 index + 13개 모드를 바로 열 수 있습니다.

항목값
프로파일auto
스킬 버전5.2.3
HTML 수index.html + 13개 페이지
콘텐츠13명 전문가 에이전트가 모든 얕은 섹션 보강 (페이지당 표·카드·코드·콜아웃·체크리스트 대폭 확충, 표 caption 100%)
검증validate_output.py: OK, test_governance_gates.py: 25/25 checks passed
코어 CSS 해시3b4887c281115b3c7a5ade783cd05464c14c043e8f888615b4c069fce0029b09
# 최신 산출물 검증
python3 skills/adaptive-html-final/scripts/validate_output.py \
  output/adaptive-html-final-13-topics-20260605_083433 \
  --skill-dir skills/adaptive-html-final

# 로컬 브라우저 확인
python3 -m http.server 8770 -d output/adaptive-html-final-13-topics-20260605_083433
# → http://127.0.0.1:8770/index.html

📦 17개 모드

요청에서 여러 트리거가 감지되면 우선순위가 높은 모드가 선택되며, 사용자가 모드를 명시하면 그 지시가 우선합니다. GitHub URL은 의도에 따라 분기됩니다 — 코드 건전성·리스크·투자판단 = github_analysis, 기능·사용법·도입 가이드(실제 화면) = github_feature_usage.

#Mode언제 쓰나Layout
1skill_auditSKILL.md/.skill 분석·개선·통합skill-audit-report.html
2platform_blog티스토리·벨로그·네이버·워드프레스 변환platform-adaptation.html
3seo_dashboard제목·메타·태그·검색 의도 설계seo-dashboard.html
4education_html강의·온보딩·실습·퀴즈course-module.html
5github_analysisGitHub 저장소 URL/owner/repo 실사·README·이슈·릴리스·라이선스·리스크 분석github-analysis.html
6youtube_analysisYouTube URL/자막/댓글 발췌를 근거 지도·주장 위험·재사용 전략으로 분석youtube-analysis.html
7manual_analysis제품/운영 매뉴얼을 역할별 실행 경로·안전 조건·트러블슈팅으로 재구성manual-analysis.html
8expert_html전문가 리포트·아키텍처·리스크 진단expert-report.html
9article_html공개 아티클·매거진형 글magazine-article.html
10blog_writer블로그 글·포스팅·경험담personal-blog-essay.html
11beginner_html초보자 설명·비유·용어 풀이beginner-learning.html
12reference_html레퍼런스·API 문서·치트시트·옵션표reference-manual.html
13comparison_html비교·장단점·선택 기준comparison-matrix.html
14case_study_html사례 연구·회고·프로젝트 기록case-study.html
15landing_brief_html소개·랜딩·요약 페이지landing-brief.html
16checklist_playbook체크리스트·운영 절차·플레이북checklist-playbook.html
17🆕 github_feature_usageGitHub 저장소를 "무엇을 해주나·어떻게 쓰나·어디 맞나" 기능·사용법·도입 가이드로, 실제 화면(스크린샷) 중심github-feature-usage.html

🖼️ 쇼케이스 갤러리

🆕 최신 실전 산출물 데모 (현행 스킬 v5.10.0 기준, 게이트 OK)

최근 생성한 실전 산출물 3종 + 신규 모드 smoke 2종입니다. 썸네일을 클릭하면 GitHub Pages에서 실제 결과물이 바로 열립니다(상단 스위처로 8테마 전환).

🌐 라이브(GitHub Pages): github_analysis · grok 가이드 · windows-audio 레퍼런스 · 로컬 확인은 python3 -m http.server 8080 후 http://localhost:8080/output/<dir>/index.html

🌐 라이브 캐노니컬 갤러리 — 13-topics (v5.2.3, 게이트 OK)

현재 스킬 v5.2.3의 정적 품질 게이트를 0 issue로 완전 통과하고, 13명 전문가 에이전트가 모든 얕은 섹션을 보강한 캐노니컬 산출물입니다. 메인 화면과 13개 모드 페이지를 웹에서 바로 볼 수 있습니다.

▶ 메인 화면: 13개 모드 신규 주제 쇼케이스 (index)

#Mode주제열기
01beginner_html로컬 RAG 개인 지식 금고 입문▶ 보기
02expert_htmlAI 코드 리뷰 게이트웨이 운영 모델▶ 보기
03article_html작은 팀의 운영 문서와 제품 속도▶ 보기
04education_htmlPostgreSQL 쿼리 플랜 읽기 3주 교육▶ 보기
05blog_writer두 번째 뇌를 다시 작게 만든 30일 회고▶ 보기
06seo_dashboardAI 회의록 자동화 검색 허브▶ 보기
07platform_blog컨퍼런스 발표를 플랫폼별 글로 변환▶ 보기
08skill_audit배포 체크리스트 생성 스킬 감사▶ 보기
09reference_htmlWebhook 서명 검증 레퍼런스▶ 보기
10comparison_html벡터 검색 선택 기준 비교▶ 보기
11case_study_html예약 알림 지연 사고 케이스 스터디▶ 보기
12landing_brief_htmlLocalNote 팀 지식관리 랜딩 브리프▶ 보기
13checklist_playbookAI 기능 출시 전 안전성 플레이북▶ 보기

🌐 라이브(GitHub Pages): index 열기 · 상단 테마 스위처로 라이트·화이트·다크 전환 · 로컬 확인은 python3 -m http.server 8788 후 127.0.0.1:8788/...

🧩 스킬 적용용 단일 템플릿 HTML 미리보기 (final_20260604)

스킬의 모든 자산·패턴을 한 파일에 담은 단일 템플릿 HTML 2종입니다. 썸네일을 클릭하면 GitHub Pages에서 전체 화면으로 열립니다.

🌐 라이브(GitHub Pages): index.html · index-beginner-width.html · 로컬 확인은 python3 -m http.server 8788(캐시 우회 ?v=)

🎞️ 디자인 썸네일 미리보기 (v4 데모 — 참고용)

아래는 디자인 시스템을 한눈에 보는 v4 스크린샷 데모입니다(주제는 13-topics와 다름). 캐노니컬 라이브는 위 13-topics 갤러리를 사용하세요. 프로파일별 골든은 비주얼 프로파일 참조.

🌐 라이브(GitHub Pages): v4 데모 index 열기 · 로컬은 python3 -m http.server 8788 후 127.0.0.1:8788/...


🎚️ 비주얼 프로파일

스킬을 기동할 때 비주얼 스타일을 고를 수 있습니다. 코어(17모드 라우터·레이아웃·코어 CSS 5종)는 100% 공유하고, 프로파일이 어느 라이브러리·삽입 단계·CSS 번들을 쓸지만 게이트합니다. 세 프로파일 모두 외부/동작 JS 0.

프로파일별칭라이브러리 (markup)CSS 번들골든 쇼케이스
widgetstyle=v5CSS 뷰 위젯 wg-코어5 + widgets.cssshowcase-v5 (정합화)
diagramstyle=v6SVG→HTML vt-코어5 + visual-html.cssshowcase-diagram (슬림)
auto (기본)—둘 다코어5 + widgets.css + visual-html.cssshowcase-v6
# 기동 인자로 선택 (별칭 v5/v6도 수용 · 미지정 시 auto)
adaptive-html-final  profile=widget      # 또는 style=v5
adaptive-html-final  profile=diagram     # 또는 style=v6
adaptive-html-final                      # 기본 auto

# 검증기는 출력의 sources/profile.json 을 자동 인지(또는 --profile)해
# 교차 누수(diagram에 wg- / widget에 vt-)를 차단한다
python3 skills/adaptive-html-final/scripts/validate_output.py <output_dir> \
  --skill-dir skills/adaptive-html-final --profile diagram

🤖 크로스-에이전트 결정론: 인자가 명시되면 Claude Code·Codex·Gemini가 동일 결과를 낸다(정규화 profile= 우선, 무효 토큰은 invalid_profile 실패). 비대화형(AGENTS.md 경유)은 미지정 시 무조건 auto. 분리 설계·검증 계획(아카이브)은 docs/archive/implement_visual_profile_separation.md.


🏗️ 스킬 구조

디자인 시스템 (CSS 레이어)

theme.css        색/폰트/폭 토큰(:root) · skip · focus-visible · reduced-motion   ← 코어 해시
components.css    term · analogy · danger · good · hero-analogy · try · tbl · faq · cta-box ...  ← 코어 해시
visual-components.css   figure.visual-figure (8000×6000 SVG 삽입 셸)               ← 코어 해시 · v4.2
layouts.css       17개 모드별 그리드/구조 (+ github 실사·github 기능가이드·youtube·manual 분석 레이아웃)   ← 코어 해시
print.css         인쇄 대응(print-color-adjust · break-inside)                    ← 코어 해시
widgets.css       CSS 뷰 위젯 wg-01~20 (탭·플로우·아코디언, 무 JS)  ← v4.4 · widget/auto 프로파일 조건부 인라인
visual-html.css   SVG→HTML 템플릿 vt- 21종 (본문 삽입 도식)        ← v4.5+ · diagram/auto 프로파일 조건부 인라인
body-icons.css    본문 아이콘 bi- 32종                                      ← 프로파일 무관 장식 자산
editorial-patterns.css  chronology/source/insight/a11y 등 본문 패턴 8종      ← 프로파일 무관 구조 자산
shape-visuals.css · workflow-visuals.css  soft-shape 36종 + workflow 도판 10종 ← 프로파일 무관 시각 앵커
theme-dark.css    CSS-only 8-테마 토큰 오버라이드 + 라디오 세그먼트 스위처       ← v5.2 · print 뒤 항상 인라인(코어 해시 제외)

코어 해시는 5종(theme·components·visual-components·layouts·print)의 합본 SHA-256(adaptive-html-final-core-css-sha256 마커)이며, widgets.css·visual-html.css·theme-dark.css는 해시 대상이 아닌 조건부/후행 인라인 자산이다.

비주얼 템플릿 시스템 (v4.2+)

목적형 정보는 외부 사진 검색이 아니라 8000×6000 SVG 인포그래픽을 기본값으로 직접 생성합니다.

구성내용
visual-templates/*.svg.tplhero-map · card-grid · decision-tree · quality-gate · timeline · matrix · checklist-flow (7종)
scripts/render_visual_svg.pyvisual brief(JSON) → 8000×6000 SVG 렌더러 (stdlib only, 오프라인 동작)
schemas/visual-brief.schema.json시각 템플릿 입력 스키마
데모SVG 템플릿 20종 갤러리 (risk-heatmap, sankey, treemap, user-journey 등)

📁 프로젝트 구조

skills-html-showcase/
├── skills/adaptive-html-final/        # 통합 스킬 + .skill 패키지
│   ├── SKILL.md                       # 라우터 · 워크플로우 · 품질 게이트
│   ├── manifest.json                  # name/version/modes/layouts/profiles/theme_system (v5.10.0 · 17모드)
│   ├── assets/                        # base.html · CSS 12종 · 위젯/도식/패턴/테마 자산 · 17개 레이아웃 골격
│   ├── references/    (19)            # 모드/레이아웃/글쓰기/SEO/플랫폼/감사/GitHub·YouTube·Manual·기능가이드 규칙
│   ├── recipes/       (17)            # 모드별 대표 프롬프트
│   ├── schemas/       (3)             # blog-meta · quality-report · visual-brief
│   ├── tests/                         # 품질/레이아웃/시각회귀/접근성/거버넌스 게이트 (80/80)
│   ├── visual-templates/ (7)         # 8000×6000 SVG 템플릿
│   ├── scripts/                       # render_visual_svg.py · validate_output.py · completion_check.py 등
│   └── examples/                     # 모드 예시 + index (최종 정형화 단계에서 재생성 예정)
├── output/
│   ├── adaptive-html-final-showcase-v4/   # 13모드 쇼케이스 (canonical 13-mode 데모)
│   │   ├── pages/     (15)            # 13모드 + 비주얼 데모 + SVG 갤러리
│   │   └── media/svg-template-demos/ (20)  # 8000×6000 SVG 데모
│   ├── adaptive-html-final-13-topics-20260605_083433/ # ★ v5.2.3 게이트 완전 통과 캐노니컬 기준선(전문가 보강)
│   └── (playwright/ · qa-screenshots/ 는 .gitignore)
├── docs/
│   ├── screenshots/   (13)           # 본 README용 쇼케이스 썸네일
│   └── archive/                      # v4~v5.0 시점 고정 리뷰/분석/계획 기록 (SUPERSEDED)
├── demo/ · orginal_skill/            # 이전 계열 데모 · 원본 스킬
├── AGENTS.md                         # 크로스-에이전트 결정론 진입점
└── Guide.md                          # 사용 가이드 (루트는 README·AGENTS·Guide 3종만 유지)

🔬 스킬 상세 분석

docs/archive/ANALYSIS_adaptive-html-final.md — 7개 전문가 에이전트 병렬 분해 + 쟁점 적대적 검증 + 교차 통합 감사로 도출한 정밀 분석 보고서입니다(v4.5.0 시점, 아카이브). v4~v5.0 전 리뷰·계획 기록은 docs/archive/에 시점 배지와 함께 보관됩니다.

검증으로 입증된 강점

항목결과
skip link ↔ <main id="main">17 / 17 (접근성 회귀 가드로 고정)
단일 h1 원칙17 / 17 레이아웃 계약
외부 동작 JS0건
미정의 CSS 클래스0개 (레이아웃↔CSS 차집합 0)
manifest ↔ 디스크 레이아웃 매핑차집합 0 (17 / 17)
거버넌스 게이트test_governance_gates.py 80 / 80 통과
blog-writer 상세 규칙 흡수8 / 8 (제목 4계열·도입부 3유형·본문 밀도·톤 매핑·100점·메타·플랫폼·박스)

버전 진화

버전핵심
v4.0.0ultimate(13모드 라우터) + blog-writer(블로그/SEO 규칙) 통합 · skip link 버그 수정
v4.1.07-전문가 분석 P0~P2 자동 패치 — 모드 ID 통일, recipes 13/13, 스키마 보강, 디자인 토큰 정리(AA 대비·print·reduced-motion)
v4.2.xVisual Template System 도입 — 8000×6000 SVG 인포그래픽 7종 + stdlib 렌더러 + quality-gate 레이아웃 보정
v4.3.313모드 전수 캡쳐 감사 기반 반응형 폴리시 — dark CTA 대비, 플랫폼 그리드, 모바일 표 밀도, case timeline 구조 + 정적 게이트
v4.4.0뷰 위젯 시스템 편입 — CSS 뷰 위젯 wg-01~20(무 JS, widgets.css + 위젯 템플릿) + 위젯 정적 게이트, 전문가 리뷰 P0/P1 마감
v4.5.0SVG→HTML 템플릿 편입(vt- 20종, visual-html.css) + 하네스 정형화(루트 AGENTS.md 결정론 진입점) + 비주얼 프로파일(widget·diagram·auto) 도입 — 검증기 --profile·교차 누수 게이트·profiles 매니페스트
v5.0.0코어 프리미티브 업그레이드 + 토큰 전용 다크 테마 도입. CTA/SERP/platform primitive를 기존 정본 클래스 안에서 강화
v5.1.0proper-black 다크 보정. vt/wg 표면 색, CTA 태그, 회색 리터럴 토큰화, OS/토글 조합 회귀를 실제 캡처로 검증
v5.2.0CSS-only 3-테마 시스템(라이트·화이트·다크) + 라디오 세그먼트 스위처. CSS snapshot/source manifest/legacy toggle 검증 강화, wg-12·wg-16·vt-02·vt-21·.try 회귀 패치
v5.2.1body-icon :has() icon+text 정렬 + 헤더 폭 캡 해제(스킬 자산). 13-topics 캐노니컬 산출물을 13명 전문가 에이전트로 전 섹션 콘텐츠 보강하고 아이콘·테마·레이아웃 정련(게이트 OK·25/25)
v5.2.2body-icons.css에 아이콘 박스 테마 적응(white=순백/dark=카드 표면) + lede-note 라벨 정렬 승격. 조건부 자산만 변경 → 코어 해시 불변
v5.2.3editorial-patterns.css 가독성 승격 — a11y 카드/그리드/포인트 간격, impact 카드 아이콘 하단 여백. 조건부 자산만 변경 → 코어 해시 불변
v5.3.0GitHub Analysis 14번째 모드 — github_analysis, github-analysis.html, .layout-github, GitHub 분석 전략/recipe/검증 문서 추가
v5.7.0YouTube/Manual Analysis 15·16번째 모드 — youtube_analysis/manual_analysis, 전용 레이아웃·전략 문서·계약 게이트·예제/output 추가
v5.8.xyoutube/manual 깊이 계약(정량 하한) + 넓고-얇음 게이트, generated-date 모바일 오버플로 코어 수정
v5.9.0시각 정본 게이트 3종(섹션 surface·직접섹션 h2 body-icon·아이콘 다양성) + 카탈로그 reverse-sync 반응형/폭/대비 일괄 반영
v5.9.1~5.9.2wg-10 데모 섹션 한정 full-width(5.9.1) · 외부 세리프 폰트 금지·pull-quote Pretendard·vt-02 정합·toc-map/manual 회귀 방지(5.9.2)
v5.10.0GitHub Feature-Usage 17번째 모드 — github_feature_usage, github-feature-usage.html, .layout-github-feature(github 컴포넌트 어휘 공유 + 스크린샷 갤러리), 계약 게이트·tie-breaker·경계 버그 수정. 거버넌스 80/80

전체 변경 이력: skills/adaptive-html-final/CHANGELOG.md · 프로파일 분리 계획(아카이브): docs/archive/implement_visual_profile_separation.md


✅ 품질 게이트

모든 산출물이 통과해야 하는 최소 조건입니다. (tests/quality-checklist.md, tests/accessibility-checklist.md)

  • 요청 목적과 선택 모드 일치 + 모드별 필수 블록 존재
  • lang="ko" · viewport · <title> · meta description
  • h1 정확히 1개 · 주요 h2에 .h2-sub(모드 한정 권장)
  • #main skip link target · :focus-visible · prefers-reduced-motion
  • 모바일 1컬럼 전환 · 표는 .tbl 래퍼(가로 스크롤)
  • 8-테마 스위처는 name="ahf-theme" 라디오 계약을 사용하고 legacy #theme-toggle 없음
  • 외부/동작 JS 0 · 확인되지 않은 최신 정보 단정 금지 · 출처 추측 금지
  • 교육용=퀴즈+정답 · 전문가용=리스크+검증 · 블로그/SEO=제목+메타+태그 · 감사=개선본
  • 비주얼: 8000×6000 캔버스 · figure+figcaption · 의미 있는 alt · 캔버스 잘림 없음

🟢 게이트 현황(v5.10.0): 거버넌스 test_governance_gates.py 80/80 통과, 검증기 validate_output.py는 17모드 계약(시각 정본·모드별 vt/wg·toc-map·무 JS·코어 해시)을 정적으로 강제합니다. output/adaptive-html-final-13-topics-20260605_083433/는 v5.2.3 시점의 캐노니컬 기준선이며, 그 후 코어 CSS가 진화(v5.3~v5.10)해 해시가 드리프트했으므로 17모드 기준 캐노니컬 산출물·examples 재생성은 후속(정형화) 단계입니다.

# 재현 (저장소 루트에서)
python3 skills/adaptive-html-final/scripts/validate_output.py \
  output/adaptive-html-final-13-topics-20260605_083433 \
  --skill-dir skills/adaptive-html-final   # → 마지막 줄 OK

참고: v4~v5.0 시점에 생성된 일부 output/·examples/는 그 후 코어 CSS가 진화해 해시가 드리프트하면 현재 게이트에서 FAILED가 날 수 있습니다(시점 고정 산출물). 최신 기준선은 항상 위 13-topics 디렉토리입니다.


⚡ 사용법

스킬로 콘텐츠 생성 요청

[입력 자료/URL/파일/주제]를 [목적/독자]용 [모드]로 만들어줘.
출력은 [단일 HTML / Markdown+HTML / 플랫폼별 원고]로 해줘.
비주얼: profile=widget | diagram | auto  (또는 style=v5 | v6, 미지정 시 auto)
반드시 포함: [목차, 용어 풀이, 예시, 리스크, FAQ, CTA 등]
주의: [최신 정보는 확인 필요 표시, 외부 JS 금지, 모바일 안전 표]

profile=widget은 탭·플로우 같은 인터랙티브 위젯(wg-)을, profile=diagram은 본문 삽입 도식(vt-)을, auto(기본)는 둘 다 적용합니다. 자세한 선택 규칙은 비주얼 프로파일 참조.

비주얼 인포그래픽 직접 렌더

# visual brief(JSON) → 8000×6000 SVG (stdlib only, 오프라인 동작)
python3 skills/adaptive-html-final/scripts/render_visual_svg.py brief.json output.svg

쇼케이스 로컬에서 보기

# 저장소 루트에서
python3 -m http.server 8788
# canonical v4 쇼케이스
# → http://127.0.0.1:8788/output/adaptive-html-final-showcase-v4/index.html

# 최신 v5.2.3 13-topic 산출물(전문가 보강)
# → http://127.0.0.1:8788/output/adaptive-html-final-13-topics-20260605_083433/index.html

HTML → PDF/PNG/WebP export

완성된 output/<dir> HTML은 빌드 타임 도구로 PDF·테마별 PNG·WebP로 변환할 수 있습니다. 출력 HTML에는 JS를 삽입하지 않고, export 전후 HTML SHA와 validate_output.py --json 이슈 불변성을 manifest에 기록합니다.

재사용 스킬: skills/html-exporter — 다른 프로젝트에서도 동일한 export 절차를 적용할 때 사용합니다.

# 최초 1회
npm install

# 기본: pdf,png,webp + light,light2,white,dark,dark2,blue,skyblue,sepia 요청
npm run export:output -- output/final_20260604 --clean

# 13-topic 기준선 export
npm run export:output -- output/adaptive-html-final-13-topics-20260605_083433 --clean
항목v1 계약
엔진Playwright Chromium (:has() 테마·대형 SVG 충실도 유지)
WebPsharp optional dependency. 없으면 webp skip, --require-webp면 실패
테마DOM radio name="ahf-theme"에 존재하는 테마만 캡처. 기본 요청은 light,light2,white,dark,dark2,blue,skyblue,sepia이며 없는 테마는 skip 기록
긴 페이지--scale 2 요청 후 Chromium 안전선에 맞춰 scale_used 자동 강등. scale 1에서도 긴 페이지는 PNG master로 시도하고 WebP는 16383px로 downscale
산출물<output_dir>/exports/{pdf,png,webp}/ + exports/export-manifest.json
커밋 정책output/**/exports/는 재생성 산출물이므로 .gitignore 처리

허용 옵션은 --formats, --themes, --scale, --viewport, --require-webp, --clean 6개입니다. screen PDF, controls 노출, concurrency, WebP chunks 등은 v2 reserve라 v1에서는 exit 2로 거부합니다.


📜 License

별도 라이선스가 지정되지 않았습니다. 사용 전 저장소 소유자(coreline-ai)에게 확인하세요.

Ver o original no GitHub

Bom para

Relacionados