🌍 Global Fleet

Managing skills shouldn't be limited to a single repository. Skill Harbor allows you to maintain a Global Manifest to synchronize your personal utilities, refactoring rules, and documentation helpers across every project in your workspace.

⚓ The Global/Local Duality

Skill Harbor recognizes two distinct levels of orchestration:

1. Project Manifest: Stored at .harbor/harbor-manifest.json. Defines the skills every developer on the team needs.
2. Global Manifest: Stored at ~/.harbor/harbor-manifest.json. Defines your personal "synced brain" that follows you from project to project.

⚓ Usage and the --global Flag

By default, all commands target the local project manifest. To target the user-level manifest, use the --global or -g flag.

Syncing Anywhere

Run skill-harbor up --global in any directory to instantly berth your personal global skills into your local agent folders (Claude, Cursor, etc.).

# Sync your personal brain into the current project workspace
skill-harbor up --global

# Sync both local and global fleets simultaneously
skill-harbor up && skill-harbor up --global

Registering Personal Skills

Use the -g flag with dock to save a skill to your global manifest instead of the current repository.

# Register a personal skill globally
skill-harbor dock https://github.com/my-org/my-rules --global

⚓ Why Use Global Fleet?

1. Personal Governance: Keep your project manifests clean and professional, while still having access to your custom keybindings and automation scripts.
2. Context Portability: Your personal intelligence layer is no longer tethered to a single machine or repository.
3. Zero-Tier Discovery: Global skills are automatically included in the 000-fleet-intelligence.md Master Manifest produced by up, allowing agents to discover your personal tools even when they aren't part of the core team repo.

# List all skills in your global fleet
skill-harbor list --global