Skill compass

Local-first personal launchpad and public store for Agent Skills on macOS

Install

npx -y skills add yinyoudexing/skill-compass

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

13 days oldThe repository was created 13 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when a user wants to find, understand, browse, install, update, or remember Agent Skills without memorizing their names

SKILL.md

1.9 KB, as published. Nobody here has run it

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_* 环境变量继续兼容。