home / skills / trpc-group / trpc-agent-go / user_file_ops

user_file_ops skill

safe

This skill summarizes user and external text files, computes basic statistics, and provides a quick preview to boost review efficiency.

npx playbooks add skill trpc-group/trpc-agent-go --skill user_file_ops

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

1.1 KB

---
name: user-file-ops
description: Simple operations on user-provided text files including summarization.
---

Overview

Summarize text files that come from the user or from other skills.
This skill can compute basic statistics (lines, words, bytes) and
capture a short preview of the file.

User-provided files are typically exposed under `work/inputs/` (for
example, when a host directory is mounted as inputs). Files produced
by other skills are usually written under `out/` and can be
summarized directly from there.

Examples

1) Summarize a text file already present in the workspace

   Command:

   bash scripts/summarize_file.sh \
     work/inputs/example.txt \
     out/example_summary.txt

2) Summarize a different file

   Command:

   bash scripts/summarize_file.sh \
     work/inputs/notes.txt \
     out/notes_summary.txt

3) Summarize a file produced by another skill

   Command:

   bash scripts/summarize_file.sh \
     out/sample_fib.txt \
     out/sample_fib_summary.txt

Output Files

- out/example_summary.txt
- out/notes_summary.txt
- out/sample_fib_summary.txt

Overview

This skill performs simple operations on user-provided text files, including concise summarization and basic file statistics. It computes line, word, and byte counts and captures a short text preview to help you quickly assess file contents. The skill expects files in common workspace locations and writes summaries to an output path.

How this skill works

The skill reads a target text file from the workspace (commonly work/inputs/ or out/) and generates a short summary plus basic metrics: lines, words, bytes, and a preview snippet. It writes the resulting summary and statistics to an output file you specify, making it easy to chain with other tools or skills. The summarization is designed for brevity and quick comprehension rather than exhaustive analysis.

When to use it

Quickly understand the contents of large or unfamiliar text files.
Generate lightweight overviews for files produced by other tools or skills.
Collect simple file metrics for logging or monitoring workflows.
Create preview snippets for human review or downstream processing.

Best practices

Point the skill at plain text files; avoid binary or highly formatted files.
Place user files under work/inputs/ or use out/ for files created by other skills for consistent paths.
Specify a clear output path to capture the summary (e.g., out/your_summary.txt).
Use the preview and metrics for triage, then run fuller analysis if deeper insights are needed.

Example use cases

Summarize a client-provided meeting transcript located at work/inputs/meeting.txt to out/meeting_summary.txt.
Create a quick overview of notes.txt before feeding it into a downstream summarizer or topic extractor.
Generate statistics and a snippet for a log file produced by another skill (input under out/), then store the summary alongside the log.
Batch-process several user files to produce lightweight summaries for an index or dashboard.

FAQ

Which files can I summarize?

Plain text files are supported. Avoid binary files or proprietary formats; convert them to text first.

Where should I put input files?

Place user-supplied files under work/inputs/ for predictable behavior. Files created by other skills usually reside under out/ and can be summarized from there.