refresh-research

Re-fetch upstream sources and apply detected changes to research syntheses.

9|2|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/harnessprotocol/harness-kit --skill refresh-research
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refresh-research
Source: https://github.com/harnessprotocol/harness-kit/tree/main/plugins/research/skills/refresh-research
Command: npx skills add https://github.com/harnessprotocol/harness-kit --skill refresh-research

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python>=3.10.

What problem does it solve?

This Skill prevents your research knowledge base from going stale by re-fetching upstream sources and updating synthesis files with the latest facts.

Core Features & Use Cases

  • Refreshable source tracking: Refreshes only repo and docs sources, based on source_type (with auto-detection when missing).
  • Versioned raw sources: Stores every fetched update as a new dated raw file, never overwriting history.
  • Surgical synthesis updates: Updates existing syntheses while preserving your analysis, plus logs changes in an Update Log section.
  • Staleness & dry-run auditing: Supports audit-only reporting and refresh based on age thresholds to reduce unnecessary churn.

Quick Start

Run the refresh interactively so the system shows which entries are stale and lets you choose what to update.

Frequently Asked Questions about refresh-research

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

FAQPage Schema
How do I keep research documentation from going stale?

To keep research documentation from going stale, you can re-fetch eligible upstream sources and apply detected changes to synthesis files using a staleness audit and refresh process.

What is the best way to audit a knowledge base for outdated sources?

The best way to audit a knowledge base for outdated sources is running an audit-only dry run, which reports staleness without modifying files, or by triggering a refresh based on age thresholds.

How does versioned source storage work when refreshing research files?

Versioned source storage works by saving every re-fetched upstream update as a new dated raw file, ensuring historical data is never overwritten during synthesis updates.

Can I refresh only specific categories in my research corpus?

Yes, you can refresh specific categories in your research corpus, as the process supports single files, whole categories, full corpora, and staleness-threshold refreshes.

Do I need Python to run a staleness audit on GitHub documentation?

Yes, you need Python 3.10 or higher to run a staleness audit on GitHub documentation and re-fetch eligible repo and docs sources for your knowledge base.

Will refreshing upstream sources overwrite my existing analysis?

Refreshing upstream sources will not overwrite your existing analysis; the process applies surgical synthesis updates that preserve your original notes while logging changes in an Update Log.