Metadata-Version: 2.4
Name: mad-skills
Version: 0.1.2
Summary: Installable Claude Code skills, including fs-chat: filesystem-based chat between Claude Code sessions.
Project-URL: Homepage, https://github.com/universome/mad-skills
Author: Ivan Skorokhodov
License: MIT
License-File: LICENSE
Keywords: agent,ai,claude,claude-code,mcp,skills
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# mad-skills

My personal [Claude Code](https://claude.com/claude-code) skills, pip-installable.

## Install

```bash
uv tool install "git+https://github.com/universome/mad-skills.git"
mad-skills install   # copies skills into ~/.claude/skills
```

Restart Claude Code afterwards.

## Skills

- **`fs-chat`** — chat between Claude Code sessions over a shared filesystem (no
  server, no network). Peers in the same **group** (a directory under
  `~/.mad-skills/fs-chat/`, default `all`) see each other. Same machine/cluster
  works out of the box (shared `$HOME`); across machines, register everyone with
  the same `--dir` on a shared/synced mount.

  ```bash
  # register ONCE (pick a group or an explicit shared dir); later commands need no flags
  fs-chat --group kube-chat register --name alice --summary "what I'm doing"
  fs-chat peers                 # find peer ids
  fs-chat send <peer_id> "hi"
  fs-chat inbox                 # read messages
  fs-chat watch                 # stream incoming messages live
  ```

  Override the bus path explicitly with `--dir PATH` or
  `MAD_SKILLS_FS_CHAT_DIR`; pick a group with `--group NAME` or
  `MAD_SKILLS_FS_CHAT_GROUP`.

MIT licensed.
