register-self

name	Register Self
description	Register the agent as active with the Crewly backend on startup. Use when an agent first launches and needs to join the team and become visible to the orchestrator. For confirming responsiveness after registration, use heartbeat instead.
version	1.0.0
category	system
skillType	claude-skill
assignableRoles	["developer","qa","tpm","designer","frontend-developer","backend-developer","fullstack-dev","qa-engineer","product-manager","architect","generalist","sales","support"]
triggers	["register","check in","go online"]
tags	["system","registration","startup"]
execution	{"type":"script","script":{"file":"execute.sh","interpreter":"bash","timeoutMs":15000}}

Register Self

Register the agent as active with the Crewly backend. This must be the first skill run on agent startup to join the team and become visible to the orchestrator.

When to Use

Run this skill immediately after the agent process starts. Registration makes the agent visible in the team dashboard and enables it to receive tasks, messages, and heartbeat checks. Without registration, the orchestrator cannot assign work to the agent.

Parameters

Parameter	Required	Description
sessionName / --session	Yes	Agent session name (e.g., dev-1)
role / --role	Yes	Agent role: developer, qa, tpm, designer, product-manager, etc.
teamMemberId / --team-member	No	Team member UUID for identity linking
claudeSessionId / --claude-session	No	Claude session ID for resume support

Examples

Register using CLI flags (preferred)

bash config/skills/agent/core/register-self/execute.sh --session dev-1 --role developer

Register with all options

bash config/skills/agent/core/register-self/execute.sh --session dev-1 --role qa --team-member tm-abc123 --claude-session cs-xyz789

Register using legacy JSON argument

bash config/skills/agent/core/register-self/execute.sh '{"sessionName":"dev-1","role":"developer"}'

Register via stdin pipe

echo '{"sessionName":"dev-1","role":"developer"}' | bash config/skills/agent/core/register-self/execute.sh

Output

JSON confirmation from POST /api/teams/members/register containing the registered agent's details including session name, assigned role, and team membership status.

Error Handling