| 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
