Communitygithub.com

ulasalyesil/personal-website-v2

정확하고 완전한 메타데이터를 제공합니다.

personal-website-v2란 무엇인가요?

이 스킬은 웹사이트의 메타데이터를 검토하고 수정하는 AI 에이전트(Claude Code, Cursor, Codex 등)를 위한 규칙 기반 가이드입니다. 페이지 제목, 설명, 표준 URL, 로봇 메타 태그, Open Graph/Twitter 카드, 아이콘, 매니페스트, 구조화된 데이터(JSON-LD), 로케일 및 대체 언어 등 모든 메타데이터 관련 작업에 적용됩니다. 잘못되거나 누락된 메타데이터는 SEO, 소셜 공유, 색인 생성에 치명적일 수 있으므로, 이 스킬은 우선순위별(1순위: 정확성 및 중복, 8순위: 도구 경계) 규칙을 통해 각 페이지가 안전하고 일관된 메타데이터를 제공하도록 보장합니다. 특히 중복 태그, 비결정적 값, 누락된 소셜 카드, 잘못된 표준 URL을 비판적으로 검토하고 최소한의 변경만 권장합니다. Next.js 메타데이터 API, react-helmet, 수동 head 등 다양한 프레임워크에서 작동하며, 기존 패턴을 존중합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/fixing-metadata

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

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

문서

메타데이터 수정

정확하고 완전한 메타데이터를 제공합니다.

사용 방법

  • /fixing-metadata 이 대화에서 모든 메타데이터 작업에 다음 제약 조건을 적용합니다.

  • /fixing-metadata <파일> 아래 모든 규칙에 따라 파일을 검토하고 다음을 보고합니다:

    • 위반 사항 (정확한 줄 또는 코드 조각 인용)
    • 왜 중요한지 (짧은 문장 하나)
    • 구체적인 수정 사항 (코드 수준 제안)

명시적으로 요청하지 않는 한 새로운 프레임워크나 SEO 라이브러리를 도입하지 마십시오. 최소한의 차이(diff)를 선호합니다.

적용 시점

다음 상황에서 이 지침을 참조하세요:

  • 페이지 제목, 설명, 표준 URL, 로봇 태그를 추가하거나 변경할 때
  • Open Graph 또는 Twitter 카드 메타데이터를 구현할 때
  • 파비콘, 앱 아이콘, 매니페스트, 테마 색상을 설정할 때
  • 공유 SEO 컴포넌트 또는 레이아웃 메타데이터 기본값을 구축할 때
  • 구조화된 데이터(JSON-LD)를 추가할 때
  • 로케일, 대체 언어 또는 표준 라우팅을 변경할 때
  • 새 페이지, 마케팅 페이지 또는 공유 가능한 링크를 제공할 때

우선순위별 규칙 카테고리

우선순위카테고리영향
1정확성 및 중복치명적
2제목 및 설명높음
3표준 URL 및 색인 생성높음
4소셜 카드높음
5아이콘 및 매니페스트중간
6구조화된 데이터중간
7로케일 및 대체낮음-중간
8도구 경계치명적

빠른 참조

1. 정확성 및 중복 (치명적)

  • 페이지당 하나의 위치에 메타데이터를 정의하고, 경쟁 시스템을 피하십시오.
  • 중복된 title, description, canonical 또는 robots 태그를 내보내지 마십시오.
  • 메타데이터는 결정적이어야 하며, 무작위 또는 불안정한 값을 사용하지 마십시오.
  • 사용자 생성 또는 동적 문자열은 이스케이프 및 정화 처리하십시오.
  • 모든 페이지는 제목과 설명에 안전한 기본값을 가져야 합니다.

2. 제목 및 설명 (높음)

  • 모든 페이지에는 제목이 있어야 합니다.
  • 사이트 전체에서 일관된 제목 형식을 사용하십시오.
  • 제목을 짧고 읽기 쉽게 유지하고, 키워드를 채우지 마십시오.
  • 공유 가능하거나 검색 가능한 페이지에는 메타 설명이 있어야 합니다.
  • 설명은 일반 텍스트여야 하며, 마크다운이나 인용 spam을 사용하지 마십시오.

3. 표준 URL 및 색인 생성 (높음)

  • 표준 URL은 페이지의 선호 URL을 가리켜야 합니다.
  • 비공개, 중복 또는 공개되지 않은 페이지에만 noindex를 사용하십시오.
  • robots 메타는 실제 접근 의도와 일치해야 합니다.
  • 미리보기 또는 스테이징 페이지는 가능한 경우 기본적으로 noindex여야 합니다.
  • 페이지 매김된 페이지는 올바른 표준 URL 동작을 가져야 합니다.

4. 소셜 카드 (높음)

  • 공유 가능한 페이지는 Open Graph 제목, 설명 및 이미지를 설정해야 합니다.
  • Open Graph 및 Twitter 이미지는 절대 URL을 사용해야 합니다.
  • 올바른 이미지 크기와 안정적인 종횡비를 선호합니다.
  • og:url은 표준 URL과 일치해야 합니다.
  • 적절한 og:type을 사용하십시오. 일반적으로 website 또는 article입니다.
  • twitter:card를 적절히 설정하고, 기본값은 summary_large_image입니다.

5. 아이콘 및 매니페스트 (중간)

  • 브라우저 간 호환되는 파비콘을 하나 이상 포함하십시오.
  • 관련이 있는 경우 apple-touch-icon을 포함하십시오.
  • 매니페스트는 유효해야 하며, 사용 시 참조되어야 합니다.
  • 의도적으로 theme-color를 설정하여 UI 크롬 불일치를 방지하십시오.
  • 아이콘 경로는 안정적이고 캐시 가능해야 합니다.

6. 구조화된 데이터 (중간)

  • 실제 페이지 콘텐츠에 명확하게 매핑되지 않으면 JSON-LD를 추가하지 마십시오.
  • JSON-LD는 유효해야 하며 실제로 렌더링된 내용을 반영해야 합니다.
  • 평점, 리뷰, 가격 또는 조직 세부 정보를 임의로 만들지 마십시오.
  • 필수가 아닌 한 페이지당 하나의 구조화된 데이터 블록을 선호합니다.

7. 로케일 및 대체 (낮음-중간)

  • html lang 속성을 올바르게 설정하십시오.
  • 지역화가 존재하는 경우 og:locale을 설정하십시오.
  • 페이지가 실제로 존재하는 경우에만 hreflang 대체를 추가하십시오.
  • 지역화된 페이지는 로케일별로 올바르게 표준화되어야 합니다.

8. 도구 경계 (치명적)

  • 최소한의 변경을 선호하고, 관련 없는 코드를 리팩터링하지 마십시오.
  • 요청되지 않은 경우 프레임워크 또는 SEO 라이브러리를 마이그레이션하지 마십시오.
  • 프로젝트의 기존 메타데이터 패턴(Next.js metadata API, react-helmet, 수동 head 등)을 따르십시오.

검토 지침

  • 먼저 치명적인 문제(중복, 표준 URL, 색인 생성)를 수정하십시오.
  • title, description, canonical 및 og:url이 일치하는지 확인하십시오.
  • 로컬호스트가 아닌 실제 URL에서 소셜 카드를 확인하십시오.
  • 영리하거나 동적인 메타데이터보다 안정적이고 지루한 메타데이터를 선호하십시오.
  • 차이(diff)를 최소화하고 메타데이터로만 범위를 제한하십시오.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

관련 스킬