Proposal: standardize SKILL.md frontmatter with tier / destructive / YAML tags

[AnterCreeper]

问题描述

当前上游 .claude/skills/*/SKILL.md 的 frontmatter 存在两类规范不一致，影响 AgentSkills 解析和自动化分类：

1. 缺少 tier 和 destructive 字段：约 40 个 skill 中绝大多数未声明 tier（层级）和 destructive（是否具有破坏性操作）。这两个字段对于 Agent 编排和权限控制非常重要。
2. tags 格式不统一：部分 skill 使用 JSON 数组内联格式 tags: ["a", "b"]，建议统一为 YAML 列表格式，提升可读性和可维护性。

建议规范

参考本地 fork 的实践经验，建议为所有 skill 补充以下 frontmatter 字段：

---
name: <skill-name>
description: <description>
version: 1.0.0
author: ZimoLiao/scholaraio
license: MIT
tags:
  - tag1
  - tag2
tier: <core | utility | writing | visualization>
destructive: <true | false>
---

tier 分类建议

值	含义	包含 skill
core	知识库核心操作（搜索、展示、入库、索引、导出等）	search, show, ingest, ingest-link, export, graph, import, index, enrich, topics, translate, citations, metrics, audit, rename
utility	工具型辅助功能（arXiv、网页搜索/提取、备份、洞察等）	arxiv, websearch, webextract, backup, explore, insights, setup, patent-search, patent-fetch
writing	学术写作辅助	paper-writing, literature-review, review-response, research-gap, writing-polish, paper-guided-reading
visualization	可视化与图表生成	draw, diagram, document

destructive 分类建议

• destructive: true：会修改数据、删除文件或覆盖已有内容的 skill（如 ingest-link --force、rename --all、publish、scrub 等）。
• destructive: false：只读或查询型 skill（如 search, show, citations 等）。

受影响 skill 清单（建议值）

Skill	当前 tier	当前 destructive	建议 tier	建议 destructive	备注
academic-writing	缺失	缺失	writing	false	路由型 skill
arxiv	缺失	缺失	utility	false	部分 frontmatter 也不完整
audit	缺失	缺失	core	false
bioinformatics	缺失	缺失	utility	false	科学计算类
citation-check	缺失	缺失	utility	false
citations	缺失	缺失	core	false
document	缺失	缺失	visualization	false
draw	缺失	缺失	visualization	false
enrich	缺失	缺失	core	false	会写 meta.json，但通常视为非破坏性
explore	缺失	缺失	utility	false
export	缺失	缺失	core	false
graph	缺失	缺失	core	false
gromacs	缺失	缺失	utility	false	科学计算类
import	缺失	缺失	core	false
index	缺失	缺失	core	false
ingest	缺失	缺失	core	false
ingest-link	缺失	缺失	utility	true	会修改 papers/ 和 index.db
insights	缺失	缺失	utility	false
lammps	缺失	缺失	utility	false	科学计算类
literature-review	缺失	缺失	writing	false
metrics	缺失	缺失	core	false
openfoam	缺失	缺失	utility	false	科学计算类
paper-writing	缺失	缺失	writing	false
poster	缺失	缺失	writing	false
publish	缺失	缺失	utility	true	会修改 published/ 和 assets/
quantum-espresso	缺失	缺失	utility	false	科学计算类
rename	缺失	缺失	core	true	会重命名目录
research-gap	缺失	缺失	writing	false
review-response	缺失	缺失	writing	false
scientific-runtime	缺失	缺失	utility	false
scientific-tool-onboarding	缺失	缺失	utility	false
search	缺失	缺失	core	false
setup	缺失	缺失	utility	false
show	缺失	缺失	core	false
technical-report	缺失	缺失	writing	false
topics	缺失	缺失	core	false
translate	缺失	缺失	core	false	会写 paper_{lang}.md
workspace	缺失	缺失	core	false
writing-polish	缺失	缺失	writing	false

示例 Diff

以 search 为例：

 ---
 name: search
 description: Search academic papers in the local ScholarAIO knowledge base. Supports
   unified search (keyword + semantic fusion), keyword-only (FTS5), semantic-only (FAISS),
   author search, and federated search across main library, explore databases, and
   arXiv. Use when the user wants to find papers, look up literature, search by author,
   explore research topics, or search across multiple sources. For citation rankings
   and citation count updates, see the /citations skill.
 version: 1.0.0
 author: ZimoLiao/scholaraio
 license: MIT
-tags: ["academic", "search", "papers", "semantic", "fts5"]
+tags:
+  - academic
+  - search
+  - papers
+  - semantic
+  - fts5
+tier: core
+destructive: false
 ---

额外建议

部分科学计算类 skill（bioinformatics, gromacs, lammps, openfoam, quantum-espresso, scientific-runtime, scientific-tool-onboarding）目前缺少完整的 version / author / license frontmatter，建议一并补齐基础字段。

---

如果维护者同意，我可以批量提交一个 PR，为所有 skill 统一 frontmatter 格式并补充缺失字段。