progress-channel

progress-channel is a skill for Claude Code from alexmond/alexmskills. It costs 149 tokens per session (3,926 once invoked), scanned B, original, MIT.

A shared local progress page for tracking work that takes more than a few seconds, including background commands and work handled by other systems.

In plain words
What is it for?
Use it to register jobs, show their current state, estimate completion time, and mirror progress from external systems.
Why use it?
It gives long-running jobs one visible status location instead of requiring repeated checks or relying on incomplete terminal output.

Skill for Claude Code

Written for Claude Code: PreToolUse hook event. Also seen: reads .claude/ paths; mentions subagents; mentions Claude Code.

Part of the progress-channel plugin — 1 skill shipped together

Good fit Use it to register jobs, show their current state, estimate completion time, and mirror progress from external systems.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/alexmond/alexmskills/progress-channel
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.

Any agent
npx skills add alexmond/alexmskills --skill progress-channel
Clone the repo
git clone --depth 1 https://github.com/alexmond/alexmskills

Made for: Claude Code.

Or install progress-channel, the plugin that ships this one along with the rest of its 1 skill.

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 progress-channel

README.md
[![agentmods](https://agentmods.dev/badge/skills/alexmond/alexmskills/progress-channel.svg)](https://agentmods.dev/skills/alexmond/alexmskills/progress-channel)
Your own site
<a href="https://agentmods.dev/skills/alexmond/alexmskills/progress-channel"><img src="https://agentmods.dev/badge/skills/alexmond/alexmskills/progress-channel.svg" alt="Measured on agentmods" height="20"></a>
Per session 149 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,926 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 2 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00149 $0.03926
Opus 5 $0.00075 $0.01963
Sonnet 5 $0.00030 $0.00785
Haiku 4.5 $0.00015 $0.00393

Measured yesterday against content hash eb821ad718cd, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade B, and why

progress-channel scanned grade B with 2 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 yesterday.

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.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

Use it as the whole status line, in `~/.claude/settings.json`:

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s 'localhost:7717/jobs?session=<id>' # one session's work
plugins/progress-channel/skills/progress-channel/SKILL.md · 317 lines

How it starts

The opening of the file, as written. The whole thing — 317 lines — stays where its author put it; the contents beside it link to each section on GitHub.

progress-channel

Work that takes minutes is usually reported by whatever the agent happens to print — a carriage-returned counter in one terminal. That fails three ways: the only way to learn the state is to re-ask (pure overhead), the counter can lie (a stale fragment reads as a stall; submission-order iteration pins it at 0), and work handed to another system has no representation at all. This skill makes a shared progress channel the default for all three.

The discipline

  • Register anything expected to exceed ~10s — a sweep, a backgrounded command, a call that hands work to another system and returns early. progress forecast <name> answers "how long has this taken before" prior to starting; if history says minutes, register.
  • Never answer a progress question by re-polling and narrating. The answer is the channel: the live page at http://127.0.0.1:7717/, watch in a terminal, or list once. Register, then get on with something else.
  • External work gets a mirror watcher — one small process polling the foreign system into the same channel, exiting when the work is idle. One list, whatever the source.

Architecture

The thing that serves the progress page is the tracker. A stdlib-only Python daemon (http.server, no dependencies) binds 127.0.0.1:7717 ($PROGRESS_PORT overrides), holds live jobs in memory — single writer, so there is no store or locking at all — and serves the HTML view at /, JSON at /jobs, and forecasts at /forecast?name=.

  • Producers auto-spawn it: the first Job brings the daemon up if it isn't running; binding the port is the single-instance lease. Nothing to install or supervise.
  • Only the learning data is persisted: finished runs append to ~/.claude/progress/history.jsonl (cat/jq-able; $PROGRESS_HOME overrides the directory). Live state is memory-only on purpose — if the daemon restarts, producers re-register on their next flush; a reboot kills the jobs anyway.
  • A job never fails because the tracker is sick: if the daemon can't be reached or spawned, the job degrades to a warn-once untracked no-op.

Read the full file on GitHub · 317 lines

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. yesterday Changed · +21 lines eb821ad718cd
  2. 2d ago Changed · +126 lines scan A → B a89b24a3fdcc
  3. 8d ago First seen · 170 lines · 149 tokens per session scan A b29b3ef9138d

Subscribe to this mod's changes

progress-channel is a skill published in the GitHub repository alexmond/alexmskills (6 stars, last pushed today), licensed MIT. It adds 149 tokens to every session and 3,926 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it B with 2 findings (reads agent configuration directories, makes network calls). 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

skill-factory

A workflow that examines completed session work and turns reusable patterns into Claude Code skills.

sangrokjung/claude-forge · 122 tokens

session-wrap

Use when wrapping up a session before ending. 4 parallel subagents detect doc updates, repeated patterns, learning points, and follow-ups, then a verifier deduplicates and presents choices. Triggers on /session-wrap, session wrap, session cleanup, end of session.

sangrokjung/claude-forge · 58 tokens

relay

Session relay — compresses what's been done so far (writes a one-liner for /compact) and generates a "next task" prompt (a baton) for the user to hand off. Use on requests like "relay / hand off / next session / continue after compact / baton / handoff / clean up context and continue next task." Does not run /compact…

sangrokjung/claude-forge · 97 tokens

strategic-compact

Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.

sangrokjung/claude-forge · 27 tokens

token-optimizer

Reduce Claude Code token consumption and API costs without sacrificing output quality. Use this skill whenever the user mentions high costs, expensive sessions, token waste, burning through credits, wanting to use Haiku instead of Opus, model routing, MAXTHINKINGTOKENS, extended thinking cost, CLAUDECODESUBAGENTMODEL…

arturseo-geo/claude-code-skills · 152 tokens

korean-character-count

Count Korean text deterministically with exact grapheme, line, and byte contracts for self-intros and form limits.

sangrokjung/claude-forge · 28 tokens