Agent skill

Writing Marchat Docs

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

Updates marchat documentation and changelogs to match code and release practice.

MITAuto-check passedDevelopment

Install Writing Marchat Docs

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

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

GitHub CLI
$ gh skill install Cod-e-Codes/marchat writing-marchat-docs --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/writing-marchat-docs .claude/skills/writing-marchat-docs && 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
writing-marchat-docs
GitHub stars
137
Token cost
~734 tokens
SKILL.md length
344 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Updates marchat documentation and changelogs to match code and release practice.

  • Editing CHANGELOG.md
  • SKILL.md covers Style, CHANGELOG.md, Behavior changes (required) and README.md, plus 4 more sections
  • Calls go and git
  • ARCHITECTURE.md

What it does

Writing Marchat Docs is an agent skill from Cod-e-Codes/marchat. Updates marchat documentation and changelogs to match code and release practice. Use when editing CHANGELOG.md, README.md, ARCHITECTURE.md, PROTOCOL.md, TESTING.md, or other project markdown.

Its SKILL.md is about 730 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 Changelog and release notes and Technical documentation. 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

  • Editing CHANGELOG.md
  • ARCHITECTURE.md
  • Other project markdown

Example prompts

  • “Use the writing-marchat-docs skill to update marchat documentation and changelogs to match code and release practice”
  • “/writing-marchat-docs”

Requirements

  • Docker

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
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Writing Marchat Docs loads about 734 tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 344 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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). 344 words, ~734 tokens.

