← Back to SkillSea

Documentation

Learn how to install and use SkillSea for AI skill management with Claude Code and MCP-compatible assistants.

Quick Install

macOS / Linux

curl -fsSL https://probecodex.com/downloads/skillsea/install.sh | bash

Windows (PowerShell)

irm https://probecodex.com/install.ps1 | iex

Then follow the Getting Started guide to set up hooks and sync your first skills. See the Download page for all platforms and options.

Guides & Reference

What is SkillSea?

SkillSea is an MCP (Model Context Protocol) server that provides intelligent skill management for AI assistants. It uses Neo4j graph database with multiple search strategies to help your AI find and load the right skills automatically.

  • Smart Search - Fast keyword and name matching (default)
  • Semantic Search - Find skills by meaning using local AI embeddings
  • Text2Cypher - Natural language converted to Neo4j Cypher queries for graph traversal
  • Fulltext Search - Direct Lucene index lookups for fastest results
  • Neo4j-Powered - Graph database for skill relationships and discovery
  • MCP Integration - Works with Claude Code and any MCP-compatible AI
  • Dynamic Loading - Skills sync automatically based on context
  • Security Scanning - Skills are scanned for malicious patterns before use

Product Documentation

Troubleshooting

Connection Failed

If you see "Connection refused" errors:

  • Check that Neo4j is running and accessible
  • Verify your NEO4J_URI, NEO4J_USERNAME, and NEO4J_PASSWORD are correct
  • For Neo4j Aura, ensure you're using the correct connection string format

Semantic Search Slow

First semantic search may be slow while loading the model:

  • Use skillsea hook status --warmup to preload the embedding model
  • Or start the server with --preload-embeddings

Skills Not Syncing

If skills aren't appearing in your workspace:

  • Verify hooks are installed: skillsea hook status
  • Check that the .claude/skills directory exists
  • Try running skillsea hook clear then restart Claude Code

Command Not Found

If skillsea is not found after install:

  • Restart your terminal or run source ~/.zshrc
  • Check the binary is in your PATH: which skillsea
  • See Installation Guide for platform-specific details

Need Help?

Our team is here to help you get the most out of SkillSea.