refine

Identify and remediate stale pages, weak connections, and structural deficiencies in Cairn knowledge vaults.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/JustinBeaudry/cairn --skill refine-justinbeaudry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine
Source: https://github.com/JustinBeaudry/cairn/tree/main/skills/refine
Command: npx skills add https://github.com/JustinBeaudry/cairn --skill refine-justinbeaudry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill cleans up outdated or weakly linked pages in a Cairn knowledge vault, removing stale content, strengthening connections, and fixing backlink gaps.

Core Features & Use Cases

  • Vault health dashboard: Generates a baseline and post‑refinement summary of pages, links, and orphaned content.
  • Stale page handling: Detects pages not updated in over 30 days and prompts for update, archive, or leave unchanged.
  • Under‑connected page improvement: Finds pages with few inbound links and suggests new relationships.
  • Merge & split automation: Identifies overlapping or overly broad pages, presents side‑by‑side previews, and creates merged or split pages after user approval.
  • Backlink audit: Verifies that every wikilink is reciprocated in the target’s backlink section and fixes gaps automatically.
  • User‑approved structural changes: All merges, splits, and archives require explicit confirmation, preserving knowledge integrity.

Quick Start

Ask the assistant to run /cairn:refine on your vault to begin the refinement process.

Frequently Asked Questions about refine

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

FAQPage Schema
How do I clean up stale pages and fix broken backlinks in my knowledge vault?

To clean up stale pages and fix backlink gaps in a knowledge vault, run a refinement session that detects outdated content, audits reciprocated links, and automatically synchronizes missing backlinks. It prompts you to update, archive, or leave pages unchanged.

What's the best way to merge overlapping or split overly broad wiki pages?

The best way to merge or split wiki pages is to use a refinement tool that identifies overlapping or overly broad pages, presents side-by-side previews, and creates the merged or split pages after explicit user approval to preserve knowledge integrity.

How do I find orphaned and under-connected pages in a wiki?

You can find orphaned and under-connected pages by generating a vault health dashboard that baselines pages and links, then identifies content with few inbound links and suggests new relationships to improve link density.

Does the knowledge vault refinement process require any external dependencies?

No, the knowledge vault refinement process requires no external dependencies. It operates entirely within the Cairn system to execute health dashboards, remediate stale content, and synchronize backlinks automatically.

When should I run a refinement session on my team wiki?

You should run a refinement session when your team wiki has pages not updated in over 30 days, weak connections, or structural deficiencies. It generates a post-refinement summary to verify improved content relevance and organization.

Are structural changes to the vault automated without user confirmation?

No, all structural changes including merges, splits, and archives require explicit user confirmation. This preserves knowledge integrity by ensuring you approve every remediation action before it is applied.