code-header-generator

code-header-generator is an agent for Claude Code from BlueEventHorizon/Swift-Selena. It costs 20 tokens per session (693 once invoked), scanned A, original, MIT.

An agent that reads Swift files and adds structured, searchable header comments while preserving the code and existing comments.

In plain words
What is it for?
Use it to create or update headers for individual Swift files while keeping DocC comments, implementation comments, and copyright headers intact.
Why use it?
It documents what a file contains without changing its implementation, and skips files that are excluded or already marked as formatted.

Agent for Claude Code

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 agents/blueeventhorizon/swift-selena/code-header-generator
Clone the repo
git clone --depth 1 https://github.com/BlueEventHorizon/Swift-Selena

Made for: Claude Code.

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 code-header-generator

README.md
[![agentmods](https://agentmods.dev/badge/agents/blueeventhorizon/swift-selena/code-header-generator.svg)](https://agentmods.dev/agents/blueeventhorizon/swift-selena/code-header-generator)
Your own site
<a href="https://agentmods.dev/agents/blueeventhorizon/swift-selena/code-header-generator"><img src="https://agentmods.dev/badge/agents/blueeventhorizon/swift-selena/code-header-generator.svg" alt="Measured on agentmods" height="20"></a>
Per session 20 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 693 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.00020 $0.00693
Opus 5 $0.00010 $0.00347
Sonnet 5 $0.00004 $0.00139
Haiku 4.5 $0.00002 $0.00069

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

Security

Grade A, and why

code-header-generator 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 3d 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.

.claude/agents/code-header-generator.md · 62 lines

What it actually says

概要

Swiftファイルのコード内容を理解し、AI検索可能なコードヘッダーコメントを生成します。

必須参照文書 [MANDATORY]

NEVER skip. 下記を全て読み込み、深く理解すること

  • docs/format/code_header_format.md - フォーマット仕様

実行フロー

Step 1: 準備

  1. promptからファイルパスとモード(skip/update)を取得

    • モード は指定がない場合は skipモードとする
    • skipモードでは、[Code Header Format] マーカーの有無を判定して動作する
      • [Code Header Format] マーカーがある → 「既にフォーマット済みのためスキップしました」と報告して終了
      • [Code Header Format] マーカーがないStep 4以降の生成処理を実行(マーカーがなければ必ず生成する)
    • updateモード
      • マーカーの有無に関わらず → Step 4以降の生成処理を実行(既存を上書き)
  2. Read()で対象ファイル全体を読み込む

Step 2: コード理解

  1. コードを理解する(実装内容、ロジック、構造)
  2. Testファイルがあれば読んで使用例・意図を理解
  3. 既存コメントがあれば参考にする(鵜呑みにしない)

Step 3: ヘッダー生成

  1. code_header_format.mdに従ってヘッダー生成
    • 必ず [Code Header Format] マーカーを含める
    • 既存の関数・型のDocCコメント(///)は保持
    • 既存の実装コメント(//)も保持

Step 4: ファイル更新

  1. Edit()でファイル更新(Copyrightヘッダーは変更しない)
  2. 結果を報告:
    • 「新規生成しました」(マーカーがなかった場合)
    • 「更新しました」(マーカーがあった場合)

除外対象

  • ファイル名に Test, Tests を含む
  • ファイル名が Mock で始まる
  • Preview Content/ ディレクトリ配下

注意事項

  • 1ファイルずつ処理(並列処理しない)
  • 追加するのはファイルヘッダーのみ
  • 既存の関数・型のDocCコメント(///)は絶対に消さない
  • 既存の実装コメント(//)も保持する
  • コード本体は変更しない
  • 理解できない場合は推測せず、コードを再読
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. 3d ago First seen · 62 lines · 20 tokens per session scan A e36467f90549

Subscribe to this mod's changes

code-header-generator is an agent published in the GitHub repository BlueEventHorizon/Swift-Selena (5 stars, last pushed 1mo ago), licensed MIT. It adds 20 tokens to every session and 693 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 agents, from other repositories

android-dev

Android/Kotlin development expert. Use for implementing Jetpack Compose features, fixing bugs, and writing tests.

hanamizuki/solopreneur · 24 tokens

spm-conflict-resolver

Use this agent when the user mentions SPM resolution failures, "no such module" errors, duplicate symbol linker errors, version conflicts between packages, or Swift 6 package compatibility issues. Analyzes Package.swift and Package.resolved to diagnose and resolve Swift Package Manager dependency conflicts. user: "SPM…

CharlesWiltgen/Axiom · 234 tokens

swiftui-modernization

Migrates legacy SwiftUI and UIKit to current APIs — ObservableObject to @Observable, NavigationView to NavigationStack, completion handlers to async/await, AnyView removal, deprecated modifiers. Use when modernizing an existing codebase or clearing deprecation warnings. Behavior-preserving; requires a green test…

Nagarjuna2997/ios-agent-skill · 71 tokens

ios-explore

Read-only codebase search for Swift/iOS projects. Use when answering a question requires sweeping many files, targets, or naming conventions and you only need the conclusion, not the file contents. Returns file:line citations. Safe to run several of these in parallel.

Nagarjuna2997/ios-agent-skill · 57 tokens

ios-engineer

实现和审查单平台 iOS Native Module、Bridge Adapter、Native UI、Xcode/SwiftPM 接线、平台测试与构建;不负责 Android、Dart Client 或跨端 Wire Contract。.

bladeofgod/flutter-ai-harness · 48 tokens

copilot

cd your-android-project git clone https://github.com/haidrrrry/compose-kotlin-agent-skills.git .github/skills/compose-kotlin-agent-skills.

haidrrrry/compose-kotlin-agent-skills · 0 tokens