guile-skills: Docs

Back to guile-skills.

Installation

Plugin and skill installs behave differently:

# as a plugin
claude --plugin-dir /path/to/guile-skills      # one session

# as skills
gh skill install dsp-dr/guile-skills --pin v0.1.2

Requires Guile 3.x. The binary is guile3 on FreeBSD, guile-3.0 on Debian and Ubuntu, guile under Homebrew; the plugin probes all three. Bare guile is 2.2.7 on some systems and will not work.

Usage

Start the server, evaluate against it, trace, read the transcript back. The server binds 127.0.0.1 on a port derived from the working directory, with a logging proxy one port above it.

Traps

These are the genuinely useful part – each cost someone real debugging time.

  • ,trace is silent without --debug.
  • ,profile prints No samples recorded. on a workload too short to sample.
  • A module already loaded does not pick up file edits.
  • Connecting to PORT instead of PORT+1 works and records nothing – the proxy, not the raw REPL port, is where the transcript is written.

On-disk state

Transcripts live under ${CLAUDE_PLUGIN_DATA}/projects/<slug>/, which is ~/.claude/plugins/data/<id>/. Rotated at 4 MiB, five generations. Removed when the plugin is uninstalled, unless you pass --keep-data. Never written inside your repository, deliberately – a REPL transcript contains whatever was evaluated.

Elsewhere