as-work-on-issue

Automate GitHub issue handling from fetch to pull request creation.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/aaronsilinskas/ai-skills --skill as-work-on-issue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: as-work-on-issue
Source: https://github.com/aaronsilinskas/ai-skills/tree/main/as-work-on-issue
Command: npx skills add https://github.com/aaronsilinskas/ai-skills --skill as-work-on-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, jq, and includes scripts (resource) components.

What problem does it solve?

This Skill automates end-to-end GitHub issue handling: fetch the issue, read project context, explore code, and drive a test-driven path to a merged PR.

Core Features & Use Cases

  • End-to-end handling of GitHub issues from discovery to PR creation.
  • Context-aware exploration of project guidelines (AGENTS.md, docs/agents/*) to align with acceptance criteria.
  • TDD-driven implementation workflow with isolated worktrees and clear commit history.

Quick Start

Provide an issue number to start, or run the dispatch.sh script to pick the next ready-for-agent task.

Frequently Asked Questions about as-work-on-issue

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

FAQPage Schema
How do I automate GitHub issue workflows from start to PR?

You can automate the full GitHub issue workflow by fetching the issue, gathering project context, exploring the codebase, and driving a test-driven implementation to create a PR. This Skill executes that entire sequence using command-line tools.

Does this issue automation tool support test-driven development?

Yes, this issue automation tool supports test-driven development by applying a TDD-driven implementation workflow. It creates isolated worktrees and maintains a clear commit history while validating code against acceptance criteria.

Can I automatically pick the next ready backlog item across repositories?

Yes, you can automatically pick the next ready backlog item across repositories by running the dispatch script. The Skill applies when requested to work on, implement, fix, or pick the next available task.

Do I need to install gh and jq to automate GitHub issue handling?

Yes, you need to install gh and jq because they are the required dependencies for this Skill. These command-line tools enable the automation of fetching issues, parsing data, and creating pull requests.

How does context-aware code exploration work for GitHub issues?

Context-aware code exploration works by reading project guidelines like AGENTS.md and docs/agents/* to align with acceptance criteria. This ensures the implementation meets project standards before creating a PR.