agent-branch-handoff
Guides the PR process for sub-agents, ensuring clear handover between developers and project leads.
Install
mkdir -p .claude/skills/agent-branch-handoff && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13806" && unzip -o skill.zip -d .claude/skills/agent-branch-handoff && rm skill.zipInstalls to .claude/skills/agent-branch-handoff
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
StudySolo 子 Agent 并行开发与交接技能。用于指导“仅提交 Agent 相关代码 + README 对接说明 + 审核 Merge 后由负责人补主后端与更新日志”的标准流程。Key capabilities
- →Determine the branch status and create/switch to `feat/subagent-*`
- →Control commit scope to `agents/<agent-name>/` only
- →Enforce mandatory README documentation for main backend integration
- →Clarify PR responsibilities for developers and review leaders
- →Prevent committing to incorrect branches
- →Ensure `docs/Updates` is updated by the review leader
How it works
The skill first assesses the branch status, then enforces strict rules for commit scope, mandatory README documentation for main backend integration, and clear PR responsibilities before merging.
Inputs & outputs
When to use agent-branch-handoff
- →Submitting agent code
- →Managing agent branch handoffs
- →Updating agent registration
About this skill
Agent Branch Handoff Skill
激活后第一句话（必须）
激活本技能后，第一句话必须包含：
使用 Agent 分支交接 SOP 处理本次提交
必读文档（按顺序）
docs/项目规范与框架流程/功能流程/团队协作/Agent分支提交SOP.mddocs/项目规范与框架流程/项目规范/10-Git与协作规范.mddocs/项目规范与框架流程/项目规范/10-Git与协作规范.mddocs/项目规范与框架流程/项目规范/02-模块边界规范.mddocs/issues/TeamRefactor/contracts/agent-gateway-contract.md
核心执行规则
- 先判断分支状态：
- 若目标分支不存在：从
main创建feat/subagent-* - 若分支已存在：先切换并同步，不重复创建
- 若目标分支不存在：从
- 严控提交范围：
- 默认只
git add agents/<agent-name>/ - 不允许默认
git add .
- 默认只
- 强制 README 交接：
- 必须写清主后端对接方式（含
agents.yaml建议片段） - 明确本 PR 是否改主后端注册表
- 必须写清主后端对接方式（含
- PR 接力边界必须写清：
- 开发者负责 Agent 代码 + README
- 审核负责人负责 PR 分析、Merge 后补主后端、更新
docs/Updates
输出模板（建议）
当用户问“这次怎么提 Agent PR”时，输出应包含以下 4 段：
- 当前分支状态与创建/切换建议
git add精确范围- README 必填字段清单
- Merge 后负责人收尾事项（主后端 +
docs/Updates）
严禁行为
- 在错误分支直接提交
- 未检查暂存区文件就 commit
- README 无主后端对接信息
- 将主后端接入责任写成“无人负责”
- 漏掉
docs/Updates更新
When not to use it
- →When the submission is not related to sub-agent code
- →When the workflow does not follow the "only commit agent-related code" standard
- →When the user does not want to follow the specified PR handoff process
Limitations
- →The skill is for StudySolo sub-agent parallel development and handoff.
- →It guides the standard process of "only committing agent-related code + README documentation + review and merge by the responsible person, who then supplements the main backend and update logs."
- →It requires clear README documentation for main backend integration.
How it compares
This skill enforces a specific, structured workflow for sub-agent branch handoffs, including strict commit boundaries and clear documentation requirements, which is more controlled than a general Git workflow.
Compared to similar skills
agent-branch-handoff side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| agent-branch-handoff (this skill) | 0 | 4mo | No flags | Intermediate |
| resolve-conflicts | 81 | 8mo | Review | Intermediate |
| openspec-onboard | 10 | 6mo | Review | Beginner |
| codex-cli-bridge | 9 | 9mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
resolve-conflicts
antinomyhq
Use this skill immediately when the user mentions merge conflicts that need to be resolved. Do not attempt to resolve conflicts directly - invoke this skill first. This skill specializes in providing a structured framework for merging imports, tests, lock files (regeneration), configuration files, and handling deleted-but-modified files with backup and analysis.
openspec-onboard
studyzy
Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
codex-cli-bridge
alirezarezvani
Bridge between Claude Code and OpenAI Codex CLI - generates AGENTS.md from CLAUDE.md, provides Codex CLI execution helpers, and enables seamless interoperability between both tools
skill-sync
KyleKing
Syncs Claude Skills with other AI coding tools like Cursor, Copilot, and Codeium by creating cross-references and shared knowledge bases. Invoke when user wants to leverage skills across multiple tools or create unified AI context.
github-workflow-automation
ruvnet
Advanced GitHub Actions workflow automation with AI swarm coordination, intelligent CI/CD pipelines, and comprehensive repository management
git-advanced-workflows
wshobson
Master advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog to maintain clean history and recover from any situation. Use when managing complex Git histories, collaborating on feature branches, or troubleshooting repository issues.