mav-github-issue-workflow

mav-github-issue-workflow is a skill for Claude Code, Codex from thermiteau/maverick. It costs 44 tokens per session (1,307 once invoked), scanned A, original, Apache-2.0.

Reusable guidance for managing GitHub issues throughout development, including reading them, recording progress, creating branches, and opening pull requests. GitHub issues are shared records for tasks, bugs, and feature requests.

In plain words
What is it for?
Use it in workflows that start from GitHub issues to track phases, branches, comments, sub-issues, and pull requests through the GitHub command line.
Why use it?
It keeps task status and related work visible on GitHub instead of relying on one computer's local files. Consistent issue updates make work easier to resume and coordinate.

Skill for Claude CodeCodex

Part of the maverick plugin — 41 skills, 5 agents, 5 hooks shipped together

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/thermiteau/maverick/mav-github-issue-workflow
Any agent
npx skills add thermiteau/maverick --skill mav-github-issue-workflow
Clone the repo
git clone --depth 1 https://github.com/thermiteau/maverick

Made for: Claude Code, Codex.

Or install maverick, the plugin that ships this one along with the rest of its 41 skills, 5 agents, 5 hooks.

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 mav-github-issue-workflow

README.md
[![agentmods](https://agentmods.dev/badge/skills/thermiteau/maverick/mav-github-issue-workflow.svg)](https://agentmods.dev/skills/thermiteau/maverick/mav-github-issue-workflow)
Your own site
<a href="https://agentmods.dev/skills/thermiteau/maverick/mav-github-issue-workflow"><img src="https://agentmods.dev/badge/skills/thermiteau/maverick/mav-github-issue-workflow.svg" alt="Measured on agentmods" height="20"></a>
Per session 44 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,307 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.00044 $0.01307
Opus 5 $0.00022 $0.00654
Sonnet 5 $0.00009 $0.00261
Haiku 4.5 $0.00004 $0.00131

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

Security

Grade A, and why

mav-github-issue-workflow 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/mav-github-issue-workflow/SKILL.md · 174 lines

How it starts

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

GitHub Issue Workflow Patterns

Reusable patterns for GitHub issue interactions. Workflow skills (e.g., do-issue-guided, do-issue-solo) reference this skill for consistent GitHub operations.

Issue State

The maverick-task-progress marker on the GitHub issue is the single state surface for issue-driven work. It records the current phase, the working branch, and the artefact comment ids — durable on GitHub, shared across instances, written only through the CLI. There is no local state file; anything local is a derivable cache.

Read it:

uv run maverick task-progress read <repo> <issue>

Write phase checkpoints (merge semantics — accreted fields like the branch and comment ids survive):

uv run maverick task-progress set <repo> <issue> <phase>
uv run maverick task-progress set <repo> <issue> branch --branch feat/42-add-export
uv run maverick task-progress set <repo> <issue> tasks --has-sub-issues

Never compose or edit the marker comment by hand — the CLI owns the schema. For marker kinds without a dedicated verb, use uv run maverick gh-state write.

Reading an Issue

Always fetch structured JSON to get the full picture including comments.

gh issue view $ISSUE_NUMBER --json title,body,labels,assignees,milestone,comments,state

Reading Specific Fields

# Just the body
gh issue view $ISSUE_NUMBER --json body -q '.body'

# Labels as comma-separated list
gh issue view $ISSUE_NUMBER --json labels -q '[.labels[].name] | join(", ")'

Posting Artefact Comments

One comment per artefact — design, plan, tasks, completion. Post and update them only through the CLI, which returns the comment id from the API response (never scraped from output that may carry warnings) and records it in the task-progress marker automatically:

# Post (body from a file, or '-' for stdin)
uv run maverick issue comment post <repo> <issue> --kind design --body-file /tmp/design.md

# Revise later — updates the same comment, keeping one artefact per kind
uv run maverick issue comment update <repo> <issue> --kind design --body-file /tmp/design-v2.md

Read the full file on GitHub · 174 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. 4d ago First seen · 174 lines · 44 tokens per session scan A f9387880c0a2

Subscribe to this mod's changes

mav-github-issue-workflow is a skill published in the GitHub repository thermiteau/maverick (11 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 44 tokens to every session and 1,307 once invoked, about $0.0002 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-30.

Related

Other skills, from other repositories

wayfinder

Plan a huge chunk of work (more than one agent session can hold) as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.

mattpocock/skills · 46 tokens

sap-transport-overview

System-wide inventory of open transport requests — every visible modifiable request, who owns it, how big it is, and supported risk signals such as empty/local requests, explicit locks, and confirmed manifest overlaps. Headers-only and cheap; NO source diffs. Use when asked "what transports are open in the system"…

arc-mcp/arc-1 · 106 tokens

timeline-creator

Create HTML timelines and project roadmaps with Gantt charts, milestones, phase groupings, and progress indicators. Use when users request timelines, roadmaps, Gantt charts, project schedules, or milestone visualizations.

mhattingpete/claude-skills-marketplace · 47 tokens

okx-task-watch

监听任务进展 / 帮我盯着任务 / 任务有动静告诉我 / 历史消息 / 未读消息 / 未决策 / 待决策 / 继续监听 / task watch / user watch / monitor task progress / catch me up on tasks / outstanding decisions — OKX A2A user-session task-notification monitor: live long-poll via okx-a2a user watch (also drains backlog of past/missed/unread events on entry) plus…

nirholas/three.ws · 138 tokens

pm-all

Skill "pm-all" from wei63w/pm-manager, covering user input, outline and shared workflow (all /pm- commands).

wei63w/pm-manager · 8 tokens

bootstrap-prd

Set up PRD-driven development infrastructure for a new project, including directory structure, templates, and roadmap.

joshukraine/dotfiles · 25 tokens