Name: opencorvus-matrix-channel-config
Author: yangheng95

Imported from yangheng95/opencorvus-archive (packages/opencorvus/src.bak/skill/builtin/channel/opencorvus-matrix-channel-config/SKILL.md). Install upstream with npx skills add yangheng95/opencorvus-archive --skill opencorvus-matrix-channel-config. Copyright stays with the author.

OpenCorvus Matrix Channel Config

Overview

Guide the user through the official Matrix client-auth flow, stop for every provider-side action, and apply values to OpenCorvus only after the user pastes them.

Workflow

Confirm mode.

Default to overlay-guided setup in Channel Config.
Offer text-guided fallback that writes to packages/channel-runtime/.env.
Process one credential or sync setting at a time and wait for explicit confirmation after each manual step.

Load references.

Read packages/opencorvus/src/skill/builtin/channel/opencorvus-channel-config-wizard/references/channel-matrix.md.
Use only the Matrix section and the official Matrix URLs listed there.

Guide provider-side setup.

Ask the user for the homeserver URL first.
Ask the user to obtain an access_token from the official Matrix login flow or an admin-issued token.
Ask for MATRIX_SINCE_TOKEN only if they want to resume from an existing sync checkpoint.
Ask the user to add the bot account to the target room before validation.

Apply OpenCorvus config.

When the user pastes a value, write it immediately instead of asking them to edit files themselves.
Overlay mode: set MATRIX_HOMESERVER_URL, MATRIX_ACCESS_TOKEN, and optional MATRIX_SINCE_TOKEN, then click Save Config.
Text fallback: update packages/channel-runtime/.env and keep unrelated keys unchanged.
Redact secrets in summaries and confirmations.

Verify runtime.

Confirm packages/channel-runtime/src/main.ts registers MatrixAdapter.
Confirm packages/channel-runtime/src/adapters/matrix.ts matches the supplied homeserver flow.
Run bun run --cwd packages/channel-runtime --no-env-file --env-file .env src/main.ts.
Send one inbound Matrix message and confirm one reply.

Troubleshoot.

If login or sync fails, re-check the homeserver URL and token audience.
If replies fail, re-check room membership and access-token scope.
If event replay looks wrong, re-check MATRIX_SINCE_TOKEN.

Guardrails

Do not claim full automation for Matrix account creation or homeserver admin operations.
Do not output real secrets.
Keep edits focused on overlay env values or packages/channel-runtime/.env unless the user asks for code changes.
Do not claim parity features that the adapter does not implement.

Output Format

Mode and current provider step.
Required official page and exact manual action.
Values received and env keys updated.
Verification result.
Next blocker or completion status.

Install opencorvus-matrix-channel-config and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "yangheng95-opencorvus-archive-opencorvus-matrix-channel-config", "kind": "skill", "name": "opencorvus-matrix-channel-config", "description": "Guide official Matrix client setup for OpenCorvus, collect Matrix credentials from the user, and write them into OpenCorvus after the user provides them. Use when tasks involve Matrix access-token retrieval, homeserver setup, env wiring, or Matrix runtime verification.", "publisher": "yangheng95", "version": "1.0.0", "capabilities": { "domains": [ "math" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Guide official Matrix client setup for OpenCorvus, collect Matrix credentials from the user, and write them into OpenCorvus after the user provides them. Use when tasks involve Matrix access-token retrieval, homeserver setup, env wiring, or Matrix runtime verification." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/yangheng95/opencorvus-archive", "path": "packages/opencorvus/src.bak/skill/builtin/channel/opencorvus-matrix-channel-config/SKILL.md", "ref": "babef4a99224cf29de7e9d02b82a97543632a378", "url": "https://github.com/yangheng95/opencorvus-archive/blob/babef4a99224cf29de7e9d02b82a97543632a378/packages/opencorvus/src.bak/skill/builtin/channel/opencorvus-matrix-channel-config/SKILL.md", "key": "yangheng95/opencorvus-archive/packages/opencorvus/src.bak/skill/builtin/channel/opencorvus-matrix-channel-config/SKILL.md" } }, "instructions": "# OpenCorvus Matrix Channel Config\n\n## Overview\n\nGuide the user through the official Matrix client-auth flow, stop for every provider-side action, and apply values to OpenCorvus only after the user pastes them.\n\n## Workflow\n\n1. Confirm mode.\n\n- Default to overlay-guided setup in `Channel Config`.\n- Offer text-guided fallback that writes to `packages/channel-runtime/.env`.\n- Process one credential or sync setting at a time and wait for explicit confirmation after each manual step.\n\n2. Load references.\n\n- Read `packages/opencorvus/src/skill/builtin/channel/opencorvus-channel-config-wizard/refere", "cost": { "context_tokens": 636 } }

opencorvus-matrix-channel-config

About