Home / badmuriss / my-llm-kit · skills/trim-code-comments/SKILL.md · GitHub

trim-code-comments skillA

trim-code-comments is agent-read markdown (skill) from badmuriss/my-llm-kit: Review source comments and remove low-value comments that only narrate visible code while preserving rationale, constraints, safety context, public documentation, and tooling directives. Use when asked to trim code comments or remove dumb, redundant, obvious, excessive, or AI-generated comments. Do not run automatically after implementation..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Trim Code Comments

Reduce comment noise without erasing context that future maintainers need.

## Scope

Inspect changed source files by default. Inspect the whole repository only when the user explicitly asks for all comments. Skip generated files, vendored code, dependencies, lockfiles, snapshots, fixtures, and prose documentation.

## Classification

Remove a comment only when the adjacent code expresses the same fact just as clearly. Typical candidates narrate assignments, loops, branches, calls, returns, or obvious names.

Keep comments that carry information the code cannot express directly:

- rationale, trade-offs, invariants, or failure semantics;
- security boundaries, threat assumptions, or fail-open/fail-closed behavior;
- compatibility constraints, workarounds, protocol rules, RFCs, issues, or TODO context;
- architecture, deployment, concurrency, ordering, performance, or lifecycle constraints;
- public API documentation required by the language or repository;
- lint, formatter, coverage, build, code-generation, or type-checker directives;
- non-obvious examples, units, ownership, or data provenance.

When uncertain, keep the comment.

## Workflow
…

Read the whole file at its exact version.

How to install

Latest version
mdr add badmuriss/my-llm-kit/trim-code-comments@git:20260906.3d137c0
Exact content
mdr add badmuriss/my-llm-kit/trim-code-comments@sha256:7eb8d0be5489b8e0

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260906.3d137c0 latest2026-09-06 3d137c0 2,702 BA view · diff
git:20260812.1a72bee2026-08-12 1a72bee 2,705 BA view · diff
git:20260812.5e009b32026-08-12 5e009b3 2,375 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (2702 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

badmuriss/my-llm-kit · 3 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bxs263gvz7ckt4ox
GET https://markdownregistry.com/api/v1/resolve?ref=badmuriss/my-llm-kit/trim-code-comments
GET https://markdownregistry.com/api/v1/blob/7eb8d0be5489b8e094476a8fdfa252dd6dc0ebff0bbc27152ea4aefbaf5894ae

Your agent 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.

More from badmuriss/my-llm-kit

AGENTS.md agents
badmuriss/my-llm-kit · AGENTS.md
git:20260906.3d137c0 · audit A · 3 stars
AGENTS.md@instructions agents
badmuriss/my-llm-kit · instructions/AGENTS.md
git:20260923.97e81e6 · audit A · 3 stars
agent-graph skill
badmuriss/my-llm-kit · skills/agent-graph/SKILL.md · Run durable task graphs when independent work needs ownership, integration checks and recovery. Use for graph…
git:20260921.471bbed · audit A · 3 stars
computer-use skill
badmuriss/my-llm-kit · skills/computer-use/SKILL.md · Inspect and operate local browser or desktop interfaces. Prefer Jev Ultrafast for supported browser-only goals when its…
git:20260921.471bbed · audit A · 3 stars
frontend-visual-validation skill
badmuriss/my-llm-kit · skills/frontend-visual-validation/SKILL.md · Verify rendered UI changes with reproducible screenshots and vision review on their supported platforms.
git:20260906.3d137c0 · audit A · 3 stars
grill-me skill
badmuriss/my-llm-kit · skills/grill-me/SKILL.md · Adversarial interview about a plan until you reach shared understanding. use_when: "grill me", stress-test a plan or…
git:20260808.343cbe3 · audit A · 3 stars
grill-with-docs skill
badmuriss/my-llm-kit · skills/grill-with-docs/SKILL.md · Grill a plan against the documented domain model, updating CONTEXT.md and ADRs inline. use_when: stress-test a plan…
git:20260808.343cbe3 · audit A · 3 stars
impl skill
badmuriss/my-llm-kit · skills/impl/SKILL.md · Implement a requested change or approved plan, verify its outcomes, and report concrete blockers. Use graph execution…
git:20260921.471bbed · audit A · 3 stars
ingest skill
badmuriss/my-llm-kit · skills/ingest/SKILL.md · Extract content from documents when their format or layout prevents reliable direct reading. Verify reading order and…
git:20260906.3d137c0 · audit A · 3 stars
readme-pass skill
badmuriss/my-llm-kit · skills/readme-pass/SKILL.md · Make a public repository README easier to understand and use. Apply when README structure or presentation is requested.
git:20260906.3d137c0 · audit A · 3 stars
remove-ai-marks skill
badmuriss/my-llm-kit · skills/remove-ai-marks/SKILL.md · Inspect and remove requested metadata or invisible marks from user-owned files. Use when provenance cleanup is…
git:20260906.3d137c0 · audit B · 3 stars
research skill
badmuriss/my-llm-kit · skills/research/SKILL.md · Research external questions and compare evidence with source attribution. Use for research or fact-checking, not facts…
git:20260923.97e81e6 · audit A · 3 stars

Every file in badmuriss/my-llm-kit

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