nature-experiment-log Skill for Claude: Structured Lab Experiment Logs

Turns experiment photos, voice notes and text into structured Markdown logs, for a plain folder or an Obsidian vault.

Installs: 12K; on skills.sh
Stars: 51.7K; on GitHub
Files: 10; besides SKILL.md
Updated: Nov 2026; last repo commit

nature-experiment-log makes Claude turn raw experiment material into one standard log per experiment. You upload images, audio, a voice transcript or text, or point it at a local file or folder. It extracts the details, asks you about anything missing or unclear instead of guessing, and writes a Markdown file with YAML frontmatter plus an archive of the original attachments.

It gives each log an experiment ID and a sample batch ID, and has templates for an experiment index, an anomaly log and equipment tracking. Output goes to a normal folder you choose, or to an Obsidian vault. Feishu group input is optional and uses a separate skill and the lark-cli command. SKILL.md is written in Chinese, and the repo includes an English README.

Good for

Lab researchers who keep experiment notes as photos, voice memos and chat messages
Obsidian users who want experiment logs that Dataview can query
Teams that collect lab material in Feishu groups

Install nature-experiment-log

Claude Code

Copy this prompt.

Install the nature-experiment-log skill in Claude Code. Run this command:

npx skills add https://github.com/yuan1z0825/nature-skills --skill nature-experiment-log

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

标准化实验日志记录——直接上传或读取本地图片、语音和文字，产出带 YAML frontmatter 的 Markdown；可选集成飞书 CLI 与 Obsidian。

Sections in SKILL.md

输入方式
输出方式
处理流程
目录结构
实验 ID 规则
样品批次 ID 规则
设备代码
可选的 Obsidian 集成
参考示例
可选的飞书 CLI 集成
自定义指南
相关文件

Key facts

Author: Jiahao8595 (SKILL.md metadata)
License: SKILL.md says MIT; the repo LICENSE and README badge say Apache 2.0
Installs on skills.sh: 11,991 (Nov 2, 2026)
GitHub stars: 51,696 (repo, Nov 2, 2026)
Files: 11 including SKILL.md: 3 templates, 3 examples, 2 READMEs, a manifest and Codex metadata; no scripts
Optional add-ons: The core flow does not require Feishu or Obsidian (both optional)
Last commit: Nov 1, 2026 (repo)

What it includes

Takes images, audio, transcripts or text, or reads a local path.
A Feishu group is read through the optional feishu-cli-integration skill.
Files · Input: upload, local files or Feishu
Pulls structured details with vision_analyze and text parsing, then asks about gaps.
SKILL.md says not to guess temperatures, sample numbers or results.
Read · Extract and confirm
Saves {OUTPUT_ROOT}/实验日志/{system}/{type}/{exp_id}.md with YAML frontmatter.
If you give no folder, it returns the Markdown instead of choosing a path.
Write · Write the log
Copies originals to raw/experiments/YYYY.MM.DD_description_EXPID/ and links them.
The log references the archived files.
Write · Archive raw attachments
Updates the experiment index and adds an anomaly record when needed.
Only if the index templates are set up in your vault.
Write · Index and anomalies
Experiment ID, sample batch ID and six device codes (M, T, E, G, F, B).
System codes are yours to define, for example CL, NO or OX. Device codes cover muffle furnace, tube furnace, electrochemical station, glovebox, controlled-atmosphere furnace and general.
ID rules and device codes
Experiment index dashboard, anomaly log and equipment and reagent tracking.
Copy them into your Obsidian vault as SKILL.md describes.
templates/ (3 files)
Full example logs: corrosion soak, electrochemical CV window and thermal stability.
Each has complete YAML frontmatter and body text.
references/ (3 examples)
Runs lark-cli to list group messages and download images.
Needs the bot in the group with im:message, im:message.group_msg and im:resource permissions.
Runs code · Optional Feishu step

From the official docs

Permissions

Medium risk

It writes log files and copies your attachments into the folder you choose. If you turn on the Feishu option, it reads group messages and downloads files with a bot that has message permissions.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Optional Feishu access reads group messages
SKILL.md runs lark-cli to list messages and download images, and needs a bot with im:message, im:message.group_msg and im:resource. Skip it unless you want group input. github.com
It writes into your vault or folder
Logs, raw attachments, index and anomaly files are created under the output root. Pick a folder you back up. github.com

Technical details

Scopes	output folder or Obsidian vault lark-cli (optional) im:message im:message.group_msg im:resource

Questions

What does nature-experiment-log do?

It turns experiment photos, audio, transcripts and text into a standard Markdown log with YAML frontmatter. It archives the originals and links them from the log.

How do I install nature-experiment-log?

Use the install box above. The nature-skills README documents the skills CLI and also a Claude Code route with a local clone and wrapper files.

Do I need Obsidian or Feishu?

No. SKILL.md says the core flow needs neither. You can save to a normal folder. Obsidian and Feishu are optional add-ons.

Will it make up missing details?

SKILL.md says it should not. It asks about unclear conditions and sample numbers. The English README says unconfirmed items are kept as AUTHOR_INPUT_NEEDED.

Is it safe to use with lab data?

It writes files to the folder you choose and copies your attachments there. The optional Feishu step reads a group through a bot, so give that bot only the permissions SKILL.md lists. Keep unpublished data in a folder you control.

Which license applies?

The files disagree. SKILL.md says MIT, while the repo LICENSE and README badge say Apache 2.0. Check the repo before reusing the files.

Information

updated Nov 2, 2026

Repository: yuan1z0825/nature-skills
Folder: skills/nature-experiment-log

yuan1z0825/nature-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 7

nature-experiment-log SKILL.md · github.com
README_EN.md · github.com
LICENSE · github.com
nature-skills README · github.com
nature-experiment-log on skills.sh · skills.sh
yuan1z0825/nature-skills · github.com
manifest.yaml · github.com