Communitygithub.com

ulasalyesil/personal-website-v2

交付正确、完整的元数据。

personal-website-v2 是什么?

该技能旨在帮助开发者和 AI 代理确保在任何项目中都能交付正确、完整的元数据。它提供了一套清晰的规则和优先级分类,涵盖从标题和描述的正确性到社交卡片、结构化数据以及本地化等各个方面。该技能支持通过 `/fixing-metadata` 命令在对话中应用约束,或通过 `/fixing-metadata <file>` 命令对特定文件进行全面审查,报告违规行为、解释其重要性并提供具体的代码级修复建议。它强调最小化修改,避免引入新的框架或 SEO 库,适用于各种平台,包括 Next.js 或使用 react-helmet 的项目,是确保网页元数据规范、提升 SEO 和社交分享效果的实用工具。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/fixing-metadata

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

fixing-metadata

交付正确、完整的元数据。

如何使用

  • /fixing-metadata 在此对话中,对所有元数据相关工作应用这些约束。

  • /fixing-metadata <file> 根据以下所有规则审查文件,并报告:

    • 违规行为(引用确切的代码行或片段)
    • 为何重要(一句简短的说明)
    • 具体的修复方案(代码级别的建议)

除非明确要求,否则不要引入新的框架或 SEO 库。优先采用最小变更。

何时应用

在以下情况参考这些指南:

  • 添加或更改页面标题、描述、规范链接、robots
  • 实现 Open Graph 或 Twitter 卡片元数据
  • 设置网站图标、应用图标、manifest、主题色
  • 构建共享 SEO 组件或布局元数据默认值
  • 添加结构化数据(JSON-LD)
  • 更改区域设置、替代语言或规范路由
  • 发布新页面、营销页面或可分享链接

按优先级划分的规则类别

优先级类别影响
1正确性与重复严重
2标题与描述高
3规范链接与索引高
4社交卡片高
5图标与 manifest中
6结构化数据中
7区域设置与替代语言低-中
8工具边界严重

快速参考

1. 正确性与重复(严重)

  • 每个页面的元数据只在一个位置定义,避免竞争系统
  • 不要重复发送标题、描述、规范链接或 robots 标签
  • 元数据必须是确定性的,不能包含随机或不稳定的值
  • 对任何用户生成或动态字符串进行转义和清理
  • 每个页面都必须有安全的标题和描述默认值

2. 标题与描述(高)

  • 每个页面都必须有标题
  • 在整个站点中使用一致的标题格式
  • 保持标题简短易读,避免关键词堆砌
  • 可分享或可搜索的页面应有 meta 描述
  • 描述必须为纯文本,不能包含 markdown 或引号垃圾

3. 规范链接与索引(高)

  • 规范链接必须指向页面的首选 URL
  • 仅对私有、重复或非公开页面使用 noindex
  • robots meta 必须与实际访问意图匹配
  • 预览或临时页面在可能的情况下默认设置为 noindex
  • 分页页面必须具有正确的规范链接行为

4. 社交卡片(高)

  • 可分享页面必须设置 Open Graph 标题、描述和图片
  • Open Graph 和 Twitter 图片必须使用绝对 URL
  • 优先使用正确的图片尺寸和稳定的宽高比
  • og:url 必须与规范链接 URL 一致
  • 使用合理的 og:type,通常是 website 或 article
  • 适当设置 twitter:card,默认使用 summary_large_image

5. 图标与 manifest(中)

  • 至少包含一个跨浏览器有效的网站图标
  • 在适当情况下包含 apple-touch-icon
  • manifest 必须有效,并且在被使用时正确引用
  • 有意识地设置 theme-color,以避免 UI 界面颜色不匹配
  • 图标路径应保持稳定且可缓存

6. 结构化数据(中)

  • 除非 JSON-LD 明确映射到页面实际内容,否则不要添加
  • JSON-LD 必须有效,并反映实际渲染的内容
  • 不要编造评分、评论、价格或组织详细信息
  • 除非必要,每个页面优先使用一个结构化数据块

7. 区域设置与替代语言(低-中)

  • 正确设置 html lang 属性
  • 当存在本地化内容时设置 og:locale
  • 仅当页面真实存在时添加 hreflang 替代链接
  • 本地化页面必须按区域设置正确进行规范化

8. 工具边界(严重)

  • 优先最小化变更,不要重构无关代码
  • 除非要求,不要迁移框架或 SEO 库
  • 遵循项目现有的元数据模式(Next.js 元数据 API、react-helmet、手动 head 等)

审查指南

  • 优先修复严重问题(重复、规范链接、索引)
  • 确保标题、描述、规范链接和 og:url 一致
  • 在真实 URL 上验证社交卡片,而非 localhost
  • 优先使用稳定、规范的元数据,而非花哨或动态的
  • 保持差异最小,仅限元数据相关的修改

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

相关技能