create-github-issues-for-unmet-specification-requirements

This skill automates the creation of GitHub issues for requirements in a specification file that have not yet been implemented in the codebase. It solves the gap between written specs and delivered code by systematically turning unmet requirements into tracked, actionable issues, reducing the chance that documented needs are silently dropped.

The workflow is compact: analyze the specification file to extract all requirements, check the codebase to determine each requirement's implementation status, search existing issues (via search_issues) to avoid duplicates, and create one new issue per unimplemented requirement (via create_issue) using the repository's feature_request.yml template, falling back to the default template when absent. Each issue is expected to carry a clear requirement ID and description mapping, implementation guidance, and acceptance criteria, with labels like feature or enhancement as appropriate. The implementation check includes searching the codebase for related patterns, checking related spec files under a /spec/ directory, and verifying a requirement is not already partially implemented.

It targets developers, tech leads, and project maintainers who work from specification documents and want to keep their issue tracker in sync with unmet requirements. Typical use cases include bootstrapping a backlog from a new spec, reconciling a spec against an existing codebase, and ensuring each requirement has a traceable issue. This is a thin, read-and-create workflow: it reads the spec and code and writes GitHub issues through standard tooling, with no destructive operations, credential handling, or code execution, making it low risk.