take-issue

Export a GitHub issue thread and attachments into the repository and commit them on the branch.

Updated Nov 17, 2025
One-click install
npx skills add https://github.com/vzakharov/vovazakharov.com --skill take-issue-vzakharov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: take-issue
Source: https://github.com/vzakharov/vovazakharov.com/tree/main/.claude/skills/take-issue
Command: npx skills add https://github.com/vzakharov/vovazakharov.com --skill take-issue-vzakharov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? GitHub issue threads and their attachments are not reliably readable from an agent session: gh issue view cannot fetch private-image attachments, and WebFetch often fails on github.com pages. This Skill pulls the full issue — body, comments, timeline, and attachments — into the repository as committed files so any session can re-read the source of truth. ## Core Features & Use Cases - Issue export: Runs scripts/export-github-item.py to write docs/issue/<n>/issue.md and download attachments to docs/issue/<n>/attachments/. - Committed snapshot: Commits the export on the working branch immediately, so resumed or parallel sessions re-read the thread instead of re-exporting. - Video attachment handling: Loads video-frames.md to extract frames with ffmpeg when an attachment is a screen recording. - Use Case: A caller skill like /task or /plan receives fix the sidebar scroll #847; this Skill exports issue 847, commits it, and hands the number and export path back to the caller. ## Quick Start Invoke the skill with an issue number or URL, for example by asking to take issue 847 onto the current branch.

Frequently Asked Questions about take-issue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I export a GitHub issue with its attachments locally?

Run the bundled exporter script with the issue number or URL: `python3 scripts/export-github-item.py <number|url>`. It writes the thread to `docs/issue/<n>/issue.md` and downloads attachments to `docs/issue/<n>/attachments/`.

Why can't gh issue view fetch issue attachments?

GitHub attachment URLs on private-user-images.githubusercontent.com require an authenticated request even for public issues, which `gh issue view` does not perform. The export script handles authentication and redirect-specific header rules to download them.

What authentication does the GitHub issue exporter need?

The script reads the GH_TOKEN or GITHUB_TOKEN environment variable first, then falls back to `gh auth token`. One of these must be available, and the script exits non-zero on any auth, network, or download failure.

How do I read a video attachment from a GitHub issue?

Install ffmpeg, then extract frames with `ffmpeg -i <attachment> -vf fps=2 tmp/frames/frame_%03d.jpg` and read the frames as images. Use ffprobe to check duration and adjust the frame rate for short or long clips.

Does this skill work in native plan mode?

No. Native plan mode cannot write the export under docs/issue/ or the plan under docs/plans/, both of which must be committed. Switch to accept-edits or auto mode and the run continues without re-invocation.