Cursor Skills Installer

Cursor Skills Installer

Skill pro instalaci a aktualizaci Cursor skills z GitHub repozitáře. Skills se instalují do ~/.cursor/skills/ (nebo do $CURSOR_SKILLS_HOME, pokud je nastaveno).

Kdy použít

• Uživatel chce nainstalovat nebo aktualizovat skills z vlastního GitHub repa
• Vypsat dostupné skills v repu (z manifest.json nebo ze složky skills/)
• Přidat nový skill do repa a pushnout změny

Výchozí repo

Pokud uživatel neřekne jinak, používej repo ddanielrrakowski/cursor-skills (branch main). Uživatel může zadat jiné repo ve tvaru owner/repo.

Instalace / aktualizace

Spusť skript z adresáře tohoto skillu (nebo s cestou ke skriptu):

# Nainstalovat všechny skills z výchozího repa
"$HOME/.cursor/skills/cursor-skills-installer/scripts/install-from-repo.sh"

# Z konkrétního repa (owner/repo)
"$HOME/.cursor/skills/cursor-skills-installer/scripts/install-from-repo.sh" --repo owner/repo

# Konkrétní branch nebo tag
"$HOME/.cursor/skills/cursor-skills-installer/scripts/install-from-repo.sh" --ref develop

# Jen vybrané skills
"$HOME/.cursor/skills/cursor-skills-installer/scripts/install-from-repo.sh" mjml-email maileroo

Parametry:

• --repo owner/repo – GitHub repozitář (výchozí: ddanielrrakowski/cursor-skills)
• --ref branch|tag – větev nebo tag (výchozí: main)
• --list – pouze vypsat skills v repu (nestahovat, neinstalovat)
• skill1 skill2 ... – nainstalovat jen tyto složky ze skills/; bez argumentů = všechny

Po instalaci doporuč uživateli restart Cursoru (nebo znovu otevřít projekt), aby se načetly nové skills.

Výpis dostupných skills

• Spusť skript s --list a předaným --repo, nebo
• V repu je soubor manifest.json v kořeni – obsahuje pole skills s id, name, description. Můžeš ho přečíst z GitHub API nebo po naklonování.

Struktura očekávaného repa

Repo musí mít složku skills/ a v ní podadresáře, každý s souborem SKILL.md:

repo/
├── skills/
│   ├── mjml-email/
│   │   └── SKILL.md
│   └── maileroo/
│       └── SKILL.md
└── manifest.json   # volitelně

Skript stáhne repo (zip), rozbalí ho a zkopíruje každou složku z skills/* do ~/.cursor/skills/<jméno>/. Existující složky se přepíší (aktualizace).

Soukromé repo

Pro soukromé repozitáře musí být na stroji dostupné buď:

• GitHub CLI (gh) v přihlášeném stavu, nebo
• git s nakonfigurovaným přístupem (HTTPS + token, nebo SSH klíč).

Skript nejdřív zkusí stáhnout zip (funguje pro veřejné repo). Při 401/403/404 zkusí git clone --depth 1 do tempu a kopírovat ze něj.