file-insight

Promote chat insights into markdown knowledge-base pages with wikilinks.

1|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/shawnpetros/claude-skills --skill file-insight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-insight
Source: https://github.com/shawnpetros/claude-skills/tree/main/file-insight
Command: npx skills add https://github.com/shawnpetros/claude-skills --skill file-insight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill stops strong analyses from disappearing into chat history by promoting them into a durable, searchable knowledge base entry.

Core Features & Use Cases

  • Promotes substantive chat output to a saved note: Converts multi-paragraph syntheses (comparisons, architecture critiques, decision rationales, research findings, or plans) into a standalone markdown file.
  • Routes the note to the right destination: Automatically selects an appropriate vault folder (references, ideas, projects history, people, or life-admin areas) based on content shape.
  • Maintains navigation and provenance: Updates index.md with a one-line entry, appends to log.md, and includes clear wikilinks and a “Filed from session” footer.

Quick Start

After the assistant produces a useful synthesis, ask it to save it by saying: Worth filing to the vault?

Frequently Asked Questions about file-insight

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

FAQPage Schema
How do I save chat insights to a personal knowledge vault?

To save chat insights to a personal knowledge vault, you promote substantive syntheses like comparisons or research findings into standalone markdown files with wikilinks, updating your vault index and ingestion log to prevent valuable analyses from disappearing into chat history.

How does wikilink-based indexing work for logging research notes?

Wikilink-based indexing for logging research notes works by writing a new markdown file containing aggressive wikilinks, then appending a one-line entry to `index.md` and adding a provenance record to `log.md` to maintain navigation and session history.

What is the best way to organize decision rationales and architecture analysis in a markdown vault?

The best way to organize decision rationales and architecture analysis in a markdown vault is routing the promoted note to an appropriate folder, such as references, projects history, or ideas, based on the content shape and confirming the output is valuable before filing.

Can I avoid saving duplicate or noisy chat transcripts when promoting notes?

Yes, you can avoid saving duplicate or noisy chat transcripts because the promotion process only applies to substantive outputs the user explicitly confirms as valuable, filtering out unneeded conversational filler.

Do I need a specific folder structure to file knowledge management outputs?

You need a folder structure with categories like references, ideas, projects history, people, or life-admin areas so the skill can automatically route your markdown files to the correct destination based on their content shape.