该技能面向以产出个人、跨项目使用的 MCP 服务器或 Agent Skill 为目的的仓库（如 *-polite-mcp 系列、product-research-pipeline），说明如何让仓库可被 Claude Code 在任意项目中加载。
开发循环：仓库将 repo-tasks 作为开发依赖（uv add --dev git+https://github.com/TheodoreAD/repo-tasks），tasks.py 仅 from repo_tasks import ns；克隆后运行 inv dev-env.setup 同步 .venv，提交前运行 inv quality.precommit 执行自动修复与完整门禁，测试使用已提交的夹具，不访问实时网络。invoke 属项目级 venv 依赖，CI 等场景需用 uv run inv <task>。
安装与注册：在 pyproject.toml 的 [project.scripts] 声明入口，再用 uv tool 安装。开发时用 uv tool install -e ~/projects/github.com-personal/olx-polite-mcp；稳定后从 GitHub 安装 uv tool install git+https://github.com/TheodoreAD/olx-polite-mcp；注册统一为 claude mcp add --scope user olx-polite-mcp olx-polite-mcp。切换来源只需重新 uv tool install，无需移除重加。可编辑安装不能与 Git 来源合并。
分发：个人非商业规模下不发布 PyPI，Git 仓库即制品库，可用 @tag/@sha 固定版本。技能通过 skills CLI 分发，放在 skills/<name>/SKILL.md 即可：npx skills add TheodoreAD/<repo> --global 或 --skill <name>。
注意事项：CLI 有时不会创建 Claude Code 符号链接，需自行确认；安装是复制而非链接，源未推送的改动不可见。技能应职责单一、触发条件不冲突，描述按用户实际请求措辞撰写；约定型技能在遇到摩擦时应询问并把结论增量写回源文件后重新安装，不要直接改已安装副本；技能自身的后续检查应作为可执行步骤内嵌，而非交给用户手工完成。