TODOs to GitHub Issues

Scan codebases for TODO and FIXME comments and create GitHub Issues with labels, priorities, and descriptions.

3|1|Updated Apr 18, 2021
One-click install
npx skills add https://github.com/nashgao/mqtt-client --skill todos-to-github-issues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: TODOs to GitHub Issues
Source: https://github.com/nashgao/mqtt-client/tree/main/.claude/skills/todos-to-issues
Command: npx skills add https://github.com/nashgao/mqtt-client --skill todos-to-github-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of transforming development notes like TODOs and FIXMEs found in your codebase into actionable GitHub Issues, streamlining your project management and issue tracking.

Core Features & Use Cases

  • Automated Issue Creation: Scans code for TODO/FIXME comments and generates corresponding GitHub Issues.
  • Contextual Analysis: Analyzes code context, priority, and type (bug, feature, etc.) to create well-defined issues.
  • Standard Compliance: Adheres to project-specific standards, issue templates, and contribution guidelines for forks.
  • Use Case: After a code review, you find several TODO comments. This Skill can automatically create GitHub Issues for each TODO, complete with relevant code snippets and context, ready for your team to address.

Quick Start

Use the todos-to-issues skill to scan the current repository for TODO comments and create GitHub issues.

Frequently Asked Questions about TODOs to GitHub Issues

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

FAQPage Schema
How do I convert TODO comments in my codebase into GitHub Issues automatically?

To convert TODO comments into GitHub Issues automatically, you need a code scanning tool that parses your repository for TODO and FIXME tags and generates structured issues. This Skill scans the codebase, analyzes project context and contribution guidelines, and creates GitHub Issues complete with labels, priorities, and descriptions using the GitHub CLI.

Do I need the GitHub CLI installed to create issues from code TODOs?

Yes, you need the GitHub CLI installed to create issues from code TODOs. The Skill requires the gh command-line tool for authenticating your GitHub account and programmatically creating the structured issues directly within your repository.

Can I use my existing issue templates when generating issues from FIXME comments?

Yes, you can use your existing issue templates when generating issues from FIXME comments. The Skill adheres to project-specific standards, analyzes your issue templates, and follows contribution guidelines to ensure the generated issues comply with your repository's formatting requirements.

How does code context analysis improve automated GitHub issue creation?

Code context analysis improves automated GitHub issue creation by examining surrounding code to determine the type and priority of the TODO or FIXME. This ensures the resulting GitHub Issues are well-defined, accurately labeled as bugs or features, and populated with relevant code snippets for your team.

What is the best way to track technical debt scattered across a repository?

The best way to track technical debt scattered across a repository is by scanning code for TODO and FIXME comments and converting them into actionable GitHub Issues. This centralizes fragmented development notes into a structured issue tracker with appropriate priorities and descriptions.