insight

Distill raw research notes into concise bullets for vision docs.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/aspelldenny/sos-kit --skill insight-aspelldenny
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: insight
Source: https://github.com/aspelldenny/sos-kit/tree/main/skills/attic/insight
Command: npx skills add https://github.com/aspelldenny/sos-kit --skill insight-aspelldenny

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Raw research notes, interviews, and market observations are often noisy and hard to convert into actionable architecture decisions. This skill distills the material into concise bullets that fit into PROJECT.md, SOUL.md, or CHARACTER.md for quick ingestion by the Architect.

Core Features & Use Cases

  • Convert large notes sets into focused bullets aligned to specific vision docs
  • Classify insights by impact on WHAT to build, WHY it exists, or WHO it targets
  • Produce ready-to-paste updates for PROJECT.md, SOUL.md, or CHARACTER.md
  • Use Case: You finish a research sprint and need to update the Architect with key findings to shape the next roadmap.

Quick Start

Paste your raw material (notes, interviews, article excerpts) and indicate the target vision doc sections to update; the skill will return compact bullets ready for insertion.

Frequently Asked Questions about insight

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

FAQPage Schema
How do I distill raw research notes into vision docs?

Distilling raw research notes into vision docs requires providing your unstructured material and indicating target sections for PROJECT.md, SOUL.md, or CHARACTER.md to generate concise, testable bullets for architecture and product-vision alignment.

What is the best way to convert interviews into project doc updates?

Converting interviews into project doc updates is done by classifying insights based on impact on WHAT to build, WHY it exists, or WHO it targets, transforming observations into ready-to-paste bullets for PROJECT.md.

Can I use unstructured market observations to update a SOUL.md file?

Yes, you can use unstructured market observations to update a SOUL.md file by inputting the raw material and specifying target sections, which yields compact bullets designed for quick ingestion by the Architect.

Do I need formatted markdown before distilling notes for a CHARACTER.md file?

No, you do not need formatted markdown before distilling notes for a CHARACTER.md file; the process directly accepts large, unstructured raw material and outputs targeted, testable bullets suitable for vision docs.

Why does stakeholder alignment fail when using raw notes for architecture decisions?

Stakeholder alignment fails when using raw notes for architecture decisions because unstructured material is noisy, whereas distilling notes into concise, testable bullets ensures targeted updates for clear product-vision communication.