Openwisdom skill 会写到哪个目录，取决于你使用的编码 Agent。下表是 CLI / 安装工具采用的常见（typical）路径——若 Agent 版本不同或技能未出现，请以该 Agent 的官方文档为准。
本页说明
- Openwisdom 把 skill 目录安装到各 Agent 约定的 skills 根路径。分析始终在你的 Agent 与模型额度中运行，本站不提供托管分析会话。
- CLI 与 MCP 按 provider 路径表写入（如 claude、cursor、codex、agents）。手动拷贝时，请使用同一套常见根目录。
- 路径会随 Agent 版本变化。请将矩阵视为默认参考；不确定时走安装中枢的手动步骤，或用 CLI/MCP 做 provider 检测。
常见项目路径
每行对应工具识别的 provider id。项目路径相对仓库根目录；全局路径在用户主目录下。skill 再下一层：例如 .claude/skills/macro-scan/SKILL.md。
| Provider | 常见项目路径 | 说明 |
|---|---|---|
| Claude Code (claude) | .claude/skills | 全局：~/.claude/skills。别名 claude-code。若版本不同，请核对 Claude Code 文档。 |
| Cursor (cursor) | .cursor/skills | 全局：~/.cursor/skills。部分环境也会读 portable 的 .agents/skills——需要时可选用 agents。 |
| Portable agents (agents) | .agents/skills | 跨 harness 的可移植根（别名 portable）。全局：~/.agents/skills。多工具共用 agents 风格 skills 时很有用。 |
| Codex (codex) | .agents/skills | 项目路径与 agents 共用（安装会去重）。全局常见：~/.codex/skills。请以当前 Codex 文档为准。 |
| GitHub Copilot (github) | .github/skills | 别名 copilot。全局常见：~/.copilot/skills。产品/版本差异较大——检测失败时请手动安装。 |
| Gemini CLI (gemini) | .gemini/skills | 全局：~/.gemini/skills。别名 gemini-cli。 |
| 其他 / 未知 harness | 因版本而异—请手动安装 | 无保证路径。将 skill 文件夹拷到 Agent 文档标明的目录，或到 GitHub Issues 说明 Agent 名称与版本。 |
项目 scope 与全局 scope
- 安装 scope 决定 skill 写入哪一层根目录。希望 skill 随仓库走时选项目；希望本机所有工作区可用（且该 harness 支持）时选全局。
项目 scope
写入当前工作目录（仓库根）下，例如 project-root/.claude/skills/skill-id。适合团队共享或仓库本地流程。仅在团队明确要共享时再提交这些文件。
全局 scope
写入用户主目录，例如 ~/.claude/skills/skill-id，或 provider 特定全局根如 ~/.codex/skills。并非所有 harness 的项目路径与全局路径一致——Codex、Copilot 的全局目录与项目路径不同。
排障
- Agent 里看不到刚装的 skill
- 确认目录落在该 harness 的 skills 根下（见上表）、存在 SKILL.md、slug 与目录 id 一致，然后重载或重启 Agent。路径可能因版本而异——核对官方文档，或用显式 --providers 重新安装。
- 如何知道本机有哪些 provider？
- CLI 交互安装可检测常见 harness 标记；MCP 提供只读的 openwisdom_detect_providers 工具。也可检查项目中是否有 .claude、.cursor、.agents 等目录，或按矩阵手动拷贝。
- 同时选 Codex 与 agents 会写两份吗？
- 项目安装两者都落在 .agents/skills；Openwisdom 会对相同写入目标去重，只写一份。Codex 全局仍使用 ~/.codex/skills。
- 我的 Agent 不在表里
- 请手动安装：把 skill 目录拷到该 Agent 文档要求的路径。不要臆造路径。安装中枢始终提供手动步骤。
- 安装后 Openwisdom 会替我跑分析吗？
- 不会。安装只放置 skill 包。你在自己的 Agent 里调用 skill；本站没有托管分析会话。