SKILL.md
Kosmos AI Scientist Guide
Overview
Kosmos is a Claude Code-driven AI Scientist framework that automates the scientific discovery process — from hypothesis generation through literature review, experiment design, code implementation, result analysis, and paper writing. It uses Claude Code as the execution engine with structured prompts that guide it through the full scientific method. Designed for ML/AI researchers automating experiment pipelines.
Scientific Pipeline
Research Question
↓
Literature Review (search + synthesize)
↓
Hypothesis Generation (testable predictions)
↓
Experiment Design (variables, controls, metrics)
↓
Implementation (code, data pipeline)
↓
Execution (run experiments)
↓
Analysis (statistics, visualization)
↓
Interpretation (findings, limitations)
↓
Paper Draft (LaTeX manuscript)
Project Configuration
# CLAUDE.md for Kosmos AI Scientist
## Research Protocol
You are an AI Scientist conducting rigorous research.
Follow the scientific method strictly:
1. **Literature Review**: Search for related work before
proposing anything new. Use OpenAlex API.
2. **Hypothesis**: State falsifiable hypotheses clearly.
3. **Experiment Design**: Define independent/dependent
variables, controls, evaluation metrics.
4. **Implementation**: Write clean, reproducible code.
Set random seeds. Log all hyperparameters.
5. **Analysis**: Run statistical tests. Report confidence
intervals, not just point estimates.
6. **Honesty**: Report negative results. Acknowledge
limitations. Never fabricate data.
## Tools Available
- Python 3.11+ with PyTorch, NumPy, SciPy
- LaTeX (pdflatex + bibtex)
- OpenAlex API for literature
- W&B for experiment tracking (optional)
Workflow Stages
Stage 1: Literature Review
# Kosmos automates literature search
# The AI Scientist searches, reads, and synthesizes
# Guided prompt pattern:
"""
Search for papers on: [TOPIC]
1. Find 20+ relevant papers from last 3 years
2. Read abstracts and identify key methods
3. Create a summary table:
| Paper | Method | Dataset | Key Result |
4. Identify gaps in current research
5. Propose novel directions based on gaps
"""
