🥷 Jump Skills Ninjas

Multi-Tenant Ninja System for AI Agent Orchestration

Intelligent routing skills that orchestrate specialized agent capabilities from multiple cloud providers

AWS Ninja • Azure Ninja • Firecrawl Ninja • Installation

🤔 What are Ninjas?

Ninjas are intelligent meta-skills — master orchestrators that route your requests to the most appropriate specialized skill from a curated library. Instead of manually searching through hundreds of individual skills, you simply describe your task and the Ninja:

1. 🎯 Identifies the most relevant specialized skill(s)
2. 📖 Loads the full skill instructions on-demand
3. ⚡ Executes the task with expert-level knowledge

Think of Ninjas as expert dispatchers — they understand the entire landscape of available capabilities and always route you to the right specialist.

┌─────────────────────────────────────────────────────────────────────────┐
│                           YOUR REQUEST                                  │
│                    "Set up an EKS cluster with                          │
│                     Karpenter for autoscaling"                          │
└─────────────────────────────────────────────────────────────────────────┘
                                   │
                                   ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                          🥷 AWS NINJA                                   │
│                    Analyzes intent & context                            │
│                                                                         │
│   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐                │
│   │ eks-design  │    │eks-karpenter│    │eks-security │                │
│   │   skill     │ ── │   skill     │ ── │   skill     │                │
│   └─────────────┘    └─────────────┘    └─────────────┘                │
│         ▲                  ▲                                            │
│         └────── SELECTED ──┘                                            │
└─────────────────────────────────────────────────────────────────────────┘
                                   │
                                   ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                     EXPERT EXECUTION                                    │
│          Full skill knowledge loaded & task completed                   │
└─────────────────────────────────────────────────────────────────────────┘

⚠️ Important: Installation Notice

[!CAUTION] This repository cannot be installed via npx skills

Jump Skills is a meta-repository that orchestrates skills from multiple external repositories. The Ninja skills reference paths to cloned repositories that must exist locally.

To use Jump Skills, you must:

1. Clone this repository
2. Run ./sync-repos.sh to clone all source repositories
3. Run ./install-ninjas.sh to install Ninjas to your agents

📦 Installation

🤖 Ask Your Agent

Simply copy and paste this prompt to your AI coding agent:

Clone https://github.com/fabricioctelles/jump-skills,
then run ./sync-repos.sh to clone all skill repositories,
and ./install-ninjas.sh to install the Ninjas.

Manual Installation

# 1. Clone the repository
git clone https://github.com/fabricioctelles/jump-skills.git
cd jump-skills

# 2. Sync all source repositories (clones ~15 repos, ~500MB)
./sync-repos.sh

# 3. Install Ninjas to your agents (Claude Code, Kiro, Cursor, etc.)
./install-ninjas.sh

What gets installed?

The installer detects and installs to these AI coding agents:

🥷 Available Ninjas

AWS Ninja

230+ skills from 10 official AWS repositories

The AWS Ninja is your expert guide for all things Amazon Web Services. It orchestrates skills covering:

Source repositories:

• aws/agent-toolkit-for-aws
• aws/tools-for-devops-agent
• aws-samples/sample-apex-skills
• And 7 more...

Azure Ninja

40 skills from Microsoft official + community repositories

The Azure Ninja orchestrates Azure expertise across the full deployment lifecycle:

Source repositories:

• microsoft/azure-skills — Official Azure plugin
• github/awesome-copilot — Community Azure skills

Firecrawl Ninja

33 skills for web scraping, research, and data extraction

The Firecrawl Ninja is your specialist for web data operations:

Source repository:

• firecrawl/skills

🗂️ Repository Structure

jump-skills/
├── ninjas/                    # Ninja definitions
│   ├── aws-ninja/SKILL.md     # AWS orchestrator (230+ skills)
│   ├── azure-ninja/SKILL.md   # Azure orchestrator (40 skills)
│   └── firecrawl-ninja/SKILL.md # Firecrawl orchestrator (33 skills)
├── sync-repos.sh              # Clone/update source repositories
├── install-ninjas.sh          # Install Ninjas to agents
├── repos.md                   # Repository definitions per Ninja
├── ninjas.md                  # Ninja registry
│
│   # Generated after running sync-repos.sh:
├── repos/                     # 📁 Cloned source repositories (git-ignored)
│   ├── aws-ninja/             #    └── 10 AWS repos
│   ├── azure-ninja/           #    └── 2 Azure repos
│   └── firecrawl-ninja/       #    └── 1 Firecrawl repo
└── .skills-map                # 📄 Auto-generated skill→path mapping

