Creating Skills

There are three ways to create Skills in Bluebag:

1. skills.sh Import - Import from the public skills.sh marketplace (recommended for discovering pre-built Skills)
2. GitHub Import - Import a Skill directly from any public GitHub repository
3. CLI Push - Push Skills from your local filesystem using the Bluebag CLI

All methods validate your Skill files and upload them to your project where they become immediately available to your AI agents.

Prerequisites

Before creating Skills, ensure you have:

• A Bluebag account with an organization and project
• A valid Skill directory containing a SKILL.md file
• Files that meet the accepted file types requirements

Quick Start

Using skills.sh (Fastest)

URL Swap method — Find a Skill on skills.sh, then change skills.sh to bluebag.ai in your browser:

https://skills.sh/acme/my-skill  →  https://bluebag.ai/acme/my-skill

That's it. You'll land directly on the import page.

Using GitHub Import

1. Navigate to your project's Skills page in the Bluebag dashboard
2. Click "Create Skill" and select "GitHub"
3. Paste the URL to your Skill directory (e.g., https://github.com/owner/repo/tree/main/skills/my-skill)
4. Review the imported files and click "Create Skill"

Using the CLI

# Navigate to your skills directory
cd my-project/skills

# Push all skills to Bluebag
npx bluebag push

Choosing a Method

Validation

Both methods automatically validate your Skills before upload:

• SKILL.md presence - Every Skill must have a SKILL.md file
• Valid frontmatter - Name and description are required
• Name format - Lowercase letters, numbers, and hyphens only
• File types - Only allowed file extensions
• Size limits - Individual files max 10MB, total Skill max 100MB

If validation fails, you'll see specific error messages explaining what needs to be fixed.

Next Steps