用途：将可复用的智能体技能打包一次，使其可在不同机器、人员、仓库和执行框架（Codex、Claude Code、OpenCode）之间安装与共享，使用共享的本地技能存储。
主要能力：提供技能包仓库生成脚本、克隆/发布后的本地与 GitHub 校验、跨机器同步、以及无人值守的定时刷新。同步脚本会对清单中每个仓库重跑安装命令，再执行全局更新。
使用方式：新建技能包仓库时，先在 SkillPort 仓库运行 scripts/create-agent-skill-repo.sh，检查生成的占位符、插件清单、README、示例、schema 与安装脚本，再补充真实技能；把 GitHub 仓库简写加入 SkillPort 清单（通常是 config/skill-repos.local.yaml）。本地校验用 npx skills add /path/to/generated/repo --list；推送到 GitHub 后用 npx skills add https://github.com/OWNER/REPO --list 校验。日常跨机同步用 ./scripts/skillport-sync.sh。基准安装命令为 npx skills add <repo> --skill '*' -a codex claude-code opencode -g -y。
适用场景：个人或团队维护公开/私有技能仓库，需要跨设备、跨仓库统一分发与刷新。
限制：GitHub 模板仓库会复制整个仓库，不能直接模板化子目录；仅需 GitHub UI 或 gh repo create --template 流程时才建独立最小模板仓库。应只保留一份规范检出，避免每个框架放可编辑副本；全局指引生成由 AgentDesk 负责，SkillPort 只调用其生成器。自动推送失败关闭：私有仓库需验证可见性与凭证扫描，公开仓库需精确的已审 HEAD 批准与个人数据扫描，自动化不执行暂存或提交。首次迁移需比对并显式替换、备份原有内容。其他框架的全局路径与导入语法未必兼容。macOS 与 Windows 的定时刷新配置细节及部分路径约定详见原文文档。