Agent skill

Atomic Decomposition

by lingzhi227 in lingzhi227/agent-research-skills

Decompose research ideas into atomic, self-contained concepts with bidirectional math-code mapping.

No licenceAuto-check passedResearch & Science

Install Atomic Decomposition

skills CLI
$ npx skills add lingzhi227/agent-research-skills --skill atomic-decomposition -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lingzhi227/agent-research-skills atomic-decomposition --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/lingzhi227/agent-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/atomic-decomposition .claude/skills/atomic-decomposition && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
atomic-decomposition
GitHub stars
386
Token cost
~712 tokens
SKILL.md length
242 words
Files
2 (incl. references)
Skills in repo
31
Repo updated
First seen
Licence
None found

At a glance

Decompose research ideas into atomic, self-contained concepts with bidirectional math-code mapping.

  • Works in 3 steps: Break Down into Atomic Definitions → For Each Atomic Definition → Compile Knowledge Base
  • Complex system papers requiring formal grounding
  • SKILL.md covers Input, References, Workflow (from AI-Researcher… and Rules, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Atomic Decomposition is an agent skill from lingzhi227/agent-research-skills. 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.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/decomposition-prompts.md`).

It sits in Research & Science, covering Hypothesis generation. The repository describes itself as: Skills for Claude Code — deep-research: systematic academic literature review.

When your agent uses it

  • Complex system papers requiring formal grounding
  • Tasks that involve Hypothesis generation

Example prompts

  • “/atomic-decomposition”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Break Down into Atomic Definitions
  2. For Each Atomic Definition
  3. Compile Knowledge Base

What it can do on your machine

Read from SKILL.md and the folder at commit 9e6c085. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Atomic Decomposition loads about 712 tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 66 tokens; SKILL.md has 242 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~66
When it runs · the whole SKILL.md, loaded when a task matches
~712
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 242 words (~712 tokens).

“Decompose research ideas into atomic concepts with math formula <-> code implementation mapping.”

— opening of SKILL.md by lingzhi227
name
atomic-decomposition
argument-hint
idea-or-paper

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in skills/atomic-decomposition of lingzhi227/agent-research-skills.

  • SKILL.md
  • references/decomposition-prompts.md

Open the folder on GitHubat commit 9e6c085

Compare with similar skills

Atomic Decomposition next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Atomic Decomposition compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Atomic Decomposition this skilllingzhi227/agent-research-skills386—~712Automated safety check: PassNone
Hypothesis Generationspacering-net/codeg3.9k14 repos~3.6kAutomated safety check: NotesMIT
Nature Paper CardYuan1z0825/nature-skills47k2 repos~2.1kAutomated safety check: PassApache-2.0
Hypothesis GenerationK-Dense-AI/claude-scientific-writer2.4k2 repos~3.9kAutomated safety check: PassMIT
Good QuestionRimagination/good-question3051 repos~4.3kAutomated safety check: PassMIT
High Stakes Analytics Decision Lablimingrui679-design/high-stakes-analytics-decision-lab1k—~2.2kAutomated safety check: PassMIT

Similar skills

  • Hypothesis Generation

    spacering-net/codeg

    Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.

    3.9k GitHub starsUsed in 14 repos~3.6k tokens
    Research & ScienceAuto-check: notes
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed
  • Hypothesis Generation

    K-Dense-AI/claude-scientific-writer

    Formulate evidence-bounded scientific questions, candidate hypotheses, rival explanations, causal or associational claims, discriminating predictions, measurements, and preregistration-ready…

    2.4k GitHub starsUsed in 2 repos~3.9k tokens
    Research & ScienceAuto-check passed
  • Good Question

    Rimagination/good-question

    A skill your agent uses when a researcher is choosing, framing, refining, or stress-testing a research question, hypothesis, thesis topic, project idea, grant direction, paper angle, or stalled…

    305 GitHub starsUsed in 1 repo~4.3k tokens
    Research & ScienceAuto-check passed
  • High Stakes Analytics Decision Lab

    limingrui679-design/high-stakes-analytics-decision-lab

    Build or review source-backed descriptive, diagnostic, predictive, and prescriptive analysis for consequential decisions.

    1k GitHub stars~2.2k tokensUpdated 3 days ago
    Research & ScienceAuto-check passed
  • Claim-Driven Experiment Planner

    zjYao36/Auto-Research-Refine

    Turns a refined research proposal into a claim-to-evidence-to-run-order roadmap instead of a sprawling benchmark wishlist.

    128 GitHub starsUsed in 6 repos~2.3k tokens
    Research & ScienceAuto-check: notes

More from lingzhi227/agent-research-skills

All 31 skills in this repo
  • Backward Traceability

    lingzhi227/agent-research-skills

    Makes each number in a LaTeX paper link back to the code line that produced it, using hypertarget and hyperlink tags and compile-time `\num` formulas.

    386 GitHub stars~802 tokensUpdated 7 mo ago
    Auto-check passed
  • Statistical Data Analysis

    lingzhi227/agent-research-skills

    Writes statistical analysis code for experimental data, runs it through a four-round review, and reports effect sizes, p-values and confidence intervals.

    386 GitHub stars~886 tokensUpdated 7 mo ago
    Auto-check passed
  • Excalidraw Canvas Toolkit

    lingzhi227/agent-research-skills

    Draws and refines Excalidraw diagrams on a live canvas through MCP tools or a REST API, with screenshots, file import and export, snapshots and Mermaid conversion.

    386 GitHub stars~3.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Research Experiment Designer

    lingzhi227/agent-research-skills

    Plans research experiments in four progressive stages, from a first working implementation through baseline tuning and creative research to ablation studies.

    386 GitHub stars~752 tokensUpdated 7 mo ago
    Auto-check passed
  • Scientific Figure Generation

    lingzhi227/agent-research-skills

    Generates publication-quality scientific figures with matplotlib or seaborn through query expansion, a run-and-retry coding loop and a visual check of the rendered PNG.

    386 GitHub stars~809 tokensUpdated 7 mo ago
    Auto-check passed
  • Research Idea Generation

    lingzhi227/agent-research-skills

    Generates and iteratively refines research ideas for a given area, checking each one's novelty against Semantic Scholar and arXiv, and scoring it on interestingness, feasibility and novelty.

    386 GitHub stars~747 tokensUpdated 7 mo ago
    Auto-check passed

Questions about Atomic Decomposition

What does Atomic Decomposition do?

Decompose research ideas into atomic, self-contained concepts with bidirectional math-code mapping. Atomic Decomposition is an agent skill from lingzhi227/agent-research-skills. Decompose research ideas into atomic, self-contained concepts with bidirectional math-code mapping.

When should I use Atomic Decomposition?

Atomic Decomposition fits situations like: complex system papers requiring formal grounding; tasks that involve Hypothesis generation.

How do I install Atomic Decomposition in Claude Code?

Run `npx skills add lingzhi227/agent-research-skills --skill atomic-decomposition -a claude-code`. Or copy the skill folder (skills/atomic-decomposition in lingzhi227/agent-research-skills) into .claude/skills/atomic-decomposition in your project. Claude Code loads it when a task matches its description.

How do I install Atomic Decomposition in Codex?

Run `npx skills add lingzhi227/agent-research-skills --skill atomic-decomposition -a codex`. Or copy the skill folder (skills/atomic-decomposition in lingzhi227/agent-research-skills) into .agents/skills/atomic-decomposition in your project. Codex loads it when a task matches its description.

Can I use Atomic Decomposition in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lingzhi227/agent-research-skills --skill atomic-decomposition -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/atomic-decomposition, .gemini/skills/atomic-decomposition, .github/skills/atomic-decomposition and .opencode/skills/atomic-decomposition in your project.

What does Atomic Decomposition need to run?

SKILL.md names no scripts, command-line tools or credentials: Atomic Decomposition is instructions for the agent only.

Does Atomic Decomposition access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Atomic Decomposition safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Atomic Decomposition use?

No licence was found for Atomic Decomposition or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Atomic Decomposition use?

About 712 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Atomic Decomposition?

Skills that share tags, products or a category with Atomic Decomposition: Hypothesis Generation (spacering-net/codeg, 3.9k stars), Nature Paper Card (Yuan1z0825/nature-skills, 47k stars), Hypothesis Generation (K-Dense-AI/claude-scientific-writer, 2.4k stars) and Good Question (Rimagination/good-question, 305 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Atomic Decomposition?

lingzhi227 (a GitHub user) maintains it in lingzhi227/agent-research-skills, which has 386 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on February 27, 2026.

Source: lingzhi227/agent-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.