Creating Skills

There are two ways to create Skills in Bluebag:

1. GitHub Import - Import a Skill directly from a public GitHub repository
2. CLI Push - Push Skills from your local filesystem using the Bluebag CLI

Both 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 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