Skip to content
Conduit

skill

awesome-catalogs

Paste a GitHub link — auto-classify, install to the right directory, and update a searchable Markdown catalog.

doublesq97-ui/awesome-catalogscommunitylistedunreviewed
Use skill

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/doublesq97-ui/awesome-catalogs itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 22, 2026

🛠️ awesome-catalogs

Paste a GitHub link — auto-classify, extract a summary, install it, and update your catalog. Works as a CLI and as a Claude Code / Codex skill.

version categories status license

✨ 这是什么？

awesome-catalogs 是一个 GitHub 资源整理器，也可以作为 Claude Code / Codex 的本机技能资产管理器。

你给它一个 GitHub 链接或本地 repo 路径，它会：

  • 🔍 判断它属于 skill、tool、script、plugin 还是 software
  • 📝 从 README.md 提取一句话摘要
  • 📦 安装到对应的本地目录
  • 🗂️ 更新 ~/.claude/awesome-catalogs/ 下的 Markdown 目录
  • 📊 追踪每个工具的使用频率，5 分制评分
  • 🧹 扫描僵尸项目（从未使用 / 长期闲置），一键清理
  • 🔎 提供目录查看和搜索能力
  • 🌟 批量导入 GitHub Stars，按领域分组推荐
  • 🔬 装前 7 维评估：热度 / 活跃度 / 社区健康 / 版本稳定性 / 安装成本 / 重叠度 / 场景匹配
  • 🔄 重叠检测：4 层加权语义对比，自动发现功能重复的工具
  • 🚫 反推荐：评估不通过时自动列出已有替代品
  • 💡 智能推荐：交叉对比使用习惯 × 目录，推荐被遗忘的工具
  • 🧭 本机技能审计：扫描 Claude / Codex / Hermes / Marvis / WorkBuddy skills，生成保留、迁移、合并、归档建议

v1.7.0 已实现「能识别、能安装、能追踪、能评估、能推荐、能审计本机多 agent skills」的完整闭环。

🚀 快速开始

安装

git clone https://github.com/doublesq97-ui/awesome-catalogs.git
cd awesome-catalogs
pip install .

安装后可以运行：

awesome --help

作为 Claude Code Skill 使用

把本 repo 放到 Claude skills 目录，或用你自己的 skill 安装方式安装：

mkdir -p ~/.claude/skills
cp -R /path/to/awesome-catalogs ~/.claude/skills/awesome-catalogs

Claude Code 中可以直接说：

  • “评估这个 GitHub repo 要不要安装”
  • “扫描我的 skills”
  • “找出重复的 skills”
  • “清理长期没用的 skill”

作为 Codex Skill 使用

把轻量入口放到 Codex skills 目录：

mkdir -p ~/.codex/skills/awesome-catalogs
cp /path/to/awesome-catalogs/SKILL.md ~/.codex/skills/awesome-catalogs/SKILL.md

如果你希望 Codex 使用本地源码版 CLI，建议在 skill 中调用：

PYTHONPATH=/path/to/awesome-catalogs python3 -m awesome_catalogs <command>

Codex 中适合触发它的请求：

  • “整理本机 skills”
  • “评估哪些 skill 该迁移到 Codex”
  • “看看 Claude/Hermes/Marvis 里哪些技能重复”
  • “把 awesome catalog 更新一下”

第一次试运行

先用 --dry-run 看看它会如何判断，不会复制文件，也不会写 catalog：

awesome install https://github.com/owner/repo --dry-run

你会看到类似反馈：

Name:      repo
Category:  tool (Tools)
Domain:    Dev Tools
Summary:   A small CLI helper for developer workflows.
Source:    https://github.com/owner/repo
Target:    ~/.claude/tools/repo
Status:    ready

确认没问题后再正式安装：

awesome install https://github.com/owner/repo

✅ 已实现能力

v1.2.0（分类 + 安装 + Stars 导入）

  • 🔍 自动分类：基于 repo 文件结构做规则判断
  • 📝 摘要提取：从 README 提取第一段有效描述
  • 📦 本地安装：复制 repo 到对应目标目录
  • 🗂️ catalog 更新：写入总目录和分类目录
  • 🔎 基础查询：支持 list 和 search
  • 🚫 重复检测：安装时自动提示 catalog 中已有的相同来源
  • 🧪 试运行：支持 --dry-run，先看判断结果再安装
  • 🌟 Stars 导入：import-stars 批量导入 + 按领域分组 + 推荐/跳过分类
  • 🧱 基础测试：22 个测试覆盖分类、决策、摘要清洗

v1.3.0（使用追踪 + 僵尸清理）

  • 📊 安装追踪：awesome install 自动写入 activity.json（安装时间、类型、来源）
  • 🔢 使用计数：awesome record-usage <name> 记录使用次数和最后使用时间
  • ⭐ 5 分制评分：距上次使用 ≤7 天 = █████，>365 天 = █░░░░，从未使用 = ░░░░░
  • 🧹 僵尸扫描：awesome cleanup 列出所有 score ≤1 的项目
  • 🗑️ 批量清理：awesome cleanup --force 确认后删除 + 同步更新 catalog + activity.json

