技能罗盘
- 作者仓库星标 211
- 作者仓库 SkillCompass
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 92 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @Evol-ai · v1.0.0 · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# 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: always use `D1`-`D6` codes.
Do NOT invent alternative labels (e.g. "Structural clarity", "Trigger accuracy" are wrong — use the labels above). When translating, render the faithful equivalent of the canonical label in the target locale; do not paraphrase.
- JSON output fields (`schemas/eval-result.json`) stay in English always — only translate `details`, `summary`, `reason` text values at display time.
### Interaction Conventions
1. **Choices, not raw commands.** Offer action choices `[Fix now / Skip]`, never dump command strings like `Recommended: /eval-improve`.
2. **Dual-channel.** Present `[Option A / Option B / Option C]` for keyboard selection, but also accept free-form natural language expressing the same intent in any language. Both modes are always valid.
3. **Context before choice.** Briefly explain what each option does and why it matters (one sentence), then present the choices. Example: "Trigger is the weakest (5.5/10); fixing it will raise invocation accuracy." → `[Fix now / Skip]`.
4. **`--internal` flag.** When a command invokes another command internally, pass `--internal`. The callee skips all interactive prompts and returns results only. Prevents nested prompt loops.
5. **`--ci` guard.** `--ci` suppresses all interactive output. Stdout is pure JSON.
6. **Flow continuity.** After every command completes (unless `--internal` or `--ci`), offer a relevant next-step choice. Never leave the user at a blank prompt.
7. **Max 3 choices.** Show at most 3 options at once; pick the top 3 by relevance.
8. **Hooks are lightweight.** Hook scripts collect data and write files. stderr output is minimal — at most one short status line. Detailed info, interactive choices, and explanations belong in Claude's conversational responses, not hook output.
### First-Run Guidance
When setup completes for the first time (no previous `setup-state.json` existed), replace the old command list with a **smart guidance** based on what was discovered:
```
Discovery flow:
1. Show one-line summary: "{N} skills (Code/Dev: {n}, Productivity: {n}, ...)"
2. Run Quick Scan D1+D2+D3 on all skills
3. Show context budget one-liner: "Context usage: {X} KB / 80 KB ({pct}%)"
4. Smart guidance — show ONLY the first matching condition:
Condition Guidance
───────────────────────────────── ─────────────────────────────────────────────
Has high-risk skill (any D ≤ 4) Surface risky skills + offer [Evaluate & fix / Later]
Context > 60% "Context usage is high" + offer [See what can be cleaned → /skill-inbox all]
Skill count > 8 "Many skills installed" + offer [Browse → /skill-inbox all]
Skill count 3-8, all healthy "All set ✓ You'll be notified via /skill-inbox when suggestions arrive"
Skill count 1-2 "Ready to use" + offer [Check quality → /eval-skill {name}]
```
Do NOT show a list of all commands. Do NOT show the full skill inventory (that's `/skill-inbox all`'s job).
## Behavioral Constraints
1. **Never modify target SKILL.md frontmatter** for version tracking. All version metadata lives in the sidecar `.skill-compass/` directory.
2. **D3 security gate is absolute.** A single Critical finding forces FAIL verdict, no override.
3. **Always snapshot before modification.** Before eval-improve writes changes, snapshot the current version.
4. **Auto-rollback on regression.** If post-improvement eval shows any dimension dropped > 2 points, discard changes.
5. **Correction tracking is non-intrusive.** Record corrections in `.skill-compass/{name}/corrections.json`, never in the skill file.
6. **Tiered verification** based on change scope:
- L0: syntax check (always)
- L1: re-evaluate target dimension
- L2: full six-dimension re-evaluation
- L3: cross-skill impact check (for composite/meta)
## Security Notice
This includes read-only installed-skill discovery, optional local sidecar config reads, and local `.skill-compass/` state writes.
This is a **local evaluation and hardening tool**. Read-only evaluation commands are the default starting point. Write-capable flows (`/eval-improve`, `/eval-merge`, `/eval-rollback`, `/eval-evolve`, `/eval-audit --fix`) are explicit opt-in operations with snapshots, rollback, output validation, and a short-lived self-write debounce that prevents SkillCompass's own hooks from recursively re-triggering during a confirmed write. No network calls are made. See **[SECURITY.md](SECURITY.md)** for the full trust model and safeguards.
章节与文件索引
按说明文件中的顺序排列。
安装后入门
六大评估维度
评分
主要入口点
快捷别名(未积极推广;适用于了解它们的用户)
文件/命令 -> hooks/scripts/session-tracker.js · .skill-compass/cc/last-version · {baseDir}/commands/post-install-onboarding.md · {baseDir}/shared/scoring.md · commands/skill-compass.md · commands/skill-inbox.md · commands/skill-report.md · commands/skill-update.md
内容校验值 -> 9e172faffb1f
当前原文的自动摘译,尚未人工审校。
安装后入门
由 SessionStart 挂钩触发。
hooks/scripts/session-tracker.js将当前 SkillCompass 版本与.skill-compass/cc/last-version进行比较。如果它们不同(首次安装、重新安装或更新),挂钩会注入一条上下文消息,要求 Claude 在用户第一次交互时运行安装后入门。当您看到该消息时,请使用阅读工具加载{baseDir}/commands/post-install-onboarding.md并严格遵循它。不要等待斜线命令。六大评估维度
ID · 维度 · 权重 · 目的 D1 · 结构 · 10% · Frontmatter 有效性、降价格式、声明 D2 · 触发器 · 15% · 激活质量、拒绝准确性、可发现性 D3 · 安全性 · 20% · 门维度 - 秘密、注入、权限、渗透 D4 · 功能 · 30% · 核心质量、边缘情况、输出稳定性、错误处理
评分
通过:分数 >= 70 且 D3 通过 注意:50-69,或 D3 高结果 失败:分数 < 50,或 D3 严重(门覆盖) 完整评分规则:使用读取加载
{baseDir}/shared/scoring.md。主要入口点
命令·文件·目的/技能指南针·
commands/skill-compass.md·唯一主条目-智能响应:显示建议(如果有),否则显示摘要;接受自然语言快捷别名(未积极推广;适用于了解它们的用户)
命令·路由至·目的/所有技能·
commands/skill-inbox.md(arg:全部)·完整技能列表/技能报告·commands/skill-report.md·技能生态系统报告/技能更新·commands/skill-update.md·检查和更新技能/收件箱·commands/skill-inbox.md·建议视图(旧别名)