← Back to Skills Marketplace
118
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install protein-struct-viz
Description
Generate PyMOL scripts to highlight specific protein residues in PDB structures. Use this skill when the user needs to visualize specific amino acid residues...
Usage Guidance
This skill appears to do what it says (generate PyMOL scripts), but exercise caution before installing or running generated scripts.
What to consider before using:
- Do NOT run .pml files produced from untrusted inputs without inspection. The generator inserts user-provided residue specs directly into the script, so malicious text could inject PyMOL commands.
- Restrict the output path: the tool writes the provided filename verbatim. Avoid running it with untrusted output paths and ensure the filename is normalized and confined to a safe workspace (prevent '../' escapes).
- Validate inputs: only allow residue specs that match a safe pattern (example regex idea: ^(?:(?:[A-Za-z]|\*)?:)?\d{1,5}(?::[A-Z]{3})?$ with explicit handling of wildcards) and disallow characters like semicolons, newline, backticks, or other shell/command delimiters. Sanitize color names and style choices against allowed lists.
- Review generated .pml before executing in PyMOL, and avoid executing scripts from unknown sources. Look for unexpected commands (e.g., system calls or file manipulation commands) inserted into the file.
- Be aware that the generated scripts may include 'fetch <pdb_id>' which triggers network downloads when run inside PyMOL; if that is a privacy or network policy concern run PyMOL in an environment where network access is controlled.
- If you plan to adopt this skill into automated workflows, either add input sanitization and path normalization to scripts/main.py or run the generator in a sandbox/VM and only transfer inspected outputs into production systems.
If you want, I can provide a safe-sanitizing wrapper for this script (validate residue specs, restrict output path to workspace, and whitelist style/color inputs) or specific regex patterns and filename normalization code to reduce these risks.
Capability Analysis
Type: OpenClaw Skill
Name: protein-struct-viz
Version: 1.0.0
The protein-struct-viz skill is a legitimate bioinformatics tool designed to generate PyMOL visualization scripts (.pml). The core logic in scripts/main.py safely constructs PyMOL commands based on user-provided residue specifications and structural data, with no evidence of malicious intent, data exfiltration, or unauthorized execution. While the SKILL.md documentation self-identifies as 'High' risk due to the nature of script generation and network fetching of PDB files, these behaviors are standard for the stated purpose and are handled transparently.
Capability Assessment
Purpose & Capability
Name/description match the actual artifacts: the repository includes a Python script that generates PyMOL (.pml) scripts and the SKILL.md documents expected parameters. It requires PyMOL to be installed separately (declared) and no unrelated credentials or binaries are requested.
Instruction Scope
The generator embeds user-supplied residue specs and output filename directly into the .pml text with no sanitization. A malicious or malformed residue string can inject arbitrary PyMOL commands into the generated script; the output filename is used directly and can contain path traversal (e.g., '../') leading to writing files outside the workspace. The script also emits 'fetch <pdb_id>' commands — when run in PyMOL those will perform network downloads. SKILL.md lists input validation in a checklist but the implementation does not enforce it.
Install Mechanism
No install spec or remote downloads are present; this is essentially an instruction + included script. Nothing in the manifest pulls external archives or installs packages during install time.
Credentials
No environment variables or credentials are requested, which is proportionate for the stated functionality. There are no unexpected secret accesses.
Persistence & Privilege
always:false and no special persistence or skill-wide config modifications. The skill does write files to disk (output .pml) but does not request elevated platform privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install protein-struct-viz - After installation, invoke the skill by name or use
/protein-struct-viz - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of protein-struct-viz.
- Generates customizable PyMOL scripts to highlight specific protein residues in PDB structures.
- Supports multiple residue selection formats and visual styles (sticks, spheres, surface, cartoon).
- Allows user-defined color schemes and output filenames for generated scripts.
- Designed for creating publication-ready protein structure visualizations.
- No external Python package dependencies; outputs plain text PyMOL scripts.
Metadata
Frequently Asked Questions
What is Protein Struct Viz?
Generate PyMOL scripts to highlight specific protein residues in PDB structures. Use this skill when the user needs to visualize specific amino acid residues... It is an AI Agent Skill for Claude Code / OpenClaw, with 118 downloads so far.
How do I install Protein Struct Viz?
Run "/install protein-struct-viz" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Protein Struct Viz free?
Yes, Protein Struct Viz is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Protein Struct Viz support?
Protein Struct Viz is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Protein Struct Viz?
It is built and maintained by AIpoch (@aipoch-ai); the current version is v1.0.0.
More Skills