Skill compass

Skill Compass

Skill Compass is a local-first personal Skill launchpad for macOS. It helps users find a Skill by describing a task, browse public Skills, and keep private notes about the Skills they use.

Recommended entry point

Open the local interface:

http://127.0.0.1:48765

When the user invokes skill-compass, prefer this interface instead of printing a long list. The service dynamically scans local Skill directories and refreshes when Skill or metadata files change.

Terminal commands

Run:

skill-compass

Filter by keyword:

skill-compass project
skill-compass mcp

Include additional local Skill roots:

skill-compass --all

Print only the local URL:

skill-compass --url

The legacy skill-help command remains available as a compatibility alias.

Privacy and safety

• Local scanning and personal notes work offline.
• Browser notes stay in local browser storage.
• Public discovery requires network access.
• Standard installs are previewed and statically audited before execution.
• Complex tool suites fall back to a manual guide and are never auto-executed.

中文说明

Skill Compass 是 macOS 本地优先的个人能力启动台。忘记 Skill 名称时，可以直接描述任务； 也可以浏览公共商店、查看安全预检，并记录收藏、备注和使用次数。

默认约定：

• 个人 Skill 默认扫描 ~/.agents/skills 和 ~/.codex/skills。
• 命令默认扫描 ~/.local/bin，并识别指向 Skill 脚本目录的包装命令。
• HTML 服务由 dev.skillcompass.server LaunchAgent 常驻。
• 内置中文元数据位于安装目录，个人覆盖位于 ~/.config/skill-compass/summaries.local.zh.json。
• 旧 skill-help 命令与 SKILL_HELP_* 环境变量继续兼容。