comments SKILL.md skillA

This file is byte-identical to the first copy the registry indexed, one of 4 indexed copies. Same content hash, so the same checks give both the same grade.

comments from yelmuratoff/exuno is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add yelmuratoff/exuno/comments@git:20260512.5fd702f

Pins git:20260512.5fd702f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
yelmuratoff/exuno
Path
lib/templates/skills/comments/SKILL.md
Versions recorded
2
Latest version
git:20260512.5fd702f, committed May 12, 2026
First version recorded
May 7, 2026
Size
2,771 bytes
Repository stars
17
License
GPL-3.0

Scan recently written or edited code and remove comments that do not earn their place — narration, step markers, task/PR references, commented-out blocks, decorative banners. Use this skill after finishing a non-trivial code change, when reviewing a diff for comment hygiene, when the user mentions noisy or redundant comments, or proactively before declaring a coding task complete. Defer to the `comments` rule for what makes a comment worth keeping.

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

# Comments Cleanup

Scan the diff you just produced and strip comments that the code already carries. The `comments` rule has the long-form criteria and examples; this skill is the cleanup procedure.

## Procedure

1. **Pull the diff.** `git diff` for unstaged work, `git diff --staged` for staged. Focus on `+`-lines that introduced comments.
2. **For each new comment, ask one question** — *would a competent reader miss anything if this comment were removed?* If the answer is no, delete the comment.
3. **Tighten what remains.** A comment that stays should describe *why*, fit on one line where possible, and use the language's doc-comment syntax for public APIs only.

## Categories to delete on sight

- **Narration** — restates what the code does (`// increment counter`, `// loop through users`, `// validate user`).
- **Step markers** — planning artefacts (`// Step 1: fetch users`, `// now we will…`, `// AI thought: …`).
- **Task / PR / caller references** (`// added for ticket X`, `// used by Y`) — that context belongs in the commit message.
- **Commented-out code** — git keeps the history.
- **Decorative banners** (`// ===== HELPERS =====`) when nothing else in the file uses them.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add yelmuratoff/exuno/comments@sha256:abde92d978575e14

The line at the top of this page pins the label git:20260512.5fd702f, 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_id2xwszci4pnlqxu.svg)](https://markdownregistry.com/a/art_id2xwszci4pnlqxu)

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

Versions

The registry has recorded 2 versions of this file, between May 7, 2026 and May 12, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20260512.5fd702f latest2026-05-12 5fd702f 2,771 BA view · diff
git:20260507.46611a12026-05-07 46611a1 3,678 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 (2771 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

yelmuratoff/exuno · 17 stars · license GPL-3.0 · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_id2xwszci4pnlqxu
GET https://markdownregistry.com/api/v1/resolve?ref=yelmuratoff/exuno/comments
GET https://markdownregistry.com/api/v1/blob/abde92d978575e14cb9f29931750e0bd94314a3783af3116c927c667421fdef8

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 yelmuratoff/exuno

AGENTS.md@.ai/src AGENTS.md file
yelmuratoff/exuno · .ai/src/AGENTS.md
git:20261007.95b1395 · audit B · 17 stars
add-tool SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/add-tool/SKILL.md · Add support for a new AI coding tool to Exuno's sync engine — create the tool YAML, configure targets and converters…
git:20261007.95b1395 · audit A · 17 stars
comments SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/comments/SKILL.md · Scan recently written or edited code and remove comments that do not earn their place — narration, step markers…
git:20260512.5fd702f · audit A · 17 stars
commit SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/commit/SKILL.md · Create a well-structured git commit for staged or unstaged changes — analyze the diff, match the project's existing…
git:20260728.7c60c81 · audit A · 17 stars
debug SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/debug/SKILL.md · Investigate and fix bugs, errors, or unexpected behavior systematically — reproduce, locate, understand the root cause…
git:20260728.7c60c81 · audit A · 17 stars
fix-issue SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/fix-issue/SKILL.md · Investigate and fix a GitHub issue in this repo — pull the issue with `gh`, trace it to the root cause across `src/`…
git:20260919.72b55dc · audit A · 17 stars
prompt-engineering SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/prompt-engineering/SKILL.md · Design, debug, and refine prompts for LLM-based coding tools, agents, and pipelines. Use this skill when writing or…
git:20261007.95b1395 · audit A · 17 stars
refactor SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/refactor/SKILL.md · Restructure existing code without changing its behavior — reduce duplication, improve naming, simplify complex logic…
git:20260728.7c60c81 · audit A · 17 stars
release SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/release/SKILL.md · Bump the Exuno version, write a CHANGELOG entry summarising changes since the last tag, and prepare a clean release…
git:20261012.dc99d8c · audit A · 17 stars
review SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/review/SKILL.md · Perform a structured code review on a diff, PR, or staged changes — surface correctness, security, error-handling…
git:20261007.95b1395 · audit A · 17 stars
AGENTS.md@example/.ai/src AGENTS.md file
yelmuratoff/exuno · example/.ai/src/AGENTS.md
git:20260331.a1a2b85 · audit A · 17 stars
commit SKILL.md skill
yelmuratoff/exuno · example/.ai/src/skills/commit/SKILL.md · Create a well-structured git commit for staged or unstaged changes — analyze the diff, match the project's existing…
git:20260728.7c60c81 · audit A · 17 stars

Every file in yelmuratoff/exuno

Other files named comments

comments SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/comments/SKILL.md · Scan recently written or edited code and remove comments that do not earn their place — narration, step markers…
git:20260512.5fd702f · audit A · 17 stars
comments SKILL.md skill
yelmuratoff/agent_sync · .ai/src/skills/comments/SKILL.md · Scan recently written or edited code and remove comments that do not earn their place — narration, step markers…
git:20260512.5fd702f · audit A · 17 stars
comments SKILL.md skill
yelmuratoff/agent_sync · lib/templates/skills/comments/SKILL.md · Scan recently written or edited code and remove comments that do not earn their place — narration, step markers…
git:20260512.5fd702f · audit A · 17 stars
comments SKILL.md skill
tonydzi/second-brain-starter-kit · skills/comments/SKILL.md · Work the comments under published posts in one pass: list unanswered ones, reply only where a reply is genuinely…
git:20261007.cd6c208 · audit A · 12 stars

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