# Feynman Skills (Platform-Agnostic Port)

Adapted from the [Feynman](https://feynman.is) research skills pack (v0.2.34) for use with **Claude Code**, **OpenCode**, and any Anthropic-spec skill runtime.

## Source

- Upstream: `~/.codex/skills/feynman/` (Feynman CLI installer)
- Upstream license/model: research workflows produced by the Feynman project
- This copy is re-adapted to remove Feynman-runtime coupling so skills work standalone.

## What changed from upstream

| Upstream element | This port |
|---|---|
| `/deepresearch`, `/lit`, `/review`, `/draft`, `/audit`, `/replicate`, `/compare`, `/watch`, `/log`, `/jobs` slash commands | Inline procedure inside `SKILL.md` or in `references/<name>.md`. Invoke the skill by name, not by slash command. |
| `researcher` / `reviewer` / `writer` / `verifier` bundled subagents | Mapped to **Claude Code `Task` tool** (`subagent_type: scholar / oracle / general-purpose`) and **OpenCode `task` tool** (with a `scholar` / `oracle` / `forge` agent). |
| `pi-autoresearch`, `pi-schedule-prompt`, `pi-charts`, `pi-processes` | Replaced with platform equivalents (Claude `ScheduleWakeup` / cron, Mermaid, bash) or marked optional. |
| `~/.feynman/sessions/` transcripts | Generalized to per-platform session paths (documented in `session-search/`). |
| `/preview` command | Bash fallbacks (`xdg-open`, `open`, `pandoc`). |
| `../prompts/<name>.md` sibling references | Inlined into each SKILL.md, or moved to `references/<name>.md` inside the skill so the skill is portable. |

## Output conventions (carried over from upstream `AGENTS.md`)

- Research outputs → `outputs/`
- Paper-style drafts → `papers/`
- Session logs → `notes/`
- Workspace lab notebook → `CHANGELOG.md`
- Plan artifacts → `outputs/.plans/`
- Intermediate research → `<slug>-research-*.md` on disk, not returned inline
- Slug rule: every workflow derives a short hyphenated slug (`≤5 words`) and prefixes all artifacts with it — concurrent runs must not collide

## Platform-tool mapping reference

See `_platform-mapping.md` — the canonical mapping used by every SKILL.md in this directory.

## Skill list (19)

Research workflows:
- `deep-research`, `literature-review`, `source-comparison`, `paper-code-audit`,
- `peer-review`, `paper-writing`, `replication`, `autoresearch`

Paper utilities:
- `alpha-research`, `eli5`

Compute environments:
- `docker`, `modal-compute`, `runpod-compute`

Session / project:
- `session-log`, `session-search`, `jobs`, `watch`, `preview`

Self-referential:
- `contributing` (for contributing to the upstream Feynman repo)
