edit SKILL.md skillA

edit from gagoar/iceberg is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add gagoar/iceberg/edit@git:20261009.560747e

Pins git:20261009.560747e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
gagoar/iceberg
Path
skills/edit/SKILL.md
Versions recorded
6
Latest version
git:20261009.560747e, committed Oct 9, 2026
First version recorded
Jun 3, 2026
Size
14,226 bytes
Repository stars
8
License
MIT

/iceberg:edit — Rewrite a technical document using 14 Hemingway rules (short sentences, active voice, no hedges, concrete nouns). Returns the clean document, no annotations. ALWAYS apply automatically to every plan and every document Claude returns to the user. This is not optional and requires no user prompt. Run it on every plan, spec, proposal, README, or prose document before returning it. Also trigger on: /iceberg:edit <file-path>, /iceberg:edit with pasted text. Natural language…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Iceberg Editor

Named after Hemingway's iceberg theory: the strength of a document comes from what you cut.

These rules apply to documentation, plans, proposals, READMEs, and any prose. They do not apply to code blocks, inline code, command names, variable names, or URLs.

## Input

- `/iceberg:edit <file-path>` — read the file, apply rules, write it back in place. Resolve relative paths from the current working directory.
- `/iceberg:edit <file-path> "intent description"` — edit while preserving the intended voice
- `/iceberg:edit <file-path> --no-em-dash --no-weakeners --strip-ai-commentary` — also apply the opt-in extended rules (any combination, including one alone)
- `/iceberg:edit <file-path> --jargon=finance,legal` — also drop words from the named bundled packs for this run
- `/iceberg:edit` — user pastes text; return the rewritten version
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add gagoar/iceberg/edit@sha256:f04d73a99e3073cb

The line at the top of this page pins the label git:20261009.560747e, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ag5ggwcihyezhpuf.svg)](https://markdownregistry.com/a/art_ag5ggwcihyezhpuf)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Jun 3, 2026 and Oct 9, 2026, about one every 26 days.

versioncommittedcommitsizeaudit
git:20261009.560747e latest2026-10-09 560747e 14,226 BA view · diff
git:20261005.cf276d32026-10-05 cf276d3 14,233 BA view · diff
git:20260909.6f537072026-09-09 6f53707 11,588 BA view · diff
git:20260909.28e0b8e2026-09-09 28e0b8e 9,560 BA view · diff
git:20260620.32b0c0d2026-06-20 32b0c0d 6,957 BA view · diff
git:20260603.10205c32026-06-03 10205c3 6,906 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14226 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

gagoar/iceberg · 8 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ag5ggwcihyezhpuf
GET https://markdownregistry.com/api/v1/resolve?ref=gagoar/iceberg/edit
GET https://markdownregistry.com/api/v1/blob/f04d73a99e3073cb7329b8a11a255dde5e4afdf0cf7bdb1db85dd1ef2b0d1550

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from gagoar/iceberg

jargon SKILL.md skill
gagoar/iceberg · skills/jargon/SKILL.md · /iceberg:jargon — Build and manage the jargon list that /iceberg:edit removes and /iceberg:score flags (Rule 18). Pick…
git:20261009.560747e · audit A · 8 stars
score SKILL.md skill
gagoar/iceberg · skills/score/SKILL.md · /iceberg:score — Score a technical document against 14 Hemingway writing rules without changing it. Returns a graded…
git:20261009.560747e · audit A · 8 stars

Every file in gagoar/iceberg

Other files named edit

edit SKILL.md skill
kinggyusuh/codex-image-in-cc · skills/edit/SKILL.md · Edit an image through Codex CLI's built-in imagegen skill
git:20260912.4d958f0 · audit B · 35 stars
edit SKILL.md skill
xxwtiancai/nanorsi · src/nanorsi/templates/coding/target/agent/skills/edit/SKILL.md
git:20260912.4c1f315 · audit C · 3 stars
edit SKILL.md skill
xxwtiancai/nanorsi · src/nanorsi/templates/skills/target/agent/skills/edit/SKILL.md
git:20260908.d4e0058 · audit C · 3 stars

Browse by kind, by grade A, or by owner.