Agent skill

Debugging Marchat

by Cod-e-Codes in Cod-e-Codes/marchat

Diagnoses marchat client and server issues using -doctor, env configuration, and logs.

MITAuto-check: notesDevelopment

Install Debugging Marchat

skills CLI
$ npx skills add Cod-e-Codes/marchat --skill debugging-marchat -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Cod-e-Codes/marchat debugging-marchat --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Cod-e-Codes/marchat.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/debugging-marchat .claude/skills/debugging-marchat && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
debugging-marchat
GitHub stars
137
Token cost
~668 tokens
SKILL.md length
253 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Diagnoses marchat client and server issues using -doctor, env configuration, and logs.

  • Works in 4 steps: Reproduce with minimal steps. → Run -doctor on client and server. → Read relevant test file for expected… → …
  • Debugging connection failures
  • SKILL.md covers Doctor (first step), Common issues, WebSocket and Logging, plus 1 more section
  • Calls go; needs MARCHAT_GLOBAL_E2E_KEY

What it does

Debugging Marchat is an agent skill from Cod-e-Codes/marchat. Diagnoses marchat client and server issues using -doctor, env configuration, and logs. Use when debugging connection failures, E2E decryption, database DSN, handshake errors, or when the user mentions doctor, diagnostics, or MARCHAT environment variables.

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Debugging, End-to-end testing and Secrets management. It works with MySQL and SQLite. The repository describes itself as: Terminal chat for developers: Go WebSocket server + Bubble Tea TUI client, optional E2E, reactions, DMs, channels, plugins, files, code snippets, admin UI. Backends: SQLite… The licence is MIT.

When your agent uses it

  • Debugging connection failures
  • Handshake errors
  • The user mentions doctor
  • MARCHAT environment variables

Example prompts

  • “Use the debugging-marchat skill to diagnose marchat client and server issues using -doctor, env configuration, and logs”
  • “/debugging-marchat”

Requirements

  • Docker
  • A credential in MARCHAT_GLOBAL_E2E_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Reproduce with minimal steps.
  2. Run -doctor on client and server.
  3. Read relevant test file for expected behavior before changing production code.
  4. Fix root cause; add a regression test (testing-marchat).

What it can do on your machine

Read from SKILL.md and the folder at commit 3440f09. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • go

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • MARCHAT_GLOBAL_E2E_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Debugging Marchat loads about 668 tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 253 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~668

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:20
    r doctor lists `MARCHAT_*` after `config/.env` load (`godotenv.Overload`: file wins on same key).

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Cod-e-Codes/marchat at commit 3440f09, republished under its MIT licence (© Cod-e-Codes). 253 words, ~668 tokens.

