Agent skill

Issue Progress Tracking

by yonatangross in yonatangross/orchestkit

GitHub issue workflow ceremony using gh CLI — labels issues as in-progress, creates feature branches (issue/N-description), commits with issue references, posts progress comments, and links PRs with…

MITAuto-check: notesProductivity & Automation

Install Issue Progress Tracking

skills CLI
$ npx skills add yonatangross/orchestkit --skill issue-progress-tracking -a claude-code

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

GitHub CLI
$ gh skill install yonatangross/orchestkit issue-progress-tracking --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/yonatangross/orchestkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/skills/issue-progress-tracking .claude/skills/issue-progress-tracking && 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
issue-progress-tracking
GitHub stars
288
Token cost
~1.1k tokens
SKILL.md length
345 words
Files
5
Skills in repo
107
Repo updated
First seen
Licence
MIT

At a glance

GitHub issue workflow ceremony using gh CLI — labels issues as in-progress, creates feature branches (issue/N-description), commits with issue references, posts progress comments, and links PRs with…

  • Works in 4 steps: Start Work → During Work — Small Commits → Report Progress (Long Implementations) → …
  • Starting work on an issue
  • SKILL.md covers Invocation, Phase 1: Start Work, Phase 2: During Work — Small… and Phase 3: Report Progress (Long…, plus 5 more sections
  • Calls gh and git

What it does

Issue Progress Tracking is an agent skill from yonatangross/orchestkit. GitHub issue workflow ceremony using gh CLI — labels issues as in-progress, creates feature branches (issue/N-description), commits with issue references, posts progress comments, and links PRs with Closes N. Keeps issues in sync with development work. Use when starting work on an issue, tracking progress, or completing work with a PR.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `rules/_sections.md`, `rules/small-commits.md` and `rules/start-work-ceremony.md`). Compatibility notes: Claude Code 2.1.277+.

It sits in Productivity & Automation, covering Task management. It works with GitHub. The repository describes itself as: The Complete AI Development Toolkit for Claude Code. 106 skills, 36 agents, 171 hooks. Install ork for stable (v9.x), or ork-alpha for the v10 line, which ships daily. The licence is MIT.

When your agent uses it

  • Starting work on an issue
  • Tracking progress
  • Completing work with a PR

Example prompts

  • “/issue-progress-tracking”

Requirements

  • Compatibility (from SKILL.md): Claude Code 2.1.277+.
  • Pre-approved tools (allowed-tools): Bash

Workflow steps

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

  1. Start Work
  2. During Work — Small Commits
  3. Report Progress (Long Implementations)
  4. Complete Work

What it can do on your machine

Read from SKILL.md and the folder at commit 1f8d8f3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • git

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

  • Network

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

  • Compatibility

    Claude Code 2.1.277+.

    From compatibility in the SKILL.md frontmatter.

Context cost

Issue Progress Tracking loads about 1.1k tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 345 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~91
When it runs · the whole SKILL.md, loaded when a task matches
~1.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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash

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

The full file from yonatangross/orchestkit at commit 1f8d8f3, republished under its MIT licence (© yonatangross). 345 words, ~1,120 tokens.

Download SKILL.mdSave it as .claude/skills/issue-progress-tracking/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
issue-progress-tracking
description
GitHub issue workflow ceremony using gh CLI — labels issues as in-progress, creates feature branches (issue/N-description), commits with issue references, posts progress comments, and links PRs with Closes #N. Keeps issues in sync with development work. Use when starting work on an issue, tracking progress, or completing work with a PR.
allowed-tools
Bash
compatibility
Claude Code 2.1.277+.
license
MIT
context
inherit
user-invocable
false
disable-model-invocation
true
effort
low
model
haiku
metadata.category
workflow-automation
metadata.version
1.0.0
metadata.author
OrchestKit
metadata.complexity
low

Issue Progress Tracking

Ceremony guide for tracking GitHub issue progress via gh CLI. Ensures issues stay updated as work progresses from start to PR.

Invocation

