{"id":48555271,"url":"https://github.com/paradedb/agent-skills","last_synced_at":"2026-04-08T10:30:37.465Z","repository":{"id":337311911,"uuid":"1133827757","full_name":"paradedb/agent-skills","owner":"paradedb","description":"An AI agent skill that provides expert guidance on ParadeDB","archived":false,"fork":false,"pushed_at":"2026-03-18T15:58:08.000Z","size":32,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-01T09:57:31.871Z","etag":null,"topics":["agent","agents","analytics","llms","llms-txt","mcp","mcp-server","paradedb","postgres","postgresql","search","skills"],"latest_commit_sha":null,"homepage":"https://paradedb.com","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paradedb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["paradedb"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2026-01-13T21:47:30.000Z","updated_at":"2026-03-20T15:31:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/paradedb/agent-skills","commit_stats":null,"previous_names":["paradedb/agent-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/paradedb/agent-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradedb%2Fagent-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradedb%2Fagent-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradedb%2Fagent-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradedb%2Fagent-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paradedb","download_url":"https://codeload.github.com/paradedb/agent-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paradedb%2Fagent-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31551697,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T10:21:54.569Z","status":"ssl_error","status_checked_at":"2026-04-08T10:21:38.171Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agents","analytics","llms","llms-txt","mcp","mcp-server","paradedb","postgres","postgresql","search","skills"],"created_at":"2026-04-08T10:30:36.457Z","updated_at":"2026-04-08T10:30:37.450Z","avatar_url":"https://github.com/paradedb.png","language":null,"readme":"# ParadeDB Agent Skill\n\nAn AI agent skill for [ParadeDB](https://paradedb.com) - Elasticsearch-quality full-text search in Postgres.\n\nThis skill uses a pointer-based approach. Instead of bundling static docs that can become stale, it instructs agents to fetch current ParadeDB docs from [https://docs.paradedb.com/llms-full.txt](https://docs.paradedb.com/llms-full.txt) at runtime and reuse the first successful fetch for the rest of the session.\n\n\u003e [!NOTE]\n\u003e ParadeDB also supports MCP integrations. For setup instructions, use\n\u003e [https://docs.paradedb.com/welcome/ai-agents](https://docs.paradedb.com/welcome/ai-agents).\n\u003e The `/mcp` route is a protocol endpoint, not a human-readable docs page.\n\n## Installation\n\n### One-Line Install (Recommended)\n\n```bash\nnpx skills add paradedb/agent-skills\n```\n\n`npx skills add` is the most stable installation path because the installer keeps up with agent-specific directory conventions.\n\n### Sync Across Agents\n\n\u003e **Easiest way to sync across agents:** Use\n\u003e [dotagents](https://github.com/iannuttall/dotagents) to manage your skills in\n\u003e one place.\n\n### Manual Installation (Fallback)\n\nUse this path when `npx skills add` is unavailable.\n\n\u003e [!TIP]\n\u003e Directory conventions below were verified on **March 3, 2026**.\n\n| Agent       | Global directory                                      | Project directory                        |\n| ----------- | ----------------------------------------------------- | ---------------------------------------- |\n| Claude Code | `~/.claude/skills`                                    | `.claude/skills`                         |\n| OpenCode    | `~/.config/opencode/skills` (or `~/.opencode/skills`) | `.opencode/skills`                       |\n| Cursor      | `~/.cursor/skills`                                    | `.cursor/skills`                         |\n| Amp         | `~/.config/agents/skills`                             | `.agents/skills`                         |\n| Windsurf    | `~/.codeium/windsurf/skills`                          | `.windsurf/skills`                       |\n| Codex       | `$CODEX_HOME/skills`                                  | Set `CODEX_HOME` to a project-local path |\n\nInstall the skill in the directory that matches your agent:\n\n```bash\nSKILL_REF=\"main\"  # Replace with a tag or commit SHA to pin a specific version.\nTARGET_DIR=\"$HOME/.claude/skills/paradedb-skill\"  # Change for your agent.\n\nmkdir -p \"$TARGET_DIR\"\ncurl -fsSL \\\n  \"https://raw.githubusercontent.com/paradedb/agent-skills/${SKILL_REF}/SKILL.md\" \\\n  -o \"$TARGET_DIR/SKILL.md\"\ncurl -fsSL \\\n  \"https://raw.githubusercontent.com/paradedb/agent-skills/${SKILL_REF}/EXAMPLES.md\" \\\n  -o \"$TARGET_DIR/EXAMPLES.md\"\n```\n\nFor project-local installs, change `TARGET_DIR` to the corresponding project\ndirectory (for example, `.claude/skills/paradedb-skill`).\n\n### VS Code (GitHub Copilot) Repository Instructions\n\nGitHub Copilot supports repository-wide instructions via\n`.github/copilot-instructions.md`.\n\n```bash\nmkdir -p .github\ncurl -fsSL \\\n  https://raw.githubusercontent.com/paradedb/agent-skills/main/SKILL.md \\\n  | awk 'NR == 1 \u0026\u0026 $0 == \"---\" { in_frontmatter = 1; next } in_frontmatter \u0026\u0026 $0 == \"---\" { in_frontmatter = 0; next } !in_frontmatter { if (!started \u0026\u0026 $0 == \"\") { next } started = 1; print }' \\\n  \u003e .github/copilot-instructions.md\nprintf '\\n\\n' \u003e\u003e .github/copilot-instructions.md\ncurl -fsSL \\\n  https://raw.githubusercontent.com/paradedb/agent-skills/main/EXAMPLES.md \\\n  \u003e\u003e .github/copilot-instructions.md\n```\n\nThis keeps the file in the location Copilot looks for repository instructions\nand strips the YAML frontmatter from `SKILL.md` before appending the examples.\n\n## Usage\n\nOnce installed, the skill activates when you ask your AI agent about:\n\n- ParadeDB\n- BM25 indexing\n- Full-text search in Postgres\n- Elasticsearch alternatives for Postgres\n\nOn the first ParadeDB question in a session, the agent should fetch live docs\nbefore answering. After a successful fetch, it should reuse that session copy\nfor later ParadeDB questions and only refetch when the user asks for a refresh,\nthe answer depends on newer/current changes, the earlier fetch was incomplete,\nor the session context is no longer available.\n\nIf docs are unavailable due to network or access errors, the skill requires the\nagent to report the error. When a cached session copy exists, the agent should\nsay it can continue from that cached copy; otherwise it should ask whether to\ncontinue with local context only.\n\n### Example Prompts\n\nSee [EXAMPLES.md](EXAMPLES.md) for categorized prompt examples.\n\n## Links\n\n- [ParadeDB Documentation](https://docs.paradedb.com)\n- [ParadeDB AI Agents Guide](https://docs.paradedb.com/welcome/ai-agents)\n- [LLM-Optimized Docs](https://docs.paradedb.com/llms-full.txt)\n- [ParadeDB GitHub](https://github.com/paradedb/paradedb)\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n","funding_links":["https://github.com/sponsors/paradedb"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparadedb%2Fagent-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparadedb%2Fagent-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparadedb%2Fagent-skills/lists"}