knoopx/research-protocol
agent/skills/protocols/research-protocol/SKILL.md
Gather facts from the web using evidence-first approach with mandatory citations. Use when researching topics, answering factual questions, or any task requiring web-sourced evidence.
$ install --global
skillsauthnpx skillsauth add knoopx/pi research-protocolInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 20, 2026, 7:56 AM229.5s1 file scanned
SKILL.md
- name:
- research-protocol
- description:
- Gather facts from the web using evidence-first approach with mandatory citations. Use when researching topics, answering factual questions, or any task requiring web-sourced evidence.
- related:
- [cite-before-answer, task-decomposition]
- token_cost:
- 180
Available research tools
- web-search(query, limit) — DuckDuckGo search. Returns titles, URLs, and descriptions.
- web-fetch(source) — Fetch a URL or local file and convert to Markdown text. Use on URLs found via web-search.
- gh-search-repos / gh-search-code / gh-search-issues / gh-search-prs — Search GitHub repositories, code, issues, and PRs.
- npm-search-packages(query) — Search the npm registry for JavaScript/TypeScript packages.
- pypi-search-packages(query) — Search PyPI for Python packages.
- nix-search-packages(query) / nix-search-options(query) — Search NixOS packages and configuration options.
- hm-search-options(query) — Search Home Manager configuration options.
- hf-search-models(query) — Search Hugging Face models.
Research Protocol (evidence-first)
- Decompose the question into one or two unknowns. Write them down in your first reply.
- For each unknown, search with the appropriate tool above, then fetch relevant pages with web-fetch, then call evidence-add (one fact per entry).
- Do NOT state a fact that isn't backed by an evidence-add id.
- Before answering, call evidence-list. Your answer must reference at least one id.
- If evidence-list is empty, you are not ready to answer — go back to step 2.
Rules
- NEVER state a fact that isn't backed by an evidence-add id
- ALWAYS call evidence-list before answering
- Your answer must reference at least one evidence id
- If evidence-list is empty, go back to gathering evidence
- After 3+ search refinements with no usable evidence, say "insufficient evidence" instead of guessing
Stop conditions
- You have an evidence id for every claim in your answer → ANSWER
- You have tried 3+ search refinements with no usable evidence → say "insufficient evidence"
Example workflow
web-search(query="Turing machine invention date")
→ returns results including Wikipedia URL
web-fetch(source="https://en.wikipedia.org/wiki/Turing_machine")
evidence-add(source="...", note="Turing machine introduced in 1936", snippet="...")
evidence-list()
→ Answer with citations: e1
Workflow
- Decompose: Break the question into 1-2 unknowns
- Search: Use web-search, gh-search-*, npm-search-packages, pypi-search-packages, or other domain tool
- Fetch: Use web-fetch on promising URLs to get full page content
- Save evidence: Call evidence-add for each fact found (one fact per entry)
- Verify: Call evidence-list before answering; answer must reference at least one ID
- Stop condition: Answer when all claims have evidence; say "insufficient evidence" after 3+ failed searches
Related Skills
knoopx/notify
tools
VerifiedTrustedCommunity
Inform the user what is happening — skip passive lookups
52SKILL.mdUpdated May 20, 2026
knoopx/markdown-rendering
development
VerifiedTrustedCommunity
Renders markdown to self-contained HTML with a custom dark stylesheet and opens in browser. Use when previewing markdown documents, generating styled HTML from README or report files.
52SKILL.mdUpdated May 20, 2026
knoopx/jj-hunk
testing
VerifiedTrustedCommunity
Programmatic hunk selection for Jujutsu — split, commit, or squash specific hunks without interactive prompts. Use when making partial commits or selective squashes.
52SKILL.mdUpdated May 18, 2026
knoopx/jj-core
content-media
VerifiedTrustedCommunity
Manage version control with Jujutsu (jj) — no staging area, immediate changes, smart rebasing. Use when navigating history, squashing, or pushing to Git remotes.
52SKILL.mdUpdated May 18, 2026