mosaicstack/agent-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Merged
jason.woltje merged 1 commits from feat/mosaic-tools-skill into main 2026-06-19 18:30:59 +00:00
Conversation 0 Commits 1 Files Changed 1 +66
jason.woltje commented 2026-06-19 18:21:34 +00:00
Owner
Copy Link

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 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QoYiBeKNh3BiYtAJS5Z587
jason.woltje merged commit 5d2371cf3c into main 2026-06-19 18:30:59 +00:00
jason.woltje deleted branch feat/mosaic-tools-skill 2026-06-19 18:31:00 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
jason.woltje
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaicstack/agent-skills#1
Delete Branch "feat/mosaic-tools-skill"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?