Agent skill

Hunt Comments

by dealfluence in dealfluence/adeu

A skill your agent uses when hunting down verbose, narrative, or dead comments in the codebase to reduce comment noise and character counts.

MITAuto-check passedDocuments & Office

Install Hunt Comments

skills CLI
$ npx skills add dealfluence/adeu --skill hunt-comments -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dealfluence/adeu hunt-comments --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/dealfluence/adeu.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/hunt-comments .claude/skills/hunt-comments && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hunt-comments
GitHub stars
165
Token cost
~355 tokens
SKILL.md length
153 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when hunting down verbose, narrative, or dead comments in the codebase to reduce comment noise and character counts.

  • Works in 4 steps: Run the Comment Density Spotter → Target High-Density Files → Identify & Remove Non-Essential Commentary → …
  • Hunting down verbose
  • Calls uv, npm and python
  • Dead comments in the codebase to reduce comment noise and character counts

What it does

Hunt Comments is an agent skill from dealfluence/adeu. Use when hunting down verbose, narrative, or dead comments in the codebase to reduce comment noise and character counts.

Its SKILL.md is about 360 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office. It works with Python. The repository describes itself as: docx ↔ LLM translator. Projects .docx office files to Markdown for editing. Projects edits back to OOXML as tracked changes (redlines). Python and Node.js implementations. The licence is MIT.

When your agent uses it

  • Hunting down verbose
  • Dead comments in the codebase to reduce comment noise and character counts

Example prompts

  • “/hunt-comments”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Run the Comment Density Spotter
  2. Target High-Density Files
  3. Identify & Remove Non-Essential Commentary
  4. Verify Behavior

What it can do on your machine

Read from SKILL.md and the folder at commit 096baa8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • npm
    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv and npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hunt Comments loads about 355 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 153 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~355

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from dealfluence/adeu at commit 096baa8, republished under its MIT licence (© dealfluence). 153 words, ~355 tokens.

