ai4s-agent

Seven agent skills for AI-for-Science research — turn a research direction into literature surveys, runnable experiments, publication-grade papers, and integrity audits, with every citation, number, and figure traceable to its source.

---

Contents

• 🧩 The skills
• 🔗 How they connect
• ✅ Authenticity
• 🔬 Example
• 📦 Install
• 🚀 Usage
• 🗂️ Repository layout
• 🛠️ Included tools
• 🤝 Contributing
• ⚖️ License
• 🙏 Acknowledgments

The skills

Each skill is a folder with a SKILL.md plus its own references, templates, and tools. MIT-licensed; works with Claude Code, Cursor, Codex, and Aider.

How they connect

direction
   │
   ▼
[1] research-explorer ──▶ pick one $TOPIC
   │
   ├──▶ [2] literature-survey   → survey PDF + bibliography.bib
   ├──▶ [3] experiment-suite    → results.json + figures/
   └──▶ [4] paper-writer        → paper PDF  (reuses [2] and [3])

integrity-auditor ──▶ audits any paper: external PDF / DOI / arXiv, or [4]'s output

ai4s-agent runs steps 1–4 in order. Skills pass work to each other through a shared slug and the path output/<skill>/<slug>/latest/.

Authenticity

The focus of the project. Every skill enforces:

Example

A complete run from experiment-suite + paper-writer: "Learning the Burgers Solution Operator with a Fourier Neural Operator" — an 8-page paper backed by code the agent wrote and ran. Full artifact in examples/fno-burgers/ (paper, code, results.json, report).

• Real code, really run — model.py is a 1-D FNO; the full study runs in ~35 min on a laptop CPU.
• Measured results — FNO 4.41% rel-L2 vs MLP 21.63% and CNN 67.69% (3 seeds); zero-shot super-resolution holds 4.2–4.7% from grid 128 to 1024.
• Real citations — 22 references, each traceable to its source.

Every number is measured (provenance in results.json); the paper states it was AI-generated and recommends domain-expert review.

Install

Run the installer from the project you want the skills in:

git clone https://github.com/ai4s-research/ai4s-skills

cd /path/to/your-project
/path/to/ai4s-skills/install.sh                              # all skills → ./.claude/skills
/path/to/ai4s-skills/install.sh paper-writer                 # or specific ones
SKILLS_DIR=~/.claude/skills /path/to/ai4s-skills/install.sh  # global instead

To install by hand, copy any skills/<name>/ into ~/.claude/skills/ (global) or <project>/.claude/skills/ (project).

Usage

In Claude Code:

Use the literature-survey skill to write a survey on <your topic>.

With Cursor, Codex, or Aider, point the agent at the skill file:

Read skills/literature-survey/SKILL.md and its references/, then produce the survey
for "<your topic>" as specified.

Each SKILL.md directs the agent to read its references/ first; those files hold the procedures for bibliography expansion, figures, layout, and quality checks.

Repository layout

ai4s-skills/
├── skills/
│   ├── ai4s-agent/          SKILL.md + references/
│   ├── research-explorer/   SKILL.md
│   ├── literature-survey/   SKILL.md + references/ + templates/survey/
│   ├── experiment-suite/    SKILL.md + references/ + figure_examples/
│   ├── paper-writer/        SKILL.md + references/ + templates/paper/
│   ├── mindmap-render/      SKILL.md + scripts/ + tests/
│   └── integrity-auditor/   SKILL.md + references/ + forensics_tools/ + templates/ + tests/
├── tools/validate_skills.py   structure / frontmatter validator (run in CI)
├── install.sh
└── .github/workflows/ci.yml

Each SKILL.md carries YAML frontmatter (name, description) so an agent can find and route to it.

Included tools

Small, single-purpose scripts the skills call. Each directory has its own requirements.txt.

• skills/integrity-auditor/forensics_tools/ — image duplication / ORB matching, panel splitting, channel checks, magnitude (Benford-style) consistency, decimal matching, spreadsheet aggregate consistency.
• `skills/exp