mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-09-07 08:26:02 +00:00

fix: rename all remaining built-in-shadowing skill names and harden the last cp1252-fatal scripts (#885 , #969 follow-through)

Round-2 sweep after re-auditing all 15 reported issues against the merged dev:

- #885 generalized: the original fix only renamed self-improving-agent's
  status/review, but three more plugins shipped skills whose bare names
  shadow Claude Code built-ins. Renamed with the same convention:
  playwright-pro init/review -> pw-init/pw-review, agenthub init/status ->
  hub-init/hub-status, autoresearch-agent status/resume -> ar-status/
  ar-resume. All command references (/pw: /hub: /ar:), docs, audit records,
  harness manifests, and mirror trees/indexes updated; the flat mirror
  namespace no longer collides on 'status'. New scripts/check_skill_names.py
  gate (wired into ci-quality-gate.yml as blocking) fails CI on any future
  bare reserved name; rule added to SKILL-AUTHORING-STANDARD.md.
- #969 follow-through: five more scripts print box-drawing characters that
  cannot exist in cp1252 (api_scorecard, api_linter,
  breaking_change_detector, humanizer_scorer, content_scorer) — same
  guarded UTF-8 reconfigure applied; all smoke-tested under a forced
  legacy encoding.

Verified: check_skill_names (incl. negative test), check_plugin_json,
check_paths, derive_counters, check_dual_publish, smoke_scripts (634/634),
0 broken mirror symlinks.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qgc6RYXWJPr5oW9DHU7zR4

2026-08-21 08:38:50 +00:00

3.9 KiB

Raw Permalink Blame History

title	description
/hub:spawn — Launch Parallel Agents — Agent Skill for Codex & OpenClaw	Launch N parallel subagents in isolated git worktrees to compete on the session task. Use when the user runs /hub:spawn or asks to start the. Agent skill for Claude Code, Codex CLI, Gemini CLI, OpenClaw.

/hub:spawn — Launch Parallel Agents

:material-rocket-launch: Engineering - POWERFUL :material-identifier: `spawn` :material-github: Source

Install: claude /plugin install engineering-advanced-skills

Spawn N subagents that work on the same task in parallel, each in an isolated git worktree.

Usage

/hub:spawn                                    # Spawn agents for the latest session
/hub:spawn 20260317-143022                    # Spawn agents for a specific session
/hub:spawn --template optimizer               # Use optimizer template for dispatch prompts
/hub:spawn --template refactorer              # Use refactorer template

Templates

When --template <name> is provided, use the dispatch prompt from references/agent-templates.md instead of the default prompt below. Available templates:

Template	Pattern	Use Case
`optimizer`	Edit → eval → keep/discard → repeat x10	Performance, latency, size reduction
`refactorer`	Restructure → test → iterate until green	Code quality, tech debt
`test-writer`	Write tests → measure coverage → repeat	Test coverage gaps
`bug-fixer`	Reproduce → diagnose → fix → verify	Bug fix with competing approaches

When using a template, replace all {variables} with values from the session config. Assign each agent a different strategy appropriate to the template and task — diverse strategies maximize the value of parallel exploration.

What It Does

Load session config from .agenthub/sessions/{session-id}/config.yaml
For each agent 1..N:
- Write task assignment to .agenthub/board/dispatch/
- Build agent prompt with task, constraints, and board write instructions
Launch ALL agents in a single message with multiple Agent tool calls:

Agent(
  prompt: "You are agent-{i} in hub session {session-id}.

Your task: {task}

Read your full assignment at .agenthub/board/dispatch/{seq}-agent-{i}.md

Instructions:
1. Work in your worktree — make changes, run tests, iterate
2. Commit all changes with descriptive messages
3. Write your result summary to .agenthub/board/results/agent-{i}-result.md
   Include: approach taken, files changed, metric if available, confidence level
4. Exit when done

Constraints:
- Do NOT read or modify other agents' work
- Do NOT access .agenthub/board/results/ for other agents
- Commit early and often with descriptive messages
- If you hit a dead end, commit what you have and explain in your result",
  isolation: "worktree"
)

Update session state to running via:

python {skill_path}/scripts/session_manager.py --update {session-id} --state running

Critical Rules

All agents in ONE message — spawn all Agent tool calls simultaneously for true parallelism
isolation: "worktree" is mandatory — each agent needs its own filesystem
Never modify session config after spawn — agents rely on stable configuration
Each agent gets a unique board post — dispatch posts are numbered sequentially

After Spawn

Tell the user:

{N} agents launched in parallel
Each working in an isolated worktree
Monitor with /hub:hub-status
Evaluate when done with /hub:eval

3.9 KiB Raw Permalink Blame History