fetch-story

Fetch the highest-priority Ready story from a GitHub Project via GraphQL API.

2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/amdmax/claude_marketplace --skill fetch-story
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fetch-story
Source: https://github.com/amdmax/claude_marketplace/tree/main/.claude/skills/github%3Astory-fetch
Command: npx skills add https://github.com/amdmax/claude_marketplace --skill fetch-story

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of selecting the next high-priority task from a GitHub Project, ensuring development effort is always focused on the most critical items.

Core Features & Use Cases

  • Automated Story Selection: Automatically identifies and retrieves the highest-priority "Ready" story from GitHub Projects.
  • Status Updates: Updates the selected story's status to "In Progress" on GitHub.
  • Data Persistence: Stores fetched story details locally for use by subsequent skills.
  • Use Case: When starting your workday, run /fetch-story to instantly get the most important task assigned to you, complete with all necessary details, and have its status updated on the project board.

Quick Start

Run the fetch-story command to get the next ready story from your GitHub project.

Frequently Asked Questions about fetch-story

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

FAQPage Schema
How do I automatically fetch the next high-priority story from a GitHub Project?

To automatically fetch the next high-priority story from a GitHub Project, run the fetch-story command. It queries your configured GitHub Project via the GraphQL API, identifies the highest-priority 'Ready' story by sorting P0, P1, and P2 tasks, and updates its status to 'In Progress'.

Can I use GitHub Projects to automatically select tasks based on priority?

Yes, you can use GitHub Projects to automatically select tasks based on priority. This Skill uses the GraphQL API to sort stories by priority levels (P0 > P1 > P2) and automatically selects the highest-priority 'Ready' item for your development workflow.

Do I need GitHub CLI authentication to fetch stories from a GitHub Project board?

Yes, you need GitHub CLI authentication to fetch stories from a GitHub Project board. The Skill requires an authenticated GitHub CLI session and a configured project ID, field IDs, and option IDs to execute GraphQL API queries and update story statuses.

How does the automated story selection process manage task data locally?

The automated story selection process manages task data locally by storing the fetched story's details in a local file named `.claude/active-story.json`. This data persistence allows subsequent development skills and workflow scripts to access the selected story's context.

What is the best way to keep development focused on critical GitHub Project items?

The best way to keep development focused on critical GitHub Project items is to automate task selection by fetching the highest-priority 'Ready' story. This ensures effort is consistently directed toward the most critical items by sorting P0, P1, and P2 priorities automatically.