> (1) User is new and hasn't run any tools yet, (3) Modal authentication errors occur, (4) User asks how to get started or set up the environment, (5) biomodals directory is missing or tools aren't working.
npx skills add https://github.com/BioTender-max/awesome-bio-agent-skills --skill setup
Help users get their environment ready to run protein design tools.
Run through this checklist when a user encounters setup issues:
| Step | Check | Fix |
|------|-------|-----|
| 1. Modal CLI | modal --version | pip install modal |
| 2. Modal auth | modal token show | modal setup |
| 3. biomodals | ls biomodals/modal_*.py | git clone https://github.com/hgbrian/biomodals |
| 4. Test | cd biomodals && modal run modal_boltzgen.py --help | See troubleshooting |
Cause: Modal CLI not installed.
Fix:
pip install modal
Then restart the terminal or run hash -r.
Cause: Modal not authenticated.
Fix:
modal setup
This opens a browser. Click "Authorize" to complete authentication.
Cause: biomodals repository not cloned or not in correct directory.
Fix:
git clone https://github.com/hgbrian/biomodals
cd biomodals
Cause: uvx is an optional wrapper from the uv package. It's not required.
Fix: Run modal directly (recommended):
modal run modal_boltzgen.py --help
Or install uv if you prefer using uvx:
pip install uv
pip install modal
Verify: modal --version
modal setup
This opens a browser. Click "Authorize".
Verify: modal token show
git clone https://github.com/hgbrian/biomodals
cd biomodals
Verify: ls modal_*.py should show files like modal_boltzgen.py
cd biomodals
modal run modal_boltzgen.py --help
Expected: Usage instructions appear showing --input-yaml, --protocol, --num-designs options.
Once setup is complete, users can:
cd biomodals
# Design binders with BoltzGen (requires YAML config)
modal run modal_boltzgen.py --input-yaml binder.yaml --protocol protein-anything --num-designs 50
# Generate backbones with RFdiffusion
modal run modal_rfdiffusion.py --pdb target.pdb --contigs "A1-150/0 70-100" --num-designs 100
# Validate with Chai
modal run modal_chai1.py --input-faa designs.fasta
Set GPU with environment variable:
GPU=A10G modal run modal_rfdiffusion.py --pdb target.pdb --contigs "A1-100/0 50-80" --num-designs 10
GPU=L40S modal run modal_boltzgen.py --input-yaml config.yaml --num-designs 50
GPU=A100 modal run modal_chai1.py --input-faa complex.fasta
| GPU | VRAM | Best For |
|-----|------|----------|
| T4 | 16GB | ProteinMPNN, ESM |
| A10G | 24GB | RFdiffusion, Chai |
| L40S | 48GB | BoltzGen, BindCraft |
| A100 | 40-80GB | Large complexes |
Modal offers $30/month in free credits - enough for:
Full documentation: See Installation Guide
Expert in secure backend coding practices specializing in input validation, authentication, and API security. Use PROACTIVELY for backend security implementations or security code reviews.
This skill should be used when the user asks to "perform cloud penetration testing", "assess Azure or AWS or GCP security", "enumerate cloud resources", "exploit cloud misconfigurations", "test O365 security", "extract secrets from cloud environments", or "audit cloud infrastructure". It provides comprehensive techniques for security assessment across major cloud platforms.
You are a dependency security expert specializing in vulnerability scanning, license compliance, and supply chain security. Analyze project dependencies for known vulnerabilities, licensing issues, outdated packages, and provide actionable remediation strategies.
Comprehensive Flow Nexus platform management - authentication, sandboxes, app deployment, payments, and challenges
This skill should be used when the user asks to "escalate privileges on Linux", "find privesc vectors on Linux systems", "exploit sudo misconfigurations", "abuse SUID binaries", "exploit cron jobs for root access", "enumerate Linux systems for privilege escalation", or "gain root access from low-privilege shell". It provides comprehensive techniques for identifying and exploiting privilege escalation paths on Linux systems.
Expert malware analyst specializing in defensive malware research, threat intelligence, and incident response. Masters sandbox analysis, behavioral analysis, and malware family identification. Handles static/dynamic analysis, unpacking, and IOC extraction. Use PROACTIVELY for malware triage, threat hunting, incident response, or security research.
This skill should be used when the user asks to "use Metasploit for penetration testing", "exploit vulnerabilities with msfconsole", "create payloads with msfvenom", "perform post-exploitation", "use auxiliary modules for scanning", or "develop custom exploits". It provides comprehensive guidance for leveraging the Metasploit Framework in security assessments.
Expert in secure mobile coding practices specializing in input validation, WebView security, and mobile-specific security patterns. Use PROACTIVELY for mobile security implementations or mobile security code reviews.
Take biotender-max/setup from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference pip.
Without those the skill loads but fails at the first command.