research-folder-synthesizer

Research Folder Synthesizer

This skill synthesizes a folder of heterogeneous local files (markdown notes, plain-text articles, research excerpts) into a structured thematic report. It clusters ideas across files, surfaces key findings and contradictions, and produces a single research-synthesis.md ready to use as a foundation for reports, PRDs, or strategy documents.

Input:

• A folder path or list of local file paths (.md, .txt, plain text)
• Optional: a focus question or research angle to guide thematic clustering

Output:

• research-synthesis.md — structured markdown with executive summary, named themes, key findings, contradictions/gaps, and source index

---

Language Detection

Detect the user's language from their message:

• If Russian (or contains Cyrillic): respond in Russian
• If English (or other Latin-script language): respond in English
• If ambiguous: respond in the language of the trigger phrase used

---

Instructions

Step 1: Validate Input

1. Check that the user has provided a folder path or a list of files.

   • If nothing provided: stop and report — "No files found. Provide a folder path or paste file contents directly."

2. Attempt to read all files at the provided path.

   • Log each file name and detected type (.md, .txt, or plain text) in the report preamble.
   • Skip unreadable files (binary, images, etc.); add them to a "Skipped files" list — do not stop the pipeline.
   • If all files are unreadable: stop and report — "No readable text found. Provide .md, .txt, or plain-text files."

3. If only one file is provided: note that cross-source comparison will be unavailable; proceed with single-source synthesis.

4. If >20 files: note that depth per file will be reduced for brevity; proceed.

Negative Cases:

• Folder path not provided or folder empty → stop with clear message (Step 1.1).
• All files unreadable → stop with clear message (Step 1.2).
• User provides a URL instead of local files → clarify: "This skill works with local files. Paste the text directly or save it as a .txt file first."