GuidesSkills
CLI Push
Push Skills from your local filesystem using the Bluebag CLI.
The Bluebag CLI allows you to push Skills directly from your local filesystem. This is ideal for local development, private repositories, and CI/CD pipelines.
For comprehensive CLI documentation, see the CLI Guide.
Quick Start
1. Install the CLI
npm install -g @bluebag/cliOr use npx:
npx @bluebag/cli2. Authenticate
bluebag authThis opens your browser for authentication and creates a .bluebagrc configuration file.
3. Push Skills
bluebag pushDirectory Structure
Organize your Skills in a dedicated directory:
my-project/
├── .bluebagrc # Bluebag configuration
├── skills/ # Default skills directory
│ ├── pdf-processing/
│ │ ├── SKILL.md
│ │ └── scripts/
│ └── data-analysis/
│ ├── SKILL.md
│ └── templates/
└── src/Push Commands
Push All Skills
bluebag pushPush Specific Skills
bluebag push my-skill
bluebag push skill-1 skill-2Preview Changes
bluebag push --dry-runForce Push
bluebag push --forceValidation
The CLI validates each Skill before pushing:
- SKILL.md required - Must exist with valid frontmatter
- Valid name - Lowercase, hyphens, max 64 chars
- Allowed files - Only supported file types
- Size limits - 10MB per file, 100MB total
See CLI Validation for complete details.
Common Workflows
Development Workflow
# Pull latest changes
bluebag pull
# Make local changes to Skills
# Preview what will be pushed
bluebag push --dry-run
# Push changes
bluebag pushCI/CD Integration
# Example GitHub Action
- name: Push Skills
run: npx @bluebag/cli push
env:
BLUEBAG_API_KEY: ${{ secrets.BLUEBAG_API_KEY }}