sandbase-skills

一句话定位

这个插件把 88 个 SandBase Agent Skill 一次性注入到 DeepSeek Harness，覆盖调研、社媒情报、营销和商业工作流，让你无需挨个编写就能让 Agent 学会特定任务的执行流程。

核心能力

• 通过 DSH 文件系统 Skill 提供方同时挂载 marketing/ 和 research/ 两个目录，保留默认 Skill 根目录
• 提供 multi-source-search 旗舰调研 Skill，使用 Agent 自带的搜索/网页读取工具即可跑，无需额外账号
• 配套 Python 离线校验器，可对调研报告的证据账本做一致性检查（来源唯一、置信度合理、引用不遗漏）
• 88 个 Skill 按领域分组：社媒情报 14 个、搜索与调研 17 个、商业情报 20 个、营销与内容 15 个、SEO 5 个、工具 17 个
• 内置 CLI sandbase-dsh-skills，可按需把单个 Skill 复制到项目的 .dsh/skills/<name>/ 目录，或反向移除
• 通用 Skill 默认走宿主 Agent 已有能力，专业 Skill 可按需接入 SandBase MCP 工具（如 Tavily、Exa、Scholar、Cloudsway）扩展数据源

技术实现

• 语言: JavaScript（Node.js ESM）+ Python（离线校验脚本）
• 关键依赖: @deepseek-ai/dsh-skill-filesystem（DSH 文件系统 Skill 提供方）、Node 20+ 内置 node:fs/promises / node:url（安装器）、Python 3.9+（multi-source-search 离线校验器）
• 架构模式: 通过 package.json 中 dsh.bundle.patch 指向的 Cordis patch 文件，向 DSH 注册 @deepseek-ai/dsh-skill-filesystem 服务，把包内的 marketing/ 与 research/ 目录作为额外 Skill 根目录挂载；同时暴露一个独立的 Node CLI 用于单 Skill 的复制/移除
• 入口文件: dsh/cordis.patch.yml（DSH 注入入口）、bin/sandbase-dsh-skills.mjs（CLI 入口）、lib/dsh-installer.mjs（安装/卸载库）、各 Skill 目录下的 SKILL.md

适用场景

适合做市场调研、竞品监控、内容选题或跨平台数据采集的 DSH 用户。当你想让 Agent 立刻具备"先多源检索、再交叉验证、最后输出证据账本"这类规范工作流，而自己又不想从零撰写提示词时，安装这个插件后只需对 Agent 说"用 multi-source-search 验证这个说法"即可。

前置依赖与兼容性

安装方式

dsh plugin --profile web add github:sandbaseai/sandbase-skills

配置项

本插件无需额外配置。cordis.patch.yml 已经硬编码把 marketing/ 和 research/ 两个目录挂载为额外 Skill 根目录，DSH 启动时自动生效；可选的环境变量只有 Skill 内部按需读取的 SANDBASE_API_KEY：

常见问题

Q: 安装后还需要 SandBase 账号吗？

A: 不需要。旗舰 Skill multi-source-search 直接复用 Agent 自带的搜索与网页读取工具就能跑；只有当你主动启用 SandBase 提供方（Tavily、Exa、Scholar、Cloudsway）时才需要设置 SANDBASE_API_KEY。

Q: 这个插件和 DSH 官方 Skill 是什么关系？

A: 互不影响。cordis.patch.yml 在保留 DSH 默认 Skill 根目录的前提下，额外挂载本包自带的 marketing/ 和 research/ 两个目录为新的 Skill 来源，Agent 会同时识别两边的 Skill。

Q: 如何只安装某一个 Skill 而不全部引入？

A: 用仓库自带的安装器：npx --yes github:sandbaseai/sandbase-skills add multi-source-search，会把目标 Skill 复制到当前项目的 .dsh/skills/<name>/ 目录；卸载用 sandbase-dsh-skills remove <name>。

Q: 离线怎么验证 multi-source-search 的调研报告？

A: 用 Skill 自带的 Python 校验器：python3 research/multi-source-search/scripts/validate_report.py examples/verifiable-research-report.json，会检查来源唯一性、置信度、引用一致性，不联网。

Q: 配置文件需要额外改什么吗？

