finding-crosslink

Detect and write cross-links between related research findings in a knowledge base.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Research findings in a growing knowledge base often exist in isolation, missing connections to related findings that enable, contradict, extend, or solve the same problem. Manually reviewing thousands of possible pairs to build these relationships is impractical, and naive linking produces false positives that pollute the knowledge graph. ## Core Features & Use Cases - Four Binary-Tested Relationship Types: Classifies links as enables, contradicts, extends, or same-problem using strict two-question tests, with anti-pattern guidance to reject false positives. - Parallel Subagent Evaluation: Batches candidate pairs (default 25 per batch) and dispatches concurrent subagents to evaluate relationships at scale across 24K+ pair spaces. - Human-Gated Writes with Validation: Produces a proposal report first, writes approved links to YAML frontmatter via a safe parser, then runs a mandatory post-write validation pass on stratified samples. - Use Case: After backfilling 20 new findings into a category, run the skill with --category to evaluate only affected pairs, review the proposal report, approve links, and let it write bidirectional related_findings entries with validation. ## Quick Start Run the finding-crosslink skill with --dry-run to generate a proposal report of candidate relationships across the knowledge base before approving any writes.

Frequently Asked Questions about finding-crosslink

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

FAQPage Schema
How do I find relationships between research findings in a knowledge base?▼

Generate candidate pairs using same-category, shared-source, and keyword-overlap heuristics, then evaluate each pair against four binary-tested relationship types: enables, contradicts, extends, and same-problem. Batch pairs and dispatch parallel subagents to apply the tests at scale.

How do I add related_findings links to YAML frontmatter safely?▼

Use a parser-based read/write function like kb_parser.write_frontmatter that validates round-trip YAML parsing before writing. Never use regex replacement on related_findings blocks, since multi-line nested entries break parsing and corrupt files.

What is the difference between enables and same-problem relationships?▼

Enables means one finding describes a mechanism the other requires to function, tested by whether removing it would break the dependent finding. Same-problem means both findings address the same specific problem with different but compatible approaches.

Why do automated crosslinking passes produce false positives?▼

Summary-only evaluation causes roughly 30% false positives on same-problem links because subagents treat category proximity as problem overlap. A mandatory post-write validation pass reading full finding sections catches these errors before they persist.

When should I run crosslinking on a knowledge base?▼

Run it after bulk extraction or backfill that added many findings, after a dimension rebalance moved findings between categories, or periodically as maintenance. Use the --category flag to scope runs to affected categories for incremental updates.