add-matrix

Copy and wire the Matrix adapter from the channels branch into the trunk.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/CjLogic/nanocrew --skill add-matrix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-matrix
Source: https://github.com/CjLogic/nanocrew/tree/main/.codex/skills/add-matrix
Command: npx skills add https://github.com/CjLogic/nanocrew --skill add-matrix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Matrix channel integration often requires duplicating adapters and aligning imports across branches. This skill copies the Matrix adapter from the channels branch into trunk and wires it up so Matrix can be used as a channel.

Core Features & Use Cases

  • Copy the Matrix adapter from the channels branch into the trunk to enable Matrix-based channels.
  • Patch the adapter’s ES module imports to be compatible with Node 22 and the project’s build process.
  • Use-case: add a dedicated Matrix bot channel for teams to chat with NanoCrew agents in Matrix rooms or DMs.

Quick Start

Run the provided steps to fetch the channels branch, copy the adapter, patch imports, install the adapter, and build the project.

Frequently Asked Questions about add-matrix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a Matrix channel adapter to my project?

To add a Matrix channel adapter, you copy the adapter from the channels branch into the trunk, patch its ES module imports for Node 22 compatibility, install it, and build the project to enable Matrix room communications.

How does Matrix chat integration work with a single adapter?

Matrix chat integration works by wiring a single copied adapter from the channels branch into the trunk, patching imports for ESM compatibility, provisioning bot credentials, and verifying the build to enable direct messages and room chats.

Why does the Matrix adapter require import patching for ESM compatibility?

Import patching for ESM compatibility is required to align the copied Matrix adapter with Node 22 and the project's build process, ensuring the ES module imports function correctly during runtime integration.

Can I use the Matrix adapter to set up a dedicated bot channel for direct messages?

Yes, you can use the Matrix adapter to set up a dedicated bot channel, allowing teams to chat with agents across Matrix rooms and direct messages after completing the environment setup and credentials provisioning.

What's the best way to wire the Matrix adapter from the channels branch into the trunk?

The best way to wire the Matrix adapter is to fetch the channels branch, copy the adapter into the trunk, patch its imports, install dependencies, execute the build, and run verification steps for a functioning channel.

What environment setup is needed to provision credentials for a Matrix bot?

Environment setup for provisioning Matrix bot credentials involves configuring the runtime environment, installing the copied adapter, and verifying the build to ensure secure communications across rooms and direct messages.