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.