v1.4.0（装前评估）

  • 🔬 7 维评估：热度、活跃度、社区健康、版本稳定性、安装成本、重叠度、场景匹配
  • 🔗 实时 GitHub API：拉取 stars、forks、最近 push、open issues、release 版本
  • 🔄 交叉对比：结合 activity.json 分析重叠度和使用场景匹配
  • 💡 三级建议：🟢 推荐安装 / 🟡 观望 / 🔴 不建议

v1.5.0（重叠检测 + 索引）

  • 🔄 4 层加权重叠引擎：关键词 (40%) + 领域 (25%) + 输出格式 (20%) + 场景 (15%)
  • 🔍 awesome overlap：对比新工具 vs 已安装工具，发现功能重复
  • 📊 awesome overlap（无参数）：扫描所有已安装工具，找出重叠对
  • 📝 awesome index：扫描已安装工具，自动回填描述/关键词/输出格式

v1.6.0（反推荐 + 智能推荐）🆕

  • 🚫 反推荐：evaluate 判定不通过时，自动列出已有替代品（含重叠度 + 使用率）
  • 💡 智能推荐：awesome recommend — 分析使用模式，找出高频域中从未用过的工具
  • 🧩 反推荐在 evaluate 中自动触发，无需额外命令
  • 🎯 --days / --domain 参数支持灵活过滤

当前命令状态

命令状态说明
awesome --version✅显示当前版本号 (v1.6.0)
awesome install <url>✅贴链接 → 分类 → 安装 → 更新 catalog
awesome install <url> --dry-run✅只预览，不写入
awesome install <url> --force✅强制覆盖安装
awesome classify <path>✅只分析本地 repo
awesome list [category]✅查看总目录或分类目录
awesome search <keyword>✅跨 catalog 搜索
awesome import-stars <user>✅批量导入 GitHub Stars
awesome cleanup✅扫描僵尸项目（score ≤1）
awesome cleanup --force✅确认后批量删除
awesome record-usage <name>✅记录一次使用
awesome evaluate <url>✅7 维评估 + 自动反推荐
awesome index✅扫描已安装，回填指纹数据
awesome overlap✅发现已安装的重叠对
awesome overlap <url>✅比较新工具 vs 已安装
awesome recommend✅智能推荐（高频域 × 未使用）
awesome recommend --days 30✅自定义时间窗口
awesome recommend --domain Design✅按域筛选
awesome anti-recommend <url>✅评估 + 替代方案
awesome audit-skills✅扫描 Claude/Codex/Hermes/Marvis/WorkBuddy skills，生成合并报告
awesome audit-skills --no-write✅只预览审计结果，不写报告

🧭 命令速查

# 安装
awesome install https://github.com/owner/repo
awesome install https://github.com/owner/repo --dry-run

# 浏览
awesome list
awesome list skills
awesome search agent

# Stars
awesome import-stars <username>

# 使用追踪
awesome cleanup
awesome cleanup --force

# 评估 & 推荐 (v1.4–v1.6)
awesome evaluate https://github.com/owner/repo
awesome overlap
awesome recommend
awesome recommend --days 30 --domain Design
awesome anti-recommend https://github.com/owner/repo

# 本机 skills 审计
awesome audit-skills

🎬 示例

示例 1：安装 + 使用追踪

awesome install https://github.com/owner/my-skill
awesome record-usage my-skill

示例 2：清理僵尸项目

awesome cleanup

输出：

Found 32 zombie items (score <= 1):

| Score | Name | Type | Installed | Last Used |
| --- | --- | --- | --- | --- |
| ░░░░░ | claude-code-sub-agents | skill | 2026-05-13 | never |
| ░░░░░ | n8n-code-javascript | skill | 2026-05-13 | never |
| █░░░░ | old-cli-tool | tool | 2026-01-10 | 2026-01-12 |
...

Run `awesome cleanup --force` to delete these items.

确认后执行：

awesome cleanup --force
# Deleted 32 items: claude-code-sub-agents, n8n-code-javascript, ...

示例 3：查看 catalog

awesome list tools
awesome search automation

| Domain | Name | Repo | Summary | Status |
|---|---|---|---|---|
| Dev Tools | useful-cli | github.com/owner/useful-cli | A command-line utility for everyday automation. | installed |

示例 4：装前评估 (v1.4.0)

awesome evaluate https://github.com/n8n-io/n8n

输出：

## n8n 评估

> Fair-code workflow automation platform with native AI capabilities.

| 维度 | 评估 |
|------|------|
| 热度 | 🟢 ⭐ 188,641 stars · 57,802 forks |
| 活跃度 | 🟢 0d since last push · active |
| 社区健康 | 🔴 1468 open issues · may be under-maintained |
| 版本稳定性 | 🟢 stable · stable release |
| 安装成本 | 🟡 Medium — Docker |
| 重叠度 | 🔴 8 related: claude-code-sub-agents ░░░░░, n8n-code-javascript ░░░░░... |
| 场景匹配 | 🔴 15 tools in same domain, all ░░░░░ — likely low priority |

