# Plugin Bootstrap

> Initializes or updates the local plugin ecosystem from the central vendor repo. Use this when a project needs to pull the latest plugin code or initialize for the first time.

- Skill: `richfrem/plugin-bootstrap` (Agent Skill)
- Install (CLI): `npx skillmds@latest add richfrem/plugin-bootstrap`
- Raw SKILL.md: https://api.skillmd.com/api/skills/richfrem/plugin-bootstrap/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: richfrem (https://skillmd.com/u/richfrem)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/richfrem/plugin-bootstrap

---


# Plugin Bootstrap Protocol

This skill provides a standardized way to initialize or update your local plugin environment from the central vendor repository.

## Automated Bootstrap

The quickest way to update your ecosystem is to run the bootstrap script:

```bash
python3 plugins/plugin-manager/scripts/plugin_bootstrap.py
```

This command will:
1. Ensure the vendor source in `.vendor/agent-plugins-skills` is present and up to date.
2. Refresh your local `plugins/` folder with the latest code.
3. Synchronize your active agent configurations (Antigravity, etc.).

---

## Manual Execution (Phase-by-Phase)

If you need more granular control, you can perform the bootstrap in stages:

### Phase 1: Ensure Vendor Source
If the `.vendor/agent-plugins-skills` directory is missing or needs a fresh update:

```bash
# Clone for the first time
mkdir -p .vendor
git clone https://github.com/richfrem/agent-plugins-skills.git .vendor/agent-plugins-skills

# OR update existing
cd .vendor/agent-plugins-skills && git pull
```

### Phase 2: Execute Update
Run the standardized update script to synchronize existing plugins in `plugins/`:

```bash
python3 plugins/plugin-manager/scripts/update_from_vendor.py
```

### Phase 3: Finalize Sync
Ensure all agent configurations (Antigravity, etc.) are updated to reflect the new code:

```bash
python3 plugins/plugin-manager/scripts/sync_with_inventory.py
```

---

## Next Steps (Local Environment Setup)

Once the bootstrap is complete, you may need to perform additional setup or maintenance:

1. **[Plugin Replicator](../plugin-replicator/SKILL.md)**: Install new plugins or replicate specific plugins to other project paths.
2. **[Inventory Sync](../inventory-sync/SKILL.md)**: Perform a deep audit and cleanup of your sync state.
3. **[Plugin Maintenance](../plugin-maintenance/SKILL.md)**: Audit the health and structure of your active plugins.
4. **[Agent Bridge](../agent-bridge/SKILL.md)**: Manually trigger resource synchronization for specific agent targets.