SurfSense is an open-source desktop application that uses an AI agent to research, transform, and edit documents while keeping their index on the user's machine. It is intended for people working with documents they cannot upload, with a choice of local or remote models and no account required.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add MODSetter/SurfSense --skill quizgit clone --depth 1 https://github.com/MODSetter/SurfSenseWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/modsetter/surfsense/quiz)<a href="https://agentmods.dev/skills/modsetter/surfsense/quiz"><img src="https://agentmods.dev/badge/skills/modsetter/surfsense/quiz/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/modsetter/surfsense/quiz"><img src="https://agentmods.dev/badge/skills/modsetter/surfsense/quiz.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00011 | $0.00638 |
| Opus 5.5 | $0.00004 | $0.00255 |
| Sonnet 5.5 | $0.00002 | $0.00128 |
| Haiku 4.5 | $0.00001 | $0.00064 |
Grade A, and why
quiz scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 76 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Quiz
Create one /workspace/<slug>.json file. JSON is the canonical quiz; do not
write a separate Markdown summary.
Contract
Use exactly this closed version-one shape:
{
"schema_version": 1,
"title": "Quiz title",
"questions": [
{
"question_text": "One focused question",
"options": ["Option A", "Option B", "Option C", "Option D"],
"correct_option_index": 1,
"explanation_text": "Why Option B is correct."
}
]
}
- Include 5–30 questions. Use an explicitly requested count within that range; otherwise create exactly 10. If the requested count is outside the range, stop and explain the supported range instead of clamping it.
- Plan distinct assessment targets before writing. Do not duplicate, paraphrase, reverse, or pad weak questions to reach the minimum.
- If the available source cannot support five defensible questions, stop without creating filler.
- Every question has exactly four distinct options and exactly one objectively
correct option.
correct_option_indexis an integer from0through3. - Write three plausible distractors. Avoid “All of the above,” “None of the above,” trick wording, grammar clues, and obvious correct-position patterns.
explanation_textis required and should concisely teach why the selected answer is correct.- Title: 1–200 characters. Question and each option: 1–4,000. Explanation: 1–12,000.
- Content is plain text. The only formatting syntax is LaTeX: use
\(...\)for inline math and\[...\]for display math. Escape each backslash as\\in JSON. Keep delimiters and braces balanced and do not nest math delimiters. - Do not add fields, change
schema_version, use Markdown or raw HTML, include links or media, duplicate question text, or usenull. - Write UTF-8 JSON without comments or a byte-order mark.
Verify and save
Call:
verify_artifact(path="/workspace/<slug>.json", format="quiz")
Fix all blocking findings together, rewrite the JSON once, and reverify the exact path. If a blocker remains, stop and explain it instead of looping.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 76 lines · 11 tokens per session scan A c3da4595c214
quiz is a skill published in the GitHub repository MODSetter/SurfSense (16,464 stars, last pushed today), licensed Apache-2.0. It adds 11 tokens to every session and 638 once invoked, about $0.0000 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-13.
Other skills, from other repositories
first-reader
Beta readers for any draft, run by simulating how a real reader experiences it, moment by moment. A skim gate, a no-lookahead timed read producing an attention transcript with quit points, a recall test of what a reader remembers the next day, and a trust ledger of the implied author. Use when the user asks for a beta…
mcp-apps-builder
MANDATORY for ALL MCP server work - mcp-use framework best practices and patterns. READ THIS FIRST before any MCP server work, including: Creating new MCP servers Modifying existing MCP servers (adding/updating tools, resources, prompts, widgets) Debugging MCP server issues or errors Reviewing MCP server code for…
project-graveyard
Scans the developer's machine for dead side projects, autopsies each one from its git history (died at the payments wall, killed by a newer project, finished but never shipped), surfaces their personal death patterns, and picks the corpse most worth resurrecting — then helps ship it. Use when the user mentions…
commit-archaeologist
Reconstructs why code exists from local git history, including the introducing commit, later changes, current authors, repeated companion files, and likely intent. Use when the user asks "why does this code exist", "who wrote this function and why", or to "explain the history of this function" before a rewrite…
dependency-doctor
Checks requirements.txt, pyproject.toml, and package.json dependency manifests for surface-level direct-dependency footguns: standard-library shadowing pins, abandoned backports, unpinned dependencies, and obvious intra-manifest conflicts, plus opt-in PyPI yanked releases. Use when the user asks to check a manifest…
scope-creep-detector
Analyzes git diffs against a stated intent to detect scope creep, unrelated files, broad pull requests, changes that grew beyond a fix, dependency additions, public API renames, config or CI edits, oversized hunks, and formatting-only files. Use when the user asks whether a change grew beyond the fix, a PR is too…