Pulling Skills

Pull remote Skills from your Bluebag project to your local workspace.

Basic Usage

Pull all Skills from your project:

bluebag pull

Pull Specific Skills

Pull only specific Skills by name:

bluebag pull my-skill

Pull multiple Skills:

bluebag pull my-skill another-skill

Options

Force Pull

Overwrite local changes without prompting:

bluebag pull --force

Use with caution—this will overwrite local changes even if conflicts exist.

Dry Run

Preview what would be pulled without making changes:

bluebag pull --dry-run

This shows which Skills would be downloaded, updated, or skipped.

Pull Workflow

When you run bluebag pull, the CLI performs these steps:

1. Fetch Remote Skills

The CLI retrieves the list of available Skills from your project.

2. Conflict Detection

Compares remote and local versions:

• If you have local changes that haven't been pushed, you'll be prompted to resolve the conflict
• Use --force to skip conflict detection and overwrite local

3. Download

Files are downloaded from cloud storage:

• Progress is displayed for each Skill
• Files are written to your skillsDir
• Existing files are overwritten with remote versions

4. Verification

Downloaded files are verified:

• Hash verification ensures file integrity
• Corrupted downloads are automatically retried

Examples

Pull All Skills

# Pull everything from the remote project
bluebag pull

Pull a Single Skill

# Pull only the pdf-processing skill
bluebag pull pdf-processing

Preview Before Pulling

# See what would be pulled
bluebag pull --dry-run

# Then pull if everything looks good
bluebag pull

Force Overwrite Local

# Overwrite local changes (use carefully)
bluebag pull --force

What Gets Pulled

The CLI downloads all files from each remote Skill:

• All files in the Skill directory
• Subdirectories and their contents
• The complete directory structure is preserved

After Pulling

Once pulled, Skills are available in your local skillsDir:

skills/
  pdf-processing/
    SKILL.md
    scripts/
      extract.py
  data-analysis/
    SKILL.md
    templates/
      report.hbs

You can:

• Edit Skills locally and push changes
• Run and test scripts
• Add new files to existing Skills

Sync Workflow

For team collaboration, follow this workflow:

1. Pull before starting work:

bluebag pull

2. Make your changes locally

3. Push when done:

bluebag push

This minimizes conflicts and keeps everyone in sync.