Skill

react-composition

react-composition — a Claude Code skill from s-hiraoku/synapse-a2a

Features

✓Inter-agent collaboration via A2A Protocol
✓Non-invasive design, no agent behavior change
✓Transparent wrapping of agent I/O
✓Leverage each agent's strengths with role assignments
✓Zero learning curve, maintain existing workflows
✓Future-proof against agent updates
✓Visit GitHub for more tools

Installation Guide

Install via the GitHub CLI (requires gh 2.90.0+):

bash

# Install core skills from this repository
gh skill install s-hiraoku/synapse-a2a synapse-a2a
gh skill install s-hiraoku/synapse-a2a synapse-manager

# Pin to a release tag so updates are explicit
gh skill install s-hiraoku/synapse-a2a synapse-a2a --pin v0.26.4

# Install for a specific agent runtime
gh skill install s-hiraoku/synapse-a2a synapse-a2a --agent claude-code
gh skill install s-hiraoku/synapse-a2a synapse-a2a --agent copilot

# Preview a skill before installing
gh skill preview s-hiraoku/synapse-a2a synapse-a2a

# Check for upstream changes on installed skills
gh skill update

Each installed skill's SKILL.md frontmatter records the source
repository, ref, and tree SHA, so gh skill update can detect
drift and --pin gives you a deterministic version.

Legacy path — npx skills add s-hiraoku/synapse-a2a
(skills.sh) still works for older gh installs, but gh skill
is the recommended tool going forward. See
[docs/skills-management.md](docs/skills-management.md) for the
migration matrix.

Included Skills

| Skill | Description |
|-------|-------------|
| synapse-a2a | Comprehensive guide for inter-agent communication: synapse send, priority, A2A protocol, history, File Safety, settings |
| synapse-manager | Multi-agent management workflow: task delegation, progress monitoring, quality verification with regression testing, feedback delivery, cross-review orchestration, worker agent guide, and mandatory cleanup enforcement |
| check-ci | Check CI status, merge conflict state, and CodeRabbit review status for the current PR (/check-ci, /check-ci --fix) |
| fix-ci | Auto-diagnose and fix CI failures: lint, format, type-check, test errors |
| fix-conflict | Auto-resolve merge conflicts: fetch base, test merge, analyze both sides, resolve, verify, push |
| fix-review | Auto-fix CodeRabbit review comments: classify by severity (Bug/Style/Suggestion), apply fixes, verify, push |

Core Skills: Essential skills like synapse-a2a are automatically deployed to agent directories on startup (best-effort) to ensure basic quality even if skill sets are skipped.

Skill Management

Synapse includes a built-in skill manager with a central store (~/.synapse/skills/) for organizing and deploying skills across agents.

#### Skill Scopes

| Scope | Location | Description |
|-------|----------|-------------|
| Synapse | ~/.synapse/skills/ | Central store (deploy to agents from here) |
| User | ~/.claude/skills/, ~/.agents/skills/, etc. | User-wide skills |
| Project | ./.claude/skills/, ./.agents/skills/, etc. | Project-local skills |
| Plugin | ./plugins/*/skills/ | Read-only plugin skills |

#### Commands

bash

# Interactive TUI
synapse skills

# List and browse
synapse skills list                          # All scopes
synapse skills list --scope synapse          # Central store only
synapse skills show <name>                   # Skill details

# Manage
synapse skills delete <name> [--force]
synapse skills move <name> --to <scope>

# Central store operations
synapse skills import <name>                 # Import from agent dirs to ~/.synapse/skills/
synapse skills deploy <name> --agent claude,codex --scope user
synapse skills add <repo>                    # Install from repo (legacy wrapper; prefer `gh skill install`)
synapse skills create                        # Show guided skill creation steps

# Skill sets (named groups)
synapse skills set list
synapse skills set show <name>
synapse skills apply <target> <set_name>     # Apply skill set to running agent
synapse skills apply <target> <set_name> --dry-run  # Preview changes without applying

#### Default Skill Sets

Synapse ships with 6 built-in skill sets (defined in .synapse/skill_sets.json):

| Skill Set | Description | Skills |
|-----------|-------------|--------|
| architect | System architecture and design — design docs, API contracts, code review | synapse-a2a, system-design, api-design, code-review, project-docs |
| developer | Implementation and quality — test-first development, refactoring, code simplification | synapse-a2a, test-first, refactoring, code-simplifier, agent-memory |
| reviewer | Code review and security — structured reviews, security audits, code simplification | synapse-a2a, code-review, security-audit, code-simplifier |
| frontend | Frontend development — React/Next.js performance, component composition, design systems, accessibility | synapse-a2a, react-performance, frontend-design, react-composition, web-accessibility |
| manager | Multi-agent management — task delegation, progress monitoring, quality verification, cross-review orchestration, re-instruction | synapse-a2a, synapse-manager, task-planner, agent-memory, code-review, synapse-reinst |
| documentation | Documentation expert — audit, restructure, synchronize, and maintain project documentation | synapse-a2a, project-docs, api-design, agent-memory |

Directory Structure

text

plugins/
└── synapse-a2a/
    ├── .claude-plugin/plugin.json
    ├── README.md
    └── skills/
        ├── synapse-a2a/
        │   ├── SKILL.md
        │   └── references/          # api, collaboration, commands, examples, features, file-safety, messaging, spawning
        └── synapse-manager/
            ├── SKILL.md
            ├── references/          # auto-approve-flags, commands-quick-ref, features-table, worker-guide
            └── scripts/             # wait_ready.sh, check_team_status.sh, regression_triage.sh

See [plugins/synapse-a2a/README.md](plugins/synapse-a2a/README.md) for details.

Note: Codex and Gemini don't support plugins, but you can place expanded skills in the .agents/skills/ directory to enable these features.

---