skills/m31uk3/ai-skills/validated-knowledge-synthesis

validated-knowledge-synthesis

SKILL.md

Validated Knowledge Synthesis (VKS)

Transform raw information into validated, actionable knowledge while preserving productive tensions.

Parameters

Acquire all required parameters upfront in a single prompt:

Parameter Required Description
source_materials Yes Raw sources (direct text, file paths, URLs)
synthesis_topic Yes Subject being synthesized
target_audience Yes Intended users of the knowledge
document_type No "curated context" (default), "guidance", or "reference"
output_location No File path to save output

Support multiple input methods: direct text, file paths, URLs, or other user-preferred methods.

Workflow

1. Source Validation

Assess each source for:

  • Authority and credibility
  • Recency and relevance
  • Internal consistency
  • Citation quality

Create a source validation matrix. Flag sources lacking sufficient validation.

2. Pattern Recognition

Identify across sources:

  • Common themes and shared insights
  • Contradictory claims or competing frameworks
  • Gaps where sources don't address key aspects
  • Overlapping evidence strengthening claims

Categorize relationships as convergent (ideas strengthen each other) or tension-based (separation maintains value).

3. Synthesis Strategy Selection

Apply convergence when:

  • Ideas are complementary
  • Contradictions resolve at higher abstraction
  • Unified approach improves application
  • No valuable knowledge lost in combination

Apply tension preservation when:

  • Contradictions generate new insights
  • Different contexts require different approaches
  • Forced convergence would flatten valuable complexity

4. Document Type Execution

See references/document-types.md for detailed format specifications.

Curated Context (default): Hybrid of guidance and reference. Clear sections distinguishing each. Optimized for ease of recall.

Guidance: Narrative flow, problem-solution-implementation arc, 200+ words continuous prose before formatting, bullet points only for final checklists.

Reference: Quick lookup, categorical organization, bullet-friendly, designed for scanning.

5. Writing Execution

Apply these principles to all documents. See references/writing-principles.md for details.

  • Reader Empathy: Communicate key ideas in minimal words. Core tenet: "Learning how to communicate something in 30 seconds that takes most people 5 minutes is a HUGE unlock."
  • Short Sentences: Simple sentences build patience for complex concepts.
  • Strong Verbs: Use precise verbs. Avoid helpers (has, had), infinitives when direct verbs work, "to be" variations.
  • Simple Words: Choose simpler words (use not utilize, help not facilitate).

6. Apply Frameworks

See references/frameworks.md for complete framework details.

Golden Path Criteria: Purpose & Audience, Clear & Concise, Structure & Logic, Evidence & Impact, Action & Execution.

Answer-Explain-Educate: Lead with direct answer, support with key details, add important context.

What-So What-Now What: Present facts, analyze consequences, propose recommendation.

7. Validation

Verify:

  • Logical progression (premises support conclusions, no circular reasoning)
  • Narrative coherence (reader can follow logic without headers)
  • Flow validation (paragraphs connect logically)
  • Comprehension test (audience can understand and implement)

8. Output Generation

Create synthesis document including:

  • Executive summary with key insights
  • Source validation matrix
  • Synthesis strategy decisions with rationale
  • Convergent knowledge with evidence
  • Preserved tensions with context boundaries
  • Implementation guidance

Save to output_location if specified.

Troubleshooting

Problem Solution
Forced convergence weakens knowledge Apply tension preservation instead
Validation failures Revisit synthesis strategy; clarify context boundaries
Low-quality sources Exclude or document limitations clearly
Excessive complexity Create layered documentation (summary, analysis, appendices)
Fragmented narrative Add transitions, embed lists in prose, test without formatting
Weekly Installs
1
GitHub Stars
4
First Seen
Mar 1, 2026
Installed on
amp1
cline1
opencode1
cursor1
continue1
kimi-cli1