research-query

Investigates a specific question via Perplexity and writes a report with optional KB persistence.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/nickgogan/improvement-loop --skill research-query-nickgogan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: research-query
Source: https://github.com/nickgogan/improvement-loop/tree/main/.claude/skills/research-query
Command: npx skills add https://github.com/nickgogan/improvement-loop --skill research-query-nickgogan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you have a specific question or topic that your knowledge base doesn't cover, this Skill runs a targeted research investigation, checks the results against existing KB coverage, and lets you decide whether findings should be persisted. ## Core Features & Use Cases - Targeted Research: Uses Perplexity research, reasoning, search, and ask tools plus WebFetch to investigate a focused question in depth. - Dimension Routing & Deduplication: Checks the topic against active research dimensions and scans existing findings before researching to avoid redundant work. - Gated Persistence: Always writes a research report, but only writes findings and sources to the KB after explicit user approval. - Use Case: Ask "what's the state of the art on agent memory compaction?" and receive a structured report with key insights, evidence strength, sources, and an option to persist novel findings into the KB. ## Quick Start Ask the agent to research a specific question, for example: research how production teams handle long-context memory in AI agents.

Frequently Asked Questions about research-query

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I research a specific topic and save findings to a knowledge base?▼

Invoke the skill with your question or topic as the argument. It researches via Perplexity, writes a report, then asks whether you want to persist findings and sources to the KB before writing anything.

What is the difference between research-query and research-loop?▼

research-query handles targeted, question-driven research with optional persistence, while research-loop runs periodic broad scans that always persist findings. Use research-query for one-off questions and research-loop for scheduled coverage.

When should I use perplexity-research instead of research-query?▼

Use perplexity-research for pure intelligence gathering that produces reports only. Use research-query when the findings might belong in the knowledge base, since it adds dimension checking, deduplication, and a persistence gate.

Does research-query write to the knowledge base automatically?▼

No. Persistence is always user-gated. The skill always writes a research report to operations/research-reports/, but findings and sources are only written to the KB after you explicitly approve.

What happens if my topic doesn't fit an existing research dimension?▼

The skill flags the mismatch and asks you to choose: research and persist with a possible new dimension (requiring your approval), or produce a one-off report with no KB writes. It never force-fits topics into wrong dimensions.