File Ops
Documentsfile-opsFile Ops is an Agent Skill for documents published in the barry-ran/QuickDesk repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Read, write, list, move, and inspect files and directories on a remote host via QuickDesk. Use when the user needs to browse folders, view file contents, create or edit files, rename or relocate files, or check file metadata (size, permissions, modification time) on a remote machine.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/barry-ran/QuickDesk/blob/HEAD/quickdesk-skill-host/skills/file-ops/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/file-ops, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
file-ops
Manage files and directories on a remote host connected through QuickDesk.
Tools
read_file
Read the text contents of a file.
- path (string, required) — absolute path to the file
Returns { "path", "content", "size" }.
write_file
Write content to a file. Creates the file (and parent directories) if it does not exist; overwrites if it does.
- path (string, required) — absolute path to the file
- content (string, required) — content to write
Returns { "path", "bytes_written" }.
list_directory
List files and directories at a given path, sorted directories-first then alphabetically.
- path (string, required) — absolute path to the directory
Returns { "path", "count", "entries": [{ "name", "type", "size" }] }.
create_directory
Create a directory and any missing parent directories.
- path (string, required) — absolute path of the directory to create
Returns { "path", "created": true }.
move_file
Move or rename a file or directory.
- source (string, required) — source path
- destination (string, required) — destination path
Returns { "source", "destination", "moved": true }.
get_file_info
Get file metadata including size, type, modification time, and permissions.
- path (string, required) — absolute path to the file or directory
Returns { "path", "type", "size", "readonly", "modified_unix", "permissions_octal" } (permissions_octal on Unix only).
Workflow
- Use
list_directoryto browse a remote folder. - Use
read_fileto inspect a specific file. - Use
write_fileto create or update content — parent directories are created automatically. - Use
get_file_infobefore destructive operations likemove_fileto confirm the target exists and check permissions.