amcos-onboarding

name	amcos-onboarding
description	Use when onboarding new agents to the team, providing role briefings, conducting project handoffs, and ensuring agents are ready to contribute effectively. Trigger with new agent or new project setup. Loaded by ai-maestro-chief-of-staff-main-agent
user-invocable	false
license	Apache-2.0
compatibility	Requires AI Maestro messaging API access, project documentation access, and role definition documents. Requires AI Maestro installed.
metadata	{"author":"Emasoft","version":"1.0.0"}
context	fork
agent	ai-maestro-chief-of-staff-main-agent

AI Maestro Chief of Staff Onboarding Skill

Overview

Agent onboarding integrates new AI agents into a coordinated team. The Chief of Staff ensures each new agent understands their role, project context, key procedures, and communication channels.

Prerequisites

1. Agent to be onboarded is created and running
2. Project documentation is available
3. Team registry is accessible

Instructions

1. Identify what needs onboarding (agent or project)
2. Gather required context and documentation
3. Send onboarding materials to target
4. Verify understanding and readiness

Checklist

Copy this checklist and track your progress:

• Agent session is active and responsive
• Role briefing delivered with responsibilities and reporting chain
• Project context and conventions shared
• Agent confirmed understanding of assigned tasks

Output

Onboarding Type	Output
New agent	Agent understands role and context
New project	Project registered, team assigned
Role change	Agent updated with new responsibilities

Core Procedures

PROCEDURE 1: Execute Onboarding Checklist

When/Steps: Initiate session, verify identity, work through checklist items, confirm completion, document.

PROCEDURE 2: Deliver Role Briefing

When/Steps: Retrieve role definition, explain responsibilities, clarify reporting, set expectations, confirm understanding.

PROCEDURE 3: Conduct Project Handoff

When/Steps: Provide project overview, share current state, explain conventions, transfer knowledge, verify comprehension.

Validate Handoff Document

Validate handoff documents before sending using the validation checklist and scripts.

Examples

Input: "Onboard new agent libs-svg-renderer for SVG rendering tasks on project svg-player"

Output:

Onboarding libs-svg-renderer:
1. Role briefing sent: SVG renderer, reports to apps-svgplayer-development
2. Project handoff: svg-player repo, conventions, current sprint context
3. Agent confirmed ready. Registry updated.
[DONE] libs-svg-renderer onboarded successfully.

See onboarding-overview-and-examples in Resources for examples and handoff validation.

Error Handling

Issue	Resolution
Agent does not respond	Verify session active, retry with higher priority, escalate if persistent
Agent confused by briefing	Provide specific examples, break down responsibilities, have agent repeat back
Handoff incomplete	Review checklist, identify gaps, send supplementary information

Resources

• onboarding-overview-and-examples — Full onboarding guide with examples and checklists
  • What Is Agent Onboarding
  • Onboarding Components
  • Examples: Initiating Onboarding for New Developer
  • Examples: Role Briefing Message
  • Examples: Project Handoff Summary
  • Handoff Validation Checklist
  • Handoff Required Fields
  • Key Takeaways
  • Task Checklist