[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7356XWHWGD2SN8FXKK22H96":3,"skill-same:01M7356XWHWGD2SN8FXKK22H96":63},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":6,"updatedAt":34,"install":35,"resources":48},"01M7356XWHWGD2SN8FXKK22H96","alterlab-benchling",null,"Part of the AlterLab Academic Skills suite. Benchling R&D platform integration. Access registry (DNA, proteins), inventory, ELN entries, workflows via API, build Benchling Apps, query Data Warehouse, for lab data management automation.","roohe\u002Fagentic-super-skills","roohe","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99054084?v=4","01M734WCDFP6RZVT5CNM00QR26","01M734WCE4BD0T4NZS5PCV9V5F",10,"MIT","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Falterlab-benchling\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: alterlab-benchling\ndescription: Part of the AlterLab Academic Skills suite. Benchling R&D platform integration. Access registry (DNA, proteins), inventory, ELN entries, workflows via API, build Benchling Apps, query Data Warehouse, for lab data management automation.\nlicense: MIT\ncompatibility: Requires a Benchling account and API key\nmetadata:\n    skill-author: AlterLab\n    version: \"1.0.0\"\n---\n\n# Benchling Integration\n\n## Overview\n\nBenchling is a cloud platform for life sciences R&D. Access registry entities (DNA, proteins), inventory, electronic lab notebooks, and workflows programmatically via Python SDK and REST API.\n\n## When to Use This Skill\n\nThis skill should be used when:\n- Working with Benchling's Python SDK or REST API\n- Managing biological sequences (DNA, RNA, proteins) and registry entities\n- Automating inventory operations (samples, containers, locations, transfers)\n- Creating or querying electronic lab notebook entries\n- Building workflow automations or Benchling Apps\n- Syncing data between Benchling and external systems\n- Querying the Benchling Data Warehouse for analytics\n- Setting up event-driven integrations with AWS EventBridge\n\n## Core Capabilities\n\n### 1. Authentication & Setup\n\n**Python SDK Installation:**\n```python\n# Stable release\nuv pip install benchling-sdk\n# or with Poetry\npoetry add benchling-sdk\n```\n\n**Authentication Methods:**\n\nAPI Key Authentication (recommended for scripts):\n```python\nfrom benchling_sdk.benchling import Benchling\nfrom benchling_sdk.auth.api_key_auth import ApiKeyAuth\n\nbenchling = Benchling(\n    url=\"https:\u002F\u002Fyour-tenant.benchling.com\",\n    auth_method=ApiKeyAuth(\"your_api_key\")\n)\n```\n\nOAuth Client Credentials (for apps):\n```python\nfrom benchling_sdk.auth.client_credentials_oauth2 import ClientCredentialsOAuth2\n\nauth_method = ClientCredentialsOAuth2(\n    client_id=\"your_client_id\",\n    client_secret=\"your_client_secret\"\n)\nbenchling = Benchling(\n    url=\"https:\u002F\u002Fyour-tenant.benchling.com\",\n    auth_method=auth_method\n)\n```\n\n**Key Points:**\n- API keys are obtained from Profile Settings in Benchling\n- Store credentials securely (use environment variables or password managers)\n- All API requests require HTTPS\n- Authentication permissions mirror user permissions in the UI\n\nFor detailed authentication information including OIDC and security best practices, refer to `references\u002Fauthentication.md`.\n\n### 2. Registry & Entity Management\n\nRegistry entities include DNA sequences, RNA sequences, AA sequences, custom entities, and mixtures. The SDK provides typed classes for creating and managing these entities.\n\n**Creating DNA Sequences:**\n```python\nfrom benchling_sdk.models import DnaSequenceCreate\n\nsequence = benchling.dna_sequences.create(\n    DnaSequenceCreate(\n        name=\"My Plasmid\",\n        bases=\"ATCGATCG\",\n        is_circular=True,\n        folder_id=\"fld_abc123\",\n        schema_id=\"ts_abc123\",  # optional\n        fields=benchling.models.fields({\"gene_name\": \"GFP\"})\n    )\n)\n```\n\n**Registry Registration:**\n\nTo register an entity directly upon creation:\n```python\nsequence = benchling.dna_sequences.create(\n    DnaSequenceCreate(\n        name=\"My Plasmid\",\n        bases=\"ATCGATCG\",\n        is_circular=True,\n        folder_id=\"fld_abc123\",\n        entity_registry_id=\"src_abc123\",  # Registry to register in\n        naming_strategy=\"NEW_IDS\"  # or \"IDS_FROM_NAMES\"\n    )\n)\n```\n\n**Important:** Use either `entity_registry_id` OR `naming_strategy`, never both.\n\n**Updating Entities:**\n```python\nfrom benchling_sdk.models import DnaSequenceUpdate\n\nupdated = benchling.dna_sequences.update(\n    sequence_id=\"seq_abc123\",\n    dna_sequence=DnaSequenceUpdate(\n        name=\"Updated Plasmid Name\",\n        fields=benchling.models.fields({\"gene_name\": \"mCherry\"})\n    )\n)\n```\n\nUnspecified fields remain unchanged, allowing partial updates.\n\n**Listing and Pagination:**\n```python\n# List all DNA sequences (returns a generator)\nsequences = benchling.dna_sequences.list()\nfor page in sequences:\n    for seq in page:\n        print(f\"{seq.name} ({seq.id})\")\n\n# Check total count\ntotal = sequences.estimated_count()\n```\n\n**Key Operations:**\n- Create: `benchling.\u003Centity_type>.create()`\n- Read: `benchling.\u003Centity_type>.get(id)` or `.list()`\n- Update: `benchling.\u003Centity_type>.update(id, update_object)`\n- Archive: `benchling.\u003Centity_type>.archive(id)`\n\nEntity types: `dna_sequences`, `rna_sequences`, `aa_sequences`, `custom_entities`, `mixtures`\n\nFor comprehensive SDK reference and advanced patterns, refer to `references\u002Fsdk_reference.md`.\n\n### 3. Inventory Management\n\nManage physical samples, containers, boxes, and locations within the Benchling inventory system.\n\n**Creating Containers:**\n```python\nfrom benchling_sdk.models import ContainerCreate\n\ncontainer = benchling.containers.create(\n    ContainerCreate(\n        name=\"Sample Tube 001\",\n        schema_id=\"cont_schema_abc123\",\n        parent_storage_id=\"box_abc123\",  # optional\n        fields=benchling.models.fields({\"concentration\": \"100 ng\u002FμL\"})\n    )\n)\n```\n\n**Managing Boxes:**\n```python\nfrom benchling_sdk.models import BoxCreate\n\nbox = benchling.boxes.create(\n    BoxCreate(\n        name=\"Freezer Box A1\",\n        schema_id=\"box_schema_abc123\",\n        parent_storage_id=\"loc_abc123\"\n    )\n)\n```\n\n**Transferring Items:**\n```python\n# Transfer a container to a new location\ntransfer = benchling.containers.transfer(\n    container_id=\"cont_abc123\",\n    destination_id=\"box_xyz789\"\n)\n```\n\n**Key Inventory Operations:**\n- Create containers, boxes, locations, plates\n- Update inventory item properties\n- Transfer items between locations\n- Check in\u002Fout items\n- Batch operations for bulk transfers\n\n### 4. Notebook & Documentation\n\nInteract with electronic lab notebook (ELN) entries, protocols, and templates.\n\n**Creating Notebook Entries:**\n```python\nfrom benchling_sdk.models import EntryCreate\n\nentry = benchling.entries.create(\n    EntryCreate(\n        name=\"Experiment 2025-10-20\",\n        folder_id=\"fld_abc123\",\n        schema_id=\"entry_schema_abc123\",\n        fields=benchling.models.fields({\"objective\": \"Test gene expression\"})\n    )\n)\n```\n\n**Linking Entities to Entries:**\n```python\n# Add references to entities in an entry\nentry_link = benchling.entry_links.create(\n    entry_id=\"entry_abc123\",\n    entity_id=\"seq_xyz789\"\n)\n```\n\n**Key Notebook Operations:**\n- Create and update lab notebook entries\n- Manage entry templates\n- Link entities and results to entries\n- Export entries for documentation\n\n### 5. Workflows & Automation\n\nAutomate laboratory processes using Benchling's workflow system.\n\n**Creating Workflow Tasks:**\n```python\nfrom benchling_sdk.models import WorkflowTaskCreate\n\ntask = benchling.workflow_tasks.create(\n    WorkflowTaskCreate(\n        name=\"PCR Amplification\",\n        workflow_id=\"wf_abc123\",\n        assignee_id=\"user_abc123\",\n        fields=benchling.models.fields({\"template\": \"seq_abc123\"})\n    )\n)\n```\n\n**Updating Task Status:**\n```python\nfrom benchling_sdk.models import WorkflowTaskUpdate\n\nupdated_task = benchling.workflow_tasks.update(\n    task_id=\"task_abc123\",\n    workflow_task=WorkflowTaskUpdate(\n        status_id=\"status_complete_abc123\"\n    )\n)\n```\n\n**Asynchronous Operations:**\n\nSome operations are asynchronous and return tasks:\n```python\n# Wait for task completion\nfrom benchling_sdk.helpers.tasks import wait_for_task\n\nresult = wait_for_task(\n    benchling,\n    task_id=\"task_abc123\",\n    interval_wait_seconds=2,\n    max_wait_seconds=300\n)\n```\n\n**Key Workflow Operations:**\n- Create and manage workflow tasks\n- Update task statuses and assignments\n- Execute bulk operations asynchronously\n- Monitor task progress\n\n### 6. Events & Integration\n\nSubscribe to Benchling events for real-time integrations using AWS EventBridge.\n\n**Event Types:**\n- Entity creation, update, archive\n- Inventory transfers\n- Workflow task status changes\n- Entry creation and updates\n- Results registration\n\n**Integration Pattern:**\n1. Configure event routing to AWS EventBridge in Benchling settings\n2. Create EventBridge rules to filter events\n3. Route events to Lambda functions or other targets\n4. Process events and update external systems\n\n**Use Cases:**\n- Sync Benchling data to external databases\n- Trigger downstream processes on workflow completion\n- Send notifications on entity changes\n- Audit trail logging\n\nRefer to Benchling's event documentation for event schemas and configuration.\n\n### 7. Data Warehouse & Analytics\n\nQuery historical Benchling data using SQL through the Data Warehouse.\n\n**Access Method:**\nThe Benchling Data Warehouse provides SQL access to Benchling data for analytics and reporting. Connect using standard SQL clients with provided credentials.\n\n**Common Queries:**\n- Aggregate experimental results\n- Analyze inventory trends\n- Generate compliance reports\n- Export data for external analysis\n\n**Integration with Analysis Tools:**\n- Jupyter notebooks for interactive analysis\n- BI tools (Tableau, Looker, PowerBI)\n- Custom dashboards\n\n## Best Practices\n\n### Error Handling\n\nThe SDK automatically retries failed requests:\n```python\n# Automatic retry for 429, 502, 503, 504 status codes\n# Up to 5 retries with exponential backoff\n# Customize retry behavior if needed\nfrom benchling_sdk.retry import RetryStrategy\n\nbenchling = Benchling(\n    url=\"https:\u002F\u002Fyour-tenant.benchling.com\",\n    auth_method=ApiKeyAuth(\"your_api_key\"),\n    retry_strategy=RetryStrategy(max_retries=3)\n)\n```\n\n### Pagination Efficiency\n\nUse generators for memory-efficient pagination:\n```python\n# Generator-based iteration\nfor page in benchling.dna_sequences.list():\n    for sequence in page:\n        process(sequence)\n\n# Check estimated count without loading all pages\ntotal = benchling.dna_sequences.list().estimated_count()\n```\n\n### Schema Fields Helper\n\nUse the `fields()` helper for custom schema fields:\n```python\n# Convert dict to Fields object\ncustom_fields = benchling.models.fields({\n    \"concentration\": \"100 ng\u002FμL\",\n    \"date_prepared\": \"2025-10-20\",\n    \"notes\": \"High quality prep\"\n})\n```\n\n### Forward Compatibility\n\nThe SDK handles unknown enum values and types gracefully:\n- Unknown enum values are preserved\n- Unrecognized polymorphic types return `UnknownType`\n- Allows working with newer API versions\n\n### Security Considerations\n\n- Never commit API keys to version control\n- Use environment variables for credentials\n- Rotate keys if compromised\n- Grant minimal necessary permissions for apps\n- Use OAuth for multi-user scenarios\n\n## Resources\n\n### references\u002F\n\nDetailed reference documentation for in-depth information:\n\n- **authentication.md** - Comprehensive authentication guide including OIDC, security best practices, and credential management\n- **sdk_reference.md** - Detailed Python SDK reference with advanced patterns, examples, and all entity types\n- **api_endpoints.md** - REST API endpoint reference for direct HTTP calls without the SDK\n\nLoad these references as needed for specific integration requirements.\n\n### scripts\u002F\n\nThis skill currently includes example scripts that can be removed or replaced with custom automation scripts for your specific Benchling workflows.\n\n## Common Use Cases\n\n**1. Bulk Entity Import:**\n```python\n# Import multiple sequences from FASTA file\nfrom Bio import SeqIO\n\nfor record in SeqIO.parse(\"sequences.fasta\", \"fasta\"):\n    benchling.dna_sequences.create(\n        DnaSequenceCreate(\n            name=record.id,\n            bases=str(record.seq),\n            is_circular=False,\n            folder_id=\"fld_abc123\"\n        )\n    )\n```\n\n**2. Inventory Audit:**\n```python\n# List all containers in a specific location\ncontainers = benchling.containers.list(\n    parent_storage_id=\"box_abc123\"\n)\n\nfor page in containers:\n    for container in page:\n        print(f\"{container.name}: {container.barcode}\")\n```\n\n**3. Workflow Automation:**\n```python\n# Update all pending tasks for a workflow\ntasks = benchling.workflow_tasks.list(\n    workflow_id=\"wf_abc123\",\n    status=\"pending\"\n)\n\nfor page in tasks:\n    for task in page:\n        # Perform automated checks\n        if auto_validate(task):\n            benchling.workflow_tasks.update(\n                task_id=task.id,\n                workflow_task=WorkflowTaskUpdate(\n                    status_id=\"status_complete\"\n                )\n            )\n```\n\n**4. Data Export:**\n```python\n# Export all sequences with specific properties\nsequences = benchling.dna_sequences.list()\nexport_data = []\n\nfor page in sequences:\n    for seq in page:\n        if seq.schema_id == \"target_schema_id\":\n            export_data.append({\n                \"id\": seq.id,\n                \"name\": seq.name,\n                \"bases\": seq.bases,\n                \"length\": len(seq.bases)\n            })\n\n# Save to CSV or database\nimport csv\nwith open(\"sequences.csv\", \"w\") as f:\n    writer = csv.DictWriter(f, fieldnames=export_data[0].keys())\n    writer.writeheader()\n    writer.writerows(export_data)\n```\n\n## Additional Resources\n\n- **Official Documentation:** https:\u002F\u002Fdocs.benchling.com\n- **Python SDK Reference:** https:\u002F\u002Fbenchling.com\u002Fsdk-docs\u002F\n- **API Reference:** https:\u002F\u002Fbenchling.com\u002Fapi\u002Freference\n- **Support:** [email protected]\n\n","# Benchling Integration\n\n## Overview\n\nBenchling is a cloud platform for life sciences R&D. Access registry entities (DNA, proteins), inventory, electronic lab notebooks, and workflows programmatically via Python SDK and REST API.\n\n## When to Use This Skill\n\nThis skill should be used when:\n- Working with Benchling's Python SDK or REST API\n- Managing biological sequences (DNA, RNA, proteins) and registry entities\n- Automating inventory operations (samples, containers, locations, transfers)\n- Creating or querying electronic lab notebook entries\n- Building workflow automations or Benchling Apps\n- Syncing data between Benchling and external systems\n- Querying the Benchling Data Warehouse for analytics\n- Setting up event-driven integrations with AWS EventBridge\n\n## Core Capabilities\n\n### 1. Authentication & Setup\n\n**Python SDK Installation:**\n```python\n# Stable release\nuv pip install benchling-sdk\n# or with Poetry\npoetry add benchling-sdk\n```\n\n**Authentication Methods:**\n\nAPI Key Authentication (recommended for scripts):\n```python\nfrom benchling_sdk.benchling import Benchling\nfrom benchling_sdk.auth.api_key_auth import ApiKeyAuth\n\nbenchling = Benchling(\n    url=\"https:\u002F\u002Fyour-tenant.benchling.com\",\n    auth_method=ApiKeyAuth(\"your_api_key\")\n)\n```\n\nOAuth Client Credentials (for apps):\n```python\nfrom benchling_sdk.auth.client_credentials_oauth2 import ClientCredentialsOAuth2\n\nauth_method = ClientCredentialsOAuth2(\n    client_id=\"your_client_id\",\n    client_secret=\"your_client_secret\"\n)\nbenchling = Benchling(\n    url=\"https:\u002F\u002Fyour-tenant.benchling.com\",\n    auth_method=auth_method\n)\n```\n\n**Key Points:**\n- API keys are obtained from Profile Settings in Benchling\n- Store credentials securely (use environment variables or password managers)\n- All API requests require HTTPS\n- Authentication permissions mirror user permissions in the UI\n\nFor detailed authentication information including OIDC and security best practices, refer to `references\u002Fauthentication.md`.\n\n### 2. Registry & Entity Management\n\nRegistry entities include DNA sequences, RNA sequences, AA sequences, custom entities, and mixtures. The SDK provides typed classes for creating and managing these entities.\n\n**Creating DNA Sequences:**\n```python\nfrom benchling_sdk.models import DnaSequenceCreate\n\nsequence = benchling.dna_sequences.create(\n    DnaSequenceCreate(\n        name=\"My Plasmid\",\n        bases=\"ATCGATCG\",\n        is_circular=True,\n        folder_id=\"fld_abc123\",\n        schema_id=\"ts_abc123\",  # optional\n        fields=benchling.models.fields({\"gene_name\": \"GFP\"})\n    )\n)\n```\n\n**Registry Registration:**\n\nTo register an entity directly upon creation:\n```python\nsequence = benchling.dna_sequences.create(\n    DnaSequenceCreate(\n        name=\"My Plasmid\",\n        bases=\"ATCGATCG\",\n        is_circular=True,\n        folder_id=\"fld_abc123\",\n        entity_registry_id=\"src_abc123\",  # Registry to register in\n        naming_strategy=\"NEW_IDS\"  # or \"IDS_FROM_NAMES\"\n    )\n)\n```\n\n**Important:** Use either `entity_registry_id` OR `naming_strategy`, never both.\n\n**Updating Entities:**\n```python\nfrom benchling_sdk.models import DnaSequenceUpdate\n\nupdated = benchling.dna_sequences.update(\n    sequence_id=\"seq_abc123\",\n    dna_sequence=DnaSequenceUpdate(\n        name=\"Updated Plasmid Name\",\n        fields=benchling.models.fields({\"gene_name\": \"mCherry\"})\n    )\n)\n```\n\nUnspecified fields remain unchanged, allowing partial updates.\n\n**Listing and Pagination:**\n```python\n# List all DNA sequences (returns a generator)\nsequences = benchling.dna_sequences.list()\nfor page in sequences:\n    for seq in page:\n        print(f\"{seq.name} ({seq.id})\")\n\n# Check total count\ntotal = sequences.estimated_count()\n```\n\n**Key Operations:**\n- Create: `benchling.\u003Centity_type>.create()`\n- Read: `benchling.\u003Centity_type>.get(id)` or `.list()`\n- Update: `benchling.\u003Centity_type>.update(id, update_object)`\n- Archive: `benchling.\u003Centity_type>.archive(id)`\n\nEntity types: `dna_sequences`, `rna_sequences`, `aa_sequences`, `custom_entities`, `mixtures`\n\nFor comprehensive SDK reference and advanced patterns, refer to `references\u002Fsdk_reference.md`.\n\n### 3. Inventory Management\n\nManage physical samples, containers, boxes, and locations within the Benchling inventory system.\n\n**Creating Containers:**\n```python\nfrom benchling_sdk.models import ContainerCreate\n\ncontainer = benchling.containers.create(\n    ContainerCreate(\n        name=\"Sample Tube 001\",\n        schema_id=\"cont_schema_abc123\",\n        parent_storage_id=\"box_abc123\",  # optional\n        fields=benchling.models.fields({\"concentration\": \"100 ng\u002FμL\"})\n    )\n)\n```\n\n**Managing Boxes:**\n```python\nfrom benchling_sdk.models import BoxCreate\n\nbox = benchling.boxes.create(\n    BoxCreate(\n        name=\"Freezer Box A1\",\n        schema_id=\"box_schema_abc123\",\n        parent_storage_id=\"loc_abc123\"\n    )\n)\n```\n\n**Transferring Items:**\n```python\n# Transfer a container to a new location\ntransfer = benchling.containers.transfer(\n    container_id=\"cont_abc123\",\n    destination_id=\"box_xyz789\"\n)\n```\n\n**Key Inventory Operations:**\n- Create containers, boxes, locations, plates\n- Update inventory item properties\n- Transfer items between locations\n- Check in\u002Fout items\n- Batch operations for bulk transfers\n\n### 4. Notebook & Documentation\n\nInteract with electronic lab notebook (ELN) entries, protocols, and templates.\n\n**Creating Notebook Entries:**\n```python\nfrom benchling_sdk.models import EntryCreate\n\nentry = benchling.entries.create(\n    EntryCreate(\n        name=\"Experiment 2025-10-20\",\n        folder_id=\"fld_abc123\",\n        schema_id=\"entry_schema_abc123\",\n        fields=benchling.models.fields({\"objective\": \"Test gene expression\"})\n    )\n)\n```\n\n**Linking Entities to Entries:**\n```python\n# Add references to entities in an entry\nentry_link = benchling.entry_links.create(\n    entry_id=\"entry_abc123\",\n    entity_id=\"seq_xyz789\"\n)\n```\n\n**Key Notebook Operations:**\n- Create and update lab notebook entries\n- Manage entry templates\n- Link entities and results to entries\n- Export entries for documentation\n\n### 5. Workflows & Automation\n\nAutomate laboratory processes using Benchling's workflow system.\n\n**Creating Workflow Tasks:**\n```python\nfrom benchling_sdk.models import WorkflowTaskCreate\n\ntask = benchling.workflow_tasks.create(\n    WorkflowTaskCreate(\n        name=\"PCR Amplification\",\n        workflow_id=\"wf_abc123\",\n        assignee_id=\"user_abc123\",\n        fields=benchling.models.fields({\"template\": \"seq_abc123\"})\n    )\n)\n```\n\n**Updating Task Status:**\n```python\nfrom benchling_sdk.models import WorkflowTaskUpdate\n\nupdated_task = benchling.workflow_tasks.update(\n    task_id=\"task_abc123\",\n    workflow_task=WorkflowTaskUpdate(\n        status_id=\"status_complete_abc123\"\n    )\n)\n```\n\n**Asynchronous Operations:**\n\nSome operations are asynchronous and return tasks:\n```python\n# Wait for task completion\nfrom benchling_sdk.helpers.tasks import wait_for_task\n\nresult = wait_for_task(\n    benchling,\n    task_id=\"task_abc123\",\n    interval_wait_seconds=2,\n    max_wait_seconds=300\n)\n```\n\n**Key Workflow Operations:**\n- Create and manage workflow tasks\n- Update task statuses and assignments\n- Execute bulk operations asynchronously\n- Monitor task progress\n\n### 6. Events & Integration\n\nSubscribe to Benchling events for real-time integrations using AWS EventBridge.\n\n**Event Types:**\n- Entity creation, update, archive\n- Inventory transfers\n- Workflow task status changes\n- Entry creation and updates\n- Results registration\n\n**Integration Pattern:**\n1. Configure event routing to AWS EventBridge in Benchling settings\n2. Create EventBridge rules to filter events\n3. Route events to Lambda functions or other targets\n4. Process events and update external systems\n\n**Use Cases:**\n- Sync Benchling data to external databases\n- Trigger downstream processes on workflow completion\n- Send notifications on entity changes\n- Audit trail logging\n\nRefer to Benchling's event documentation for event schemas and configuration.\n\n### 7. Data Warehouse & Analytics\n\nQuery historical Benchling data using SQL through the Data Warehouse.\n\n**Access Method:**\nThe Benchling Data Warehouse provides SQL access to Benchling data for analytics and reporting. Connect using standard SQL clients with provided credentials.\n\n**Common Queries:**\n- Aggregate experimental results\n- Analyze inventory trends\n- Generate compliance reports\n- Export data for external analysis\n\n**Integration with Analysis Tools:**\n- Jupyter notebooks for interactive analysis\n- BI tools (Tableau, Looker, PowerBI)\n- Custom dashboards\n\n## Best Practices\n\n### Error Handling\n\nThe SDK automatically retries failed requests:\n```python\n# Automatic retry for 429, 502, 503, 504 status codes\n# Up to 5 retries with exponential backoff\n# Customize retry behavior if needed\nfrom benchling_sdk.retry import RetryStrategy\n\nbenchling = Benchling(\n    url=\"https:\u002F\u002Fyour-tenant.benchling.com\",\n    auth_method=ApiKeyAuth(\"your_api_key\"),\n    retry_strategy=RetryStrategy(max_retries=3)\n)\n```\n\n### Pagination Efficiency\n\nUse generators for memory-efficient pagination:\n```python\n# Generator-based iteration\nfor page in benchling.dna_sequences.list():\n    for sequence in page:\n        process(sequence)\n\n# Check estimated count without loading all pages\ntotal = benchling.dna_sequences.list().estimated_count()\n```\n\n### Schema Fields Helper\n\nUse the `fields()` helper for custom schema fields:\n```python\n# Convert dict to Fields object\ncustom_fields = benchling.models.fields({\n    \"concentration\": \"100 ng\u002FμL\",\n    \"date_prepared\": \"2025-10-20\",\n    \"notes\": \"High quality prep\"\n})\n```\n\n### Forward Compatibility\n\nThe SDK handles unknown enum values and types gracefully:\n- Unknown enum values are preserved\n- Unrecognized polymorphic types return `UnknownType`\n- Allows working with newer API versions\n\n### Security Considerations\n\n- Never commit API keys to version control\n- Use environment variables for credentials\n- Rotate keys if compromised\n- Grant minimal necessary permissions for apps\n- Use OAuth for multi-user scenarios\n\n## Resources\n\n### references\u002F\n\nDetailed reference documentation for in-depth information:\n\n- **authentication.md** - Comprehensive authentication guide including OIDC, security best practices, and credential management\n- **sdk_reference.md** - Detailed Python SDK reference with advanced patterns, examples, and all entity types\n- **api_endpoints.md** - REST API endpoint reference for direct HTTP calls without the SDK\n\nLoad these references as needed for specific integration requirements.\n\n### scripts\u002F\n\nThis skill currently includes example scripts that can be removed or replaced with custom automation scripts for your specific Benchling workflows.\n\n## Common Use Cases\n\n**1. Bulk Entity Import:**\n```python\n# Import multiple sequences from FASTA file\nfrom Bio import SeqIO\n\nfor record in SeqIO.parse(\"sequences.fasta\", \"fasta\"):\n    benchling.dna_sequences.create(\n        DnaSequenceCreate(\n            name=record.id,\n            bases=str(record.seq),\n            is_circular=False,\n            folder_id=\"fld_abc123\"\n        )\n    )\n```\n\n**2. Inventory Audit:**\n```python\n# List all containers in a specific location\ncontainers = benchling.containers.list(\n    parent_storage_id=\"box_abc123\"\n)\n\nfor page in containers:\n    for container in page:\n        print(f\"{container.name}: {container.barcode}\")\n```\n\n**3. Workflow Automation:**\n```python\n# Update all pending tasks for a workflow\ntasks = benchling.workflow_tasks.list(\n    workflow_id=\"wf_abc123\",\n    status=\"pending\"\n)\n\nfor page in tasks:\n    for task in page:\n        # Perform automated checks\n        if auto_validate(task):\n            benchling.workflow_tasks.update(\n                task_id=task.id,\n                workflow_task=WorkflowTaskUpdate(\n                    status_id=\"status_complete\"\n                )\n            )\n```\n\n**4. Data Export:**\n```python\n# Export all sequences with specific properties\nsequences = benchling.dna_sequences.list()\nexport_data = []\n\nfor page in sequences:\n    for seq in page:\n        if seq.schema_id == \"target_schema_id\":\n            export_data.append({\n                \"id\": seq.id,\n                \"name\": seq.name,\n                \"bases\": seq.bases,\n                \"length\": len(seq.bases)\n            })\n\n# Save to CSV or database\nimport csv\nwith open(\"sequences.csv\", \"w\") as f:\n    writer = csv.DictWriter(f, fieldnames=export_data[0].keys())\n    writer.writeheader()\n    writer.writerows(export_data)\n```\n\n## Additional Resources\n\n- **Official Documentation:** https:\u002F\u002Fdocs.benchling.com\n- **Python SDK Reference:** https:\u002F\u002Fbenchling.com\u002Fsdk-docs\u002F\n- **API Reference:** https:\u002F\u002Fbenchling.com\u002Fapi\u002Freference\n- **Support:** [email protected]\n\n",{"name":5,"license":14,"metadata":23,"description":7,"compatibility":26},{"version":24,"skill-author":25},"1.0.0","AlterLab","Requires a Benchling account and API key","master","f483e54f3ad5f202a77d45f2e57f8d970b71195f","skills_library\u002Falterlab-benchling",2,"https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills","https:\u002F\u002Fgithub.com\u002Froohe","yoou.link","2026-05-19 15:56:07",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add roohe\u002Fagentic-super-skills --skill alterlab-benchling",{"tool":41,"command":42},"bunx","bunx skills add roohe\u002Fagentic-super-skills --skill alterlab-benchling",{"tool":44,"command":45},"pnpm","pnpm dlx skills add roohe\u002Fagentic-super-skills --skill alterlab-benchling","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Falterlab-benchling\u002FSKILL.md",true,[49,55,59],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fapi_endpoints.md","REFERENCE","参考文档",14226,"https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Falterlab-benchling\u002Freferences\u002Fapi_endpoints.md",{"path":56,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fauthentication.md",10124,"https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Falterlab-benchling\u002Freferences\u002Fauthentication.md",{"path":60,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":61,"sourceHtmlUrl":62},"references\u002Fsdk_reference.md",17621,"https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Falterlab-benchling\u002Freferences\u002Fsdk_reference.md",[64,71,78,85,92,99],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":18},"01M73D865CZME2FCMKA4PQM348","zarr-python","Chunked N-D arrays for cloud storage. Compressed arrays, parallel I\u002FO, S3\u002FGCS integration, NumPy\u002FDask\u002FXarray compatible, for large-scale scientific computing pipelines.","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fzarr-python\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":18},"01M73D7Z64J4ABWZJD7P44XBBF","youtube-downloader","Download and process YouTube content for research. Use when: downloading competitor videos for analysis; extracting audio for podcasts; getting transcripts for content repurposing; archiving webinars; research content curation","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fyoutube-downloader\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":18},"01M73D7K8778TGZV3GJFR3703D","yc-pitch-deck","Create a compelling startup pitch deck that follows the structure proven to raise billions from top investors. Master the YC and Sequoia formats that get founders funded. Use when: **Fundraising** to create investor pitch decks; **YC application** to structure your narrative; **Demo Day prep** to craft your 2-minute pitch; **Angel investors** to communicate your opportunity; **Partnership pitches** to structure compelling asks","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fyc-pitch-deck\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":18},"01M73D70KJSE0E8Z28YMNNRT04","x-twitter-scraper","Use when the user needs X (Twitter) data or confirmation-gated X actions through Xquik: tweet search, user lookup, follower extraction, media download, monitoring, webhooks, MCP, SDKs, posting, likes, DMs, and profile updates. Requires a Xquik API key. Never ask for X login material.","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fx-twitter-scraper\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":18},"01M73D6ED01GV077R7K4NZNFZJ","write-vignette","Create R package vignettes using R Markdown or Quarto. Covers vignette setup, YAML configuration, code chunk options, building and testing, and CRAN requirements for vignettes. Use when adding a Getting Started tutorial, documenting complex workflows spanning multiple functions, creating domain-specific guides, or when CRAN submission requires user-facing documentation beyond function help pages.","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fwrite-vignette\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":18},"01M73D69YJR0BK3NFHE0CYG3EF","write-validation-documentation","Write IQ\u002FOQ\u002FPQ validation documentation for computerized systems in regulated environments. Covers protocols, reports, test scripts, deviation handling, and approval workflows. Use when validating R or other software for regulated use, preparing for a regulatory audit, documenting qualification of computing environments, or creating and updating validation protocols and reports for new or re-qualified systems.","https:\u002F\u002Fgithub.com\u002Froohe\u002Fagentic-super-skills\u002Fblob\u002Fmaster\u002Fskills_library\u002Fwrite-validation-documentation\u002FSKILL.md",[],[]]