🔧 How It Works

1. Repository Sync (sync-repos.sh)

Reads repos.md and clones all source repositories into repos/<ninja-name>/:

./sync-repos.sh                 # Sync all ninjas
./sync-repos.sh aws-ninja       # Sync only AWS repos
./sync-repos.sh --status        # Show sync status

2. Skill Mapping

During sync, the script discovers all SKILL.md files and creates .skills-map:

aws-ninja|eks-design|repos/aws-ninja/sample-apex-skills/skills/eks-design/
azure-ninja|azure-prepare|repos/azure-ninja/azure-skills/skills/azure-prepare/

3. Installation (install-ninjas.sh)

Copies Ninja SKILL.md files to detected agents, replacing {{JUMP_SKILLS_DIR}} with the absolute path:

./install-ninjas.sh             # Install all ninjas
./install-ninjas.sh aws-ninja   # Install only AWS ninja
./install-ninjas.sh --status    # Show installation status

➕ Adding a New Ninja

1. Add repositories to repos.md:

   ## [my-ninja]
   
   ```repos
   https://github.com/org/repo1
   https://github.com/org/repo2
   

2. Register in ninjas.md:

   ```ninjas
   aws-ninja
   azure-ninja
   firecrawl-ninja
   my-ninja          # Add here
   

3. Sync repositories:

   ./sync-repos.sh my-ninja
   

4. Create the Ninja SKILL.md:

   mkdir -p ninjas/my-ninja
   # Create ninjas/my-ninja/SKILL.md with skill catalog
   # Use .skills-map to find available skills and their paths
   

5. Install:

   ./install-ninjas.sh my-ninja
   

📊 Status Commands

# Show all sync status
./sync-repos.sh --status

# Show all installation status
./install-ninjas.sh --status

# Count total skills
wc -l .skills-map

🤝 Contributing

Contributions are welcome! You can:

• 🐛 Report issues or suggest improvements
• 📝 Improve Ninja SKILL.md documentation
• ➕ Add new Ninjas for other platforms (GCP, DigitalOcean, etc.)
• 🔧 Improve sync/install scripts

Please read CONTRIBUTING.md before submitting PRs.

📄 License

This project is licensed under the MIT License — see LICENSE for details.

The source skill repositories have their own licenses:

• AWS repositories: Apache 2.0 / MIT-0
• Microsoft repositories: MIT
• Firecrawl repository: MIT

❓ FAQ

Context window efficiency. If you installed all 300+ skills directly, your AI agent would load all of them at startup, consuming your entire context window before you even ask a question.

Ninjas are Jump Skills — they load only metadata (~500 tokens), then load full skill instructions on-demand when needed. This means:

• ✅ 100x less context usage at startup
• ✅ Faster responses (less to process)
• ✅ More room for your actual conversation
• ✅ Always routes to the most specific skill for your task

Think of it like a library index vs. carrying all the books at once.

10+ agents including Claude Code, Kiro CLI, Cursor, Codex, OpenCode, VS Code Copilot, and more. The installer auto-detects available agents on your system.

All skills are from official repositories:

• AWS skills: aws/ and aws-samples/ orgs — written by AWS Solutions Architects
• Azure skills: microsoft/azure-skills — official Microsoft plugin
• Firecrawl skills: firecrawl/skills — official Firecrawl repository

Run ./sync-repos.sh weekly or before major projects to get the latest best practices and new skills.

Yes! See CONTRIBUTING.md for the full guide on adding new Ninjas for other platforms.

Yes, after initial ./sync-repos.sh. All skills are cloned locally to the repos/ directory.

Jump Skills is a meta-repository — it orchestrates skills from multiple external repos. The Ninja SKILL.md files contain paths like {{JUMP_SKILLS_DIR}}/repos/... that must be resolved to actual cloned repositories on your machine. This requires the full clone + sync workflow.

🙏 Acknowledgments

• AWS — For open-sourcing comprehensive agent skills
• Microsoft — For the Azure Skills plugin
• GitHub — For the awesome-copilot community collection
• Firecrawl — For web scraping skills
• Agent Skills Specification — Standard skill format
• skills.sh — Multi-agent installer inspiration
• Shields.io — Beautiful badges

👤 About

Fabricio Telles

Building tools for AI-assisted development

Made with 🥷 by Fabricio Telles