GuidesSkills

skills.sh Import

Import Skills from the public skills.sh marketplace.

skills.sh is the public marketplace for AI agent Skills. Browse hundreds of community-created Skills and import them into your Bluebag project instantly.

Fastest Way: URL Swap

The quickest way to import any Skill from skills.sh is to simply change the domain:

https://skills.sh/...  →  https://bluebag.ai/...

Find a Skill on skills.sh, replace skills.sh with bluebag.ai in your browser's address bar, and you'll go directly to the import flow with the Skill pre-loaded.

Import Methods

Method 1: URL Swap (Fastest)

  1. Browse Skills at skills.sh
  2. Find a Skill you want to import
  3. In your browser's address bar, change skills.sh to bluebag.ai
  4. Press Enter — you'll land directly on the import page

Example:

FromTo
https://skills.sh/acme/pdf-processorhttps://bluebag.ai/acme/pdf-processor

That's it. One URL change and you're importing.

Method 2: Copy Command

Alternatively, you can copy the import command from skills.sh:

  1. On the Skill page at skills.sh, copy the import command
  2. In Bluebag, click "Create Skill" → "skills.sh"
  3. Paste the command and click "Import"

The command format:

npx skills add https://github.com/owner/repo --skill skill-name

Step-by-Step Guide

1. Find a Skill

Visit skills.sh and browse or search for Skills that match your needs. Each Skill shows:

  • Name and description
  • What it does
  • The import command

2. Copy the Command

On the Skill page, you'll find an import command. Copy the full command, which includes:

  • The GitHub repository URL
  • The --skill flag with the Skill name (if the repo contains multiple Skills)

Example commands:

# Single skill repository
npx skills add https://github.com/acme/pdf-processor

# Multi-skill repository with specific skill
npx skills add https://github.com/acme/ai-skills --skill data-analysis

3. Import in Bluebag

  1. Navigate to your project's Skills page in the Bluebag dashboard
  2. Click "Create Skill" and select "skills.sh"
  3. Paste the command you copied
  4. Click "Import Skill"

4. Review and Confirm

Bluebag fetches the Skill from GitHub and shows you:

  • All files that will be imported
  • The Skill name and description
  • Any validation warnings

Review the files, optionally edit the name/description, then click "Create Skill".

Command Format

The skills.sh command supports these formats:

FormatExample
Basicnpx skills add https://github.com/owner/repo
With skill filternpx skills add https://github.com/owner/repo --skill my-skill
With branchnpx skills add https://github.com/owner/repo/tree/main

The --skill Flag

When a repository contains multiple Skills, use --skill to specify which one:

npx skills add https://github.com/acme/skills-collection --skill pdf-processing

Without the flag, Bluebag scans the repository and lets you choose from available Skills.

Error Handling

"Looks like a GitHub URL"

If you paste a plain GitHub URL (without npx skills add), you'll see a suggestion to use the GitHub Import method instead. Both work—skills.sh import just uses the command format from the marketplace.

"Invalid command format"

Ensure your command starts with npx skills add followed by a valid GitHub URL.

"Skill not found"

The specified --skill name doesn't exist in the repository. Check the Skill name on skills.sh or omit the flag to see all available Skills.

Why Use skills.sh?

BenefitDescription
Curated SkillsCommunity-vetted Skills with descriptions and examples
One-click importCopy, paste, done
DiscoverabilityBrowse by category, search by use case
Always freshSkills link directly to source repositories

Comparison with Other Methods

MethodBest For
skills.shDiscovering and importing community Skills
GitHub ImportDirect import from any GitHub URL
CLI PushLocal development, private repos, CI/CD

Next Steps

On this page