A: 不需要。整个插件通过 Cordis patch 在 DSH 内部注入，无任何用户级配置项；Skill 运行时按需读取宿主环境变量 SANDBASE_API_KEY。

Q: 支持哪些宿主 Agent？

A: 凡是实现 Agent Skills 规范的宿主都可用，包括 Claude Code、OpenAI Codex、Cursor、Gemini CLI；DSH 集成只是其中一种挂载方式。

Q: 如何完全卸载？

A: dsh plugin --profile web remove sandbase-skills，DSH 会自动撤销 bundle 注入层；之前复制到项目的 .dsh/skills/<name>/ 文件夹需要手动删除。

上手难度

入门 — 安装一行命令即可获得 88 个 Skill，不需要写任何配置；想深入用 multi-source-search 时只需让 Agent 按 Skill 指令运行就能跑起来。

已知问题与限制

• 暂无已知问题

Browse the flagship Skill: skills.sh · Agentic Awesome Skills · Agent Skill Exchange · askill · Awesome Skills · skills.re · SkillsCat · OpenAgentSkill · AgentSkill.sh

Have a repeatable workflow that is missing? Request a Skill with a public example and acceptance criteria.

English | 中文 | 日本語 | 한국어 | Español | Français | Deutsch | Português

88 installable Agent Skills for research, social intelligence, marketing, and business workflows. Install into any compatible agent (DeepSeek Harness, Claude Code, Codex, Cursor, Gemini CLI) and start working immediately. The flagship research Skill works with host-provided search tools; connect SandBase when you want broader provider coverage.

Start with multi-source-search: it runs with your agent's existing search tools, ships a worked evidence-ledger example, and includes an offline validator. If it improves a real workflow, star the repository so other builders can discover it.

What are Skills?

A Skill is an instruction file that teaches an AI agent how to do one specific job. Each Skill defines a repeatable workflow, evidence rules, and output format. Portable Skills can use capabilities already provided by the host agent; specialized social, market, and data workflows can add SandBase providers when configured.

Quick Start

# Try it without installing: generate the complete Skill prompt
npx skills use sandbaseai/sandbase-skills@multi-source-search

# Or install it into Codex
npx skills add sandbaseai/sandbase-skills@multi-source-search --agent codex

# Use it with your agent's existing web/search tools
# "Fact-check this claim with independent sources and validate the evidence ledger"

multi-source-search needs no SandBase account when the host agent already provides search and page-reading tools. For specialized social, market, and data-provider Skills, set SANDBASE_API_KEY in your environment—never in a prompt or committed file.

GitHub CLI (official Agent Skills workflow)

GitHub CLI 2.90.0 or later can preview a Skill before installing it. Because this repository groups Skills by domain, pass the exact path shown in the catalog:

# Inspect the instructions and bundled files without installing anything
gh skill preview sandbaseai/sandbase-skills research/multi-source-search

# Install it for Codex at user scope
gh skill install sandbaseai/sandbase-skills research/multi-source-search \
  --agent codex --scope user

Replace the final path with another linked Skill path from the catalog below. See GitHub's gh skill documentation for supported agents, version pinning, updates, and security guidance.

Portable Agent Plugin (Copilot CLI and compatible clients)

Install the curated, account-free research plugin directly from this repository:

copilot plugin install sandbaseai/sandbase-skills:agent-plugin

The plugin follows the vendor-neutral Agent Plugins 1.0 specification and currently packages multi-source-search with its references and offline evidence-ledger validator. Its generated Skill copy is checked against the canonical source in CI.

Add SandBase MCP tools to the same agent

Skills provide repeatable instructions; SandBase CLI adds six MCP tools for discovering and running 2,000+ models and APIs. Connect one of the 25 supported client targets, then use these Skills and MCP tools in the same agent:

npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client codex

Replace codex with another client ID from the verified catalog.

DeepSeek Harness

Install all 88 Skills as a native DSH bundle:

dsh plugin --profile web add github:sandbaseai/sandbase-skills
dsh web

The bundle mounts the packaged marketing/ and research/ directories through DSH's filesystem Skill provider while preserving the default Skill roots.

To copy only the flagship Skill into one project's .dsh/skills/multi-source-search directory:

npx --yes github:sandbaseai/sandbase-skills add multi-source-search

