GitHub Import

GitHub Import allows you to create Skills by importing them directly from a public GitHub repository. This is the quickest way to get started if your Skills are already hosted on GitHub.

Supported URL Formats

You can import Skills using either format:

Directory URL (recommended):

https://github.com/owner/repo/tree/branch/path/to/skill

SKILL.md blob URL (automatically converted to directory):

https://github.com/owner/repo/blob/branch/path/to/skill/SKILL.md

Step-by-Step Guide

1. Navigate to Skills

In the Bluebag dashboard, go to your project and click on the "Skills" section.

2. Start Import

Click "Create Skill" and select "GitHub" from the available options.

3. Enter GitHub URL

Paste the URL to your Skill directory. For example:

https://github.com/acme-corp/ai-skills/tree/main/skills/pdf-processing

The directory must contain a SKILL.md file at its root.

4. Review Imported Files

Bluebag fetches and displays all files from the directory. Review the file list and verify:

• All expected files are included
• File sizes are within limits
• No unsupported file types are present

5. Edit Metadata (Optional)

The Skill name and description are auto-populated from your SKILL.md frontmatter. You can edit these before creating:

• Name: Must be lowercase with hyphens (e.g., pdf-processing)
• Description: Should explain what the Skill does and when to use it

6. Create Skill

Click "Create Skill" to upload. The files are uploaded to secure cloud storage and the Skill becomes immediately available to your agents.

Validation Checks

During import, the following validations are performed:

Error Handling

Common Errors

"Directory not found"

• Verify the URL points to an existing directory
• Check that the branch name is correct
• Ensure the repository is public

"SKILL.md is required"

• Add a SKILL.md file to the root of your Skill directory
• Ensure the file has valid YAML frontmatter

"Unsupported file extension"

• Remove or rename files with unsupported extensions
• See Accepted Files for allowed types

"Size limit exceeded"

• Reduce the total size of files to under 10MB
• Consider moving large assets to external storage

Best Practices

Repository Structure

Organize your Skills in a dedicated directory:

your-repo/
├── skills/
│   ├── pdf-processing/
│   │   ├── SKILL.md
│   │   └── scripts/
│   ├── data-analysis/
│   │   ├── SKILL.md
│   │   └── templates/
│   └── image-processing/
│       └── SKILL.md
└── README.md

Version Control

• Use branches for Skill development
• Import from main or a release branch for production
• Test Skills on feature branches before merging

Multiple Skills

To import multiple Skills from the same repository, import each Skill directory individually. Each import creates a separate Skill in your project.

Limitations

• Only public repositories are supported via GitHub Import
• For private repositories, use the CLI Push method
• Maximum import size is 10MB per Skill
• Some binary file types are not supported

Next Steps

• Learn about Writing Skills to create effective Skill content
• Use the CLI for more control over uploads