How do I install the Toml Editor skill?

Run npx skillmds@latest add cbrunnkvist/toml-editor in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Toml Editor safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Toml Editor?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Toml Editor free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Toml Editor?

cbrunnkvist (@cbrunnkvist) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Toml Editor by cbrunnkvist — Agent Skill

Name: Toml Editor
Author: cbrunnkvist

Toml Editor

Edit TOML files programmatically using yq, tmq, or toml-cli. Use when asked to edit .toml files, modify pyproject.toml, update pihole.toml, or any TOML operation. Triggers on "edit toml", "modify .toml", "toml file", "update pyproject.toml", "pihole.toml".

cbrunnkvist 5da91f0 6 files · 7.3 KB Updated Sep 17, 2026

File contents

TOML Editor

Edit .toml files without shell escaping issues. Three tools available:

Tool	Lang	In-place	Pros	Reference
toml-cli	Rust	No (prints)	Format-preserving, comments intact	`references/toml-cli.md`
yq	Python	Yes (`-i`)	jq-like syntax, widely known	`references/yq.md`
tmq	Go	Yes	Zero-dependency binary, fast	`references/tmq.md`

Recommendation: Prefer toml-cli for Pi-hole configs and other human-edited files where comment preservation matters. Prefer yq -t -i for automated transformations (CI, scripts). Pull the reference doc for your chosen tool above.

Installation (one-time)

# toml-cli — Rust
cargo install toml-cli
# or no-install: npx @toml-tools/editor set config.toml key "value"

# yq — Python
pip install yq
# or no-install: uvx yq -t -i '.key = "value"' config.toml

# tmq — Go
go install github.com/tmq/tmq@latest

Workflows

Adding a custom DNS record to Pi-hole v6

yq -t -i '.dns.hosts += ["10.13.37.180 myservice.lan"]' /etc/pihole/pihole.toml
pihole restartdns

Patching pyproject.toml

# Add a dependency
yq -t -i '.project.dependencies += ["httpx>=0.27"]' pyproject.toml

# Add optional dependency group
yq -t -i '.project.optional-dependencies.dev = ["pytest>=8"]' pyproject.toml

# Set Python version requirement
yq -t -i '.project.requires-python = ">=3.11"' pyproject.toml

Array append with toml-cli

toml get /etc/pihole/pihole.toml dns.hosts \
  | python3 scripts/append-toml-array.py "10.13.37.180 radarr.lan" \
  | toml set /etc/pihole/pihole.toml dns.hosts

Validation

python3 scripts/validate-toml.py file.toml
# or inline:
python3 -c "import tomllib; tomllib.load(open('file.toml','rb'))"

Safety

Back up before bulk edits: cp file.toml file.toml.bak
Validate after every edit
yq strips comments and reorders keys — use toml-cli when formatting matters
toml-cli has no -i — pipe to temp file and rename
No tool does true inline editing — they rewrite the file. Use version control.

---name: toml-editordescription: Edit TOML files programmatically using yq, tmq, or toml-cli. Use when asked to edit .toml files, modify pyproject.toml, update pihole.toml, or any TOML operation. Triggers on "edit toml", "modify .toml", "toml file", "update pyproject.toml", "pihole.toml".license: MIT---# TOML EditorEdit `.toml` files without shell escaping issues. Three tools available:| Tool | Lang | In-place | Pros | Reference ||------|------|----------|------|-----------|| **toml-cli** | Rust | No (prints) | Format-preserving, comments intact | [`references/toml-cli.md`](references/toml-cli.md) || **yq** | Python | Yes (`-i`) | jq-like syntax, widely known | [`references/yq.md`](references/yq.md) || **tmq** | Go | Yes | Zero-dependency binary, fast | [`references/tmq.md`](references/tmq.md) |**Recommendation:** Prefer `toml-cli` for Pi-hole configs and other human-edited files where comment preservation matters. Prefer `yq -t -i` for automated transformations (CI, scripts). Pull the reference doc for your chosen tool above.## Installation (one-time)```bash# toml-cli — Rustcargo install toml-cli# or no-install: npx @toml-tools/editor set config.toml key "value"# yq — Pythonpip install yq# or no-install: uvx yq -t -i '.key = "value"' config.toml# tmq — Gogo install github.com/tmq/tmq@latest```## Workflows### Adding a custom DNS record to Pi-hole v6```bashyq -t -i '.dns.hosts += ["10.13.37.180 myservice.lan"]' /etc/pihole/pihole.tomlpihole restartdns```### Patching pyproject.toml```bash# Add a dependencyyq -t -i '.project.dependencies += ["httpx>=0.27"]' pyproject.toml# Add optional dependency groupyq -t -i '.project.optional-dependencies.dev = ["pytest>=8"]' pyproject.toml# Set Python version requirementyq -t -i '.project.requires-python = ">=3.11"' pyproject.toml```### Array append with toml-cli```bashtoml get /etc/pihole/pihole.toml dns.hosts \ | python3 scripts/append-toml-array.py "10.13.37.180 radarr.lan" \ | toml set /etc/pihole/pihole.toml dns.hosts```## Validation```bashpython3 scripts/validate-toml.py file.toml# or inline:python3 -c "import tomllib; tomllib.load(open('file.toml','rb'))"```## Safety- **Back up** before bulk edits: `cp file.toml file.toml.bak`- **Validate** after every edit- **`yq` strips comments and reorders keys** — use `toml-cli` when formatting matters- **toml-cli has no `-i`** — pipe to temp file and rename- **No tool does true inline editing** — they rewrite the file. Use version control.

Frequently asked questions