原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

SkillCompass Skill

代码仓库 ↗

作者:Evol-ai★ 2141 个 skill

安装

What it does

Evaluate agent skill quality. Find the weakest link. Fix it. Prove it worked.

  • Connects Instruction files the AI reads
  • Account or key Not confirmed yet (README not read yet)
  • Category 写代码
给作者:在 README 中加徽章

如果你是作者,可把这段代码贴到 README。徽章会链接回本页。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/evol-ai-skillcompass.svg)](https://mcp.popnx.com/en/skills/evol-ai-skillcompass)

可搭配使用

在同一工作中把 AI 连到服务的 MCP

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

作者:morluto广泛使用↓ 38.9万/周★ 46.4万5天前更新

MCP · 连接服务在你的电脑上运行

Fallow

Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.

作者:fallow-rs广泛使用↓ 244.1万/周★ 5374今天更新

MCP · 连接服务在你的电脑上运行

Desktop Commander

MCP server for terminal commands, file operations, and process management

作者:wonderwhy-er广泛使用↓ 74万/周★ 1万5天前更新

MCP · 连接服务在你的电脑上运行

相似的 Skill

同类工作,排序与 Skill 列表相同

与相似项目对比
本项
SkillCompass
reaandrej-karpathy-skillsgraphifyMoneyPrinterTurbo
作者Evol-aimorlutomultica-aiGraphify-Labsharry0703
Skill 数11111
GitHub 星标214465,460233,910149,364144,149
最近代码更新2026年4月23日2026年11月17日2026年4月20日2026年11月17日2026年11月17日
许可证MITMIT–Apache-2.0MIT

Evol-ai 提供的 1 个 Skill(指令集),AI 读取后照做 · 不是 MCP server

Skill 和 MCP 有什么不同

MCP = 手

把 AI 连到外部服务或数据,例如读取 Notion 或开发票。需要有程序或服务器在运行。

Skill = 手册

教 AI 怎么做某项工作的文本文件,不连接任何服务。

有些会重叠:少数 Skill 带有调用工具的脚本,少数 MCP 只提供知识。请从你想完成的工作出发。

适用的应用

Claude CodeCodexCursorGemini CLIGitHub Copilot

依据开发者 README 和 repo 中的文件夹

安装

Is it safe?

  • Who made it

    GitHub account Evol-ai (organization) is only 8 months old: take extra care

  • Use and upkeep

    ★ 214 stars, few users so far · code last changed 2026年4月23日

  • Any scripts?

    54 scripts that can run on a computer: hooks/scripts/output-guard.js, hooks/scripts/pre-eval-scan.sh, hooks/scripts/eval-gate.js, hooks/scripts/post-skill-edit.js and 50 more

  • Uses the internet?

    Scripts that go online: scripts/eval-v2/codespace-setup.sh

  • Changes machine-wide settings?

    Installing the maker’s way adds hooks that run without you asking: run every time the AI edits a file · run every time a chat starts · run every time a chat closes

Checked automatically from the repo files at commit b98a1b6 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

第一步:你用哪个 AI?

选择你用的应用,本页只显示该应用的安装方法

Option 1Upload to claude.ai (web and app)

Uploading to claude.ai would fail: the description is over 200 characters (253). Use "Let the AI install it" instead

Option 1让 Claude Code 帮你安装

复制这句话,粘贴到 Claude Code 的对话中

Where to install

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

重新打开 Claude Code,输入 /SkillCompass,或直接提出相关任务,Claude 会自动选用

Checked against official docs 2026年11月12日 · Source: code.claude.com

For Terminal users

Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。

开发者推荐的方式

安装 Node.js(如果还没有)

已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

node -v
  • 显示版本号(例如 v26.13.1)= 已安装,可跳过这一步
  • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
怎么打开终端

Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

还没安装: 打开官方下载页,选择 LTS 版本和点选式安装程序:Mac 用 .pkg · Windows 用 .msi。双击后一路下一步即可,不需要 curl 命令

打开 Node.js 下载页 ↗

装好后关掉终端再打开,重新运行同一条命令,应显示版本号: node -v

安装一次,所有需要 Node.js 的工具都能用

正在检查命令 · 通过后才会显示复制按钮

摘自开发者 README,会下载并运行开发者的代码

  1. 打开终端

    Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”

  2. 把 skill 文件夹复制到 ~/.claude/skills

    这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹

    正在检查命令 · 通过后才会显示复制按钮

  3. 重新打开 Claude Code,输入 /SkillCompass,或直接提出相关任务,Claude 会自动选用

自己安装的 Skill 可用于 ChatGPT 桌面应用、Codex CLI 和 IDE 中的 Codex 扩展 · 网页版和手机版 ChatGPT 不能使用自己安装的 Skill,只能使用目录中插件自带的 Skill

ChatGPT 桌面应用

ChatGPT 桌面应用内置 Codex,Codex 从 ~/.agents/skills 文件夹读取 Skill

Option 1让 ChatGPT 帮你安装

在 ChatGPT 桌面应用中打开 Codex,把这句话粘贴到对话中

Where to install

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2自己放入文件夹

把 skill-compass 文件夹放到 ~/.agents/skills/skill-compass

~ 是你的主文件夹($HOME)

For Terminal users

Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。

  1. 打开终端

    Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”

  2. 把 skill 文件夹复制到 ~/.agents/skills

    这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹

    正在检查命令 · 通过后才会显示复制按钮

安装之后

  • ChatGPT 桌面应用:打开侧边栏中的 Skills,确认 Skill 已出现
  • 使用方法:在 ChatGPT 中输入 @ 并选择 Skill · 在 Codex CLI 或 IDE 扩展中运行 /skills,或输入 $ 加 Skill 名称
  • Codex 会自动发现新安装的 Skill;如果没有出现,请重启 Codex

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

网页版和手机版 ChatGPT

不能使用你自己安装的 Skill,只能使用目录中插件自带的 Skill

想在 ChatGPT 中使用这个 Skill,请按上面的方法使用 ChatGPT 桌面应用

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

Option 1让 Codex 帮你安装

复制这句话,粘贴到 Codex 的对话中 · 适用于 ChatGPT 桌面应用中的 Codex、Codex CLI 和 IDE 扩展

Where to install

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex 会自动发现新安装的 Skill;如果没有出现,请重启 Codex · 使用方法:在 ChatGPT 中输入 @ 并选择 Skill · 在 Codex CLI 或 IDE 扩展中运行 /skills,或输入 $ 加 Skill 名称

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

For Terminal users

Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。

  1. 打开终端

    Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”

  2. 把 skill 文件夹复制到 ~/.agents/skills

    这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹

    正在检查命令 · 通过后才会显示复制按钮

  3. 重新打开 Codex 并提出相关任务,Codex 会列出这个 skill

Option 1让 Cursor 帮你安装

复制这句话,粘贴到 Cursor 的对话中

Where to install

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

在 Cursor 的 Agent 聊天中输入 / 并选择 SkillCompass

Checked against official docs 2026年11月12日 · Source: cursor.com

For Terminal users

Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。

  1. 打开终端

    Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”

  2. 把 skill 文件夹复制到 ~/.cursor/skills

    这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹

    正在检查命令 · 通过后才会显示复制按钮

  3. 在 Cursor 的 Agent 聊天中输入 / 并选择 SkillCompass

Option 1Let the AI install it

适用于其他能读取 Skill 的应用。这句话列出了 Claude Code、Codex 和 Cursor 的路径,AI 会按你的应用选择 · Copy this sentence into the app’s chat

Where to install

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

其他支持 Agent Skills 的应用(如 Gemini CLI、GitHub Copilot)使用不同文件夹,请查看该应用的指南,再把含 SKILL.md 的文件夹复制过去。

在 GitHub 上查看 ↗

已于 2026年11月11日 对照 Claude Code、Codex 和 Cursor 官方指南核实 skill 文件夹

查看原始 SKILL.md

以下文字来自开发者的 repo,不是 PopNx MCP 的指令

显示前 8,000 个字符 · 在 GitHub 打开完整文件

---
name: skill-compass
version: 1.0.0
description: >
  Evaluate skill quality, find the weakest dimension, and apply directed
  improvements. Also tracks usage to spot idle or risky skills.
  Use when: first session after install, or user asks about skill quality,
  evaluation, inbox, suggestions, or improvement.
commands:
  - skillcompass
  - skill-compass
  - setup
  - eval-skill
  - eval-improve
  - eval-security
  - eval-audit
  - eval-compare
  - eval-merge
  - eval-rollback
  - eval-evolve
  - all-skills
  - skill-report
  - skill-update
  - skill-inbox
  - inbox
metadata:
  clawdbot:
    emoji: "🧭"
    homepage: https://github.com/Evol-ai/SkillCompass
    requires:
      bins: [node]
    files: ["commands/*", "lib/*", "hooks/scripts/*", "prompts/*", "shared/*", "schemas/*", "README.md", "SECURITY.md", ".claude-plugin/*"]
    type: executable
---

# SkillCompass

You are **SkillCompass**, a skill quality and management tool for Claude Code. You help users understand which skills are worth keeping, which have issues, and which are wasting context.

## Post-Install Onboarding

**Triggered by SessionStart hook.** `hooks/scripts/session-tracker.js` compares the current SkillCompass version against `.skill-compass/cc/last-version`. If they differ (first install, reinstall, or update), the hook injects a context message asking Claude to run the Post-Install Onboarding on the user's first interaction.

When you see that message, use the **Read** tool to load `{baseDir}/commands/post-install-onboarding.md` and follow it exactly. Do not wait for a slash command.

---

## Six Evaluation Dimensions

| ID | Dimension   | Weight | Purpose |
|----|-------------|--------|---------|
| D1 | Structure   | 10%    | Frontmatter validity, markdown format, declarations |
| D2 | Trigger     | 15%    | Activation quality, rejection accuracy, discoverability |
| D3 | Security    | 20%    | **Gate dimension** - secrets, injection, permissions, exfiltration |
| D4 | Functional  | 30%    | Core quality, edge cases, output stability, error handling |
| D5 | Comparative | 15%    | Value over direct prompting (with vs without skill) |
| D6 | Uniqueness  | 10%    | Overlap, obsolescence risk, differentiation |

## Scoring

```text
overall_score = round((D1*0.10 + D2*0.15 + D3*0.20 + D4*0.30 + D5*0.15 + D6*0.10) * 10)
```

- **PASS**: score >= 70 AND D3 pass
- **CAUTION**: 50-69, or D3 High findings
- **FAIL**: score < 50, or D3 Critical (gate override)

Full scoring rules: use **Read** to load `{baseDir}/shared/scoring.md`.

## Command Dispatch

### Main Entry Point

| Command | File | Purpose |
|---------|------|---------|
| **/skillcompass** | `commands/skill-compass.md` | **Sole main entry** — smart response: shows suggestions if any, otherwise a summary; accepts natural language |

### Shortcut Aliases (not actively promoted; available for users who know them)

| Command | Routes to | Purpose |
|---------|-----------|---------|
| /all-skills | `commands/skill-inbox.md` (arg: all) | Full skill list |
| /skill-report | `commands/skill-report.md` | Skill ecosystem report |
| /skill-update | `commands/skill-update.md` | Check and update skills |
| /inbox | `commands/skill-inbox.md` | Suggestion view (legacy alias) |
| /skill-compass | `commands/skill-compass.md` | Hyphenated form of /skillcompass |
| /skill-inbox | `commands/skill-inbox.md` | Full name of /inbox |

### Evaluation Commands

| Command | File | Purpose |
|---------|------|---------|
| /eval-skill | `commands/eval-skill.md` | Assess quality (scores + verdict). Supports `--scope gate\|target\|full`. |
| /eval-improve | `commands/eval-improve.md` | Fix the weakest dimension automatically. Groups D1+D2 when both are weak. |

### Advanced Commands

| Command | File | Purpose |
|---------|------|---------|
| /eval-security | `commands/eval-security.md` | Standalone D3 security deep scan |
| /eval-audit | `commands/eval-audit.md` | Batch evaluate a directory. Supports `--fix --budget`. |
| /eval-compare | `commands/eval-compare.md` | Compare two skill versions side by side |
| /eval-merge | `commands/eval-merge.md` | Three-way merge with upstream updates |
| /eval-rollback | `commands/eval-rollback.md` | Restore a previous skill version |
| /eval-evolve | `commands/eval-evolve.md` | Optional plugin-assisted multi-round refinement. Requires explicit user opt-in. |

### Dispatch Procedure

`{baseDir}` refers to the directory containing this SKILL.md file (the skill package root). This is the standard OpenClaw path variable; Claude Code Plugin sets it via `${CLAUDE_PLUGIN_ROOT}`.

1. Parse the command name and arguments from the user's input.

2. **Alias resolution:**
   - `/skillcompass` or `/skill-compass` (no args) → **smart entry** (see Step 3 below)
   - `/skillcompass` or `/skill-compass` + natural language → load `{baseDir}/commands/skill-compass.md` (dispatcher)
   - `/all-skills` → load `{baseDir}/commands/skill-inbox.md` with arg `all`
   - `/skill-report` → load `{baseDir}/commands/skill-report.md`
   - `/inbox` or `/skill-inbox` → load `{baseDir}/commands/skill-inbox.md`
   - `/setup` → load `{baseDir}/commands/setup.md`
   - All other commands → load `{baseDir}/commands/{command-name}.md`

3. **Smart entry (`/skillcompass` without arguments):**
   - Check `.skill-compass/setup-state.json`. If not exist → run Post-Install Onboarding (above).
   - If `inventory` is missing or empty → show `"No skills installed yet. Install some and rerun /skillcompass."` and stop.
   - Read inbox pending count from `.skill-compass/cc/inbox.json`. If the file is missing, unreadable, or malformed → treat pending as `0` and continue.
   - If pending > 0 → load `{baseDir}/commands/skill-inbox.md` (show suggestions).
   - If pending = 0 → show one-line summary + choices:
     ```
     🧭 {N} skills · Most used: {top_skill} ({count}/week) · {status}
     [View all skills / View report / Evaluate a skill]
     ```
     Where `{status}` is "All healthy ✓" or "{K} at risk" based on latest scan.
   - On any other unexpected read error → fall back to `/setup` for a clean re-initialization.

4. For any command requiring setup state, check `.skill-compass/setup-state.json`. If not exist, auto-initialize (same as `/inbox` first-run behavior in `skill-inbox.md`).

5. Use the **Read** tool to load the resolved command file.

6. Follow the loaded command instructions exactly.

## Output Format

- **Default**: JSON to stdout (conforming to `schemas/eval-result.json`)
- **`--format md`**: additionally write a human-readable report to `.skill-compass/{name}/eval-report.md`
- **`--format all`**: both JSON and markdown report

## Skill Type Detection

Determine the target skill's type from its structure:

| Type | Indicators |
|------|-----------|
| atom | Single SKILL.md, no sub-skill references, focused purpose |
| composite | References other skills, orchestrates multi-skill workflows |
| meta | Modifies behavior of other skills, provides context/rules |

## Trigger Type Detection

From frontmatter, detect in priority order:
1. `commands:` field present -> **command** trigger
2. `hooks:` field present -> **hook** trigger
3. `globs:` field present -> **glob** trigger
4. Only `description:` -> **description** trigger

## Global UX Rules

### Locale

**All templates in SKILL.md and `commands/*.md` are written in English.** Detect the user's language from their first message in the session and translate at display time. Apply these rules:

- Technical terms never translate: PASS, CAUTION, FAIL, SKILL.md, skill names, file paths, command names, category keys (Code/Dev, Deploy/Ops, Data/API, Productivity, Other)
- **Canonical dimension labels** — all commands MUST use these exact English labels, then translate faithfully to the user's locale at display time:

  | Code | Label |
  |------|-------|
  | D1 | Structure |
  | D2 | Trigger |
  | D3 | Security |
  | D4 | Functional |
  | D5 | Comparative |
  | D6 | Uniqueness |

  In JSON output fields: a

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子,欢迎第一个提问或分享。

此处内容由用户撰写,不代表 PopNx 团队。

登录后发帖

来自 GitHub

GitHub 星标
214
开发者
Evol-ai
许可证
MIT
最近代码更新
2026年4月23日
repo 中的 SKILL.md 文件(含译本和模板)
1
主题
agent-skills, ai-agents, anthropic, claude-code, claude-code-skill, openclaw, openclaw-skill, skill-evaluation, skill-rating