This skill is user-invocable: false and disable-model-invocation: true: there is no /ork: form and the model cannot auto-select it (#3313). An agent loads it explicitly by Reading this file's path:

text
${CLAUDE_PLUGIN_ROOT}/skills/issue-progress-tracking/SKILL.md

Phase 1: Start Work

Label the issue and create a feature branch:

bash
# Move issue to in-progress
gh issue edit $ARGUMENTS[0] --add-label "status:in-progress" --remove-label "status:todo"
gh issue comment $ARGUMENTS[0] --body "Starting work on this issue."

# Create feature branch
git checkout -b issue/$ARGUMENTS[0]-brief-description

Rules:

  • Always branch from the default branch (main/dev)
  • Branch name format: issue/<number>-<brief-description>
  • Never work directly on main/dev

Phase 2: During Work — Small Commits

Commit after each logical step, not at the end. Every commit references the issue:

bash
# Each commit references the issue number
git commit -m "feat(#$ARGUMENTS[0]): add user model

Co-Authored-By: Claude <noreply@anthropic.com>"

Rules:

  • One logical change per commit (atomic)
  • Reference issue in every commit: type(#N): description
  • Commit early and often — don't accumulate a massive diff

Phase 3: Report Progress (Long Implementations)

For multi-step work, post progress updates:

bash
gh issue comment $ARGUMENTS[0] --body "Progress update:
- Completed: database schema, API endpoints
- In progress: frontend components
- Remaining: tests, documentation"

When to post updates:

  • After completing a major milestone
  • When blocked or changing approach
  • Before stepping away from a long task

Phase 4: Complete Work

Create the PR and update labels:

bash
# Create PR that closes the issue
gh pr create \
  --title "feat(#$ARGUMENTS[0]): brief description" \
  --body "Closes #$ARGUMENTS[0]

## Changes
- Change 1
- Change 2

## Test Plan
- [ ] Unit tests pass
- [ ] Manual verification"

# Update issue status
gh issue edit $ARGUMENTS[0] --add-label "status:in-review" --remove-label "status:in-progress"

Rules Quick Reference

RuleImpactWhat It Covers
Start Work CeremonyHIGHBranch creation, label updates, initial comment
Small CommitsHIGHAtomic commits referencing issues

Total: 2 rules across 2 categories


Key Decisions

DecisionChoiceRationale
Label prefixstatus:Consistent with GitHub conventions
Branch formatissue/<N>-descLinks branch to issue automatically
Commit referencetype(#N):Conventional commits + issue linking
Progress commentsManualKeeps humans in the loop

Common Mistakes

  1. Starting work without labeling — team loses visibility into who is working on what
  2. Giant commits at the end — makes review harder and history useless for bisect
  3. Forgetting to link PR to issue — issue stays open after merge
  4. Not updating labels on PR creation — issue shows "in-progress" during review
  5. Closing issues manually with gh issue close — issues are closed ONLY by merging a PR with Closes #N in the body. During work, comment progress with gh issue comment; never close directly.

  • ork:commit — Commit with conventional format
  • ork:fix-issue — Full issue resolution workflow
  • ork:implement — Feature implementation with parallel agents
  • ork:create-pr — Create pull requests

© yonatangross, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files in src/skills/issue-progress-tracking of yonatangross/orchestkit.

  • SKILL.md
  • rules/_sections.md
  • rules/small-commits.md
  • rules/start-work-ceremony.md
  • test-cases.json

Open the folder on GitHubat commit 1f8d8f3

Compare with similar skills

Issue Progress Tracking 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.

Issue Progress Tracking compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Issue Progress Tracking this skillyonatangross/orchestkit288—~1.1kAutomated safety check: NotesMIT
Worklogtokenbender/agent-guides367—~1.6kAutomated safety check: PassApache-2.0
OpenObserve PR Briefopenobserve/openobserve22k—~1.8kAutomated safety check: PassAGPL-3.0
Agent Kanban Task Workersaltbo/agent-kanban485—~855Automated safety check: PassCustom licence
Release Kanban Mdantopolskiy/kanban-md223—~1.2kAutomated safety check: PassMIT
Pmcoreyhaines31/makerskills844—~2.2kAutomated safety check: PassMIT

Similar skills

  • Worklog

    tokenbender/agent-guides

    Issue-led atomic work logging. An agent skill from tokenbender/agent-guides.

    367 GitHub stars~1.6k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • OpenObserve PR Brief

    openobserve/openobserve

    Produces a read-only morning brief of your open pull requests across the openobserve GitHub org, with a next step for each and a reminder for idle ones.

    22k GitHub stars~1.8k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Agent Kanban Task Worker

    saltbo/agent-kanban

    Lets an agent read, claim, update and submit an assigned Agent Kanban task through the Realmroot Toolbox CLI, with progress notes and a review handoff.

    485 GitHub stars~855 tokensUpdated 5 days ago
    Productivity & AutomationAuto-check passed
  • Release Kanban Md

    antopolskiy/kanban-md

    Release kanban-md through its tag-triggered GoReleaser workflow, monitor CI, recover safely from failures, and publish user-facing GitHub release notes.

    223 GitHub stars~1.2k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • Pm

    coreyhaines31/makerskills

    When you want to manage projects across your businesses using a kanban + Eisenhower methodology.

    844 GitHub stars~2.2k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Jira

    magnus919/agent-skills

    Interact with Atlassian Jira from the terminal: search issues with JQL, view details, create issues, add comments, count matches with fast approximate-count, list projects, discover valid…

    111 GitHub stars~3.3k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed

More from yonatangross/orchestkit

All 107 skills in this repo
  • API Design

    yonatangross/orchestkit

    API contract design for REST and GraphQL, covering resource shape, URL and header versioning with deprecation windows, RFC 9457 Problem Details error handling, and OpenAPI specs.

    288 GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • Architecture Decision Record

    yonatangross/orchestkit

    ADR templates in the Nygard format with context, decision, consequences, and alternatives.

    288 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Audit Full

    yonatangross/orchestkit

    Single-pass codebase analysis leveraging a 1M-token context window for comprehensive security scanning, architecture review, and dependency auditing.

    288 GitHub stars~3.5k tokensUpdated yesterday
    Auto-check: notes
  • Code Review Playbook

    yonatangross/orchestkit

    Structured review processes, conventional comments, language-specific checklists, and feedback templates.

    288 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Create PR

    yonatangross/orchestkit

    Creates GitHub pull requests with pre-flight validation, conventional title formatting, and structured summary generation.

    288 GitHub stars~4.5k tokensUpdated yesterday
    Auto-check: notes
  • Explore

    yonatangross/orchestkit

    Multi-angle codebase exploration spawning 3-5 parallel agents for code structure, data flow, architecture patterns, and health assessment.

    288 GitHub stars~3.9k tokensUpdated yesterday
    Auto-check: notes

Works with

Questions about Issue Progress Tracking

What does Issue Progress Tracking do?

GitHub issue workflow ceremony using gh CLI — labels issues as in-progress, creates feature branches (issue/N-description), commits with issue references, posts progress comments, and links PRs with…. Issue Progress Tracking is an agent skill from yonatangross/orchestkit. GitHub issue workflow ceremony using gh CLI — labels issues as in-progress, creates feature branches (issue/N-description), commits with issue references, posts progress comments, and links PRs with Closes N.

When should I use Issue Progress Tracking?

Issue Progress Tracking fits situations like: starting work on an issue; tracking progress; completing work with a PR.

How do I install Issue Progress Tracking in Claude Code?

Run `npx skills add yonatangross/orchestkit --skill issue-progress-tracking -a claude-code`. Or copy the skill folder (src/skills/issue-progress-tracking in yonatangross/orchestkit) into .claude/skills/issue-progress-tracking in your project. Claude Code loads it when a task matches its description.

How do I install Issue Progress Tracking in Codex?

Run `npx skills add yonatangross/orchestkit --skill issue-progress-tracking -a codex`. Or copy the skill folder (src/skills/issue-progress-tracking in yonatangross/orchestkit) into .agents/skills/issue-progress-tracking in your project. Codex loads it when a task matches its description.

Can I use Issue Progress Tracking 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 yonatangross/orchestkit --skill issue-progress-tracking -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/issue-progress-tracking, .gemini/skills/issue-progress-tracking, .github/skills/issue-progress-tracking and .opencode/skills/issue-progress-tracking in your project.

What does Issue Progress Tracking need to run?

Going by SKILL.md and its folder, Issue Progress Tracking needs the command-line tools its instructions call (gh and git). Its frontmatter pre-approves these tools: Bash. Compatibility (from SKILL.md): Claude Code 2.1.277+..

Does Issue Progress Tracking access the network?

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

Is Issue Progress Tracking safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Issue Progress Tracking use?

Issue Progress Tracking is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Issue Progress Tracking use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 Issue Progress Tracking?

Skills that share tags, products or a category with Issue Progress Tracking: Worklog (tokenbender/agent-guides, 367 stars), OpenObserve PR Brief (openobserve/openobserve, 22k stars), Agent Kanban Task Worker (saltbo/agent-kanban, 485 stars) and Release Kanban Md (antopolskiy/kanban-md, 223 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Issue Progress Tracking?

yonatangross (a GitHub user) maintains it in yonatangross/orchestkit, which has 288 GitHub stars. The repository holds 107 skills in this directory. The repository was last updated on October 6, 2026.

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