Communitygithub.com

ulasalyesil/personal-website-v2

正しく完全なメタデータを提供します。

personal-website-v2 とは?

このスキルは、Webサイトやアプリケーションにおいて、正確で完全なメタデータ(タイトル、説明、canonical、OGP、Twitterカード、ファビコン、構造化データなど)を実装・レビューするためのガイドラインを提供します。主にNext.jsのMetadata APIなど、既存のメタデータパターンに従い、SEOの品質を担保します。ルールは重要度ごとにカテゴリ分けされており、重複や不整合の修正(Critical)、タイトルや説明文の最適化(High)、ソーシャルカードやアイコンの設定(Medium)などを優先順位に沿ってチェックします。このスキルは、Web開発におけるメタデータの品質を自動的にレビューし、具体的な修正提案を行うのに役立ちます。

対応~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 この会話内のメタデータ関連の作業に、以下の制約を適用します。

  • /fixing-metadata <ファイル> 指定されたファイルを以下のすべてのルールに照らしてレビューし、以下を報告します:

    • 違反箇所(該当する行またはスニペットを引用)
    • なぜそれが重要なのか(簡潔な一文)
    • 具体的な修正方法(コードレベルでの提案)

特に要求がない限り、新しいフレームワークやSEOライブラリを導入しないでください。最小限の差分を推奨します。

適用タイミング

以下の状況でこれらのガイドラインを参照してください:

  • ページのタイトル、説明、canonical、robotsを追加または変更する場合
  • Open GraphやTwitterカードのメタデータを実装する場合
  • ファビコン、アプリアイコン、マニフェスト、theme-colorを設定する場合
  • 共有SEOコンポーネントやレイアウトメタデータのデフォルトを構築する場合
  • 構造化データ(JSON-LD)を追加する場合
  • ロケール、代替言語、canonicalルーティングを変更する場合
  • 新しいページ、マーケティングページ、共有可能なリンクを公開する場合

ルールカテゴリ(優先度順)

優先度カテゴリ影響
1正確性と重複重大
2タイトルと説明高
3canonicalとインデックス高
4ソーシャルカード高
5アイコンとマニフェスト中
6構造化データ中
7ロケールと代替ページ低〜中
8ツールの境界重大

クイックリファレンス

1. 正確性と重複(重大)

  • メタデータはページごとに1箇所で定義し、競合するシステムを避けてください
  • タイトル、説明、canonical、robotsタグを重複して出力しないでください
  • メタデータは決定論的である必要があり、ランダムまたは不安定な値は避けてください
  • ユーザー生成または動的文字列はエスケープおよびサニタイズしてください
  • すべてのページにタイトルと説明の安全なデフォルトが設定されている必要があります

2. タイトルと説明(高)

  • すべてのページにタイトルが必要です
  • サイト全体で一貫したタイトル形式を使用してください
  • タイトルは短く読みやすく保ち、過剰なキーワード詰め込みを避けてください
  • 共有可能または検索可能なページにはメタ説明が必要です
  • 説明はプレーンテキストで、マークダウンや引用の多用は避けてください

3. canonicalとインデックス(高)

  • canonicalはページの優先URLを指す必要があります
  • noindexはプライベート、重複、または非公開ページにのみ使用してください
  • robotsメタは実際のアクセス意図と一致している必要があります
  • プレビューやステージングページは、可能な場合デフォルトでnoindexに設定してください
  • ページネーションされたページは正しいcanonical動作を持つ必要があります

4. ソーシャルカード(高)

  • 共有可能なページにはOpen Graphのタイトル、説明、画像を設定してください
  • Open GraphとTwitterの画像は絶対URLを使用してください
  • 適切な画像サイズと安定したアスペクト比を推奨します
  • og:urlはcanonical URLと一致する必要があります
  • 適切なog:type(通常はwebsiteまたはarticle)を使用してください
  • twitter:cardを適切に設定し、デフォルトはsummary_large_imageにしてください

5. アイコンとマニフェスト(中)

  • クロスブラウザで動作するファビコンを少なくとも1つ含めてください
  • 必要に応じてapple-touch-iconを含めてください
  • マニフェストは使用時に有効で参照されている必要があります
  • theme-colorは意図的に設定し、UIクロームの不一致を避けてください
  • アイコンパスは安定しておりキャッシュ可能である必要があります

6. 構造化データ(中)

  • JSON-LDは、実際のページコンテンツに明確にマッピングされる場合のみ追加してください
  • JSON-LDは有効であり、実際にレンダリングされる内容を反映している必要があります
  • 評価、レビュー、価格、組織の詳細を捏造しないでください
  • 特に必要がない限り、ページごとに1つの構造化データブロックを推奨します

7. ロケールと代替ページ(低〜中)

  • html lang属性を正しく設定してください
  • ローカライゼーションが存在する場合はog:localeを設定してください
  • hreflangの代替ページは、ページが実際に存在する場合のみ追加してください
  • ローカライズされたページはロケールごとに正しくcanonical化されている必要があります

8. ツールの境界(重大)

  • 最小限の変更を推奨し、無関係なコードのリファクタリングは行わないでください
  • 要求がない限り、フレームワークやSEOライブラリの移行は行わないでください
  • プロジェクトの既存のメタデータパターン(Next.js Metadata API、react-helmet、手動のheadなど)に従ってください

レビューガイダンス

  • 重大な問題(重複、canonical、インデックス)から修正してください
  • タイトル、説明、canonical、og:urlが一致していることを確認してください
  • ソーシャルカードはlocalhostではなく実際のURLで検証してください
  • 賢く動的なメタデータよりも、安定した堅実なメタデータを推奨します
  • 差分は最小限に抑え、メタデータのみに範囲を限定してください

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

関連スキル