promote-findings

Promote analysis-doc findings candidates into deduplicated Research Findings KB entries.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After running repo analysis, findings candidates sit in analysis docs with no structured path into the knowledge base, risking duplicates and lost insights. This Skill bridges that gap by reading candidates, deduplicating against existing findings, and writing formally structured Research Finding entries only after user approval. ## Core Features & Use Cases - Candidate Extraction & Deduplication: Reads Findings Candidates sections from single, all, or cross-repo comparison analysis docs and greps the KB to classify each as New, Partial match, or Full duplicate. - Human-Gated KB Writes: Presents candidates in a selection table; even with --auto, a single batch confirmation gate precedes any write, so nothing enters the KB without in-run approval. - Schema-Compliant Finding Generation: Writes findings with full YAML frontmatter (evidence strength, priority triage P1-P3, related_findings links) and standardized body sections, then annotates every candidate in the source analysis doc with its disposition. - Use Case: After running /repo-analyzer on three watched libraries, invoke this Skill to review 12 candidates, promote 8 as new findings, link 2 partial matches, and mark 2 duplicates — all traceable via bidirectional Obsidian links. ## Quick Start Ask the AI to promote findings candidates from the gsd analysis doc into the Research Findings KB and review the deduplication table before approving.

Frequently Asked Questions about promote-findings

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

FAQPage Schema
How do I promote findings from repo analysis into a knowledge base?▼

Run the skill with a library name, 'all', or 'comparison' to load candidates from analysis docs. It deduplicates against existing findings, presents a selection table, and writes approved entries with full frontmatter and body structure.

How does findings deduplication work before writing to the KB?▼

Each candidate is grep-searched against the research-findings directory and classified as New, Partial match, or Full duplicate. Partial matches get related_findings links; full duplicates are flagged so you can update the existing finding instead of creating a copy.

Does the --auto flag write findings without approval?▼

No. The --auto flag only collapses per-candidate selection into a single batch confirmation gate. One explicit in-run approval is still required before anything is written to the knowledge base.

What evidence strength should repo-analysis findings get?▼

Default to Medium (practitioner-documented) since analysis docs observe patterns in repos rather than production telemetry. Upgrade to Strong (production-tested) only when the analysis documents production usage or significant adoption.

When should I not use this skill for creating findings?▼

Do not use it for findings from web sources or URLs (use /research-loop), for classifying findings into artifact forms (use /identify-artifacts), or for modifying the analysis docs themselves (use /repo-analyzer --force).