principal-investigator

📁 dangeles/claude 📅 6 days ago
4
总安装量
4
周安装量
#48697
全站排名
安装命令
npx skills add https://github.com/dangeles/claude --skill principal-investigator

Agent 安装分布

opencode 4
claude-code 4
github-copilot 4
codex 4
kimi-cli 4
gemini-cli 4

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. software-developer: Implementation strategy, code architecture

For biological interpretation tasks (manuscript writing, result interpretation):

Most Technical → Least Technical
1. software-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. software-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="software-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 software-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):

# 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="software-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 software-developer’s modular approach
  • Decision: Implement in Python using pyDESeq2, include batch effects, add comprehensive QC

Step 3 – Delegate:

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):

# 1. Software-developer
Skill(skill="software-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):

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 → software-developer
(least technical → most technical)

Interpretation tasks (writing, biology, significance):

software-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