← Back to Skills Marketplace
dinghaibin

Join Tool

by BIN · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
37
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install join-tool
Description
Join lines of text from multiple files based on a common field. Use for relational data operations similar to SQL JOIN on text files.
README (SKILL.md)

Join - Relational Data Operator

Merge lines from two sorted files by matching a common join field. Similar to database JOIN operations but works on plain text files with field separators.

Usage

join-tool [options] file1 file2

Options

  • -1 N: Join on field N of file 1
  • -2 N: Join on field N of file 2
  • -t char: Use char as field separator
  • -a 1: Show unpaired lines from file 1

Examples

join-tool users.txt roles.txt
join-tool -t ',' -1 2 -2 1 customers.csv orders.csv
Usage Guidance
This skill's documentation promises a field-aware join utility but the included script only concatenates corresponding lines from two files. That mismatch means you should not rely on it for real join semantics — it can produce incorrect results. Before installing or using it: (1) review and test scripts/join.py on non-sensitive sample data; (2) confirm whether the author intended this simplified behavior or whether the full implementation is missing; (3) if you need true JOIN behavior, use a well-known tool (e.g., Unix 'join', csvkit, or a scripting library) instead; (4) avoid running it on production or sensitive files until corrected. If the author provides an updated implementation that matches the SKILL.md, reassess — until then the skill is incoherent and potentially dangerous due to misleading behavior.
Capability Analysis
Type: OpenClaw Skill Name: join-tool Version: 1.0.0 The skill provides a primitive Python script (scripts/join.py) that performs a simple line-by-line concatenation of two files using zip(). While the SKILL.md documentation describes advanced relational join features and command-line options (like field selection and separators) that the script does not actually implement, there is no evidence of malicious intent, data exfiltration, or security vulnerabilities. The discrepancy appears to be a functional deficiency rather than a security risk.
Capability Assessment
Purpose & Capability
The name/description and SKILL.md describe a text-file JOIN with field selection, separators, and options (-1, -2, -t, -a). The provided script (scripts/join.py) simply reads two files and concatenates corresponding lines (zip), with no support for fields, separators, options, sorting, or proper join semantics. This is a clear mismatch: the skill claims capabilities it does not implement.
Instruction Scope
SKILL.md instructs usage of a 'join-tool' with many options and examples implying complex behavior. The runtime artifact is a minimal script that ignores those options. The instructions thus overpromise and could cause users to run it expecting SQL-like joins; there is no guidance about limitations or fallback behavior.
Install Mechanism
No install spec is provided (instruction-only), which is low-risk. However a code file is bundled (scripts/join.py). The SKILL.md references an executable 'join-tool' while the repo contains 'join.py' — another coherence problem but not an installation risk by itself.
Credentials
No environment variables, credentials, or config paths are requested. The skill does not access network, secrets, or other system resources in the provided code.
Persistence & Privilege
No special persistence or elevated privileges are requested (always: false). The skill is user-invocable and can be called autonomously (default), which is normal and not by itself concerning here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install join-tool
  3. After installation, invoke the skill by name or use /join-tool
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Slug join-tool
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Join Tool?

Join lines of text from multiple files based on a common field. Use for relational data operations similar to SQL JOIN on text files. It is an AI Agent Skill for Claude Code / OpenClaw, with 37 downloads so far.

How do I install Join Tool?

Run "/install join-tool" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Join Tool free?

Yes, Join Tool is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Join Tool support?

Join Tool is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Join Tool?

It is built and maintained by BIN (@dinghaibin); the current version is v1.0.0.

💬 Comments