# Trim Md

> Trim Md

- Skill: `aksh-3141/trim-md` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add aksh-3141/trim-md`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aksh-3141/trim-md/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aksh-3141 (https://skillmd.com/u/aksh-3141)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aksh-3141/trim-md

---


# /trim-md

User request: "$ARGUMENTS"

## Task

Trim and optimize markdown files for LLM/agent consumption. Run the trim-md script on the given paths, then present the output.

## Opt-out

Files containing `<!-- trim-md:disable -->` on its own line are excluded. The comment must be a standalone line — inline mentions in prose or code blocks are ignored.

## Process

### Step 1: Resolve skill directory

```bash
SKILL_DIR="$(find "$HOME/.claude/plugins/cache" -type d -name "trim-md" -path "*/skills/trim-md" 2>/dev/null | head -1)"
[[ -z "$SKILL_DIR" ]] && SKILL_DIR="$(find "$HOME" -maxdepth 8 -type d -name "trim-md" -path "*/skills/trim-md" 2>/dev/null | head -1)"
echo "SKILL_DIR=$SKILL_DIR"
```

If `SKILL_DIR` is empty, stop with: "Could not locate the trim-md skill directory. Ensure the plugin is installed."

### Step 2: Ensure dependencies

```bash
bash "$SKILL_DIR/scripts/ensure-deps.sh"
```

If the script exits with an error, show the missing dependency message to the user and stop.

### Step 3: Run trim-md

Parse `$ARGUMENTS` for paths and the dry-run flag.

**Dry-run detection:** If `$ARGUMENTS` contains any of these tokens (case-insensitive): `dry`, `dry-run`, `--dry-run`, `dryrun` — pass `--dry-run` to the script. Remove the token from the path list.

Remaining arguments are the target paths. If no paths remain, use `.` (current directory).

```bash
bash "$SKILL_DIR/scripts/trim-md.sh" [--dry-run] <paths>
```

### Step 4: Present output

Show the script output to the user as-is. No additional commentary needed unless there were errors.