← Back to Skills Marketplace
78
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install skylv-file-versioning
Description
Tracks file changes with git-like versioning for any project
Usage Guidance
This skill appears to implement local file versioning and doesn't request network access or credentials, but exercise caution before installing or running it on sensitive directories. Specific points to consider:
- Tag handling bug: SKILL.md promises using tag names (e.g., restore config.json v1.0.0), but the version-parsing function in the included code as shown does not lookup tags; test tag commands carefully and inspect tags.json to confirm behavior.
- Large text files: text files over 10MB are recorded as 'hash-only' while still flagged as text; diffs may be incorrect or misleading for these cases.
- Watch mode: the watch command runs continuously and will snapshot anything you point it at. Only use it on directories/files you trust and intend to version; do not point it at system or secret-containing directories unless you understand the consequences.
- Review full source before use: the provided code snippet is truncated in the listing; inspect the rest of version_engine.js to ensure there are no hidden network calls, telemetry, or operations beyond local file I/O.
If you need to proceed: run the tool in a sandbox or on a non-sensitive test directory, verify tag/restore/diff behaviors, and confirm that snapshots are stored only where you expect (.fvsnap next to target files).
Capability Tags
Capability Assessment
Purpose & Capability
Name/description promise git-like file versioning and the package includes a Node.js engine (version_engine.js) that snapshots files to a local .fvsnap directory, shows history, diffs, tags, restore, compare and watch — which is coherent with the stated purpose. No external credentials, binaries, or network access are requested.
Instruction Scope
SKILL.md instructs the agent to run node version_engine.js commands and to snapshot/restore files — expected. However, there are mismatches between the documentation and code: parseVersion in the provided code does not resolve tag names (it only understands HEAD, HEAD~N, or numeric versions), yet SKILL.md repeatedly describes tagging and using tag names (e.g., restore <file> v1.0.0). There are also edge-case behaviors (text files > 10MB are stored as hash-only but are still marked isText, which may produce confusing diffs). These incoherences mean the skill may behave differently than described.
Install Mechanism
No install spec and no external downloads — the skill is instruction-only plus included source files. This is the lower-risk delivery model (nothing is pulled from arbitrary URLs during install).
Credentials
The skill requests no environment variables, credentials, or config paths. Its file and directory reads/writes are limited to paths specified by the user (it writes a local .fvsnap directory next to tracked files), which is proportionate to its purpose.
Persistence & Privilege
always is false and the skill does not request persistent platform privileges. It writes only to per-project .fvsnap directories and tags.json within those directories; it does not attempt to modify other skills or system-wide agent settings in the provided code.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install skylv-file-versioning - After installation, invoke the skill by name or use
/skylv-file-versioning - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added a front matter section to SKILL.md with concise description, keywords, name, and triggers.
- Included an explicit "Install" section at the end, detailing how to add the skill using OpenClaw.
- No functional or API changes; documentation and metadata improvements only.
- Existing technical content, usage, and features remain unchanged.
v1.0.0
Initial release: Git-style version control for any file with snapshots, diffs, tags, and restore—no git required.
- Capture file snapshots with metadata and hash, stored locally in a `.fvsnap` directory.
- View complete file history with versioning, messages, and hashes.
- See detailed diffs (including binary-aware comparison and color-coded text changes).
- Tag file versions for easy reference and restore to any previous state (or tag).
- Monitor files/directories for changes and auto-snapshot on modification.
- Compare any two files, regardless of version history.
- Pure Node.js operation—no external dependencies or git required.
Metadata
Frequently Asked Questions
What is Skylv File Versioning?
Tracks file changes with git-like versioning for any project. It is an AI Agent Skill for Claude Code / OpenClaw, with 78 downloads so far.
How do I install Skylv File Versioning?
Run "/install skylv-file-versioning" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Skylv File Versioning free?
Yes, Skylv File Versioning is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Skylv File Versioning support?
Skylv File Versioning is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Skylv File Versioning?
It is built and maintained by SKY-lv (@sky-lv); the current version is v1.0.1.
More Skills