Skip to content

Commit d722995

Browse files
wd041216-bitwd041216-bit
committed
docs: add Claude Code and Manus skill surfaces
1 parent e7f4ef5 commit d722995

5 files changed

Lines changed: 147 additions & 2 deletions

File tree

‎.claude/skills/cross-validated-search/SKILL.md‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
name: cross-validated-search
3+
description: >
4+
Claude Code-compatible skill for source-backed web search, page reading, and evidence-aware claim checking.
5+
Use it when an answer depends on current facts, live sources, or explicit support/conflict handling.
6+
version: "16.0.0"
7+
---
8+
9+
# Cross-Validated Search for Claude Code
10+
11+
Use this skill when Claude Code needs current information, supporting citations, or a compact evidence report before answering.
12+
13+
## Install
14+
15+
```bash
16+
pip install cross-validated-search
17+
```
18+
19+
## Core Commands
20+
21+
```bash
22+
search-web "latest Python release" --type news --timelimit w
23+
browse-page "https://docs.python.org/3/whatsnew/"
24+
verify-claim "Python 3.13 is the latest stable release" --deep --max-pages 2 --json
25+
evidence-report "Python 3.13 stable release" --claim "Python 3.13 is the latest stable release" --deep --json
26+
```
27+
28+
## When to Use
29+
30+
- time-sensitive questions about releases, dates, people, or statistics
31+
- factual claims that should be checked before being stated confidently
32+
- workflows where conflicting evidence should be surfaced instead of hidden
33+
- research tasks that benefit from one citation-ready artifact
34+
35+
## Guidance
36+
37+
- Start with `search-web` for live facts and recent changes.
38+
- Use `browse-page` when snippets are too thin to justify an answer.
39+
- Use `verify-claim` for support/conflict classification.
40+
- Use `evidence-report` when you want one compact output with verdict, citations, and next steps.
41+
- Prefer the free `ddgs + self-hosted searxng` path for stronger provider diversity.
42+
43+
## Limits
44+
45+
- `verify-claim` is heuristic and evidence-aware, not a proof engine.
46+
- The default path still starts with `ddgs`.
47+
- Deep verification is stronger than snippets alone, but still not full-document reasoning.
48+
49+
## License
50+
51+
MIT License.

‎README.md‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<img src="assets/banner.svg" alt="Cross-Validated Search" width="100%"/>
33
<h1>Cross-Validated Search</h1>
44
<p><strong>Evidence-aware web search, browsing, and claim verification for AI agents.</strong></p>
5-
<p><em>CLI + MCP + skill surfaces for Gemini, OpenClaw, and other agent runtimes.</em></p>
5+
<p><em>CLI + MCP + skill surfaces for Gemini, Claude Code, OpenClaw, Manus, and other agent runtimes.</em></p>
66

