construct-research-cycle

Orchestrates scoped research cycles through a Python capability with human review gates.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/mabstruct/construct --skill construct-research-cycle-mabstruct
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: construct-research-cycle
Source: https://github.com/mabstruct/construct/tree/main/CONSTRUCT-CLAUDE-impl/claude/skills/construct-research-cycle
Command: npx skills add https://github.com/mabstruct/construct --skill construct-research-cycle-mabstruct

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running literature and web research manually means searching, scoring relevance, deduplicating, and filing findings by hand. This Skill coordinates that entire research cycle conversationally while a deterministic Python capability performs the actual searching, scoring, and writing behind a human approval gate. ## Core Features & Use Cases - Scope Negotiation: Reads search-seeds.json, domains.yaml, and governance.yaml to confirm full, domain-specific, or targeted research scope with the user before anything runs. - Gated Execution: Invokes construct research run to execute the search-score-dedup pipeline, which pauses at a review gate and writes nothing until approved. - Human Review Loop: Presents the pending gate queue with titles, sources, and relevance scores, then resumes the run via construct research review with approve-all, reject-all, or per-finding decisions. - Use Case: A researcher asks "what's new in machine learning this week" — the Skill confirms scope, runs the capability, presents 12 candidate papers for approval, and only the 8 approved items become ref files and seed cards in the workspace. ## Quick Start Ask the agent to run a research cycle for your domain, then approve or reject the pending findings it presents.

Frequently Asked Questions about construct-research-cycle

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

FAQPage Schema
How do I run a research cycle in a CONSTRUCT workspace?▼

Ask the agent to run a research cycle or find papers for a domain. The Skill confirms scope, invokes `construct research run --workspace . --json`, presents the pending findings, and resumes with `construct research review` once you approve or reject items.

How does the human review gate work for research findings?▼

The research run pauses with status awaiting_review and returns a run_id plus a gate_queue of pending findings. You approve all, reject all, or submit per-finding decisions, and only approved items are written as refs and seed cards.

Does the research skill perform web searches itself?▼

No. Web search, relevance scoring, deduplication, and ingestion all live in the Python research.run capability. The Skill is a thin orchestrator that negotiates scope, relays the gate queue, and narrates the digest without direct web-fetch or workspace-write tools.

What happens if no search clusters are configured?▼

The Skill reads search-seeds.json first and, if no active clusters exist, tells you to run domain init to seed research before any cycle can start. It does not attempt a search without configured clusters.

Can I limit a research run to one domain or topic?▼

Yes. Scope is negotiated conversationally before execution: a full cycle across all active domains, a single named domain's clusters, or a targeted run for a specific topic. The confirmed scope is passed to the research capability.