mcpField
P
progress-check

progress-check

github.com/tjcagesAgent workflows685 installsUpdated 2w ago
Repository

About progress-check

A skill that standardizes progress updates for long-running work, using observable milestones and evidence rather than elapsed time. It also provides instructions for installing the behavior globally when requested.

Key features

  1. 01Defines observable milestones
  2. 02Sets rules for progress update timing
  3. 03Reports blockers and completion promptly
  4. 04Formats updates with a single progress bar
  5. 05Documents global installation steps

Use cases

  1. 01Reporting progress on lengthy tasks
  2. 02Sharing updates across agent sessions
  3. 03Informing users when work is blocked
  4. 04Installing progress rules across projects

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tjcages/skills --skill progress-check

After installing, type/progress-checkin Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

Progress Check

Full method: METHODOLOGY.md. Chat shape: RESPONSE.md. Examples: EXAMPLES.md.

Choose the mode

  • Report progress: default for qualifying long-running work.
  • Install globally: only when the user asks to persist this behavior across agents or projects.

Report progress

  1. Define a small set of observable milestones before estimating a percentage. Weight by work and risk, not elapsed time.
  2. Send one baseline update after scope is understood.
  3. Send a routine update only when at least 30 minutes have passed and one of these is true: a milestone completed, verified progress rose by at least 10 percentage points, or the next action materially changed.
  4. Report a new blocker immediately when the user can act on it. Report completion immediately.
  5. Never repeat an unchanged bar or send a routine “still working” message.

Keep each update to at most three short items: completed evidence, current work, and next step or blocker. End with exactly one overall bar styled as inline code on its own line:

Performance rollout [██████████████████░░] 90%

Use one pair of backticks for inline-code styling. Do not indent the line by four spaces and do not use a fenced code block; both create a separate block that interfaces may label or make copyable.

  • Replace the label with a short task-specific label.
  • Use 20 cells: █ completed and ░ remaining.
  • Round down to the nearest 5% unless completion evidence supports 100%.
  • Show only the overall bar unless the user requests subtask bars.
  • In multi-agent work, only the coordinator shows the overall bar.
  • The progress line is the final content in the update. End immediately after it with no note, recap, or closer.

Install globally

Prefer installing this skill globally through the available Agent Skills CLI so one source works across supported agents:

npx skills add tjcages/skills --skill progress-check -g --agent '*'

If the user explicitly requests native always-on instructions instead:

  1. Detect each installed agent's documented user-level instruction mechanism.
  2. Merge the progress rules without overwriting existing instructions.
  3. Make the change idempotent and avoid repository-level instruction files.
  4. If an agent supports only UI-managed rules, give the exact settings location and a copy-ready block instead of inventing a file path.
  5. Verify each changed target and state whether a new session is required.

Do not claim an unsupported agent was configured. Do not modify unrelated preferences.

Comments

Markdown supported