사용 가이드로 건너뛰기
Fixing Metadata작성자 ibelick

Fixing Metadata 스킬.

페이지 식별 정보, 색인 신호와 소셜 공유 미리보기를 바로잡습니다.

  • 메타데이터
  • 소셜 미리보기
소스 검토 · fixing-metadataSKILL.md
작업 페이지 식별 정보, 색인 신호와 소셜 공유 미리보기를 바로잡습니다. 결과물 범위 내 페이지의 메타데이터 결함 우선순위 목록. 시작 전 확인 원문은 무관한 리팩터링과 프레임워크 또는 SEO 라이브러리 마이그레이션을 제외합니다.
편집 요약 · 소스 검토일 2026-11-02 · 생성된 예제가 아닙니다

01 기능 소개

페이지 식별 정보, 색인 신호와 소셜 공유 미리보기를 바로잡습니다

프로젝트의 기존 방식을 유지하는 메타데이터 수정으로 canonical URL, robots, 제목, 소셜 카드와 JSON-LD를 감사하세요.

소스 기반 워크플로실행 벤치마크 아님

작업 방식

Fixing Metadata는 페이지가 검색 엔진, 소셜 미리보기와 브라우저에 제공하는 정보를 검토합니다. 충돌하거나 중복된 태그에서 시작해 제목, 설명, canonical URL과 Open Graph 식별 정보가 같은 페이지를 설명하는지 확인합니다. 화면은 완성됐지만 잘못된 이미지로 공유되거나 색인 지시가 일치하지 않을 때 유용합니다.

원문은 프로젝트의 현재 메타데이터 구현 안에서 좁은 범위의 수정을 우선합니다. 소셜 카드뿐 아니라 아이콘, 매니페스트, 구조화 데이터와 실제 언어별 대체 페이지도 다룹니다. 검증 범위가 중요합니다. 로컬에 존재하는 소셜 이미지라도 실제 접근 가능한 URL에서 확인해야 합니다.

예상 산출물

  • 범위 내 페이지의 메타데이터 결함 우선순위 목록.
  • 기존 프레임워크 또는 head 관리 방식으로 적용한 집중적인 수정.
  • canonical 식별 정보, 색인 의도와 실제 URL 소셜 미리보기에 관한 검증 기록.
예시 브리프 보기

브리프에서 검토까지

  1. 01
    페이지 식별 정보 확인

    누락되거나 충돌하는 title, description, canonical 및 robots 태그를 찾습니다. 지시를 바꾸기 전에 선호 URL과 의도된 공개·비공개 상태를 확정합니다.

  2. 02
    영향이 가장 큰 충돌 수정

    중복 정의를 제거하고 canonical을 og:url과 일치시킵니다. 기존 메타데이터 방식으로 일반 텍스트 설명과 안정적인 소셜 이미지 URL을 설정합니다.

  3. 03
    부가 표시 영역 검토

    아이콘, 매니페스트와 관련 JSON-LD를 실제 렌더링 콘텐츠와 대조합니다. 실제 언어별 대체 페이지를 확인한 뒤 접근 가능한 URL에서 소셜 카드를 검토합니다.

02 활용 상황

언제 사용하면 좋을까요

원문은 무관한 리팩터링과 프레임워크 또는 SEO 라이브러리 마이그레이션을 제외합니다.

적합한 경우

  • 잘못된 공유 미리보기공개 페이지를 공유할 때 제목, 이미지 또는 대상 페이지 식별 정보가 잘못 나타나는 경우입니다.
  • 메타데이터 출시 검토새 페이지를 공개하기 전에 색인과 브라우저 메타데이터의 일관성이 필요한 경우입니다.

확인할 한계

  • 집중된 변경원문은 무관한 리팩터링과 프레임워크 또는 SEO 라이브러리 마이그레이션을 제외합니다.
  • 근거 기반 스키마구조화 데이터는 실제 콘텐츠를 반영해야 하며 평점, 가격과 조직 정보를 지어내면 안 됩니다.
  • 접근 가능한 미리보기localhost 검사만으로 외부 소셜 카드가 올바르게 렌더링된다고 입증할 수는 없습니다.

준비할 입력

  • 대상 페이지페이지 경로와 사용하는 공용 메타데이터 코드를 제공합니다.
  • 접근 의도공개 페이지, 비공개 영역과 스테이징 경로를 식별합니다.
  • 실제 자산canonical 대상, 공유 이미지와 실제 존재하는 언어별 대체 페이지를 제공합니다.

