# Sigildex — Skill Discovery for Claude Code

> Add this to your project's CLAUDE.md or `.claude/CLAUDE.md` to teach Claude Code how to find and install skills via Sigildex.

## MCP Setup

Add Sigildex to your MCP config (`.claude/mcp.json` or Claude Code settings):

```json
{
  "mcpServers": {
    "sigildex": {
      "url": "https://sigildex.ai/mcp"
    }
  }
}
```

## Available Tools

Once connected, you have two MCP tools:

### discover_skills
Search 78K+ agent skills by natural language query. Returns ranked results with relevance scores, trust signals (stars, installs, publisher info), and install commands.

```
Use discover_skills when:
- The user needs a capability you don't have
- The user asks "find a skill for X" or "is there a skill for X"
- You need to compare available skills for a task
```

### inspect_skill
Get the full SKILL.md content for a specific skill. Use the `skill_id` from discover results. Pass the `query_id` from discover for a free inspect (1-hour TTL).

```
Use inspect_skill when:
- You found a promising skill via discover and need the full instructions
- The user wants to see what a skill does before installing
```

## Typical workflow

1. User asks for a capability → call `discover_skills` with a natural language query
2. Review results → pick the best match based on score and signals
3. Call `inspect_skill` with the skill_id (and query_id for free access)
4. Follow the install instructions in the SKILL.md content

## Pricing

- 5 free queries/day per IP — no setup needed
- After that: $0.002/query via x402 (USDC on Base)
- `/inspect` is free when using a `query_id` from a paid `/discover`

## REST API (alternative to MCP)

If MCP is not available, use the REST API directly:

```bash
# Search for skills
curl -X POST https://sigildex.ai/discover \
  -H "Content-Type: application/json" \
  -d '{"query": "your search query", "limit": 5}'

# Get full skill content
curl -X POST https://sigildex.ai/inspect \
  -H "Content-Type: application/json" \
  -d '{"skill_id": "<id>", "query_id": "<query_id>"}'
```