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

file_tools skill

safe

This skill helps you manage files and archives with shell commands, returning results and generated outputs for streamlined automation.

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

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

Files (3)

SKILL.md

564 B

---
name: file-tools
description: Simple shell utilities for files and archives.
---

Overview

Use these examples to explore basic shell commands inside a skill
workspace. The assistant can run them and return results and files.

Examples

1) List files in the workspace

   Command:

   ls -la

2) Write a sample file to out/sample.txt

   Command:

   bash scripts/write_sample.sh "Hello from skill" out/sample.txt

3) Create a tar.gz archive of the out/ folder

   Command:

   tar -czf out/sample.tgz -C out .

Output Files

- out/sample.txt
- out/sample.tgz

Overview

This skill provides simple shell utilities for inspecting, creating, and packaging files inside a skill workspace. It exposes common commands to list directories, write files, and create compressed archives. Use it to automate small file operations and produce downloadable artifacts from the workspace.

How this skill works

The skill runs basic shell commands in a controlled workspace and returns command output and generated files. Typical operations include listing files (ls), creating or writing files via shell scripts, and building tar.gz archives of folders. Results include command stdout/stderr and any output files placed in the workspace out/ directory.

When to use it

You need a quick file listing or inspection of the workspace.
You want to generate or update a text file programmatically.
You need to package a folder into a tar.gz archive for download.
You want reproducible examples of simple shell file operations.

Best practices

Keep operations small and idempotent to avoid unintended side effects.
Write files under out/ so results are easy to locate and retrieve.
Use provided scripts for consistent file creation instead of ad hoc commands.
Avoid changing system-level files; confine changes to the workspace.

Example use cases

List all files and permissions in the workspace before running a build.
Create a sample text file with a provided script for testing downstream tools.
Compress the out/ directory into out/sample.tgz and return it for download.
Run a sequence of file commands to prepare input for another agent or tool.

FAQ

What output files does the skill produce?

Typical outputs include out/sample.txt and out/sample.tgz when using the example commands.

How do I write a file into the workspace?

Use the provided write script, for example: bash scripts/write_sample.sh "Your text" out/sample.txt.