Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- Added developer instructions for installing and upgrading via the `uv` tool, reflecting typical end-user workflows. - Clarified that all official agents have a `tier_requirement` of "free" in `AGENT_CONFIG`. - Updated Quick Commands and setup steps to distinguish between development and end-user installation procedures. - Minor improvements to formatting and developer guidance in SKILL.md and referenced documentation files.
What This Skill Does
A development guide for Lobster AI, a multi-agent bioinformatics platform built on LangGraph. Covers adding agents and services, navigating the orchestration graph, and contributing to the open-source codebase. Key conventions include entry-point-based agent discovery and a mandatory 3-tuple service return pattern.
The skill captures non-obvious codebase conventions like AGENT_CONFIG placement, entry-point registration, and the mandatory ir parameter that are not apparent from reading the source alone.
When to use it
- Adding a new domain expert agent for a bioinformatics modality
- Implementing analysis services with the required 3-tuple return
- Tracing query flow from CLI through LangGraph to agent output
- Writing unit tests for new agents before submitting a PR
- Debugging agent discovery failures from missing entry point registration
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: 'Add a new metabolomics expert agent to Lobster'
- 1Creates packages/lobster-metabolomics/ following PEP 420 namespace structure
- 2Defines AGENT_CONFIG at the top of the agent file, before any heavy imports
- 3Registers the agent via entry point in pyproject.toml under lobster.agents
- 4Implements tools wrapping services with 3-tuple return and log_tool_usage(ir=ir)
- 5Runs pytest tests/unit/agents/ to verify registration and behavior
A new metabolomics_expert agent discoverable by ComponentRegistry and routable via the supervisor
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.