Download SKILL.mdSave it as .claude/skills/hunt-comments/SKILL.md (or your agent's skills folder).
name
hunt-comments
description
Use when hunting down verbose, narrative, or dead comments in the codebase to reduce comment noise and character counts.

Hunt Comments Skill

This skill provides a systematic approach to finding and reducing comment density and character bloat across source code files.

Workflow

  1. Run the Comment Density Spotter: Execute python scripts/count_comment_chars.py to rank files by comment character count:

    bash
    uv run python scripts/count_comment_chars.py -n 25
  2. Target High-Density Files: Focus on top-ranked files with high comment ratios (>20% comment characters).

  3. Identify & Remove Non-Essential Commentary:

    • Delete narrative historical explanations ("Why we added this in 2024...", "Fix for issue #123 where...").
    • Strip redundant docstrings that simply restate function signatures, types, or obvious operations.
    • Collapse multi-paragraph block comments into brief 1-line "why" notes or remove them entirely if code is self-explanatory.
    • Retain only essential architectural invariants (e.g., OPC part boundaries, Word signed int32 overflow rules, security guards).
  4. Verify Behavior: Always run test suites to verify zero functional or formatting regressions:

    • Python: uv run pytest & uv run mypy src
    • Node: npm run build && npm test
    • LangChain: uv run pytest in langchain

© dealfluence, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .opencode/skills/hunt-comments of dealfluence/adeu.

Open the folder on GitHubat commit 096baa8

Compare with similar skills

Hunt Comments next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hunt Comments compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hunt Comments this skilldealfluence/adeu165—~355Automated safety check: PassMIT
Word Document Reader and WriterHKUDS/DeepTutor41k—~2.5kAutomated safety check: PassApache-2.0
Instrument Data To Allotropeaws-samples/amazon-bedrock-agents-healthcare-lifesciences2742 repos~2.7kAutomated safety check: PassApache-2.0
Word DOCX ToolkitTokenRhythm/opensquilla7.1k—~1.7kAutomated safety check: PassApache-2.0
Markdown to HTML ReportMegaSuperKitty/WeClaw370—~456Automated safety check: PassMIT
Mathmodel SkillhandsomeZR-netizen/mathmodel-skill292—~2.5kAutomated safety check: PassMIT

Similar skills

  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Instrument Data To Allotrope

    aws-samples/amazon-bedrock-agents-healthcare-lifesciences

    Official

    Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV.

    274 GitHub starsUsed in 2 repos~2.7k tokens
    Documents & OfficeAuto-check passed
  • Word DOCX Toolkit

    TokenRhythm/opensquilla

    Inspects, edits in place or creates Word .docx files with bundled Python scripts, keeping existing styles intact when content changes.

    7.1k GitHub stars~1.7k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Markdown to HTML Report

    MegaSuperKitty/WeClaw

    Drafts a report in Markdown with numbered inline citations and a references section, then renders it to a styled HTML file through a Jinja2 template on Windows.

    370 GitHub stars~456 tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Mathmodel Skill

    handsomeZR-netizen/mathmodel-skill

    CUMCM 国赛、MCM/ICM 美赛与电工杯数学建模竞赛的端到端协作工作流。Use when a user explicitly works on one of these modeling contests or asks to run/review a modeling-competition paper from problem selection through modeling…

    292 GitHub stars~2.5k tokensUpdated 12 days ago
    Documents & OfficeAuto-check passed
  • Literature Survey

    ai4s-research/ai4s-skills

    A skill your agent uses when the user wants a comprehensive literature survey on a specific research topic.

    237 GitHub starsUsed in 2 repos~2k tokens
    Documents & OfficeAuto-check passed

More from dealfluence/adeu

  • Adeu Redlining

    dealfluence/adeu

    A skill your agent uses when reviewing, editing, redlining, or negotiating an existing Microsoft Word document (.docx) — including proposing edits as tracked changes, accepting or rejecting existing…

    165 GitHub stars~2.4k tokensUpdated 2 days ago
    Auto-check passed
  • Analyze Branching

    dealfluence/adeu

    Formally analyzes control-flow branchings, cyclomatic complexity, nesting depths, and branch redundancies across Python and TypeScript engine files.

    165 GitHub stars~290 tokensUpdated 2 days ago
    Auto-check passed
  • Check Duplication

    dealfluence/adeu

    A skill your agent uses when checking for or pruning duplicate code blocks across source files.

    165 GitHub stars~291 tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Hunt Comments

What does Hunt Comments do?

A skill your agent uses when hunting down verbose, narrative, or dead comments in the codebase to reduce comment noise and character counts. Hunt Comments is an agent skill from dealfluence/adeu. Use when hunting down verbose, narrative, or dead comments in the codebase to reduce comment noise and character counts.

When should I use Hunt Comments?

Hunt Comments fits situations like: hunting down verbose; dead comments in the codebase to reduce comment noise and character counts.

How do I install Hunt Comments in Claude Code?

Run `npx skills add dealfluence/adeu --skill hunt-comments -a claude-code`. Or copy the skill folder (.opencode/skills/hunt-comments in dealfluence/adeu) into .claude/skills/hunt-comments in your project. Claude Code loads it when a task matches its description.

How do I install Hunt Comments in Codex?

Run `npx skills add dealfluence/adeu --skill hunt-comments -a codex`. Or copy the skill folder (.opencode/skills/hunt-comments in dealfluence/adeu) into .agents/skills/hunt-comments in your project. Codex loads it when a task matches its description.

Can I use Hunt Comments in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dealfluence/adeu --skill hunt-comments -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hunt-comments, .gemini/skills/hunt-comments, .github/skills/hunt-comments and .opencode/skills/hunt-comments in your project.

What does Hunt Comments need to run?

Going by SKILL.md and its folder, Hunt Comments needs the command-line tools its instructions call (uv, npm and python). Our summary lists: Python 3.

Does Hunt Comments access the network?

SKILL.md contains no URLs. Its commands use uv and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Hunt Comments safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hunt Comments use?

Hunt Comments is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hunt Comments use?

About 355 tokens (SKILL.md is roughly 1.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Hunt Comments?

Skills that share tags, products or a category with Hunt Comments: Word Document Reader and Writer (HKUDS/DeepTutor, 41k stars), Instrument Data To Allotrope (aws-samples/amazon-bedrock-agents-healthcare-lifesciences, 274 stars), Word DOCX Toolkit (TokenRhythm/opensquilla, 7.1k stars) and Markdown to HTML Report (MegaSuperKitty/WeClaw, 370 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hunt Comments?

dealfluence (a GitHub organization) maintains it in dealfluence/adeu, which has 165 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 5, 2026.

Source: dealfluence/adeu on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.