← 返回 Skills 市场
grantgochnauer

Capacities Lookup

作者 Grant Gochnauer · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
192
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install capacities-lookup
功能描述
Search Capacities for likely object matches and return direct capacities:// links. Use when the user wants to find, open, or locate a Capacities note, meetin...
使用说明 (SKILL.md)

Capacities Lookup

Use this skill for real-time Capacities object lookup, not full-content retrieval.

What this skill does

  • searches Capacities live via the public API
  • enriches results with object types from cached /space-info metadata
  • builds direct capacities:// deep links
  • supports type-aware ranking for phrases like:
    • find my notes on X
    • meeting with Y
    • people at Z
  • may suggest Capacities proactively when a request sounds like a note/project/meeting/person lookup

What this skill does NOT do

  • read full Capacities object bodies
  • traverse properties/relations on objects
  • answer org-membership or linked-object questions unless the title lookup itself returns the target object
  • mirror Capacities locally beyond light metadata cache

Prerequisites

  • CAPACITIES_API_TOKEN must be available in the shell environment
  • one of these must define the target space id:
    1. CAPACITIES_SPACE_ID env var
    2. config/capacities.json with mainSpaceId

If the user says the token is in ~/.zshrc, source it in the same shell command before running the scripts.

Files

Skill scripts live in scripts/.

Key commands:

python3 skills/capacities-lookup/scripts/capacities_cli.py sync-structures
python3 skills/capacities-lookup/scripts/capacities_cli.py verify-space
python3 skills/capacities-lookup/scripts/capacities_cli.py lookup "recovery"
python3 skills/capacities-lookup/scripts/capacities_cli.py lookup "Find my notes on recovery" --json

Recommended workflow

1) Make sure structure metadata exists

If this is the first use or results seem type-blind, run:

source ~/.zshrc >/dev/null 2>&1 || true
python3 skills/capacities-lookup/scripts/capacities_cli.py sync-structures

2) Run lookup

Use natural language when helpful.

Examples:

source ~/.zshrc >/dev/null 2>&1 || true
python3 skills/capacities-lookup/scripts/capacities_cli.py lookup "Find my notes on recovery" --json

source ~/.zshrc >/dev/null 2>&1 || true
python3 skills/capacities-lookup/scripts/capacities_cli.py lookup "people associated with an organization" --json

3) Interpret results correctly

Prefer in chat:

  • title
  • type
  • match quality
  • matched-on term when useful
  • clickable markdown deep link

Usually omit raw object ids unless debugging.

Response rules

If a strong match exists

Return the best match directly with a clickable link.

If multiple good matches exist

Return 2–5 candidates.

If the requested object type is not found

Say so clearly. Example:

  • “I didn’t find any Person objects matching that organization, but here are the most relevant fallback Capacities objects.”

If the user asks for relationships/properties/body content

Be explicit about the current API limitation. Example:

  • “I can find the Capacities object and link you to it, but I can’t currently inspect its properties or full body through the public API.”

Operational notes

  • This skill intentionally uses live lookup + light cache, not full sync.
  • Structures metadata is cached under workspace data/capacities/.
  • Lookup cache is convenience-only; live lookup remains authoritative.
  • Type-aware behavior depends on cached structures metadata, so run a structure sync before relying on custom object types.
安全使用建议
This skill appears to do what it claims: it needs python3 and your Capacities API token and then performs live lookups against the Capacities API, caching lightweight metadata under data/capacities. Before installing or running: (1) verify the CAPACITIES_API_TOKEN is legitimate and only grant it to this tool; (2) inspect config/capacities.json if present (it can set apiBaseUrl and mainSpaceId); (3) avoid blindly running the recommended `source ~/.zshrc` unless you have reviewed that file (sourcing runs shell code, not just setting env vars); (4) note the scripts will write cache/state files under the detected workspace—ensure that location is acceptable. If you want to reduce risk, run the CLI commands manually in a controlled shell rather than granting automatic invocation.
功能分析
Type: OpenClaw Skill Name: capacities-lookup Version: 1.0.0 The capacities-lookup skill is a legitimate tool for searching the Capacities note-taking platform via its public API. The code uses standard Python libraries (urllib) to communicate exclusively with api.capacities.io and implements local caching of metadata in a dedicated data directory. While SKILL.md suggests sourcing shell configuration files (e.g., ~/.zshrc) to retrieve API tokens, this is a common pattern for local agent tools and no evidence of malicious exfiltration, obfuscation, or unauthorized execution was found across the scripts (capacities_client.py, capacities_lookup.py).
能力评估
✓ Purpose & Capability
Name/description match what the code does: the scripts perform live lookups against a Capacities API, build capacities:// deep links, and cache lightweight structure metadata. Declared requirements (python3 and CAPACITIES_API_TOKEN) are appropriate for this purpose.
ℹ Instruction Scope
SKILL.md and the CLI instruct the agent/user to source a shell rc file (e.g., source ~/.zshrc) to populate CAPACITIES_API_TOKEN if needed. The scripts themselves only call the Capacities API, read config/capacities.json if present, and write small caches under workspace data/capacities. Sourcing a user shell file can execute arbitrary shell code (not just expose env vars) so follow-up caution is advised before blindly running the provided source commands.
✓ Install Mechanism
There is no external install pipeline or remote download; the skill is distributed as included Python scripts. No URLs/payload downloads or extract steps are used. The scripts will create and write files under the detected workspace data/ directory.
ℹ Credentials
Only CAPACITIES_API_TOKEN is required (primary credential). Optionally, CAPACITIES_SPACE_ID or config/capacities.json provides the space id. This is proportional to the stated functionality. Caveat: SKILL.md suggests sourcing ~/.zshrc to load the token which may expose other environment variables or execute rc file logic—review that file before sourcing.
✓ Persistence & Privilege
The skill does not request always:true and will not force-enable itself. It writes caches under the workspace (data/capacities/) and reads/writes its own config/cache/state files only; it does not modify other skills or global agent configuration.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install capacities-lookup
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /capacities-lookup 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial public release
元数据
Slug capacities-lookup
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Capacities Lookup 是什么？

Search Capacities for likely object matches and return direct capacities:// links. Use when the user wants to find, open, or locate a Capacities note, meetin... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 192 次。

如何安装 Capacities Lookup？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install capacities-lookup」即可一键安装，无需额外配置。

Capacities Lookup 是免费的吗？

是的，Capacities Lookup 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Capacities Lookup 支持哪些平台？

Capacities Lookup 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Capacities Lookup？

由 Grant Gochnauer（@grantgochnauer）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论