Agent skill

Audit Comments

by mycelium-io in mycelium-io/mycelium

Cheap-model audit of comments and inline docs for temporal/historical narration, overly long prose, over-referencing of GitHub issues / PR numbers / plan-step IDs, and design-justification /…

Custom licenceAuto-check passedMedia & Creative

Install Audit Comments

skills CLI
$ npx skills add mycelium-io/mycelium --skill audit-comments -a claude-code

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

GitHub CLI
$ gh skill install mycelium-io/mycelium audit-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/mycelium-io/mycelium.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/audit-comments .claude/skills/audit-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
audit-comments
GitHub stars
119
Token cost
~3.1k tokens
SKILL.md length
1,488 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Custom licence

At a glance

Cheap-model audit of comments and inline docs for temporal/historical narration, overly long prose, over-referencing of GitHub issues / PR numbers / plan-step IDs, and design-justification /…

  • Works in 5 steps: Parse flags → Gather the scope → Dispatch to Haiku → …
  • The user says audit comments
  • SKILL.md covers The four smells, Steps and Hard rules
  • Calls git, uv and npm

What it does

Audit Comments is an agent skill from mycelium-io/mycelium. Cheap-model audit of comments and inline docs for temporal/historical narration, overly long prose, over-referencing of GitHub issues / PR numbers / plan-step IDs, and design-justification / conversational residue (comments that defend the approach or echo how the code was steered instead of plainly describing it). Defaults to the current PR diff; pass --all to sweep the whole codebase, --fix to apply the rewrites. Use when the user says "audit comments", "comment cleanup", "tidy comments", "check the comments"…

Its SKILL.md is about 3.1k 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 Media & Creative, covering Text to speech and voice. It works with GitHub. The repository describes itself as: Multi-agent coordination + persistent memory, semantic negotiation, async rooms, and a shared knowledge graph.

When your agent uses it

  • The user says audit comments
  • Comment cleanup
  • Check the comments

Example prompts

  • “audit comments”
  • “comment cleanup”
  • “tidy comments”
  • “/audit-comments”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Parse flags
  2. Gather the scope
  3. Dispatch to Haiku
  4. Collate & report
  5. Apply fixes (only if --fix)

What it can do on your machine

Read from SKILL.md and the folder at commit a08971b. 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:

    • git
    • uv
    • npm
    • tsc

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

  • Network

    No URLs in SKILL.md. Its commands use git, 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

Audit Comments loads about 3.1k tokens when it runs. Until then it costs about 138 tokens; SKILL.md has 1,488 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,488 words (~3,131 tokens).

“A focused pass over comments only — not logic, not architecture. It hunts the four comment smells that creep back in over time and tightens them toward the doctrine: load-bearing "why" only, matching the surrounding density, no historical narration, no…”

— opening of SKILL.md by mycelium-io, Custom licence
name
audit-comments
user_invocable
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/audit-comments of mycelium-io/mycelium.

Open the folder on GitHubat commit a08971b

Compare with similar skills

Audit 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.

Audit Comments compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Audit Comments this skillmycelium-io/mycelium119—~3.1kAutomated safety check: PassCustom licence
Video Translatorshang-zhu/violin1.1k—~1kAutomated safety check: NotesMIT
Megaphone ReleaseKuberwastaken/megaphone169—~1.3kAutomated safety check: PassMIT
Webcode Local Windows Tts Installershuyu-labs/WebCode278—~787Automated safety check: PassCustom licence
Connector Setupkatipally/openlive336—~860Automated safety check: PassApache-2.0
Bmad Install Agentvibespaulpreibisch/AgentVibes155—~557Automated safety check: PassApache-2.0