The single-Skill installer and the bundle both run directly from the GitHub source, so no npm publication or SandBase account is required.

Claude Code marketplace

Install all 88 Skills as a native Claude Code plugin:

/plugin marketplace add sandbaseai/sandbase-skills
/plugin install sandbase-skills@sandbase-agent-skills

The marketplace manifest lists every Skill explicitly, so Claude Code can discover them on demand without copying directories by hand.

Verify research output offline

The multi-source-search Skill produces an evidence ledger that can be checked before you trust or share its synthesis:

See the complete worked example, which cross-checks one claim against primary documentation from GitHub, GitLab, and Atlassian.

python3 research/multi-source-search/scripts/validate_report.py \
  examples/verifiable-research-report.json
# VALID: 3 source(s), 1 claim(s), 2 provider(s)

The validator rejects unknown or duplicate sources, inflated confidence, unused evidence, and high-confidence claims that still have a declared conflict. It runs offline and checks internal consistency; it does not claim that a source is true.

For an end-to-end example that runs this research contract inside a governed, sandboxed runtime, read Build an Auditable Research Agent.

Try a Real Workflow

Install the matching Skill, then give your agent one of these tasks:

Skill Catalog (88 Skills)

Social Intelligence (14 Skills)

Research and monitor conversations across every major social platform.

Search & Research (17 Skills)

Find, validate, and synthesize information from multiple sources.

Business Intelligence (20 Skills)

Company research, sales intelligence, and competitive analysis.

Marketing & Content (15 Skills)

Brand monitoring, influencer marketing, and content strategy.

Marketing & SEO (5 Skills)

Search engine optimization, SERP analysis, and technical auditing.

Tools & Utilities (17 Skills)

Practical tools for everyday agent tasks.

Install

# Install any Skill by name
npx skills add sandbaseai/sandbase-skills@<skill-name> --agent codex

# Global install (available across all projects)
npx skills add sandbaseai/sandbase-skills@<skill-name> --agent codex --global

# Find indexed SandBase Skills by topic
npx skills find "research" --owner sandbaseai

# Browse every Skill in the repository
npx skills add sandbaseai/sandbase-skills --list

Supported Agents

Skills work with any agent that implements the Agent Skills specification:

• Claude Code — ~/.claude/skills/
• OpenAI Codex — ~/.codex/skills/
• Cursor — ~/.cursor/skills/
• Gemini CLI — ~/.gemini/skills/
• OpenClaw, Hermes, Amp, Devin — via npx skills add

How It Works

User Question → Agent reads SKILL.md → Uses host tools and/or SandBase → Validates evidence → Answer

1. You ask a question or give a task
2. Your agent reads the installed Skill's instructions
3. The Skill starts with compatible search or browser tools already available to the host
4. When configured, SandBase adds provider-specific capabilities via sandbase_describe_tool → sandbase_call_tool
5. The agent executes the workflow, validates structured evidence, and delivers the result

SandBase Ecosystem

• SandBase CLI — connect Codex, Claude Code, Cursor, Gemini CLI, and other MCP clients to 2,000+ AI models with one onboarding command.
• SandBase Harness — run persistent agent sessions with sandboxed tools, resumable streams, artifacts, cancellation, audit, and replay in your own infrastructure.
• DSH Plugin Store — discover runtime-verified DeepSeek Harness plugins, install them into a local Web profile, and inspect active loader state from Settings.

Pricing

Skills themselves are free and open source (Apache-2.0). multi-source-search can use compatible host-provided tools without a SandBase account. Optional SandBase API calls are usage-based — typically $0.001–$0.01 per call. A typical research task using those calls costs $0.05–$0.20.

See sandbase.ai/pricing for current rates.

Repository Layout

research/<skill>/SKILL.md           Agent instruction file
research/<skill>/references/        API maps and workflow guidance
marketing/<skill>/                  Original marketing skills
catalog/skills/                     Web display metadata
integrations/sandbase-registry/     Platform registry manifests
scripts/skillpack.py                Validation helper

Contributing

See CONTRIBUTING.md before adding or changing a Skill.

# Validate locally
python3 scripts/skillpack.py validate
python3 -m unittest discover -s tests -v

License

Apache-2.0. See LICENSE.

---

Built for SandBase — One API key. Every data source. 88 installable agent skills.