paper2code

Install

npx skillfoxx add skills/paper2code

npx skills add prathamlearnstocode/paper2code --skill paper2code -a claude-code -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/prathamlearnstocode/paper2code.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/paper2code/
git -C "$tmp" checkout fcffce7a1250659ed74f2a96cdf54595c92306c4
mkdir -p .claude/skills
cp -R "$tmp/skills/paper2code" .claude/skills/paper2code

npx skills add prathamlearnstocode/paper2code --skill paper2code -a cursor -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/prathamlearnstocode/paper2code.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/paper2code/
git -C "$tmp" checkout fcffce7a1250659ed74f2a96cdf54595c92306c4
mkdir -p .agents/skills
cp -R "$tmp/skills/paper2code" .agents/skills/paper2code

npx skills add prathamlearnstocode/paper2code --skill paper2code -a github-copilot -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/prathamlearnstocode/paper2code.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/paper2code/
git -C "$tmp" checkout fcffce7a1250659ed74f2a96cdf54595c92306c4
mkdir -p .github/skills
cp -R "$tmp/skills/paper2code" .github/skills/paper2code

npx skills add prathamlearnstocode/paper2code --skill paper2code -a codex -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/prathamlearnstocode/paper2code.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/paper2code/
git -C "$tmp" checkout fcffce7a1250659ed74f2a96cdf54595c92306c4
mkdir -p .agents/skills
cp -R "$tmp/skills/paper2code" .agents/skills/paper2code

npx skills add prathamlearnstocode/paper2code --skill paper2code -a gemini-cli -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/prathamlearnstocode/paper2code.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/paper2code/
git -C "$tmp" checkout fcffce7a1250659ed74f2a96cdf54595c92306c4
mkdir -p .agents/skills
cp -R "$tmp/skills/paper2code" .agents/skills/paper2code

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/prathamlearnstocode/paper2code.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/paper2code/
git -C "$tmp" checkout fcffce7a1250659ed74f2a96cdf54595c92306c4
mkdir -p .devin/skills
cp -R "$tmp/skills/paper2code" .devin/skills/paper2code

npx skills add prathamlearnstocode/paper2code --skill paper2code -a cline -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/prathamlearnstocode/paper2code.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/paper2code/
git -C "$tmp" checkout fcffce7a1250659ed74f2a96cdf54595c92306c4
mkdir -p .cline/skills
cp -R "$tmp/skills/paper2code" .cline/skills/paper2code

npx skills add prathamlearnstocode/paper2code --skill paper2code -a roo -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/prathamlearnstocode/paper2code.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/paper2code/
git -C "$tmp" checkout fcffce7a1250659ed74f2a96cdf54595c92306c4
mkdir -p .roo/skills
cp -R "$tmp/skills/paper2code" .roo/skills/paper2code

npx skills add prathamlearnstocode/paper2code --skill paper2code -a opencode -y

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/prathamlearnstocode/paper2code.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/paper2code/
git -C "$tmp" checkout fcffce7a1250659ed74f2a96cdf54595c92306c4
mkdir -p .agents/skills
cp -R "$tmp/skills/paper2code" .agents/skills/paper2code

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/prathamlearnstocode/paper2code.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/paper2code/
git -C "$tmp" checkout fcffce7a1250659ed74f2a96cdf54595c92306c4
mkdir -p .agents/skills
cp -R "$tmp/skills/paper2code" .agents/skills/paper2code

tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/prathamlearnstocode/paper2code.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/paper2code/
git -C "$tmp" checkout fcffce7a1250659ed74f2a96cdf54595c92306c4
mkdir -p .agents/skills
cp -R "$tmp/skills/paper2code" .agents/skills/paper2code

npx skills add PrathamLearnsToCode/paper2code/skills/paper2code

This is third-party code. Review the repository files before installing.

What it does

The skill walks the agent through a pipeline: it downloads and parses the arxiv paper, identifies the single core contribution, runs an ambiguity audit and only then writes code. Every non-trivial decision carries a reference to the paper's section and equation, and anything the paper does not state is marked with tags such as UNSPECIFIED and PARTIALLY_SPECIFIED plus a list of reasonable alternatives. The output is a project layout with the model, loss functions, a hyperparameter config, reproduction notes and a walkthrough notebook. It offers minimal, full and educational modes and a choice of the pytorch, jax or numpy framework. The skill never fills gaps silently and does not guarantee the paper itself is right.

Who it is for. For developers and researchers who implement machine learning papers and want verifiable code.

Example request

Implement the paper https://arxiv.org/abs/1706.03762 with code anchored to sections

Limitations

The skill does not guarantee correctness: if the paper is incomplete or wrong, the code reflects that, though it is flagged. It does not download datasets; it provides a Dataset class skeleton with instructions. It does not set up training infrastructure, implement baselines or reimplement standard components. For parsing it installs packages via pip and fetches the paper over the network, and result quality depends on the agent's own model.

How to disable. Remove the skill from the agent's skills directory. If installed via symlink, remove the link; if copied, delete the paper2code folder.

Security check

• Installs packages via pip and downloads papers from the network
• Creates code files and artifacts in the project working directory

README in short

The README frames the problem: machine learning papers often omit hyperparameters, and naive code generation fills gaps silently. paper2code answers this by anchoring every decision to a section and equation, auditing ambiguities before writing code and flagging unspecified choices honestly. Install is via npx skills add with a choice of agents and linking method. The output includes model.py, loss.py, a hyperparameter config, a reproduction notes file and a notebook runnable on CPU with toy dimensions. The repository ships worked examples for the Attention Is All You Need and DDPM papers. MIT licensed.

SKILL.md

---
name: paper2code
description: Converts an arxiv paper into a minimal, citation-anchored Python implementation. Trigger when user runs /paper2code with an arxiv URL or paper ID, says "implement this paper", or pastes an arxiv link asking for implementation. Flags all ambiguities honestly. Never invents implementation details not stated in the paper.
---

# paper2code — Orchestration

You are executing the paper2code skill. This file governs the high-level flow. Each stage dispatches to a detailed reasoning protocol in `pipeline/`. Do NOT skip stages. Do NOT combine stages. Execute them in order.

## Parse arguments

Extract from the user's input:
- `ARXIV_ID`: the arxiv paper ID (e.g., `2106.09685`). Strip any URL prefix.
- `MODE`: one of `minimal` (default), `full`, `educational`.
- `FRAMEWORK`: one of `pytorch` (default), `jax`, `numpy`.

If the user provided a full URL like `https://arxiv.org/abs/2106.09685`, extract the ID `2106.09685`.
If the user provided a versioned ID like `2106.09685v2`, keep the version.

## Set up working directory

Create a temporary working directory: `.paper2code_work/{ARXIV_ID}/`
This is where intermediate artifacts go. The final output goes in the current directory under `{paper_slug}/`.

Related