Download SKILL.mdSave it as .claude/skills/writing-marchat-docs/SKILL.md (or your agent's skills folder).
name
writing-marchat-docs
description
Updates marchat documentation and changelogs to match code and release practice. Use when editing CHANGELOG.md, README.md, ARCHITECTURE.md, PROTOCOL.md, TESTING.md, or other project markdown.
paths
**/*.md

Writing marchat docs

Update docs when behavior, protocol, env vars, or coverage changes. Do not edit markdown the user did not ask for unless required by the same change set.

Style

  • Match existing voice: technical, direct, complete sentences.
  • Use **Bold label**: for changelog section prefixes (Client, Server, Docs, Fix:).
  • ASCII hyphen -, not Unicode em dash.
  • No decorative emoji in docs or UI chrome descriptions (user message/reaction emoji in product behavior is fine to document).
  • Link to ARCHITECTURE.md, PROTOCOL.md, TESTING.md instead of duplicating long specs.

CHANGELOG.md

  • Unreleased on main only until tag and publish.
  • Each release: date, link to prior tag, git log hint, narrative bullets (not a raw commit dump).
  • Call out breaking protocol or keystore changes explicitly.
  • Dependency bumps: name and version.
  • Published GitHub release bodies are separate from CHANGELOG. Do not commit release-notes*.md (gitignored local drafts for --notes-file only). Omit Docker from those drafts (CI appends it). See releasing-marchat.

Behavior changes (required)

When user-visible or protocol behavior changes, update CHANGELOG and normative docs together (ARCHITECTURE.md, PROTOCOL.md, TESTING.md, README.md when env/coverage/install facts shift). Update domain skills under .cursor/skills/ when agent workflows or shipped behavior they describe changes. Do not leave CHANGELOG-only updates when other docs or skills would become stale.

README.md

  • Install paths, env vars, doctor, DB backends, proxy/WSS, coverage summary pointer to TESTING.md.
  • Keep install script version snippets aligned with latest release when bumping version.

ARCHITECTURE.md / PROTOCOL.md

  • Normative for system design and wire JSON shapes.
  • E2E: global symmetric ChaCha20-Poly1305; base64 nonce || ciphertext in content when encrypted is true.
  • Do not describe chat E2E as X25519 key exchange.

TESTING.md

  • Regenerate coverage with go test -coverprofile=... and go tool cover -func=....
  • Document nested plugin/sdk separately from main module merge.
  • Note doctor osEnviron / environMu parallel test constraint.

Roadmap

Use ROADMAP.md for planned work. Do not document roadmap items as released unless they exist in code.

Checklist

  • Facts match current code (grep or read implementation)
  • Version strings consistent across touched files
  • Coverage numbers refreshed if tests changed materially
  • Normative docs and domain skills updated when behavior changes (not CHANGELOG-only)
  • No em dash introduced in new prose

© 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/writing-marchat-docs of Cod-e-Codes/marchat.

Open the folder on GitHubat commit 3440f09

Compare with similar skills

Writing Marchat Docs 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.

Writing Marchat Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Writing Marchat Docs this skillCod-e-Codes/marchat137—~734Automated safety check: PassMIT
Simple Englishmoeru-ai/airi50k2 repos~4.6kAutomated safety check: PassMIT
Ccb GitHubSeemSeam/claude_codex_bridge3.5k—~4.9kAutomated safety check: PassCustom licence
Golang Documentationunxed/f42403 repos~3.5kAutomated safety check: PassMIT
Simple Englishropensci/ckanr1043 repos~2kAutomated safety check: PassMIT
Opik Documentation Patternscomet-ml/opik22k—~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • Ccb GitHub

    SeemSeam/claude_codex_bridge

    Maintain this CCB project's GitHub-facing release and npm publication surface.

    3.5k GitHub stars~4.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Comprehensive documentation guide for Golang projects, covering godoc comments, README, CONTRIBUTING, CHANGELOG, Go Playground, Example tests, API docs, and llms.txt.

    240 GitHub starsUsed in 3 repos~3.5k tokens
    DevelopmentAuto-check passed
  • Simple English

    ropensci/ckanr

    Write or rewrite text in plain, layman-readable English in the spirit of ASD-STE100 Simplified Technical English: short sentences, active voice, simple tenses, one word one meaning, condition before…

    104 GitHub starsUsed in 3 repos~2k tokens
    DevelopmentAuto-check passed
  • Rules for writing PR descriptions, changelog entries and feature documentation in the Opik repository, including the exact headings that CI requires.

    22k GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Release

    jrswab/axe

    Prepare code for release (version bumps, changelog, README updates) and create an annotated tag to trigger the GoReleaser workflow.

    895 GitHub stars~1.4k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from Cod-e-Codes/marchat

All 11 skills in this repo
  • Debugging Marchat

    Cod-e-Codes/marchat

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

    137 GitHub stars~668 tokensUpdated 4 days ago
    Auto-check: notes
  • 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

Categories

Questions about Writing Marchat Docs

What does Writing Marchat Docs do?

Updates marchat documentation and changelogs to match code and release practice. Writing Marchat Docs is an agent skill from Cod-e-Codes/marchat. Updates marchat documentation and changelogs to match code and release practice.

When should I use Writing Marchat Docs?

Writing Marchat Docs fits situations like: editing CHANGELOG.md; ARCHITECTURE.md; other project markdown.

How do I install Writing Marchat Docs in Claude Code?

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

How do I install Writing Marchat Docs in Codex?

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

Can I use Writing Marchat Docs 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 writing-marchat-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/writing-marchat-docs, .gemini/skills/writing-marchat-docs, .github/skills/writing-marchat-docs and .opencode/skills/writing-marchat-docs in your project.

What does Writing Marchat Docs need to run?

Going by SKILL.md and its folder, Writing Marchat Docs needs the command-line tools its instructions call (go and git). Our summary lists: Docker.

Does Writing Marchat Docs access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Writing Marchat Docs safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Writing Marchat Docs use?

Writing Marchat Docs 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 Writing Marchat Docs use?

About 734 tokens (SKILL.md is roughly 2.9k 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 Writing Marchat Docs?

Skills that share tags, products or a category with Writing Marchat Docs: Simple English (moeru-ai/airi, 50k stars), Ccb GitHub (SeemSeam/claude_codex_bridge, 3.5k stars), Golang Documentation (unxed/f4, 240 stars) and Simple English (ropensci/ckanr, 104 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Writing Marchat Docs?

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.