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

Error	Cause	Solution
Missing required parameter: sessionName (--session)	Session name not provided	Pass --session <name> or include sessionName in JSON
Missing required parameter: role (--role)	Role not provided	Pass --role <role> or include role in JSON
Unknown argument: <arg>	Unrecognized CLI flag	Check spelling; run with --help for usage
curl failed with exit code N	Backend not running	Start the Crewly backend

Related Skills

• heartbeat — confirm the agent is still responsive after registration
• get-my-context — retrieve the agent's current role and team context
• accept-task — pick up the first available task after registering