코리아 에이전트 맵Korea Agent Map

코딩 에이전트에 Hallmark 설치하고 HTML 페이지 리디자인하기

Install Hallmark in a coding agent and redesign an HTML page

Hallmark는 AI가 만든 티가 나는 페이지를 피하도록 돕는 오픈소스 디자인 스킬입니다. Claude Code, Codex, Cursor, OpenCode처럼 내 컴퓨터의 프로젝트 폴더를 읽고 파일을 만드는 코딩 에이전트에 설치해서 씁니다. 웹 브라우저의 Claude 채팅 창에 붙여 넣는 방식이 아닙니다.

아래 프롬프트는 이미 있는 HTML 파일을 Hallmark로 다시 디자인하게 하는 문장입니다. 원본 파일은 그대로 두고, 문구와 링크는 바꾸지 않도록 지시합니다.

1. 전후 화면

리디자인 전: 가상의 서비스 한 곳을 소개하는 HTML 페이지 화면
전: 예제 before.html을 데스크톱 너비 1280px로 연 실제 화면입니다.
리디자인 후: 같은 문구와 링크 5개를 유지한 HTML 페이지 화면
후: 같은 화면 너비에서 연 실제 화면입니다.

이 전후 예시는 아래 짧은 프롬프트만으로 나온 결과가 아닙니다. 릴스 예시를 만들 때는 Furrow 디자인 방향을 따로 정해 주고 검토를 거쳤습니다. 같은 문구와 링크 5개를 유지했고, 가상의 서비스 한 곳을 다룬 예제입니다. 압축 파일에는 짧은 프롬프트와 Hallmark 핵심 지침·Furrow 테마로 별도 생성한 prompt-test.html도 있습니다. 문구·링크 유지와 390/1280px 가로 넘침만 확인했으며, 모든 디자인 규칙 통과나 같은 결과를 보장하지 않습니다.

2. 준비물

3. 따라 하는 순서

  1. 예제 압축 파일(example.zip)을 내려받아 풀고, 안에 있는 before.html을 확인합니다. 내 파일로 해 보려면 이 단계에 내 HTML 파일을 둡니다.
  2. 압축에 든 after.html은 비교용 결과이므로 다른 이름으로 보관하고, 그 폴더를 코딩 에이전트로 엽니다.
  3. 같은 폴더의 터미널에서 아래 명령을 실행해 스킬을 설치합니다. -g를 붙이지 않으면 현재 프로젝트에만 설치됩니다.
    프로젝트 폴더 터미널npx skills add nutlope/hallmark

    Hallmark 공식 안내의 명령을 옮긴 것입니다. 이 사이트에서 직접 실행하지는 않았습니다.

  4. 코딩 에이전트에 아래 프롬프트를 붙여 넣습니다.
  5. 에이전트가 알려 준 바뀐 점을 읽고, 새 after.html을 브라우저로 열어 문구와 링크가 그대로인지 직접 비교합니다. 배포는 하지 않습니다.

공식 안내에는 Codex에서는 $hallmark, Claude Code에서는 /hallmark로 부르는 방식도 나옵니다. 아래 프롬프트는 문장 첫머리에서 Hallmark를 쓰라고 말합니다.

4. 복사해서 쓰는 프롬프트

Hallmark를 사용해 before.html을 리디자인해줘.
- 원본은 그대로 두고 after.html을 새로 만들어줘.
- 모든 문구, 숫자, 메뉴, 버튼과 링크 목적지를 유지해줘. 새 실적이나 고객 후기를 만들지 마.
- 장식보다 실제 페이지 내용을 앞세워줘. 보고서 예시가 있으면 첫 화면에서 보이게 해줘.
- 한국어가 단어 중간에서 끊기지 않게 하고, 390px 휴대폰과 1280px 데스크톱에서 확인해줘.
- 외부 이미지, 라이브러리, 스크립트 없이 HTML과 CSS 한 파일로 만들어줘.
- 바뀐 점과 확인하지 못한 점을 알려줘. 배포하지 마.

prompt.txt 내려받기

5. 결과 확인할 때

확인하지 못한 것
  • Hallmark 자체 정적 검사(static lint)의 gate 54는 통과하지 못했습니다.
  • 실제 휴대폰 기기에서는 테스트하지 않았습니다.
  • 예제는 가상의 서비스 한 곳이며, 다른 페이지에서도 같은 결과가 나온다는 보장은 없습니다.

이런 자료를 레터로 받기Get guides like this by email

직접 테스트해 본 AI 프롬프트와 사례를 2주에 한 번 정리해 보내 드립니다. 광고는 넣지 않습니다.Prompts and cases we actually tested, every two weeks. No ads.