modsearch SKILL.md skillA

modsearch from liustack/modsearch is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add liustack/modsearch/modsearch@git:20261028.d5582ce

Pins git:20261028.d5582ce in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
liustack/modsearch
Path
skills/modsearch/SKILL.md
Versions recorded
17
Latest version
git:20261028.d5582ce, committed Oct 28, 2026
First version recorded
Aug 22, 2026
Size
10,843 bytes
Repository stars
931
License
MIT

Plug-in web search, X (Twitter) search, and page fetch for models without native web access. Use whenever the task needs current information, external facts, source links, posts from X, or the content of a specific URL, and the active model/harness has no native search or fetch tool. Runs the modsearch CLI to return structured JSON evidence. Also use when the user asks how to install or configure modsearch, or wants to switch engines or add a key.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# ModSearch — Search & Fetch Bridge Skill

Use this skill when:

- The user asks about anything after your knowledge cutoff (releases, news, prices, versions)
- The answer needs source links or verifiable external facts
- The user asks what people are saying on X or Twitter (推特, 推文, tweets, threads)
- The user gives a URL to read and the harness has no fetch tool
- The user asks how to configure modsearch, add a key, or change engines

Do not use this skill for:

- Analyzing images (that is `modlens`)
- Questions your own knowledge answers reliably and time does not affect
- Searching inside DeepSeek Harness (dsh, `DSH_SHELL=1`): there modsearch runs as
  a plugin behind the native `web_search`. If dsh still answers from its default
  provider, the plugin is missing: point the user to Step 0 of INSTALL.md

## Prerequisites

Run every modsearch command through the launcher bundled with this skill.
Replace `<skill-dir>` with the directory this SKILL.md lives in:

```bash
bash <skill-dir>/scripts/run.sh -q "test"                                       # macOS / Linux
powershell -ExecutionPolicy Bypass -File <skill-dir>\scripts\run.ps1 -q "test"  # Windows
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add liustack/modsearch/modsearch@sha256:82193b37ea549b99

The line at the top of this page pins the label git:20261028.d5582ce, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_odbxjbtibuav5xqm.svg)](https://markdownregistry.com/a/art_odbxjbtibuav5xqm)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 17 versions of this file, between Aug 22, 2026 and Oct 28, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20261028.d5582ce latest2026-10-28 d5582ce 10,843 BA view · diff
git:20261028.9f404972026-10-28 9f40497 10,843 BA view · diff
git:20261018.df0cf762026-10-18 df0cf76 10,755 BA view · diff
git:20261018.b1bcd692026-10-18 b1bcd69 10,751 BA view · diff
git:20261018.ec88c6a2026-10-18 ec88c6a 10,751 BA view · diff
git:20261018.b4f36892026-10-18 b4f3689 10,751 BA view · diff
git:20261015.0c41faf2026-10-15 0c41faf 10,514 BA view · diff
git:20261015.5a48b682026-10-15 5a48b68 10,514 BA view · diff
git:20261004.beb34982026-10-04 beb3498 10,364 BA view · diff
git:20260924.4529da62026-09-24 4529da6 10,364 BA view · diff
git:20260922.52437bf2026-09-22 52437bf 10,364 BA view · diff
git:20260915.22acb7a2026-09-15 22acb7a 10,364 BA view · diff
git:20260907.7c164512026-09-07 7c16451 10,364 BA view · diff
git:20260903.d5097a72026-09-03 d5097a7 10,364 BA view · diff
git:20260827.81ed4d12026-08-27 81ed4d1 10,364 BA view · diff
git:20260824.1492d7b2026-08-24 1492d7b 10,360 BA view · diff
git:20260822.7be93eb2026-08-22 7be93eb 10,360 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10843 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

liustack/modsearch · 931 stars · license MIT · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_odbxjbtibuav5xqm
GET https://markdownregistry.com/api/v1/resolve?ref=liustack/modsearch/modsearch
GET https://markdownregistry.com/api/v1/blob/82193b37ea549b99fe3f6ddd7b35257f9dadd471bbc2ec078dba10a467173117

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from liustack/modsearch

AGENTS.md AGENTS.md file
liustack/modsearch · AGENTS.md
git:20261028.9f40497 · audit A · 931 stars

Every file in liustack/modsearch

Browse by kind, by grade A, or by owner.