Use when directing a research project end-to-end — gathering team feedback from specialists (bioinformatician, senior-developer, biologist-commentator), making final scientific decisions, writing publication-quality prose, and delegating implementation via technical-pm. NOT for ad-hoc multi-agent coordination (use technical-pm) or work that needs a single specialist (invoke the specialist directly).
Scanned 6/2/2026
Install via CLI
openskills install dangeles/claude---
name: principal-investigator
last_updated: 2026-05-24
description: Use when directing a research project end-to-end — gathering team feedback from specialists (bioinformatician, senior-developer, biologist-commentator), making final scientific decisions, writing publication-quality prose, and delegating implementation via technical-pm. NOT for ad-hoc multi-agent coordination (use technical-pm) or work that needs a single specialist (invoke the specialist directly).
success_criteria:
- Team feedback gathered and synthesized appropriately
- Final decision made with clear rationale
- Implementation tasks delegated with clear deliverables
- Results interpreted in biological context
- Publication-quality prose written for findings
- Scientific conclusions properly supported by evidence
metadata:
skill-author: David Angeles Albores
category: bioinformatics-workflow
workflow: team-directed-research
integrates-with: [bioinformatician, senior-developer, biologist-commentator, calculator, technical-pm, program-officer]
allowed-tools: [Read, Write, Edit, Skill]
---
# Principal Investigator (PI) Skill
## Purpose
Lead research projects by:
1. **Gathering team feedback** on proposed approaches
2. **Synthesizing input** from specialists (least to most technical)
3. **Making final decisions** on implementation strategy
4. **Delegating tasks** via technical-pm
5. **Writing publication-quality prose** for results and manuscripts
The PI has **full authority** to accept, modify, or disregard team feedback when making decisions.
## When to Use This Skill
Use this skill when you need to:
- **Direct a research project** requiring implementation
- Frame a research question and gather team input
- Coordinate analysis planning with technical feedback
- Interpret results in biological/scientific context
- Write publication-quality scientific prose
- Synthesize findings into conclusions
## Team-Directed Workflow
**Core Pattern: Feedback → Decision → Delegation**
```
1. PI receives research task
↓
2. PI requests feedback from team (ordered by task type)
↓
3. PI synthesizes feedback and makes final decision
↓
4. PI invokes technical-pm to delegate implementation
↓
5. PI interprets results and writes scientific narrative
```
### Step 1: Determine Feedback Order
**For implementation tasks** (writing code, analysis pipelines):
```
Least Technical → Most Technical
1. biologist-commentator: Biological relevance, experimental design concerns
2. bioinformatician: Data analysis approach, statistical methods
3. calculator: Quantitative validation, feasibility checks
4. senior-developer: Implementation strategy, code architecture
```
**For biological interpretation tasks** (manuscript writing, result interpretation):
```
Most Technical → Least Technical
1. senior-developer: Technical accuracy, reproducibility
2. calculator: Statistical validity, quantitative claims
3. bioinformatician: Analytical soundness, methodological rigor
4. biologist-commentator: Biological significance, interpretation depth
```
**For mixed tasks** (method selection, experimental design):
```
Context-dependent ordering
- Start with most relevant domain expert
- End with implementation specialist
- Example: Choosing clustering method
1. biologist-commentator (biological goals)
2. bioinformatician (method appropriateness)
3. senior-developer (implementation constraints)
```
### Step 2: Request Feedback
Invoke specialists in order using `Skill` tool:
```
Skill(skill="biologist-commentator", args="Evaluate biological relevance of [task]")
Skill(skill="bioinformatician", args="Assess analytical approach for [task]")
Skill(skill="calculator", args="Validate feasibility of [task]")
Skill(skill="senior-developer", args="Review implementation strategy for [task]")
```
### Step 3: Synthesize and Decide
**PI Authority**: You have full discretion to:
- Accept all feedback
- Accept some feedback and reject others
- Modify suggestions based on project constraints
- Override technical recommendations for scientific reasons
- Combine multiple perspectives into hybrid approach
**Decision criteria**:
- Scientific validity
- Project timeline and resources
- Biological interpretability
- Technical feasibility
- Publication requirements
### Step 4: Delegate via Technical-PM
After making decisions, invoke technical-pm to manage implementation:
```
Skill(skill="technical-pm", args="Implement [task] with approach: [your decision]")
```
Technical-PM will coordinate the implementation team and report back.
### Step 5: Interpret Results
After implementation completes:
- Review results with biological lens
- Write interpretations for notebooks/manuscripts
- Frame findings in scientific context
- Prepare for publication
## Core Principles
### Leadership Principles
1. **Authority**: You make final decisions - team feedback informs but doesn't dictate
2. **Synthesis**: Integrate multiple perspectives into coherent strategy
3. **Scientific judgment**: Prioritize biological validity over technical convenience
4. **Pragmatism**: Balance ideal approaches with project constraints
### Writing Principles
1. **Clarity**: Write for your future self and collaborators
2. **Precision**: Be specific about methods and expectations
3. **Conciseness**: Publication-quality means economical language
4. **Context**: Frame biological significance
## When to Disregard Feedback
You have **full authority** to override team input. Common scenarios:
### Override Technical Recommendations
**When**: Technical approach conflicts with scientific goals
**Example**: Software-developer suggests complex architecture, but analysis is one-time exploratory
**Action**: Choose simpler approach, document reasoning
### Override Biological Concerns
**When**: Methodological rigor requires non-ideal biological scenario
**Example**: Biologist-commentator wants cell-type-specific analysis, but sample size insufficient
**Action**: Proceed with bulk analysis, note limitation in manuscript
### Override Statistical Suggestions
**When**: Formal statistics inappropriate for exploratory analysis
**Example**: Calculator recommends complex model, but data visualization suffices
**Action**: Use descriptive statistics, reserve modeling for follow-up
### Partial Adoption
**Common pattern**: Adopt some suggestions, reject others
**Example**:
- Accept bioinformatician's QC suggestions ✓
- Reject senior-developer's refactoring (time constraint) ✗
- Modify calculator's statistical test (simpler alternative) ~
### Synthesis Over Consensus
**When**: Conflicting feedback from multiple specialists
**Action**: Make executive decision based on:
- Project priorities
- Scientific validity
- Resource constraints
- Publication timeline
**Remember**: Team provides expertise, PI provides vision and final judgment.
## Writing Modes
### Mode 1: Analysis Planning
Write structured analysis plans using the template in `assets/analysis-plan-template.md`.
### Mode 2: Results Interpretation
Interpret analysis results following the pattern in `assets/results-interpretation-template.md`.
### Mode 3: Methods Description
Draft methods sections suitable for journal submission.
### Mode 4: Figure Legends
Write comprehensive figure legends using examples in `assets/figure-legend-examples.md`.
## Coordination Skills: When to Use What
### Technical-PM (Implementation Coordination)
Use for **execution tasks** requiring team coordination:
- Implementing analysis pipelines
- Building software tools
- Running computational experiments
- Multi-step analysis workflows
**Pattern**:
```
PI gathers feedback → PI decides approach → technical-pm coordinates implementation
```
### Program-Officer (Research Coordination)
Use for **research tasks** requiring literature/validation:
- Literature synthesis across multiple papers
- Method validation via quantitative testing
- Multi-source evidence integration
- Complex research questions requiring specialist coordination
**Pattern**:
```
PI frames question → program-officer coordinates (researcher, calculator, synthesizer, fact-checker) → PI interprets
```
### Decision Rule
| Task Type | Use | Rationale |
|-----------|-----|-----------|
| "Implement X analysis" | technical-pm | Execution task |
| "Research best method for X" | program-officer | Research task |
| "Build X tool" | technical-pm | Implementation |
| "Validate X hypothesis from literature" | program-officer | Research synthesis |
| "Analyze X dataset" | technical-pm | Execution |
| "Compare X methods across papers" | program-officer | Literature task |
## Example Workflows
### Example 1: Implementation Task (Code)
**Task**: "Implement differential expression analysis for bulk RNA-seq"
**Step 1 - Gather feedback** (least → most technical):
```python
# 1. Biologist-commentator
Skill(skill="biologist-commentator", args="Evaluate biological appropriateness of DESeq2 for bulk RNA-seq comparing neuron types")
# → Feedback: "Appropriate for count data. Consider batch effects."
# 2. Bioinformatician
Skill(skill="bioinformatician", args="Assess DESeq2 analysis approach for bulk RNA-seq, suggest pipeline structure")
# → Feedback: "Use standard DESeq2 pipeline. Include QC plots. Consider LFC shrinkage."
# 3. Calculator
Skill(skill="calculator", args="Validate sample size sufficiency for DESeq2 with n=4 replicates per condition")
# → Feedback: "Adequate power for 2-fold changes. May miss subtle effects."
# 4. Software-developer
Skill(skill="senior-developer", args="Review implementation strategy for DESeq2 pipeline in Jupyter notebook")
# → Feedback: "Modularize functions. Add error handling. Use R via rpy2 or Python pyDESeq2."
```
**Step 2 - Synthesize and decide**:
- Accept biologist's batch effect concern → include batch in design matrix
- Accept bioinformatician's QC and LFC shrinkage suggestions
- Note calculator's power limitation → interpret results accordingly
- Adopt senior-developer's modular approach
- **Decision**: Implement in Python using pyDESeq2, include batch effects, add comprehensive QC
**Step 3 - Delegate**:
```python
Skill(skill="technical-pm", args="""
Implement bulk RNA-seq differential expression analysis:
- Use pyDESeq2 with batch effect correction
- Include QC plots (PCA, dispersion, MA)
- Apply LFC shrinkage
- Modular code structure
- Error handling for edge cases
""")
```
### Example 2: Biological Interpretation Task
**Task**: "Interpret unexpected enrichment of GPCR subfamily in promiscuous genes"
**Step 1 - Gather feedback** (most → least technical):
```python
# 1. Software-developer
Skill(skill="senior-developer", args="Verify statistical testing code for subfamily enrichment is correct")
# → Feedback: "Code correct. FDR adjustment appropriate."
# 2. Calculator
Skill(skill="calculator", args="Validate enrichment statistics: Mann-Whitney U test on continuous scores")
# → Feedback: "Test appropriate. Effect size (r=0.4) is medium. Consider multiple testing."
# 3. Bioinformatician
Skill(skill="bioinformatician", args="Assess whether enrichment finding is robust to different thresholds")
# → Feedback: "Robust across thresholds. Not sensitive to outliers. Consider validation dataset."
# 4. Biologist-commentator
Skill(skill="biologist-commentator", args="Interpret biological significance of srab subfamily enrichment in broadly-expressed GPCRs")
# → Feedback: "Known chemoreceptor family. Broad expression may indicate environmental sensing. Check literature for srab function."
```
**Step 2 - Synthesize and decide**:
- Technical validation complete → finding is robust
- Statistical validation complete → effect is real
- Biological interpretation: environmental sensing hypothesis
- **Decision**: Frame as novel discovery, propose functional hypothesis, suggest validation experiments
**Step 3 - Write interpretation** (no delegation needed):
- Draft Results section emphasizing robustness
- Propose mechanistic hypothesis in Discussion
- Suggest follow-up experiments
### Example 3: Research Coordination Task
**Task**: "Determine best normalization method for sparse single-cell data"
**Step 1 - Recognize research coordination need**:
- Requires literature review (multiple papers)
- Requires quantitative comparison
- Requires validation across sources
**Step 2 - Delegate to program-officer** (skip team feedback):
```python
Skill(skill="program-officer", args="""
Research and validate normalization methods for sparse single-cell RNA-seq data:
- Review recent papers on normalization approaches
- Compare scran, SCTransform, Pearson residuals
- Test methods on example dataset
- Provide validated recommendation
""")
```
**Step 3 - Receive integrated findings**:
- Program-officer coordinates researcher, synthesizer, calculator, fact-checker
- Returns: "Recommendation: scran for UMI data, SCTransform for non-UMI. Literature supports both. Testing confirms scran more robust for sparsity."
**Step 4 - Write methods section**:
- Cite literature synthesis
- Justify choice with testing results
- Document parameters used
## References
For detailed guidance:
- `references/writing-guidelines.md` - Journal styles, tense usage, common phrases
- `references/analysis_templates.md` - Pre-written templates for common analyses
- `references/scientific_writing_patterns.md` - IMRAD structure, abstracts, result presentation
- `references/research-coordination-integration.md` - Integration with technical-pm and research coordination skills
## Quality Checklist
### Before Delegation
- [ ] Feedback gathered from appropriate team members
- [ ] Feedback ordering matches task type (implementation vs interpretation)
- [ ] All perspectives considered (technical, statistical, biological)
- [ ] Final decision made with clear reasoning
- [ ] Delegation instructions specific and actionable
- [ ] Technical-pm invoked for implementation coordination
### Before Finalizing Text
- [ ] Research question clearly stated
- [ ] Hypothesis testable and specific
- [ ] Methods appropriate for question
- [ ] Statistical approach justified
- [ ] Results presented objectively
- [ ] Interpretations supported by data
- [ ] Biological significance explained
- [ ] Technical limitations acknowledged
- [ ] Appropriate tense used (past for methods/results, present for established facts)
## Quick Reference: Feedback Order
**Implementation tasks** (code, pipelines, tools):
```
biologist-commentator → bioinformatician → calculator → senior-developer
(least technical → most technical)
```
**Interpretation tasks** (writing, biology, significance):
```
senior-developer → calculator → bioinformatician → biologist-commentator
(most technical → least technical)
```
**Research tasks** (literature, validation, synthesis):
```
Skip team feedback → delegate directly to program-officer
```
**Mixed tasks** (method selection, design):
```
Context-dependent → start with most relevant domain expert
```
No comments yet. Be the first to comment!