feat: add mosaic-tools skill (fleet toolkit fast path) #1

2026-06-19T18:21:34Z

jason.woltje commented

2026-06-19 18:21:34 +00:00

What

Adds a new mosaic-tools skill: a high-salience fast path to the Mosaic
fleet toolkit at ~/.config/mosaic/tools/.

Priority #1 — inter-agent messaging: tmux/agent-send.sh (never raw tmux send-keys).
Priority #2 — git provider wrappers: git/*.sh, including the GITEA_LOGIN-by-origin-host
gotcha (the recurring gitea / Error: GetUserByName ... not found on USC repos) — this is the
concrete value-add over the existing heavier mosaic-gitea skill.
Pointers to the other suites (woodpecker/portainer/authentik/cloudflare/health/openbrain).

Why

Fleet workers — Pi/Codex especially — repeatedly improvised raw tmux send-keys / tea / gh
instead of reaching for the maintained wrappers, because the 14 KB # Machine Tools system-prompt
block has low salience. A short, progressive-disclosure skill (description always in context, body
on demand) surfaces the few must-use tools. Validated live on throwaway Pi sessions: with this skill
loaded, a worker used agent-send.sh instead of raw tmux send-keys (0 diagnostics).

Companion change

The launcher in mosaicstack/stack (PR: force-load fleet-critical Pi skills) adds
mosaic-tools to its DEFAULT_PI_FORCE_SKILLS, so Pi force-loads this skill via explicit
--skill (otherwise Pi launches --no-skills by default and loads nothing).

Follow-up (NOT auto-applied)

Running fleet sessions need mosaic-sync-skills to pull this new skill into
~/.config/mosaic/skills/. Do not auto-reseed live sessions — coordinate via Mos.

🤖 Generated with Claude Code

## What Adds a new `mosaic-tools` skill: a high-salience **fast path** to the Mosaic fleet toolkit at `~/.config/mosaic/tools/`. - **Priority #1 — inter-agent messaging:** `tmux/agent-send.sh` (never raw `tmux send-keys`). - **Priority #2 — git provider wrappers:** `git/*.sh`, including the **GITEA_LOGIN-by-origin-host** gotcha (the recurring `gitea / Error: GetUserByName ... not found` on USC repos) — this is the concrete value-add over the existing heavier `mosaic-gitea` skill. - Pointers to the other suites (woodpecker/portainer/authentik/cloudflare/health/openbrain). ## Why Fleet workers — Pi/Codex especially — repeatedly improvised raw `tmux send-keys` / `tea` / `gh` instead of reaching for the maintained wrappers, because the 14 KB `# Machine Tools` system-prompt block has low salience. A short, progressive-disclosure skill (description always in context, body on demand) surfaces the few must-use tools. Validated live on throwaway Pi sessions: with this skill loaded, a worker used `agent-send.sh` instead of raw `tmux send-keys` (0 diagnostics). ## Companion change The launcher in `mosaicstack/stack` (PR: force-load fleet-critical Pi skills) adds `mosaic-tools` to its `DEFAULT_PI_FORCE_SKILLS`, so Pi force-loads this skill via explicit `--skill` (otherwise Pi launches `--no-skills` by default and loads nothing). ## Follow-up (NOT auto-applied) Running fleet sessions need `mosaic-sync-skills` to pull this new skill into `~/.config/mosaic/skills/`. Do not auto-reseed live sessions — coordinate via Mos. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

jason.woltje added 1 commit 2026-06-19 18:21:34 +00:00

feat: add mosaic-tools skill (fleet toolkit fast path) c92e9d5d56

High-salience fast path to ~/.config/mosaic/tools/ for fleet agents:
inter-agent messaging via tmux/agent-send.sh (priority #1) and the
git/*.sh provider wrappers, including the GITEA_LOGIN-by-origin-host
gotcha (the recurring `GetUserByName ... not found` failure on USC repos).

Lighter than mosaic-gitea (full flag reference) and purpose-built for
salience. Force-loaded for Pi by the launcher's DEFAULT_PI_FORCE_SKILLS
(mosaicstack/stack), which is otherwise `--no-skills` by default.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
Claude-Session: https://claude.ai/code/session_01QoYiBeKNh3BiYtAJS5Z587

jason.woltje referenced this pull request from mosaicstack/stack

2026-06-19 18:21:55 +00:00

feat(launch): force-load fleet-critical Pi skills + reconcile skill docs #555

jason.woltje merged commit 5d2371cf3c into main

2026-06-19 18:30:59 +00:00

jason.woltje referenced this issue from a commit

2026-06-19 18:30:59 +00:00

feat: add mosaic-tools skill (fleet toolkit fast path) (#1)

jason.woltje deleted branch feat/mosaic-tools-skill

2026-06-19 18:31:00 +00:00

Sign in to join this conversation.