mcpbeat

Atomic Decomposition

lingzhi227/atomic-decomposition

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.

2k tokens
context cost
the whole folder, loaded on every use
2
files
instructions only
0
copies elsewhere
how many repositories repackaged it
256
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/lingzhi227/agent-research-skills --skill atomic-decomposition

The instruction itself

12 sections, as written by the author

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
  • Upstream: research-planning, idea-generation
  • Downstream: experiment-code, algorithm-design
  • See also: math-reasoning

How to use it

Copy the folder

Take lingzhi227/atomic-decomposition from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.