lingzhi227Install Atomic Decomposition
Pick your agent. Every command is ready to paste.
npx skills add lingzhi227/agent-research-skills --skill atomic-decompositionThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads atomic-decomposition when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the atomic-decomposition skill”. In Codex, type $atomic-decomposition.
Atomic Decomposition
Decompose research ideas into atomic concepts with math formula <-> code implementation mapping.
Input
$0— Research idea, paper, or method description
References
- Decomposition prompts and workflow:
~/.claude/skills/atomic-decomposition/references/decomposition-prompts.md
Workflow (from AI-Researcher Survey Agent)
Step 1: Break Down into Atomic Definitions
Analyze the research idea and decompose into atomic, self-contained concepts:
- Each atom should be a single concept
- Must have clear mathematical foundations
- Must be implementable in code
- Must be traceable to specific papers
Step 2: For Each Atomic Definition
A. Paper Survey (Math Formula)
- Search papers for the mathematical formulation
- Extract the exact LaTeX formula
- Note assumptions and constraints
- Record reference papers
B. Code Survey (Implementation)
- Search codebases for implementations
- Extract the corresponding code
- Note implementation details and variations
- Record reference repositories
C. Create Knowledge Entry
{
"definition": "Kernelized Gumbel-Softmax Operator",
"math_formula": "Z = \\text{softmax}((\\log \\pi + g) / \\tau), g \\sim \\text{Gumbel}(0,1)",
"code_implementation": "def gumbel_softmax(logits, tau=1.0): ...",
"reference_papers": ["Paper Title 1"],
"reference_codebases": ["github_user/repo_name"],
"assumptions": ["Differentiable relaxation of discrete sampling"],
"connections": ["Used in Component X of the proposed method"]
}
Step 3: Compile Knowledge Base
- Merge all atomic definitions into a structured knowledge base
- Verify consistency: every math formula has a code implementation
- Verify completeness: every code module traces to a formal definition
- Identify any gaps (formulas without code, or code without theory)
Rules
- Each atomic definition must be specific enough to trace to concrete formulas and code
- Do not skip or combine definitions — analyze each separately
- If unsure about atomicity, err on the side of breaking down further
- Document breakdown reasoning before analysis
- Every mathematical concept in the paper must have verified code
- Every code module must trace back to a formal mathematical definition
Related Skills
- Upstream: research-planning, idea-generation
- Downstream: experiment-code, algorithm-design
- See also: math-reasoning
Tips for Atomic Decomposition
- • Start a fresh session after installing so your agent picks up the new skill.
- • It bundles reference files. The agent reads them only when needed, so they cost no context until then.
- • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Atomic Decomposition
What does the Atomic Decomposition skill do?
Decompose research ideas into atomic, self-contained concepts with bidirectional math-code mapping. For each concept, extract the math formula from papers and find code implementations. Use for complex system papers requiring formal grounding.
How do I install Atomic Decomposition?
Run "npx skills add lingzhi227/agent-research-skills --skill atomic-decomposition" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Atomic Decomposition work in Cursor and Codex?
Yes. Atomic Decomposition uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is Atomic Decomposition free?
Atomic Decomposition is open source on GitHub. It is free to install; check the license before commercial use.
Who made Atomic Decomposition?
Atomic Decomposition is published by lingzhi227 in the lingzhi227/agent-research-skills repository, together with 29 other skills.
