file-retrieval

Search a local filesystem for files by keyword and extension, then preview and attach the confirmed file.

335|2|Updated May 6, 2026
One-click install
npx skills add https://github.com/THU-SAGE/syll --skill file-retrieval
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-retrieval
Source: https://github.com/THU-SAGE/syll/tree/main/syll/skills/file-retrieval
Command: npx skills add https://github.com/THU-SAGE/syll --skill file-retrieval

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you locate a specific file on your local machine and deliver it to the user after an explicit confirmation step.

Core Features & Use Cases

  • Guided file discovery: Searches the filesystem using your query, narrowing by chosen roots and optional extensions when known.
  • Preview before sending: Renders previews for multiple candidate matches and presents an indexed list including size, modification time, and absolute path.
  • Confirmed delivery: Sends the selected file only in a separate second step to prevent accidental disclosure.

Use case example: You ask for “the latest monthly report pdf,” the Skill previews the top matches (by modification time if there are many), and you pick which one to send.

Quick Start

Ask for a file by saying something like: "Find the weekly report on my desktop and send the one you think is the latest after you show me the options."

Frequently Asked Questions about file-retrieval

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

FAQPage Schema
How do I find and send a local file from my Downloads or Desktop without accidentally sharing the wrong one?

To find and send a local file safely, this Skill searches a specified filesystem root for your query and previews candidate matches with size and modification time. You then explicitly confirm the correct absolute-path file before it is attached and sent, preventing accidental disclosure.

Can I filter filesystem search results by file extension when looking for specific documents like a PDF report?

You can filter filesystem search results by optional file extensions when locating documents. The Skill narrows down candidate matches in the specified root directory, presents an indexed list with document previews, and attaches the confirmed file only after you select it.

What is the best way to handle multiple candidate files matching a keyword search before sending one?

The best way to handle multiple candidate files is using a guided preview workflow. The Skill discovers all matching files, sorts them by modification time if there are many, displays an indexed list with absolute paths and metadata, and waits for your explicit confirmation before delivering the selected file.

How does the two-turn file discovery and confirmation workflow prevent accidental file disclosure?

The two-turn workflow prevents accidental file disclosure by separating discovery from delivery. In the first turn, it searches the filesystem and previews results with metadata. In the second turn, it only attaches and sends the file after you explicitly confirm the exact match from the preview list.

Can I use local automation to retrieve a document preview and attach an absolute-path file to my current channel?

You can use local automation to retrieve document previews and attach absolute-path files. The Skill searches your local filesystem, renders previews for candidate matches including size and modification time, and attaches the confirmed file to the current channel only after explicit user confirmation.

Does file discovery work when I only know a keyword and the approximate root directory?

File discovery works with keyword-based searches across a specified root directory. The Skill locates files matching your query, optionally filters by known extensions, previews the top candidate matches with their absolute paths, and requires explicit confirmation before sending the selected document.