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.