← Back to Skills Marketplace
225
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install jail-search
Description
Search a billion+ documents — papers, books, code, legal cases, forums, Wikipedia, and more.
README (SKILL.md)
JAIL Search
Search documents. Returns ranked results with title, author, year, description, url, id, score — not full content. Use URLs from results with fetch/browsing to read actual documents.
Use when: user asks to research, find papers/books/articles, look up facts, find discussions, legal cases, or any "search for..." request.
Strategy: use 2-4 keywords per query (English preferred). Pick the right type first. Try synonyms if few results. Search across multiple types to cross-reference. Use detail() for full metadata on promising results.
Types
| Type | Content |
|---|---|
academic |
OpenAlex/arXiv/Semantic Scholar/DBLP |
wiki |
Wikipedia 18 languages |
books |
books/digital libraries |
legal |
Case Law/CourtListener/EUR-Lex |
forums |
HN/StackExchange/Lobsters/LessWrong/60+ |
economics |
World Bank/IMF/FRED |
packages |
npm/PyPI/Crates.io |
knowledge |
Wikidata |
news |
news articles |
music |
Discogs/MusicBrainz |
video |
IMDb/YouTube |
health |
clinical trials |
geo |
world places |
fandom |
fan wikis |
tech |
Dev.to |
audio |
podcasts |
social |
Reddit/Mastodon/Lemmy |
crypto |
DeFi/tokens |
predictions |
prediction markets |
Search
curl -Gs "https://api.jail.li/v1/search" --data-urlencode "q=QUERY" -d "type=TYPE&limit=10"
Paginate: add &cursor=CURSOR using next_cursor from previous response.
Detail
curl -s "https://api.jail.li/v1/detail/DOC_ID"
With API key: add -H "Authorization: Bearer $JAIL_API_KEY"
Usage Guidance
This skill sends your queries to a third-party API (api.jail.li) and may fetch URLs returned by that API to read documents. If you plan to use it, don’t include secrets or private data in queries. If you have an API key, supply it only if you trust the jail.li service and understand their privacy/data-retention policy. The skill owner is not clearly identified in the registry metadata—consider verifying the homepage (https://jail.li) and the service’s terms before installing.
Capability Analysis
Type: OpenClaw Skill
Name: jail-search
Version: 1.4.1
The skill is a search tool for the jail.li API, allowing an AI agent to query various document types including academic papers, legal cases, and forums. It uses standard curl commands for API interaction and includes clear instructions for the agent that are consistent with its stated purpose, with no evidence of malicious intent, data exfiltration, or suspicious execution patterns.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description (search a large corpus) match the instructions which call https://api.jail.li endpoints. Required binary (curl) is appropriate and the only declared optional environment variable (JAIL_API_KEY) makes sense for authenticated API access. Minor note: SKILL.md mentions using detail() for full metadata but does not define that helper — likely an implementation detail of the agent.
Instruction Scope
SKILL.md only instructs the agent to issue HTTP requests to api.jail.li (search and detail endpoints) and to follow returned URLs to fetch documents. It does not instruct reading local files, unrelated env vars, or system credentials.
Install Mechanism
No install spec and no code files — instruction-only skill. This is the lowest-risk install model and consistent with the documented use of curl.
Credentials
No required credentials are declared. JAIL_API_KEY is optional and appropriate for authenticated API use. There are no unrelated or excessive environment or config requirements.
Persistence & Privilege
always is false and the skill does not request elevated or persistent system privileges, nor does it attempt to modify other skills or system configuration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install jail-search - After installation, invoke the skill by name or use
/jail-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.4.1
- SKILL.md rewritten for greater conciseness and clarity.
- Usage instructions streamlined and redundant sections removed.
- Type/content table simplified for easier reference.
- MCP-related setup and advanced usage instructions removed; now focuses on curl-based usage.
- Search tips and key parameters retained in a shorter, bulleted format.
v1.4.0
- Added Reddit to the list of supported `social` content sources.
- Updated the documentation in SKILL.md to reflect this expanded coverage.
- No changes to functionality or API; this is a documentation update.
v1.3.0
- Simplified and condensed documentation for easier reading and quicker onboarding
- Merged and trimmed usage, strategy, and response field sections
- Reduced repeated content in the introduction and when-to-use guidance
- Clarified core concepts; now emphasizes using URLs to fetch full documents
- No changes to search functionality or API endpoints
v1.2.0
- Added setup instructions for connecting to the hosted MCP server, including using an API key for higher limits.
- Expanded API key usage guidance for both MCP and curl modes.
- Minor improvements to documentation clarity and consistency.
- Updated description and phrasing to emphasize coverage of code and billion+ documents.
- No changes to API endpoints or behavior.
v1.1.3
- Expanded coverage to 1.7 billion documents and 19 content types
- Added preferred use of MCP interface for search and detail queries
- Metadata updated with research tags and new category
- Added a dedicated “Response fields” section describing output format
- Improved and reorganized documentation for clarity and completeness
- Extended use cases to include more content types such as music, movies, and packages
v1.1.0
- Added detailed documentation and usage instructions for JAIL Search, including API examples.
- Specified content types supported (academic, wiki, books, legal, forums, and others).
- Clarified API request formats for searching and fetching details.
- Explained when and how to use the skill for research, fact-finding, and discovery.
- Included usage tips (type selection, pagination, cross-referencing).
- Outlined available data sources for each type.
Metadata
Frequently Asked Questions
What is Skills?
Search a billion+ documents — papers, books, code, legal cases, forums, Wikipedia, and more. It is an AI Agent Skill for Claude Code / OpenClaw, with 225 downloads so far.
How do I install Skills?
Run "/install jail-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Skills free?
Yes, Skills is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Skills support?
Skills is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Skills?
It is built and maintained by mefengl (@mefengl); the current version is v1.4.1.
More Skills