speckit-taskstoissues

Convert tasks.md entries into GitHub issues with labels, assignees, and milestones.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/a2mus/smart-da3m --skill speckit-taskstoissues-a2mus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-taskstoissues
Source: https://github.com/a2mus/smart-da3m/tree/main/.agents/skills/speckit-taskstoissues
Command: npx skills add https://github.com/a2mus/smart-da3m --skill speckit-taskstoissues-a2mus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert tasks from tasks.md into GitHub issues to enable tracking across project boards.

Core Features & Use Cases

  • Reads tasks from tasks.md and creates corresponding GitHub issues in the target repository.
  • Maintains linkage between tasks and issues for traceability.
  • Supports basic metadata such as labels, assignees, and milestones based on task fields.

Quick Start

Run the speckit-taskstoissues skill to transform tasks.md entries into GitHub issues in the target repository.

Frequently Asked Questions about speckit-taskstoissues

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

FAQPage Schema
How do I convert tasks from a markdown file into GitHub issues?

To convert markdown tasks into GitHub issues, this Skill reads entries from tasks.md and creates corresponding issues in your target repository. It automatically maps task fields like labels, assignees, and milestones directly to issue properties for reliable project tracking.

Does converting tasks to GitHub issues require a specific project structure?

Yes, converting tasks to GitHub issues requires a spec-kit project structure containing a .specify/ directory. It also requires a valid GitHub remote repository configured in your git settings to enforce repository matching and ensure issues are created in the correct location.

How are task fields mapped to GitHub issue properties during conversion?

During conversion, task fields are mapped to GitHub issue properties by matching definitions to titles, bodies, labels, assignees, and milestones. This ensures reliable traceability and maintains linkage between your original tasks and the newly created issues.

Can I sync spec-kit tasks with GitHub project boards automatically?

Yes, you can sync spec-kit tasks with GitHub project boards by running this Skill to transform tasks.md entries into GitHub issues. This enables tracking across project boards by creating issues that mirror your original task definitions and metadata.

Why does converting tasks to GitHub issues fail with a repository matching error?

Task conversion fails with a repository matching error when the git remote URL does not match the expected GitHub repository. The Skill enforces repository matching by checking the git remote URL to prevent creating issues in the wrong repository.