Download SKILL.mdSave it as .claude/skills/debugging-marchat/SKILL.md (or your agent's skills folder).
name
debugging-marchat
description
Diagnoses marchat client and server issues using -doctor, env configuration, and logs. Use when debugging connection failures, E2E decryption, database DSN, handshake errors, or when the user mentions doctor, diagnostics, or MARCHAT_ environment variables.

Debugging marchat

Doctor (first step)

BinaryCommand
Clientgo run ./client -doctor or marchat-client -doctor
Servergo run ./cmd/server -doctor or marchat-server -doctor
JSONAdd -doctor-json (plain JSON; no TTY colors)

Server doctor lists MARCHAT_* after config/.env load (godotenv.Overload: file wins on same key).

Skip GitHub release compare in tests or offline:

bash
export MARCHAT_DOCTOR_NO_NETWORK=1

Implementation: internal/doctor/. DB dialect and DSN shape checks live there and in server/db_dialect.go.

Common issues

SymptomCheck
Handshake rejected / username takenReserved names; duplicate connection; server hub lock
WSS behind proxydeploy/, docker-compose.proxy.yml, README proxy section; client WSS URL
E2E decrypt failsSame global key on all clients (MARCHAT_GLOBAL_E2E_KEY or shared keystore.dat); not X25519 per-user
Postgres boolean errorsDialect boolean helpers in server/db_dialect.go (:search, pin toggle)
MySQL time parsingmysql.Config with parseTime=true in InitDB
SQLite path vs remote DSNMARCHAT_DB_PATH; mysql: / postgres: prefixes for driver detection
SQLite SQLITE_BUSY / missing messages under loadConfirm InitDB DSN pragmas (_busy_timeout, WAL) and writer MaxOpenConns(1); not one-shot PRAGMA alone (#118). Health/admin read tail latency under writes: file-backed reader pool via dbRead (#126)
Plugin disable raceStopPlugin waits for stdout/stderr readers (plugin/host)
Rate limitserver/loadverify_ratelimit_test.go constants match client.go read pump

WebSocket

  • Serialized writes per connection (server/client.go).
  • Origin checks use parsed hostnames; optional MARCHAT_ALLOWED_ORIGINS.
  • Trusted proxy headers: MARCHAT_TRUSTED_PROXIES for X-Forwarded-For / X-Real-IP.

Logging

Never log passphrases, admin keys, session secrets, or raw E2E keys.

Workflow

  1. Reproduce with minimal steps.
  2. Run -doctor on client and server.
  3. Read relevant test file for expected behavior before changing production code.
  4. Fix root cause; add a regression test (testing-marchat).

© Cod-e-Codes, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .cursor/skills/debugging-marchat of Cod-e-Codes/marchat.

Open the folder on GitHubat commit 3440f09

Compare with similar skills

Debugging Marchat next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Debugging Marchat compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debugging Marchat this skillCod-e-Codes/marchat137—~668Automated safety check: NotesMIT
E2Esendou-ink/sendou.ink297—~2.1kAutomated safety check: NotesAGPL-3.0
Smt E2E Dataflow DebuggingGoogleCloudPlatform/DataflowTemplates1.3k—~1.8kAutomated safety check: PassApache-2.0
Golang Databaseunxed/f42402 repos~2.9kAutomated safety check: PassMIT
Alefxberg-io/alef100—~1.7kAutomated safety check: PassMIT
Odc DebuggingDouglasNeuroInformatics/OpenDataCapture119—~2.8kAutomated safety check: NotesApache-2.0

Similar skills

  • E2E

    sendou-ink/sendou.ink

    Run, debug, and manage Playwright e2e tests. An agent skill from sendou-ink/sendou.ink.

    297 GitHub stars~2.1k tokensUpdated today
    Testing & QAAuto-check: notes
  • Smt E2E Dataflow Debugging

    GoogleCloudPlatform/DataflowTemplates

    Debugs logical errors and data discrepancies in Dataflow templates by launching jobs via Terraform and comparing source (e.g.

    1.3k GitHub stars~1.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Comprehensive guide for Go database access — parameterized queries, struct scanning, NULLable columns, transactions, isolation levels, SELECT FOR UPDATE, connection pool, batch processing, context…

    240 GitHub starsUsed in 2 repos~2.9k tokens
    DatabasesAuto-check passed
  • Alef

    xberg-io/alef

    Use Alef correctly for Rust-to-polyglot binding generation. An agent skill from xberg-io/alef.

    100 GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed
  • Odc Debugging

    DouglasNeuroInformatics/OpenDataCapture

    What actually breaks in Open Data Capture — a failing build, lint, unit test or e2e run; a change with no visible effect; a suite that stays green after you broke the code on purpose; an error…

    119 GitHub stars~2.8k tokensUpdated today
    DevelopmentAuto-check: notes
  • OpenWork Desktop CDP Driver

    different-ai/openwork

    Drives a running OpenWork desktop window over CDP from the shell to evaluate JS, take screenshots, start sessions and send prompts for hand checks.

    24k GitHub stars~465 tokensUpdated today
    Testing & QAAuto-check passed

More from Cod-e-Codes/marchat

All 11 skills in this repo
  • Developing Marchat

    Cod-e-Codes/marchat

    Implements and refactors marchat Go code with project toolchain and quality gates.

    137 GitHub stars~870 tokensUpdated 4 days ago
    Auto-check passed
  • Git Workflow Marchat

    Cod-e-Codes/marchat

    Drafts conventional commit messages and pull request bodies for marchat without committing or pushing unless explicitly requested.

    137 GitHub stars~482 tokensUpdated 4 days ago
    Auto-check: notes
  • Testing Marchat

    Cod-e-Codes/marchat

    Writes and runs marchat tests with race detection, coverage, and dialect smoke patterns.

    137 GitHub stars~802 tokensUpdated 4 days ago
    Auto-check passed
  • Client Marchat

    Cod-e-Codes/marchat

    Implements marchat terminal client TUI, commands, keystore, and WebSocket client behavior.

    137 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • Database Marchat

    Cod-e-Codes/marchat

    Changes marchat SQL schema and queries across SQLite, PostgreSQL, and MySQL using dialect helpers.

    137 GitHub stars~985 tokensUpdated 4 days ago
    Auto-check passed
  • Plugins Marchat

    Cod-e-Codes/marchat

    Develops and maintains marchat plugins: SDK, host IPC, manager install path, store downloads, and Ed25519 licenses.

    137 GitHub stars~558 tokensUpdated 4 days ago
    Auto-check passed

Works with

Questions about Debugging Marchat

What does Debugging Marchat do?

Diagnoses marchat client and server issues using -doctor, env configuration, and logs. Debugging Marchat is an agent skill from Cod-e-Codes/marchat. Diagnoses marchat client and server issues using -doctor, env configuration, and logs.

When should I use Debugging Marchat?

Debugging Marchat fits situations like: debugging connection failures; handshake errors; the user mentions doctor; MARCHAT environment variables.

How do I install Debugging Marchat in Claude Code?

Run `npx skills add Cod-e-Codes/marchat --skill debugging-marchat -a claude-code`. Or copy the skill folder (.cursor/skills/debugging-marchat in Cod-e-Codes/marchat) into .claude/skills/debugging-marchat in your project. Claude Code loads it when a task matches its description.

How do I install Debugging Marchat in Codex?

Run `npx skills add Cod-e-Codes/marchat --skill debugging-marchat -a codex`. Or copy the skill folder (.cursor/skills/debugging-marchat in Cod-e-Codes/marchat) into .agents/skills/debugging-marchat in your project. Codex loads it when a task matches its description.

Can I use Debugging Marchat in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Cod-e-Codes/marchat --skill debugging-marchat -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/debugging-marchat, .gemini/skills/debugging-marchat, .github/skills/debugging-marchat and .opencode/skills/debugging-marchat in your project.

What does Debugging Marchat need to run?

Going by SKILL.md and its folder, Debugging Marchat needs the command-line tools its instructions call (go) and credentials named MARCHAT_GLOBAL_E2E_KEY. Our summary lists: Docker; A credential in MARCHAT_GLOBAL_E2E_KEY.

Does Debugging Marchat access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Debugging Marchat safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Debugging Marchat use?

Debugging Marchat is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Debugging Marchat use?

About 668 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Debugging Marchat?

Skills that share tags, products or a category with Debugging Marchat: E2E (sendou-ink/sendou.ink, 297 stars), Smt E2E Dataflow Debugging (GoogleCloudPlatform/DataflowTemplates, 1.3k stars), Golang Database (unxed/f4, 240 stars) and Alef (xberg-io/alef, 100 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Debugging Marchat?

Cod-e-Codes (a GitHub user) maintains it in Cod-e-Codes/marchat, which has 137 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 3, 2026.

Source: Cod-e-Codes/marchat on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.