etanhey/research-prompt-quality
skills/golem-powers/research-prompt-quality/SKILL.md
Mandatory pre-flight gate before any deep-research prompt ships. Three gates: CHECK-FIRST (non-redundancy), GROUND (Drive refs + current-usage examples + prior-research stance), emit-only-if-pass. Use when writing deep research prompts, Claude Desktop research prompts, deciding should we research, or proposing research. Triggers: 'deep research', 'research prompt', 'should we research', 'propose research'. NOT for executing research — use /research, /claude-desktop-research, or /gemini-research.
$ install --global
skillsauthnpx skillsauth add etanhey/golems research-prompt-qualityInstall 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 30, 2026, 2:58 AM37.1s10 files scanned
SKILL.md
- name:
- research-prompt-quality
- description:
- Mandatory pre-flight gate before any deep-research prompt ships. Three gates: CHECK-FIRST (non-redundancy), GROUND (Drive refs + current-usage examples + prior-research stance), emit-only-if-pass. Use when writing deep research prompts, Claude Desktop research prompts, deciding should we research, or proposing research. Triggers: 'deep research', 'research prompt', 'should we research', 'propose research'. NOT for executing research — use /research, /claude-desktop-research, or /gemini-research.
Research Prompt Quality — Pre-Flight Gate
Stop flat, redundant deep-research prompts before they ship. Research execution skills run after this gate passes.
When to run
Run before writing or pasting any deep-research prompt (Claude Desktop, Gemini Deep Research, or /research --deep). If the gate fails, do not emit a research prompt — output the stop reason and route to engineering or plan work instead.
The three gates (all must pass)
Gate 1 — CHECK-FIRST (non-redundancy)
Search existing work before proposing new research.
skills/golem-powers/research-prompt-quality/scripts/check-first.sh "<topic keywords>"
Sources scanned:
Brain Drive/03_RESEARCH/(when mounted)- Every
~/Gits/*/docs.local/research/ - Every
~/Gits/*/docs.local/plans/ - Every
~/Gits/*/docs.local/decisions/
On exit 1: print ALREADY RESEARCHED → <paths> and STOP. This is engineering / plan execution, not research.
Canonical failure: proposing "RRF ranking" deep-research when ≥6 prior artifacts already exist (see evals/fixtures/neg-2-redundant-rrf.md).
Gate 2 — GROUND
Every research prompt MUST include:
- Drive folder refs — relevant
Brain Drive/03_RESEARCH/...paths (or documented folder IDs from boot grounding docs). - ≥1 concrete current-usage example — real code, config, or file path from the repo (not generic "we use agents").
- Prior-research stance — explicit BUILD-ON / VALIDATE / REFUTE for each prior artifact; never restart from zero.
Use references/ground-template.md as the required structure. Fold grounding bundles (e.g. MCL-RESEARCH-GROUNDING.md) into the prompt; do not treat the bundle as the prompt itself.
Gate 3 — Emit only if 1+2 pass
If CHECK-FIRST passes and GROUND is satisfied, emit the self-contained research prompt (reuse /claude-desktop-research format). Otherwise output only the stop message or grounding gap list.
Workflow
1. CHECK-FIRST → scripts/check-first.sh "<keywords>"
2. If hits → STOP ("ALREADY DONE → paths → engineering")
3. Gather ground → read repo paths, Drive folders, prior research files
4. Draft → references/ground-template.md
5. Score → scripts/score-research-prompt.py <draft.md> (target ≥8/10)
6. Ship prompt → hand to /claude-desktop-research or /research
Static quality bar
Run scripts/score-research-prompt.py on the draft. RED gate for eval fixtures: negative prompts ≤4/10, grounded prompts ≥8/10. See EVAL.md for rubric and fixture scores.
Integration
/research— run this gate before--deepor external research dispatch./claude-desktop-research— run this gate before writing the paste-ready prompt file.
Anti-patterns (from gen-10, 2026-05-29)
| Bad | Good |
|-----|------|
| Flat MCL prompt with no Drive refs or repo examples | Grounded prompt + MCL-RESEARCH-GROUNDING.md folded in |
| "Deep-research RRF fusion" when 6+ prior docs exist | ALREADY RESEARCHED → <paths> → engineering |
| Generic "multi-agent ecosystem" without send_input / cmux paths | Cite cmux/SKILL.md, orc/workflows/fact-propagation.md, etc. |
| Restart prior art from scratch | BUILD-ON / VALIDATE / REFUTE per prior file |
Eval
See EVAL.md — four real fixtures, literal scorer stdout, with-skill vs without-skill delta target ≥+30%.
Related Skills
etanhey/writing-skills
development
VerifiedTrustedCommunity
Create, edit, and verify golem-powers skills using the standard SKILL.md structure, workflow files, adapters, templates, and eval fixtures. Use for new skills, structural edits, workflows/adapters, and pre-deploy validation. NOT for invoking existing skills, superpowers skills, or skill-creator agent workflows.
3SKILL.mdUpdated Jun 4, 2026
etanhey/video-extract
testing
VerifiedTrustedCommunity
Extract structured knowledge from any video source — YouTube URLs or local screen recordings. YouTube → gems workflow (yt-dlp transcript → keyword hotspots → frame extract → brain_digest → structured gems). Screen recordings → QA workflow (reuses /qa-video stalker pipeline). Use when user shares a YouTube link wanting deep extraction with frames, shares a .mov/.mp4 for QA processing, says "extract from video", "video gems", "process this recording", or mentions gem extraction from video content.
3SKILL.mdUpdated Jun 4, 2026
etanhey/monitor-loop
testing
VerifiedTrustedCommunity
Use when running or reviewing any recurring monitor loop for merge queues, worker queues, collab tails, or agent completion. Enforces drive-to-completion ticks: every tick must query live state with `!`, classify whether real progress happened, and then dispatch, verify-and-decrement, or escalate-park. Triggers on: monitor loop, /loop, recurring tick, keep monitoring, silent autonomous, merge gate, blocked review, no-progress loop.
3SKILL.mdUpdated Jun 4, 2026
etanhey/mehayom
tools
VerifiedTrustedCommunity
MeHayom freelance client management — daily updates, decision tracking, time logging. Use when drafting Yuval updates, logging scope changes, tracking hours, or any MeHayom client communication. Triggers: 'draft Yuval update', 'client update', 'daily update', 'log decision', 'track time', 'mehayom'.
3SKILL.mdUpdated Jun 4, 2026