Imported from yangheng95/opencorvus-archive (
packages/opencorvus/src.bak/skill/builtin/channel/opencorvus-matrix-channel-config/SKILL.md). Install upstream withnpx 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
Matrixsection 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_tokenfrom the official Matrix login flow or an admin-issued token. - Ask for
MATRIX_SINCE_TOKENonly 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 optionalMATRIX_SINCE_TOKEN, then clickSave Config. - Text fallback: update
packages/channel-runtime/.envand keep unrelated keys unchanged. - Redact secrets in summaries and confirmations.
- Verify runtime.
- Confirm
packages/channel-runtime/src/main.tsregistersMatrixAdapter. - Confirm
packages/channel-runtime/src/adapters/matrix.tsmatches 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/.envunless 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.