03 핵심 결정

중요한 판단 기준

  1. 하나의 페이지 식별 정보

    canonical과 소셜 메타데이터를 함께 비교해 불일치를 확인할 수 있습니다.

  2. 우선순위

    영향이 작은 다듬기보다 중복과 색인 충돌부터 해결합니다.

  3. 최소한의 통합

    제품에서 정한 메타데이터 관리 책임 구조를 따라 수정합니다.

04 예시 브리프

목적을 좁힌 요청으로 시작하세요

아래 예시 브리프는 테스트되지 않았습니다. 사용하기 전에 스킬의 설정을 확인하세요.

소스와 설정 확인

페이지 경로와 사용하는 공용 메타데이터 코드를 제공합니다.

업스트림 소스 파일
https://github.com/ibelick/ui-skills/blob/4907a526b07943b3a338177558d42fae4fdf0a86/skills/fixing-metadata/SKILL.md

아래 참고 링크에서 원본 사용 지침을 확인할 수 있습니다. 사용 전에 리포지터리의 설정 요건을 확인하세요. 설치 명령어가 아닙니다.

결과물 하나부터 시작

스킬을 실행하기 전에 이 브리프의 범위, 소스 자료, 제약 조건을 상황에 맞게 조정하세요.

예시 브리프
fixing-metadata로 제품 개요 페이지와 언어별 버전을 감사해 주세요. 현재 메타데이터 구현과 렌더링된 head에서 중복을 확인하세요. 편집 전에 의도한 canonical URL, robots 지시, 페이지 제목과 og:url을 검증하세요. 공유 이미지가 절대 URL을 사용하고 언어별 대체 페이지가 실제 존재하는지 확인하세요. 변경은 메타데이터 안으로 제한하고 근거 없는 JSON-LD 필드를 추가하지 마세요. 간결한 문제 목록, 집중된 수정 내용과 소셜 카드 검증에 사용한 실제 URL을 제공하세요. 로컬에서만 확인한 항목은 표시하세요.

결과 확인

실제 출력을 다음의 관찰 가능한 기준과 비교해 확인하세요.

  • 각 페이지가 일관된 핵심 식별 태그 세트를 하나만 출력합니다.
  • 구조화 데이터와 언어별 대체 페이지가 실제 페이지 콘텐츠와 일치합니다.
  • 공유 이미지 URL과 소셜 미리보기를 localhost 외부에서 검증합니다.

OpenDesign은 코딩 에이전트를 위한 로컬 디자인 작업 공간을 제공합니다. 이 목록은 스킬이 번들로 포함되어 있거나 외부 도구, 자격 증명, 소프트웨어 의존성이 포함되어 있다는 뜻이 아닙니다.

05 출처 및 라이선스

소스와 라이선스

이 페이지는 아래에 링크된 고정 소스 리비전을 설명합니다. 업스트림의 동작과 요구 사항은 바뀔 수 있습니다.

소스 소유자
ibelick
스킬 파일
SKILL.md
라이선스
MIT
검토한 스냅샷
2026-11-02 · 4907a526b079
편집 소스 요약
페이지 식별 정보, 색인 신호와 소셜 공유 미리보기를 바로잡습니다.

링크된 소스를 바탕으로 OpenDesign이 작성한 원본 요약입니다. 저장소 스타 수는 특정 시점의 인기 지표일 뿐 스킬 사용량이나 품질 점수가 아닙니다.

06 시작 전 질문

시작 전 궁금한 점

SEO 라이브러리를 마이그레이션하나요?

원문은 마이그레이션 요청이 없는 한 기존 메타데이터 방식을 유지하도록 지시합니다.

모든 페이지에 JSON-LD가 필요한가요?

실제로 렌더링되는 콘텐츠에 적합한 스키마가 명확하게 대응할 때만 필요합니다.

스테이징 페이지는 어떻게 처리하나요?

원문은 가능한 경우 미리보기에 noindex를 권장하되, 지시는 실제 접근 의도에 맞춰 유지하도록 합니다.

OpenDesign

작업 요청과 디자인 결과물을 한곳에 모으세요.

브리프, 소스 자료, 디자인 작업을 로컬 작업 공간에 함께 보관하세요. 워크플로에 추가하기 전에 스킬 자체의 설정을 확인하세요.

업스트림 소스 파일
https://github.com/ibelick/ui-skills/blob/4907a526b07943b3a338177558d42fae4fdf0a86/skills/fixing-metadata/SKILL.md