harvest
Promote .agents knowledge.
How do I install this agent skill?
npx skills add https://github.com/boshu2/agentops --skill harvestIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill manages knowledge consolidation by scanning workspace directories and promoting artifacts to a global hub. It presents an indirect prompt injection surface as it processes untrusted data from the filesystem without explicit sanitization or boundary markers.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Harvest — Cross-Rig Knowledge Consolidation
Usage:
/harvestis for manual sweeps and CI runs. (The old/dream startnightly loop that wrapped harvest is retired — out-of-session compounding moved to Gas City; there is no live Dream process or.agents/overnight/run.lockto wait on.)
Sweep all .agents/ directories across the workspace, extract learnings, patterns,
and research, deduplicate cross-rig, and promote high-value items to the global
knowledge hub (~/.agents/learnings/).
Naming gotcha.
$harvestpromotes into~/.agents/learnings/, not~/.agents/. Users often say "harvest all to~/.agents" and mean the promotion hub. If you really want every raw artifact (not just the promotion set) mirrored verbatim, you wantrsync, not$harvest.
Which skill do I need?
See docs/skills-decision-tree.md for the full "which skill next?" decision table covering harvest, compile, dream, knowledge-activation, and quickstart.
What This Skill Does
The knowledge flywheel captures learnings per-rig, but they stay siloed. Harvest
closes the loop by walking all rigs, extracting artifacts, deduplicating by content
hash, and promoting high-confidence items to the global hub where every rig can
access them via ao inject.
When to use: Before an evolve cycle, after a burst of development across multiple rigs, or weekly as part of knowledge governance.
Output: .agents/harvest/latest.json (catalog) + promoted files in ~/.agents/learnings/
Execution Steps
Step 1: Preview Scope (Dry Run)
ao harvest --dry-run --quiet
Read .agents/harvest/latest.json and report:
- Rigs discovered
- Total artifacts extracted
- Unique vs duplicate count
- Promotion candidates (artifacts >= min confidence)
Step 2: Confirm Execution
Skip if --auto is set. Otherwise, show the dry-run summary and ask:
Harvest will promote N artifacts from M rigs to ~/.agents/learnings/.
Proceed? [Approve / Adjust threshold / Abort]
Step 3: Execute Harvest
ao harvest --roots ~/gt/ --promote-to ~/.agents/learnings --min-confidence 0.5
Step 4: Post-Harvest Cleanup
Run dedup on the promotion target to clean up any remaining duplicates:
ao dedup --merge ~/.agents/learnings/ 2>/dev/null || true
Step 5: Report Results
Report to user:
- Rigs scanned
- Artifacts extracted and unique count
- Duplicates found (with top duplicate groups)
- Artifacts promoted (with provenance)
- Top discoveries (highest-confidence cross-rig patterns)
Flags
| Flag | Default | Description |
|---|---|---|
--auto | off | Skip confirmation gate |
--roots | ~/gt/ | Override root directories to scan |
--min-confidence | 0.5 | Minimum confidence for promotion |
--include | learnings,patterns,research | Artifact types to extract |
Quick Start
/harvest # Full sweep with confirmation
/harvest --auto # Hands-free sweep
/harvest --min-confidence 0.7 # Only promote high-confidence items
/harvest --roots ~/gt/,~/projects/ # Scan additional directories
Governance
See references/governance.md for ongoing governance model: size budgets, sweep frequency, staleness thresholds, and cross-rig synthesis triggers.
See Also
- skills/compile/SKILL.md — Single-rig Mine/Grow/Defrag
- skills/flywheel/SKILL.md — Flywheel health monitoring
- skills/inject/SKILL.md — Knowledge injection into sessions
- skills/forge/SKILL.md — Transcript knowledge extraction
Reference Documents
- references/governance.md — Governance model for ongoing knowledge consolidation
- references/harvest.feature — Executable spec: sweep .agents surfaces, consolidate + de-duplicate, write learnings, manual or via the dream loop (soc-qk4b)
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/boshu2/agentops/harvest">View harvest on skillZs</a>