simplify-docs SKILL.md skillA

simplify-docs from tobihagemann/turbo is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add tobihagemann/turbo/simplify-docs@git:20261022.181a901

Pins git:20261022.181a901 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
tobihagemann/turbo
Path
claude/skills/simplify-docs/SKILL.md
Versions recorded
10
Latest version
git:20261022.181a901, committed Oct 22, 2026
First version recorded
Aug 21, 2026
Size
13,253 bytes
Repository stars
418
License
MIT

Run a multi-agent review of code comments and markdown documentation for unnecessary content, then fix the issues. Covers comments that misdescribe the code, what-restating comments, name-mirroring doc comments, status-update prose, and other documentation noise. Use when the user asks to "simplify docs", "simplify documentation", "clean up comments", "clean up docs", "review documentation", "strip unnecessary comments", "fix stale comments", "reduce doc noise", or "run simplify-docs".

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

# Simplify Docs

Review code comments and markdown documentation for unnecessary content, then fix the issues.

## Step 1: Determine the Scope

Determine what to review:

- If a specific **diff command** was provided (e.g., `git diff --cached`), use that.
- If a **file list or directory** was provided, review those files directly (read the full files, not a diff).
- If **neither** was provided, determine the appropriate diff command (e.g., `git diff`, `git diff --cached`, `git diff HEAD`) based on the current git state. When the branch is an open pull request, resolve its base with `gh pr view --json baseRefName --jq '.baseRefName'`, run `git fetch origin <base-branch>`, and diff against `origin/<base-branch>...HEAD`: a local branch of the same name can sit behind the remote, which puts the merge base before an already-merged pull request and pulls merged work into the scope. If there are no git changes, default to a full-tree sweep of source files plus top-level markdown.

State the resolved file list before launching the agents: add `--name-only` to a diff command, or list the files for a file or directory scope.

## Step 2: Launch Two Review Agents in Parallel
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add tobihagemann/turbo/simplify-docs@sha256:f8bd3c4c8abe9d70

The line at the top of this page pins the label git:20261022.181a901, 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_lwpdwgpbhcdyqfta.svg)](https://markdownregistry.com/a/art_lwpdwgpbhcdyqfta)

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

Versions

The registry has recorded 10 versions of this file, between Aug 21, 2026 and Oct 22, 2026, about one every 7 days.

versioncommittedcommitsizeaudit
git:20261022.181a901 latest2026-10-22 181a901 13,253 BA view · diff
git:20261018.e9270d62026-10-18 e9270d6 12,863 BA view · diff
git:20261013.7173b0c2026-10-13 7173b0c 12,565 BA view · diff
git:20261008.aff10272026-10-08 aff1027 12,532 BA view · diff
git:20261004.8f59b862026-10-04 8f59b86 12,496 BA view · diff
git:20260906.17c9fd02026-09-06 17c9fd0 11,896 BA view · diff
git:20260831.4f7d8842026-08-31 4f7d884 11,289 BA view · diff
git:20260823.13251812026-08-23 1325181 10,898 BA view · diff
git:20260822.8b89bae2026-08-22 8b89bae 10,529 BA view · diff
git:20260821.03604c62026-08-21 03604c6 9,844 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 (13253 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

tobihagemann/turbo · 418 stars · license MIT · pushed 2026-10-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_lwpdwgpbhcdyqfta
GET https://markdownregistry.com/api/v1/resolve?ref=tobihagemann/turbo/simplify-docs
GET https://markdownregistry.com/api/v1/blob/f8bd3c4c8abe9d70b3a7e825316d4854eb55d86f7d01fdf30d2cc40720c1ae23

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 tobihagemann/turbo

apply-turbo-handoffs SKILL.md skill
tobihagemann/turbo · .claude/skills/apply-turbo-handoffs/SKILL.md · Audit the turbo skill lessons that /self-improve writes into this repo's .turbo/handoff/ from other projects, apply the…
git:20261004.cdcfe2f · audit A · 418 stars
AGENTS.md AGENTS.md file
tobihagemann/turbo · AGENTS.md
git:20260927.fa1ba5a · audit A · 418 stars
CLAUDE.md CLAUDE.md file
tobihagemann/turbo · CLAUDE.md
git:20261002.0f83d5c · audit A · 418 stars
CLAUDE.md@assets CLAUDE.md file
tobihagemann/turbo · assets/CLAUDE.md
git:20260920.5edbbe3 · audit A · 418 stars
AGENTS.md@claude AGENTS.md file
tobihagemann/turbo · claude/AGENTS.md
git:20260726.3cf3297 · audit A · 418 stars
CLAUDE.md@claude CLAUDE.md file
tobihagemann/turbo · claude/CLAUDE.md
git:20261008.aff1027 · audit A · 418 stars
apply-findings SKILL.md skill
tobihagemann/turbo · claude/skills/apply-findings/SKILL.md · Apply findings by making the suggested code changes. Applies accepted verdicts, escalates ambiguous findings to the…
git:20261023.44fa179 · audit A · 418 stars
assess-technical-debt SKILL.md skill
tobihagemann/turbo · claude/skills/assess-technical-debt/SKILL.md · Assess project-wide structural technical debt: complexity hotspots, deprecated API usage, duplication clusters…
git:20261022.181a901 · audit A · 418 stars
changelog-rules SKILL.md skill
tobihagemann/turbo · claude/skills/changelog-rules/SKILL.md · Shared changelog conventions and formatting rules referenced by /create-changelog and /update-changelog. Not typically…
git:20260801.187c292 · audit A · 418 stars
code-style SKILL.md skill
tobihagemann/turbo · claude/skills/code-style/SKILL.md · Enforce existence, reuse, mirror, and symmetry principles to keep new code minimal and consistent with surrounding…
git:20261016.409a05c · audit A · 418 stars
codex-exec SKILL.md skill
tobihagemann/turbo · claude/skills/codex-exec/SKILL.md · Run autonomous task execution using the codex CLI. Use when the user asks to "codex exec", "run codex exec", "execute a…
git:20261008.aff1027 · audit A · 418 stars
commit-rules SKILL.md skill
tobihagemann/turbo · claude/skills/commit-rules/SKILL.md · Shared commit message rules and technical constraints for skills that write commits. Not typically invoked directly.
git:20260927.8a693f4 · audit A · 418 stars

Every file in tobihagemann/turbo

Other files named simplify-docs

simplify-docs SKILL.md skill
tobihagemann/turbo · codex/skills/simplify-docs/SKILL.md · Run a multi-agent review of code comments and markdown documentation for unnecessary content, then fix the issues…
git:20261022.181a901 · audit A · 418 stars

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