---
description: awesome claude skills compatibility
globs:
alwaysApply: false
---

# awesome-claude-skills 导入兼容规则

## 背景

`https://github.com/ComposioHQ/awesome-claude-skills` 是 **Skills 清单仓库**，主要内容是各目录下的 `SKILL.md`，并不提供 Cursor 项目规则所需的 `.mdc` 文件。

因此在 Cursor 中使用“Import GitHub/GitLab rules”导入该仓库时，会出现：

- `No importable .mdc project rule files were found in the repository`

这属于**仓库格式不匹配**，不是网络或权限问题。

## 正确做法

1. 将该仓库视为“技能来源”，不要直接作为 `.mdc` 规则仓库导入。
2. 从目标 `SKILL.md` 提取可复用约束（触发条件、步骤、限制、禁用项）。
3. 在当前项目 `.cursor/rules/` 下新建或更新 `.mdc` 文件承载这些约束。
4. 用本地 `.mdc` 生效规则，而不是依赖远程 rules 导入器自动转换。

## 迁移模板（从 SKILL.md 到 .mdc）

```md
---
description: <rule purpose>
globs:
alwaysApply: <true|false>
---

# <Rule Title>

## 使用时机
- <when to apply>

## 执行流程
1. <step 1>
2. <step 2>
3. <step 3>

## 强约束
- <must do>
- <must not do>
```

## 质量要求

- 保留原技能的关键“行为约束”，不要只复制介绍文本。
- 规则内容应聚焦当前项目，删除与项目无关的外部平台说明。
- 若引入第三方模板或流程，需注明来源链接，避免失真改写。

