skills.rest
generic-automation-and-it
generic-automation-and-itOFFICIAL
Explore all skills by this author →
GitHub

agile-github-task-from-diff

Creates a GitHub Task sub-issue from the current git diff and links it to a parent Feature.

Updated Jul 23, 2026
Search Tags:#task management#github#agile#gh cli#git diff#issue automation#sub-issue
One-click install
npx skills add https://github.com/generic-automation-and-it/smooth-ai-stockanalysis --skill agile-github-task-from-diff-generic-automation-and-it
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agile-github-task-from-diff
Source: https://github.com/generic-automation-and-it/smooth-ai-stockanalysis/tree/main/.agents/skills/agile-github-task-from-diff
Command: npx skills add https://github.com/generic-automation-and-it/smooth-ai-stockanalysis --skill agile-github-task-from-diff-generic-automation-and-it

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Turning branch changes into well-scoped GitHub issues is repetitive and error-prone: titles drift from conventions, acceptance criteria get forgotten, and sub-issue links to parent Features are missed. This Skill automates the whole flow from the current git diff. ## Core Features & Use Cases - Diff-driven issue authoring: Classifies the diff vs main into horizontal layers (backend, tests, documentation, ai-tooling, config) and generates a title, diff summary, and acceptance criteria checklist. - Project and sub-issue integration: Creates the issue via gh, adds it to a GitHub Project, and links it as a sub-issue of a parent Feature issue (by number or URL). - Branch naming convention: Suggests a <type>/<issue>-slug branch rename so downstream PR automation can derive the Closes # link. - Use Case: After finishing backend changes on a feature branch, run the script with --feature-issue 42 to create a horizontally sliced task issue, add it to the project, and link it under the parent Feature in one step. ## Quick Start Ask the agent to create a GitHub task from the current diff against main and link it as a sub-issue of Feature issue 42, starting with a dry run to preview the title and acceptance criteria.

Frequently Asked Questions about agile-github-task-from-diff

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

FAQPage Schema
How do I create a GitHub issue from a git diff?▼

Run the create_github_task_from_diff.py script, which computes the diff from the merge-base of HEAD and the base ref, classifies changed paths into layers, and creates the issue via gh issue create. Use --dry-run first to preview the generated title and body.

How to link a GitHub issue as a sub-issue of another issue?▼

Pass --feature-issue with an issue number or URL, and the script calls the GitHub REST API endpoint POST /repos/{owner}/{repo}/issues/{parent}/sub_issues. If the API call fails, it prints a fallback message so you can link manually in the GitHub UI.

What permissions does the gh CLI need for GitHub Projects?▼

The gh CLI token needs repo and project scopes. If gh project item-add fails, refresh the token with gh auth refresh -s project and verify access with gh auth status.

Why does the script say no changes detected against base ref?▼

This happens when the branch has no commits differing from origin/main or main. Confirm your branch contains changes, fetch the latest main, or override the comparison point with the --base-ref flag.

Can I skip adding the issue to a GitHub Project?▼

Yes, pass --no-project to create only the issue without adding it to any project. You can also override the default project number 1 with --project and the owning org with --org.

Related Skills

Explore More Software Engineering Skills→
usesofiausesofia

git-merge

Fetch origin/main, merge it into the current branch, resolve conflicts, run tests, and push.

Official
Intermediate
ryan-mahoneyryan-mahoney

pr

Open a GitHub pull request linked to an issue from a branch name.

Community
Intermediate
YoshikemoloYoshikemolo
5

git-jira-integration

Generate Git branch names and validate commit messages against Jira issues.

Community
Intermediate
JDenn0514JDenn0514
1

create-release-checklist

Generate an R package release checklist and GitHub issue from DESCRIPTION and NEWS.md.

Community
Advanced