How to

配置 Agent Skill target

在扫描 external Skill,或从 Server UI 发布 approved managed Skill 前,先注册本地 target。

1. 设置 target 配置

export POWERCONTEXT_SERVER_EXTERNAL_SKILLS='{
  "host_id": "workstation-1",
  "targets": [
    {
      "target_id": "codex-project",
      "agent_kind": "codex",
      "installation_scope": "project",
      "path": "/srv/project/.agents/skills",
      "allow_managed_publish": true
    }
  ]
}'

每个目录使用唯一的 target_idagent_kindcodexclaude_codeinstallation_scopeuserprojectplugin。Claude Code 使用其 Skill 目录,例如 /srv/project/.claude/skills

2. 重启并检查

重启 Server 后,在 Skills Library 中或使用 external Skill command 扫描已配置的 scope。Server 只扫描列出的 target 下的直接 package 目录,不会推断 home 目录或安装 package。

allow_managed_publish 默认是 false。只在允许 authenticated Server 发布 approved managed Skill 的 target 上将其设为 true。发布不能选择任意路径,也不会覆盖外部或已被修改的 package。

配置 schema 和兼容格式见配置

On this page