/ Directorio / Playground / Skyll
● Comunidad assafelovic ⚡ Instantáneo

Skyll

por assafelovic · assafelovic/skyll

Skyll is the 'npm search' for Claude skills — your agent asks 'do we have a skill for X?' and Skyll returns ranked matches with full SKILL.md content.

Skyll aggregates Claude skills (SKILL.md files) from across the ecosystem into a searchable index, exposed as both a REST API and an MCP server. Your agent calls search_skills('redact PII from PDFs') and gets ranked results with the skill content inline — no pre-installation, no URL guessing. Use the hosted api.skyll.app (no setup) or self-host via pip. The big idea: agents shouldn't have to pre-load every skill they might need.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

skyll-skill.replay ▶ listo
0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "skyll-skill": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.skyll.app/mcp"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "skyll-skill": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.skyll.app/mcp"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "skyll-skill": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.skyll.app/mcp"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "skyll-skill": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.skyll.app/mcp"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "skyll-skill",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.skyll.app/mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "skyll-skill": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://api.skyll.app/mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add skyll-skill -- npx -y mcp-remote https://api.skyll.app/mcp

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Skyll

Let Claude find the right skill mid-task, without you pre-installing

👤 Anyone running Claude Code or Claude Desktop with a shifting set of tasks ⏱ ~5 min beginner

Cuándo usarlo: You ask Claude to do something niche (generate invoices, migrate Redux to Zustand, do a legal review) and you don't know which skill exists for it.

Requisitos previos
  • Skyll MCP configured — Paste the config block above into your client's MCP settings — uses the hosted endpoint by default
Flujo
  1. Ask naturally
    I need to produce an investor deck from a one-pager. Use Skyll to find a skill that does this, and apply it.✓ Copiado
    → Agent calls search_skills, picks the best match (e.g. interactive-slides), and executes its instructions
  2. Verify before running
    Before applying, show me the top 3 Skyll matches with their relevance scores, so I can pick.✓ Copiado
    → 3-row ranked list with short descriptions

Resultado: Agents reach for the right skill by name when it exists — you stop re-building wheels by hand.

Errores comunes
  • Low-quality skill ranks #1 because of keyword match — Require the agent to show top-3 + scores; pick manually on first use
  • Skill content is trusted blindly — Skyll returns SKILL.md; review it like any other prompt before granting tool access
Combinar con: filesystem

Browse and curate a personal skill library

👤 DevRel, team leads standardizing tools ⏱ ~30 min intermediate

Cuándo usarlo: You want to maintain an approved list of skills your team should use — not random ones pulled at runtime.

Flujo
  1. Explore the index
    Using Skyll, show me every skill tagged 'code-review' with ≥50 stars. Group by use case.✓ Copiado
    → Ranked groups: PR review / inline review / static-analysis review
  2. Pick a short list
    From that list, pick 3 you'd ship to a team of 10 engineers. Why each?✓ Copiado
    → 3 picks with trade-off reasoning
  3. Lock them in
    Export the 3 SKILL.md files to /ops/approved-skills/ so our onboarding can use fixed versions.✓ Copiado
    → 3 files on disk; version string captured

Resultado: Team gets a vetted, versioned skill set — no Wild West installs.

Errores comunes
  • Upstream skill updates break your workflow — Pin SHA/version when exporting; re-evaluate on a cadence, not automatically
Combinar con: filesystem

Give an autonomous agent skill-discovery as a first-class primitive

👤 Builders of long-running agents (OpenClaw, custom harnesses) ⏱ ~60 min advanced

Cuándo usarlo: Your agent takes multi-step jobs and shouldn't hit 'I don't know how' when the answer is a one-file skill away.

Requisitos previos
  • Agent harness that supports MCP — Most Anthropic-ecosystem agents already do
Flujo
  1. Add skill discovery to the planner
    Update the planner: when a subtask has 'no matching local tool', call Skyll.search_skills first before giving up.✓ Copiado
    → Planner gains a new branch: local tool → Skyll → web search
  2. Cap the scope
    Require every Skyll-fetched skill be reviewed by the supervisor agent before execution. Log the SKILL.md hash.✓ Copiado
    → Audit trail of every runtime-discovered skill

Resultado: Agent gracefully expands its capability set without you pre-loading 500 skills.

Errores comunes
  • Prompt injection via skill content — Treat SKILL.md as untrusted input; sanitize or review before invoking; never auto-approve shell/write tools from a discovered skill
Combinar con: sequential-thinking

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

skyll-skill + filesystem

Write discovered skills to ~/.claude/skills/ for persistent availability

Search Skyll for 'changelog generator'. If the top match is ≥80 score, save its content to ~/.claude/skills/changelog/SKILL.md.✓ Copiado
skyll-skill + sequential-thinking

Multi-step plans that call Skyll only when local tools aren't enough

Plan the task; at each step, decide: local tool, Skyll skill, or web fetch. Execute.✓ Copiado
skyll-skill + memory

Remember which Skyll-discovered skills actually worked for similar tasks

When a Skyll skill succeeds, save to memory under 'skills.working.<tag>'. Next time, prefer saved ones.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
search_skills query: str, limit?: int Primary — natural-language lookup over the skill index free
get_skill source: str, id: str Fetch the full SKILL.md for a candidate you want to use free
add_skill name: str (or full path) Shorthand: search + get in one call free
get_cache_stats none Debug cold-lookup latency; mostly operational free

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Hosted endpoint is free for reasonable use; self-host for heavy use
Tokens por llamada
200–2000 — Skyll returns focused content, not full repo dumps
Monetario
Free
Consejo
Self-host via pip install skyll when you're hammering search; hosted is fine for one-at-a-time use

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: None for hosted use; self-host uses standard env vars
Salida de datos: Queries go to api.skyll.app (hosted) — natural-language search text only
No conceder nunca: Auto-execute shell commands from a Skyll-discovered SKILL.md without review

Resolución de problemas

Errores comunes y soluciones

Top result looks irrelevant

Try a more specific query; the free-text index favors keyword-dense phrasing. 'extract PII from PDF files' beats 'handle privacy'.

Verificar: Compare score field across queries
Hosted endpoint slow

Self-host: pip install skyll && python -m src.mcp_server. Then point the MCP config at http://localhost:8080.

Verificar: Check tavily-free endpoint at https://api.skyll.app/health
mcp-remote: connection refused

mcp-remote needs the SSE URL reachable. Test with curl https://api.skyll.app/mcp/sse first.

Verificar: curl -v https://api.skyll.app/mcp/sse

Alternativas

Skyll vs otros

AlternativaCuándo usarlaContrapartida
awesome-claude-skills (list)You want to browse skills by category, not query at runtimeHuman-curated list — lower coverage, higher signal
pre-install every skillYou know your exact workflow and want deterministic behaviorSkill drift and token bloat if you install 100+ just-in-case
web search + filesystem writeYou want a general web search, not skill-specific indexingNo relevance scoring against SKILL.md format; more hallucination risk

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills