1. Forum
  2. DOVE-Net
  3. Synchronet Programming

  • .claude/skills/synchronet-smbutils/SKILL.md

    From Rob Swindell (on Debian Linux)@VERT to Git commit to main/sbbs/master on Friday, May 22, 2026 19:16:50
    https://gitlab.synchro.net/main/sbbs/-/commit/ce4321c83a01b36d00db2968
    Added Files:
    .claude/skills/synchronet-smbutils/SKILL.md
    Log Message:
    .claude/skills: add synchronet-smbutils

    Migrated from the personal ~/.claude/skills/synchronet-smbutils/
    version. The skill covers the three SMB-level command-line tools that
    operate on Synchronet Message Base files directly (below the level of
    the BBS itself or the JS MsgBase API):

    * smbutil -- inspect/list/view/import/pack/renumber/lock/unlock
    operations on a base, plus the verbose-dump V command
    and the per-user mail-extraction recipe.
    * chksmb -- integrity scan; reports header / data / index / hash
    anomalies without modifying anything.
    * fixsmb -- destructive repair that rebuilds indexes/hashes and
    can renumber; covers when (not) to reach for it.

    Includes the SMB on-disk format references (wiki ref:smb, the 1993
    historical spec, the SMBLIB C source), the filespec convention shared
    by all three tools (path with no extension, or with a specific .shd /
    .sdt / .sid / .sha component), the [n] index-pitfall warning, a full investigate-a-corrupt-base workflow, and the boundary on when to use
    these tools versus the in-BBS interface or the MsgBase JS API.

    Only one host-specific bit needed scrubbing: an example Windows install
    path was S:\sbbs\ctrl (the personal versions drive letter); the
    in-repo version uses the conventional C:\sbbs\ctrl plus the Git
    Bash / MSYS mount-point form. Otherwise the personal SKILL.md was
    already host-agnostic.

    Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

    ---
    þ Synchronet þ Vertrauen þ Home of Synchronet þ [vert/cvs/bbs].synchro.net