← Back to Skills Marketplace
dinghaibin

Groups Tool

by BIN · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
41
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install groups-tool
Description
Display user group memberships on the system. Shows all groups a user belongs to for permission auditing and access control verification.
README (SKILL.md)

Groups - User Group Membership Checker

Display all group memberships for the current user or a specified system user. Group membership determines file access permissions and sudo privileges on Unix-like systems.

Usage

groups-tool [options] [username]

When called without arguments, shows groups for the current user. Specify a username to check another user's memberships.

Examples

# Show groups for current user
groups-tool

# Show groups for a specific user
groups-tool www-data

# Show numeric group IDs
groups-tool -id

Notes

Groups are read from /etc/group and can include both primary and supplementary group memberships. Changes to group membership take effect on next login.

Usage Guidance
This skill's documentation describes a full CLI that shows all groups for a specified user and supports options, but the included script is much more limited: it only prints supplementary groups for the current login user and does not implement username arguments or the -id option. It's not malicious, but it's inconsistent and likely non-functional for the documented use-cases. Before installing or trusting this skill: 1) ask the publisher for a corrected implementation that supports username argument, numeric ID option, and includes the primary group; 2) inspect or run the script in a safe/test environment (note os.getlogin() can fail in non-interactive contexts); 3) prefer an implementation that uses pwd.getpwuid(os.getuid()) for the current user and checks primary group via grp.getgrgid(), and that has CLI parsing. If you need the documented features, do not rely on the current package as-is.
Capability Analysis
Type: OpenClaw Skill Name: groups-tool Version: 1.0.0 The skill bundle provides a simple utility to list group memberships for the current user. While the documentation in SKILL.md describes features (like checking other users or numeric IDs) that are not actually implemented in the scripts/groups.py script, the code itself is harmless and performs read-only operations using standard Python libraries (grp, os) without any signs of malicious intent or data exfiltration.
Capability Assessment
Purpose & Capability
SKILL.md claims a full CLI (groups-tool [options] [username], -id option, ability to query another user, and mentions primary and supplementary groups). The bundled script (scripts/groups.py) only checks grp.getgrall() and prints group names where os.getlogin() appears in gr_mem — i.e., it only finds supplementary groups for the current login user. It does not accept a username argument, does not implement -id, and does not include the primary group (gid) lookup. This is a mismatch between claimed capability and actual implementation.
Instruction Scope
SKILL.md instructs running a CLI with options and querying /etc/group; the script does read the group database via the grp module (consistent with reading /etc/group) but the runtime instructions expect behavior the code does not provide. The script only prints supplementary groups for the login user, and uses os.getlogin(), which may fail in non-interactive contexts. There is no instruction to handle failures or to accept alternate usernames, so agent runtime behavior could be surprising or non-functional.
Install Mechanism
No install spec and only a small local script are included. Nothing is downloaded or written at install time — lowest install risk.
Credentials
No environment variables, credentials, or external endpoints are requested. The skill reads the system group database only, which is appropriate for its stated purpose.
Persistence & Privilege
always is false, model invocation is allowed (default). The skill does not request persistent system presence or modify other skill/system configurations. No elevated privileges are requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install groups-tool
  3. After installation, invoke the skill by name or use /groups-tool
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Slug groups-tool
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Groups Tool?

Display user group memberships on the system. Shows all groups a user belongs to for permission auditing and access control verification. It is an AI Agent Skill for Claude Code / OpenClaw, with 41 downloads so far.

How do I install Groups Tool?

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

Is Groups Tool free?

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

Which platforms does Groups Tool support?

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

Who created Groups Tool?

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

💬 Comments