Similar skills

  • Video Translator

    shang-zhu/violin

    Dub a video into another language and generate subtitles using the default Together + Cartesia stack.

    1.1k GitHub stars~1k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: notes
  • Megaphone Release

    Kuberwastaken/megaphone

    Prepare, validate, publish, and verify Megaphone releases. An agent skill from Kuberwastaken/megaphone.

    169 GitHub stars~1.3k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • A skill your agent uses when building a local Windows WebCode installer from this repo for machine testing, especially when the package must bundle the Kokoro or sherpa-onnx Reply TTS service, model…

    278 GitHub stars~787 tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed
  • Connector Setup

    katipally/openlive

    A skill your agent uses when the user wants to add, connect, sign in to or fix an MCP connector (a server that gives you tools for an app such as GitHub, Linear or Notion).

    336 GitHub stars~860 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Bmad Install Agentvibes

    paulpreibisch/AgentVibes

    Install AgentVibes TTS voice system for BMAD agents. An agent skill from paulpreibisch/AgentVibes.

    155 GitHub stars~557 tokensUpdated 22 days ago
    Media & CreativeAuto-check passed
  • Sayit Release

    callebtc/sayit

    Build, sign, validate, notarize, and publish Say It macOS DMG releases using the repository release script.

    159 GitHub stars~1.1k tokensUpdated 16 days ago
    Media & CreativeAuto-check: warnings

More from mycelium-io/mycelium

  • Modern Python

    mycelium-io/mycelium

    Modern Python tooling practices for the mycelium project. An agent skill from mycelium-io/mycelium.

    119 GitHub stars~752 tokensUpdated today
    Auto-check passed
  • Screenshot

    mycelium-io/mycelium

    Take a screenshot of the running Mycelium app, or of CLI output rendered as a terminal card, or record a short video of a flow with a visible cursor and click/zoom animations.

    119 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Mycelium

    mycelium-io/mycelium

    Multi-agent coordination layer with persistent memory. An agent skill from mycelium-io/mycelium.

    119 GitHub stars~6.4k tokensUpdated today
    Auto-check passed
  • Precommit

    mycelium-io/mycelium

    Run precommit checks (lint, format, tests) on the mycelium codebase.

    119 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Generate CLI Docs

    mycelium-io/mycelium

    Regenerate the HTML docs site (CLI Reference, Configuration, content sections) from decorators, the pydantic config schema, and markdown source files

    119 GitHub stars~641 tokensUpdated today
    Auto-check passed
  • Mycelium Remote Agent

    mycelium-io/mycelium

    Bootstrap yourself as an ephemeral Mycelium agent when your environment is wired to a hub.

    119 GitHub stars~3k tokensUpdated today
    Auto-check: notes

Works with

Questions about Audit Comments

What does Audit Comments do?

Cheap-model audit of comments and inline docs for temporal/historical narration, overly long prose, over-referencing of GitHub issues / PR numbers / plan-step IDs, and design-justification /…. Audit Comments is an agent skill from mycelium-io/mycelium. Cheap-model audit of comments and inline docs for temporal/historical narration, overly long prose, over-referencing of GitHub issues / PR numbers / plan-step IDs, and design-justification / conversational residue (comments that defend the approach or echo how the code was steered instead of plainly describing it).

When should I use Audit Comments?

Audit Comments fits situations like: the user says audit comments; comment cleanup; check the comments.

How do I install Audit Comments in Claude Code?

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

How do I install Audit Comments in Codex?

Run `npx skills add mycelium-io/mycelium --skill audit-comments -a codex`. Or copy the skill folder (.claude/skills/audit-comments in mycelium-io/mycelium) into .agents/skills/audit-comments in your project. Codex loads it when a task matches its description.

Can I use Audit 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 mycelium-io/mycelium --skill audit-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/audit-comments, .gemini/skills/audit-comments, .github/skills/audit-comments and .opencode/skills/audit-comments in your project.

What does Audit Comments need to run?

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

Does Audit Comments access the network?

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

Is Audit 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 Audit Comments use?

Audit Comments has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Audit Comments use?

About 3.1k tokens (SKILL.md is roughly 13k 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 Audit Comments?

Skills that share tags, products or a category with Audit Comments: Video Translator (shang-zhu/violin, 1.1k stars), Megaphone Release (Kuberwastaken/megaphone, 169 stars), Webcode Local Windows Tts Installer (shuyu-labs/WebCode, 278 stars) and Connector Setup (katipally/openlive, 336 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Audit Comments?

mycelium-io (a GitHub organization) maintains it in mycelium-io/mycelium, which has 119 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 8, 2026.

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