inline-comments

inline-comments is a skill for Claude Code, Codex from berkcangumusisik/claude-code-practices. It costs 14 tokens per session (258 once invoked), scanned A, original, MIT.

A code-editing helper that adds explanations beside complex or non-obvious sections, such as algorithms, regular expressions, workarounds, and business rules.

In plain words
What is it for?
Use it on a source file to add useful why-focused comments and review the changes as a before-and-after diff.
Why use it?
It makes unusual code easier to understand and records why a workaround or special decision exists.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/berkcangumusisik/claude-code-practices/inline-comments
Any agent
npx skills add berkcangumusisik/claude-code-practices --skill inline-comments
Clone the repo
git clone --depth 1 https://github.com/berkcangumusisik/claude-code-practices

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for inline-comments

README.md
[![agentmods](https://agentmods.dev/badge/skills/berkcangumusisik/claude-code-practices/inline-comments.svg)](https://agentmods.dev/skills/berkcangumusisik/claude-code-practices/inline-comments)
Your own site
<a href="https://agentmods.dev/skills/berkcangumusisik/claude-code-practices/inline-comments"><img src="https://agentmods.dev/badge/skills/berkcangumusisik/claude-code-practices/inline-comments.svg" alt="Measured on agentmods" height="20"></a>
Per session 14 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 258 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00014 $0.00258
Opus 5 $0.00007 $0.00129
Sonnet 5 $0.00003 $0.00052
Haiku 4.5 $0.00001 $0.00026

Measured 4d ago against content hash e910444689e3, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

inline-comments scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/inline-comments/SKILL.md · 40 lines

What it actually says

Add Inline Comments

File: $1

  1. Read the file. Identify sections that are non-obvious:

    • Complex algorithms or math
    • Regex patterns
    • Bitwise operations
    • Non-intuitive business logic
    • Workarounds or known limitations
    • Performance-sensitive sections
  2. Write comments that explain the why, not the what:

    // ❌ Bad: increment counter
    count++
    
    // ✅ Good: offset by 1 because API uses 1-based page numbering
    page = requestedPage + 1
    
  3. For workarounds, use this format:

    // HACK: Safari doesn't support X, so we Y instead
    // TODO: remove when Safari 18 becomes baseline
    
  4. Don't comment obvious code. If code needs a comment to be understood, also consider if it should be refactored instead.

  5. Apply comments. Show before/after diff.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 40 lines · 14 tokens per session scan A e910444689e3

Subscribe to this mod's changes

inline-comments is a skill published in the GitHub repository berkcangumusisik/claude-code-practices (10 stars, last pushed 4mo ago), licensed MIT. It adds 14 tokens to every session and 258 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

open-source

Documentation reference for writing Python code using the browser-use open-source library. Use this skill whenever the user needs help with Agent, Browser, or Tools configuration, is writing code that imports from browseruse, asks about @sandbox deployment, supported LLM models, Actor API, custom tools, lifecycle…

browser-use/browser-use · 137 tokens

skill-builder

Automatically detect source types and build AI skills using Skill Seekers. Use when the user wants to create skills from documentation, repos, PDFs, videos, or other knowledge sources.

yusufkaraaslan/Skill_Seekers · 38 tokens

golden-rss-empty

Use when testing the empty rss golden build.

yusufkaraaslan/Skill_Seekers · 14 tokens

prompt-master

Generates optimized prompts for AI tools. Activates only when the user explicitly asks to write, fix, improve, or adapt a prompt for a specific AI tool (LLM, Cursor, Midjourney, image AI, video AI, coding agents, etc.). Does not activate for general conversation, coding tasks, document writing, or other…

nidhinjs/prompt-master · 78 tokens

kayba-stage-5-action-plan

Triage each insight into discard/code-fix/prompt-fix and produce a prioritized action plan with specific recommendations. Trigger when the user says "run stage 5", "make action plan", "triage skills", or when invoked by the kayba-pipeline orchestrator. Requires eval outputs from stages 1-4.

kayba-ai/agentic-context-engine · 74 tokens

kayba-stage-2-domain-context

Gather domain context about the repository and agent — system prompt, tool definitions, domain docs, and behavior patterns from traces. Trigger when the user says "run stage 2", "gather context", "domain context", or when invoked by the kayba-pipeline orchestrator.

kayba-ai/agentic-context-engine · 64 tokens