第一个 Skill
这篇文章介绍了如何创建一个名为html-optimizer的技能工具,用于HTML代码优化。该工具具备三大核心功能:HTML结构分析、SEO优化建议和可访问性检查(a11y)。它通过关键词触发机制激活,内置了SEO最佳实践、可访问性规范和性能优化等知识体系。工作流程包括识别文件、读取代码、静态分析和生成报告四个步骤,能检测缺失元标签、语义化标签使用情况等问题,并提供修复建议和优化评分。用户可通过简
·
🚀 创建第一个 Skill:html-optimizer
1. 定义元数据 (Metadata)
name: html-optimizer
description: 提供 HTML 代码结构分析、SEO 优化建议及可访问性 (a11y) 检查
version: 1.0.0
author: "Your Name"
tags: ["html", "frontend", "seo", "accessibility"]
2. 设置触发机制 (Triggers)
当用户提到以下关键词或意图时激活:
- 关键词:
HTML 优化、SEO 检查、网页可访问性、HTML 结构分析、a11y - 意图:
analyze_html,optimize_seo,check_accessibility
3. 构建知识体系 (Knowledge Base)
这是 Skill 的“大脑”,包含以下核心知识:
- SEO 最佳实践:
- 必须包含
<title>,<meta description>,<meta viewport>。 - 图片必须有
alt属性。 - 语义化标签使用 (
<header>,<nav>,<main>,<article>,<footer>)。
- 必须包含
- 可访问性 (a11y) 规范:
- 表单必须有
<label>关联。 - 按钮必须有可点击的文本或
aria-label。 - 颜色对比度符合 WCAG 标准。
- 表单必须有
- 性能优化:
- 避免内联 CSS/JS(建议外部文件)。
- 图片懒加载 (
loading="lazy")。 - 减少 DOM 深度。
4. 设计工作流 (Workflow)
当 Skill 被激活时,按以下步骤执行:
- 识别目标文件:
- 检查当前打开的文件是否为
.html。 - 如果不是,询问用户要分析哪个 HTML 文件。
- 检查当前打开的文件是否为
- 读取代码:
- 调用
read工具获取文件内容。
- 调用
- 静态分析:
- 检查缺失的元标签。
- 检查语义化标签使用情况。
- 检查图片
alt属性和表单label。
- 生成报告:
- 输出 问题列表(严重/警告/建议)。
- 提供 修复代码示例。
- 给出 优化评分(如:SEO 85/100)。
5. 工具集成 (Tools)
read: 读取 HTML 文件内容。lsp: (可选) 检查 HTML 语法错误。write: (可选) 直接生成优化后的代码文件。
💡 如何开始使用?
你可以直接对我说:
“请激活
html-optimizer技能,分析当前打开的weibo-blog.html文件。”
或者:
“帮我检查这个 HTML 文件的 SEO 和可访问性问题。”
系统会自动识别意图,加载上述知识体系,并调用工具读取文件进行分析。
更多推荐




所有评论(0)