77
[![PyPI package](https://img.shields.io/pypi/v/cross-validated-search?label=pypi%20package)](https://pypi.org/project/cross-validated-search/)
88
[![Python Version](https://img.shields.io/pypi/pyversions/cross-validated-search)](https://python.org)
@@ -29,6 +29,8 @@ If you are reviewing this repo for collection or ecosystem inclusion, the fastes
2929
[docs/searxng-self-hosted.md](docs/searxng-self-hosted.md)
3030
4. review Gemini gallery readiness:
3131
[docs/gemini-submission-checklist.md](docs/gemini-submission-checklist.md)
32+
5. review Claude Code and Manus setup notes:
33+
[docs/claude-code.md](docs/claude-code.md), [docs/manus.md](docs/manus.md)
3234

3335
## 60-second verification
3436

@@ -178,7 +180,9 @@ Python 3.10+ is required.
178180
| MCP | Yes | `cross-validated-search-mcp` |
179181
| Gemini CLI | Yes | `gemini-extension.json`, root `skills/`, and `.gemini/SKILL.md` |
180182
| OpenClaw | Yes | `cross_validated_search/skills/SKILL.md` |
181-
| Claude Code / Cursor / Continue / Copilot | Yes | Bundled skill and instruction files |
183+
| Claude Code | Yes | `.claude/skills/cross-validated-search/SKILL.md` |
184+
| Cursor / Continue / Copilot | Yes | Bundled instruction and skill files |
185+
| Manus | Yes | Root `SKILL.md` plus [docs/manus.md](docs/manus.md) |
182186

183187
## Verification model
184188

‎SKILL.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ platforms:
1010
- cursor
1111
- copilot
1212
- gemini
13+
- manus
1314
- continue
1415
- kiro
1516
- opencode
@@ -29,6 +30,9 @@ Use this skill when a task needs live search results, source-backed verification
2930
pip install cross-validated-search
3031
```
3132

33+
For Claude Code, the repository also ships `.claude/skills/cross-validated-search/SKILL.md`.
34+
For Manus-style Agent Skills workflows, use this root `SKILL.md` plus [docs/manus.md](docs/manus.md).
35+
3236
## Core Commands
3337

3438
```bash

‎docs/claude-code.md‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# Claude Code Setup
2+
3+
`cross-validated-search` can be used from Claude Code in two complementary ways:
4+
5+
1. install the Python package so the CLI and MCP surfaces are available
6+
2. place or symlink the bundled skill from `.claude/skills/cross-validated-search/SKILL.md`
7+
8+
## Install the package
9+
10+
```bash
11+
pip install cross-validated-search
12+
```
13+
14+
## Use the bundled Claude skill
15+
16+
From the repository root, copy or symlink:
17+
18+
```bash
19+
mkdir -p ~/.claude/skills
20+
ln -s "$(pwd)/.claude/skills/cross-validated-search" ~/.claude/skills/cross-validated-search
21+
```
22+
23+
If you prefer not to symlink, copy the `cross-validated-search` folder into your Claude skill directory.
24+
25+
## Recommended workflow
26+
27+
Use the skill when Claude Code should:
28+
29+
- search before answering a factual or time-sensitive question
30+
- show supporting and conflicting evidence explicitly
31+
- browse a full page when snippets are not enough
32+
- generate one compact report with verdict, citations, and next steps
33+
34+
Typical flow:
35+
36+
```bash
37+
search-web "latest Python release" --type news --timelimit w
38+
verify-claim "Python 3.13 is the latest stable release" --deep --json
39+
evidence-report "Python 3.13 stable release" --claim "Python 3.13 is the latest stable release" --deep --json
40+
```
41+
42+
## Free stronger setup
43+
44+
For the strongest free path, pair `ddgs` with self-hosted SearXNG:
45+
46+
```bash
47+
./scripts/start-searxng.sh
48+
export CROSS_VALIDATED_SEARCH_SEARXNG_URL="http://127.0.0.1:8080"
49+
```
50+
51+
Then rerun `verify-claim` or `evidence-report` with `--deep`.

‎docs/manus.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Manus Setup
2+
3+
`cross-validated-search` is compatible with Manus-style Agent Skills and CLI-first workflows.
4+
5+
## Install
6+
7+
```bash
8+
pip install cross-validated-search
9+
```
10+
11+
## Skill surface
12+
13+
Use the repository root [SKILL.md](../SKILL.md) as the canonical skill definition.
14+
15+
The skill is designed for tasks where an agent should:
16+
17+
- search before answering recent or factual questions
18+
- verify claims with supporting and conflicting evidence
19+
- browse full pages when snippets are too thin
20+
- produce citation-ready evidence summaries
21+
22+
## Suggested workflow
23+
24+
```bash
25+
search-web "latest Python release" --type news --timelimit w
26+
browse-page "https://docs.python.org/3/whatsnew/"
27+
verify-claim "Python 3.13 is the latest stable release" --deep --json
28+
evidence-report "Python 3.13 stable release" --claim "Python 3.13 is the latest stable release" --deep --json
29+
```
30+
31+
## Notes
32+
33+
- `verify-claim` is heuristic and evidence-aware, not a proof engine.
34+
- The default provider path starts with `ddgs`.
35+
- For stronger free evidence diversity, configure self-hosted SearXNG via `CROSS_VALIDATED_SEARCH_SEARXNG_URL`.

0 commit comments

Comments
 (0)