How does the skill decide between an RFC and a Plan?

It analyzes issue length, existing human-applied labels, and mentions of architectural changes to determine if a design discussion (RFC) is needed before implementation (Plan).

What is the primary purpose of the Ingest Issue skill?

It automates the creation of technical documentation (RFCs and Plans) by extracting data from GitHub issues to jumpstart the development process.

Does this skill require external tools?

Yes, it requires the GitHub CLI (gh) to be installed and authenticated on your local machine to interact with your repository.

Will it modify my existing GitHub issues?

It may normalize the title for clarity, add priority or component labels, and will add a comment linking to the newly created documentation.

Can I use this for specific sub-modules in my project?

Yes, using the --module flag allows you to direct the generated documentation to a specific subdirectory instead of the repository root.

GitHub Issue Ingest

Name: GitHub Issue Ingest
Author: alexnodeland

byalexnodeland

•

コラボレーションツール

Transforms GitHub issues into structured technical documentation like RFCs and implementation plans to automate specification-driven development.

GitHub Issue Ingest streamlines the transition from project management to technical execution by converting raw GitHub issues into structured documentation. It intelligently analyzes issue content to determine whether an RFC, an implementation plan, or both are required, then generates pre-populated files using standardized templates. By automating metadata normalization, bidirectional linking, and lifecycle labeling, this skill ensures that every task in your repository starts with a clear, documented foundation, reducing ambiguity for developers and reviewers alike.

主な機能

01Automated transformation of GitHub issues into RFCs and Plans

02Intelligent classification based on issue complexity and labels

033 GitHub stars

04Support for both repository-root and module-specific documentation

05Bidirectional linking between GitHub issues and repository docs

06Metadata normalization for improved issue clarity and tracking

ユースケース

01Standardizing documentation workflows across large, multi-module repositories

02Converting vague feature requests into structured design proposals for team review

03Quickly generating actionable implementation plans for bug fixes with known root causes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled ingest-issue

For use in Claude.ai and ChatGPT

Download Skill