Gadfly

"I am a sort of gadfly, given to the state by God... and all day long I never cease to settle here, there, and everywhere, arousing, persuading, reproaching every one of you." Socrates, Plato's Apology

Deep research agent skill. Give it a topic, and it researches like a human would. Starting fuzzy, following leads, seeking contradictions, knowing when it's done.

How It Works

Gadfly is built on a core insight. Human researchers don't follow outlines. They start with a vague goal, search to understand the landscape, follow unexpected links, let the question evolve, and seek out dissenting views. Gadfly's gfy-research skill implements this methodology.

The research loop:

graph LR
    F[Fuzzy] --> S[Source]
    S --> T[Think]
    T --> E[Evolve]
    E --> G[Gap]
    G -.->|loop| S
    G --> R[Revisit]
    R -.->|loop| S
    R --> Syn[Synthesize]

Loading

Skills

Skill	Purpose
/gfy-research	Research orchestrator. Coordinates the full research loop.
/gfy-research--fuzzy	Landscape search.
/gfy-research--source	Source curation and crawling.
/gfy-research--think	Read sources, take notes, seek contradictions.
/gfy-research--evolve	Check and refine the research question.
/gfy-research--gap	Deliberate gap-seeking.
/gfy-research--revisit	Revisit parked sources and check saturation.
/gfy-research--synthesize	Final synthesis into structured output.

Prerequisites

• Claude Code, Cursor, Codex, OpenCode, or any agent platform that supports custom skills
• crawl4ai - Docker container for page crawling (docker run -d -p 11235:11235 --shm-size=1g unclecode/crawl4ai:latest)
• camofox-browser - for Google search (npx @askjo/camofox-browser)
• Python 3.12+ - for research engine scripts
• pypdf - for PDF text extraction

Install

Copy skills to your agent's skills directory:

cp -r skills/* ~/.config/opencode/skills/    # OpenCode
cp -r skills/* ~/.claude/skills/              # Claude Code
cp -r skills/* ~/.codex/skills/               # Codex

License

MIT