symbolic-equation — Claude Code skill: what it does, how to install
Discovers scientific equations from numerical datasets using LLM-guided evolutionary search. Useful for symbolic regression and extracting interpretable physical laws.
npx skills add lingzhi227/agent-research-skills --skill symbolic-equation -a claude-codeWhat symbolic-equation does
The skill implements the LLM-SR approach to discover mathematical equations from data. It expects input arrays such as np.ndarray, target variables, and physical context. The language model generates candidate formulas as versioned Python functions, checking each against negative MSE.
Candidate solutions live across independent populations called islands, with 10 islands by default. The system clusters formulas by score signatures and samples them using a temperature-controlled softmax. Higher temperatures promote early exploration. Later iterations focus strictly on the top clusters.
Parameter tuning requires scipy BFGS or Adam. Discovered expressions must use standard mathematical operations, and recursive functions are strictly forbidden. Every 4 hours, the bottom half of the islands resets to prevent convergence traps. The search favors shorter equations when accuracy is equal.
What it helps with
- discover an analytical equation from experimental data points
- model physical oscillator dynamics using input arrays
- optimize equation parameters using scipy BFGS or Adam
- extract interpretable mathematical laws instead of black-box models
Example prompts for the agent
- Find an acceleration equation for a damped oscillator using input arrays x and v
- Run symbolic regression to predict pressure from temperature and volume data
- Discover a mathematical relation for target variable y given features x1 and x2
How to install symbolic-equation
1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill symbolic-equation -a claude-code2Manually: put the files in place
~/.claude/skills/symbolic-equation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/symbolic-equation/
1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill symbolic-equation -a codex2Manually: put the files in place
.agents/skills/symbolic-equation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill symbolic-equation -a cursor2Manually: put the files in place
.cursor/skills/symbolic-equation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install lingzhi227/agent-research-skills symbolic-equation2Manually: put the files in place
.github/skills/symbolic-equation/SKILL.md1Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill symbolic-equation -a gemini-cli2Platform CLI
gemini skills install https://github.com/lingzhi227/agent-research-skills --path skills/symbolic-equationManually: put the files in place
.devin/skills/symbolic-equation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add lingzhi227/agent-research-skills --skill symbolic-equation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about symbolic-equation
How do I install symbolic-equation in Claude Code?
Run npx skills add lingzhi227/agent-research-skills --skill symbolic-equation -a claude-code. The files will be placed in ~/.claude/skills/symbolic-equation/SKILL.md.
What does symbolic-equation do?
It discovers interpretable mathematical equations from datasets using LLM-guided evolutionary search. The tool maintains multi-island populations and optimizes fitness via negative MSE.
What constraints apply to the generated equations?
Formulas must rely only on standard math operations without recursion. Free parameters are fitted using scipy BFGS or Adam, and simpler expressions are preferred over complex ones.