Agent skill

validated-knowledge-synthesis

Transform raw, unorganized information into actionable knowledge through systematic validation. Use when users want to synthesize information from multiple sources (documents, URLs, transcripts, notes) into structured knowledge documents. Supports three document types - curated context (default, optimized for recall), guidance (implementation-focused narrative), and reference (quick lookup). Combines convergent synthesis with tension preservation to maintain productive contradictions. Triggers on requests like "synthesize this information", "create knowledge document from these sources", "transform these notes into actionable guidance", or "help me organize this research".

Stars 5
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/m31uk3/ai-skills/tree/main/skills/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

Expand your agent's capabilities with these related and highly-rated skills.

m31uk3/ai-skills

guided-ooda-loop

Universal pattern for structured LLM interaction managing finite context windows through phased progression (Observe-Orient-Decide-Act). Use when the user has a complex problem, wants to design/build/create something (software, strategy, document, process), or uses phrases like "I have an idea for...", "help me design...", "guide me through...", or mentions OODA, RPI, or PDD. Reduces hallucinations through structured interaction.

5 1
Explore
m31uk3/ai-skills

response-quality-analysis

Analyze whether your response addresses the actual question asked before posting. Use when: (1) About to post response to forum/Slack question, (2) Want to validate response coverage, (3) Need to ensure solving the right problem, (4) Want specific improvement suggestions for gaps in response

5 1
Explore
m31uk3/ai-skills

doc-coauthoring

Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.

5 1
Explore
m31uk3/ai-skills

internal-comms

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

5 1
Explore
m31uk3/ai-skills

mcp-builder

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

5 1
Explore
m31uk3/ai-skills

canvas-design

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

5 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results