coralize-your-agent

Coralize Your Agent

This skill walks the user through connecting their existing AI agent project to the Coral Protocol, so it can participate in multi-agent sessions alongside other Coral-connected agents.

Currently supported frameworks:

• Mastra (TypeScript)

More frameworks will be added over time.

Step 0: Check if coral-server is installed

First, verify that coral-server exists:

test -f ~/.coral/coral-server/gradlew && echo "CORAL_SERVER_OK" || echo "CORAL_SERVER_NOT_FOUND"

• If "CORAL_SERVER_OK" -> proceed to Step 1.
• If "CORAL_SERVER_NOT_FOUND" -> tell the user that coral-server must be installed first, then read and follow the sibling skill coral-setup/SKILL.md to set it up. After coral-server setup completes, come back here and continue from Step 1.

Step 1: Ask for the agent project path

Ask the user:

What's the path to your agent project?

Wait for their response. The path should be an absolute path to a directory containing an agent project.

Step 2: Detect the agent framework

Go to the provided path and identify the framework by checking for signature files:

AGENT_PATH="<user-provided-path>"
echo "=== CHECKING FRAMEWORK ===" && \
(test -f "$AGENT_PATH/package.json" && grep -l "@mastra" "$AGENT_PATH/package.json" && echo "FRAMEWORK: mastra") || \
echo "FRAMEWORK: unknown"

Detection rules:

• Mastra: package.json exists and contains @mastra dependencies
• Unknown: If none of the above match, tell the user their framework isn't supported yet and list what is supported

If the framework is detected, confirm with the user:

I detected this is a Mastra agent project. I'll set it up for Coral integration. Proceed?

Wait for confirmation before continuing.

Step 3: Apply framework-specific integration

Based on the detected framework, read the corresponding reference guide and follow its instructions:

• Mastra: Read ${SKILL_DIR}/references/mastra.md and follow the steps there.

Step 4: Register in coral-server config

Read ~/.coral/coral-server/src/main/resources/config.toml and add the agent's absolute path to the local_agents list under [registry].

Use the Edit tool to update only the local_agents line. Do not modify any other part of config.toml. Make sure not to add duplicates - check if the path is already in the list first.

Step 5: Verify and report

Tell the user:

• What files were created and what they do
• That the agent is now registered with coral-server
• To start (or restart) coral-server with: cd ~/.coral/coral-server && ./gradlew run
• The agent will be auto-launched by coral-server when a session requests it
• They can still run their agent standalone (e.g., npm run dev for Mastra) without coral - the coral integration is additive and doesn't break local development

Step 6: Offer to try multi-agent orchestration

After reporting the setup results, ask the user:

Would you like to try running these agents through Coral server? I can help you orchestrate a multi-agent session.

If the user says yes, read the sibling skill at ${SKILL_DIR}/../coral-agent-swarm/SKILL.md and follow its instructions to set up and run a multi-agent session.