Skillget

agent-skills

mcp
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 8 GitHub stars
Code Warn
  • Code scan incomplete — No supported source files were scanned during light audit
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool is an AI agent skill that provides expert guidance on ParadeDB by fetching up-to-date documentation to answer user queries regarding full-text search and BM25 indexing in Postgres.

Security Assessment
The tool relies on a shell script that uses `curl` to fetch markdown files directly from the official ParadeDB documentation. This is a safe, read-only network operation. It restricts the agent's network access to a specific endpoint rather than providing unrestricted internet access, which is an excellent security practice. There are no hardcoded secrets and no dangerous permissions are requested. Since the automated code scan was incomplete for the shell source files, manual review of the script is recommended to ensure the URL fetching logic hasn't been altered maliciously. Overall risk is rated as Low.

Quality Assessment
The project is extremely new and has low community visibility, currently sitting at only 8 GitHub stars. However, it is covered by a permissive MIT license and appears to be actively maintained (last pushed 0 days ago). The underlying organization (ParadeDB) is a known commercial entity, which provides some baseline of trust compared to anonymous authors.

Verdict
Safe to use, though the low community adoption means you should briefly inspect the bash script before running the installer.
SUMMARY

An AI agent skill that provides expert guidance on ParadeDB

README.md

ParadeDB Agent Skill

An AI agent skill for ParadeDB - Elasticsearch-quality full-text search in Postgres. Once installed, the skill activates when you ask your agent about:

  • ParadeDB
  • BM25 indexing
  • Full-text search in Postgres
  • Elasticsearch alternatives for Postgres

[!NOTE]
ParadeDB also supports MCP integrations. For setup instructions, use
https://docs.paradedb.com/welcome/ai-agents.
The /mcp route is a protocol endpoint, not a human-readable docs page.

Installation

One-Line Install (Recommended)

npx skills add paradedb/agent-skills

npx skills add is the most stable installation path because the installer keeps up with agent-specific directory conventions.

Manual Installation (Fallback)

Use this path when npx skills add is unavailable.

[!TIP]
Directory conventions below were verified on March 3, 2026.

Agent Global directory Project directory
Claude Code ~/.claude/skills .claude/skills
OpenCode ~/.config/opencode/skills (or ~/.opencode/skills) .opencode/skills
Cursor ~/.cursor/skills .cursor/skills
Amp ~/.config/agents/skills .agents/skills
Windsurf ~/.codeium/windsurf/skills .windsurf/skills
Codex $CODEX_HOME/skills Set CODEX_HOME to a project-local path

Install the skill in the directory that matches your agent. For example, for Claude:

TARGET_DIR="$HOME/.claude/skills/paradedb-skill"

mkdir -p "$TARGET_DIR"
curl -fsSL \
  "https://github.com/paradedb/agent-skills/archive/main.tar.gz" \
  | tar -xzf - -C "$TARGET_DIR" --strip-components=1
chmod +x "$TARGET_DIR/scripts/paradedb-docs"

For project-local installs, change TARGET_DIR to the corresponding project
directory (for example, .claude/skills/paradedb-skill).

Implementation

Instead of bundling static docs that can become stale, this skill instructs agents to fetch the latest ParadeDB docs to answer your questions.
The skill includes a tiny script called scripts/paradedb-docs that allows the agent to fetch only the documentation using curl. This approach ensures the agent sees the
full content of docs instead of a summarized view and makes it easy to allow the agent to fetch the docs freely without also granting it unrestricted access to curl.

This is the script:

#!/bin/bash

set -euo pipefail

DOC_PATH=$1

if [[ "$DOC_PATH" != *.md && "$DOC_PATH" != *.txt ]]; then
  echo "Error: doc path must end in .md or .txt" >&2
  exit 1
fi

curl -fsSL "https://docs.paradedb.com/$DOC_PATH"

Example Prompts

See EXAMPLES.md for categorized prompt examples.

Links

License

MIT License. See LICENSE for details.

Reviews (0)

No results found