建议：🔴 不建议 — 多项指标不理想，建议观望或寻找替代品

🧠 分类规则

判断信号分类安装目标
根目录有 SKILL.mdskill默认 ~/.claude/skills/<name>/，Codex 入口可放 ~/.codex/skills/<name>/
有 MCP 或 Claude/Codex plugin 配置文件plugin默认 ~/.claude/plugins/<name>/
单文件 .sh、.py、.js、.rb 脚本仓库script默认 ~/.claude/scripts/<name>/
有 bin/、cmd/、main.go、cli.py 或 package bintool默认 ~/.claude/tools/<name>/
其他完整应用或独立项目software~/claude-projects/<name>/

优先相信结构化信号。README 里普通提到 "plugin" 或 "MCP" 不会直接触发 plugin 分类，避免把说明文档误判成插件。

🗂️ Catalog 目录

~/.claude/awesome-catalogs/
├── CATALOG.md           # 总目录
├── SKILLS_CATALOG.md    # Skills
├── TOOLS_CATALOG.md     # Tools
├── SCRIPTS_CATALOG.md   # Scripts
├── PLUGINS_CATALOG.md   # Plugins
├── SOFTWARE_CATALOG.md  # Software
└── activity.json        # 使用追踪数据 (v1.3.0)
  • 运行 awesome install 后，程序自动判断分类并写入对应 Markdown 文件
  • 想查看全部资源：awesome list
  • 想查看某一类：awesome list skills
  • 想找回某个资源：awesome search <keyword>
  • 想清理僵尸：awesome cleanup
  • 想审计本机多 agent skills：awesome audit-skills

🧭 本机 Skills 审计

awesome audit-skills 会扫描以下默认位置：

来源默认路径
Codex~/.codex/skills
Claude~/.claude/skills
Hermes~/.hermes/skills
WorkBuddy~/.workbuddy/skills
Marvis~/Library/Application Support/com.tencent.mac.marvis

输出：

~/.claude/awesome-catalogs/SKILL_AUDIT.md
~/.claude/awesome-catalogs/SKILL_AUDIT_ZH.md
~/.claude/awesome-catalogs/skill_audit.json

审计报告会标记：

  • keep：保留
  • port-to-codex：适合迁移到 Codex
  • merge：功能重叠，建议合并
  • review：人工复核
  • archive：归档/删除候选

📊 使用追踪与评分 (v1.3.0)

activity.json 记录每条工具的完整生命周期：

{
  "items": {
    "my-skill": {
      "type": "skill",
      "name": "my-skill",
      "repo": "github.com/owner/my-skill",
      "domain": "🤖 AI/Automation",
      "installed_at": "2026-05-19T16:00:00+08:00",
      "last_used_at": "2026-05-19T18:30:00+08:00",
      "times_used": 3
    }
  }
}

5 分制评分：

评分条件
█████ (5)7 天内使用过
████░ (4)30 天内使用过
███░░ (3)90 天内使用过
██░░░ (2)180 天内使用过
█░░░░ (1)365 天内使用过
░░░░░ (0)从未使用或超过一年

僵尸清理规则：

  • 不自动删除，必须先 awesome cleanup 预览
  • awesome cleanup --force 确认后才执行
  • 删除时同步清理本地文件 + catalog + activity.json

🧪 测试

python3 -m unittest discover -s tests

🧭 后续路线

已完成

Phase内容版本
核心闭环分类、安装、catalog、搜索、Stars 导入v1.2.0
使用追踪activity.json、5 分制评分、僵尸扫描清理v1.3.0
装前评估7 维评估 + GitHub API + 交叉对比v1.4.0
重叠检测4 层加权重叠引擎 + pairwise 扫描v1.5.0
反推荐 + 智能推荐评估自动反推荐 + 使用模式推荐v1.6.0
多 agent skills 审计Claude/Codex/Hermes/Marvis/WorkBuddy 扫描与合并建议v1.7.0

待规划

Phase内容
Codex 安装目标将 install 目标扩展为可选择 ~/.codex/skills
定期健康检查30 天未清理提醒 / 90 天僵尸预警 / 死链检测
Phase 0: 使用追踪         [██████████] ✅ v1.3.0
Phase 1: 装前评估         [██████████] ✅ v1.4.0
Phase 2: 重叠检测         [██████████] ✅ v1.5.0
Phase 3: 反推荐+智能推荐  [██████████] ✅ v1.6.0
Phase 4: 多 agent 审计     [██████████] ✅ v1.7.0
Phase 5: Codex 安装目标    [██░░░░░░░░] 下一期
Phase 6: 定期健康检查      [██░░░░░░░░] 待规划

如果这个方向也戳中你，欢迎给一个 star ⭐。

继续探索 Su 的开源项目

把 Skill 整理清楚只是第一步；下一步，是找到真正值得安装、能够直接解决问题的 Skill。

查看 Su 的其他开源项目 →

↑↓ navigate openesc close