Spec-Kit Tasks to Issues
Convert existing tasks into actionable, dependency-ordered GitHub issues for the feature based on available design artifacts.
User Input
$ARGUMENTS
You MUST consider the user input before proceeding (if not empty).
Prerequisites Check
- •
Run prerequisites check:
bashbash .tessl/tiles/tessl-labs/spec-kit/skills/speckit-01-specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks
- •
Parse JSON for
FEATURE_DIRandAVAILABLE_DOCS. - •
Extract the path to tasks.md from the output.
GitHub Remote Validation
Get the Git remote:
git config --get remote.origin.url
CRITICAL: ONLY PROCEED TO NEXT STEPS IF THE REMOTE IS A GITHUB URL
Valid GitHub URLs:
- •
git@github.com:owner/repo.git - •
https://github.com/owner/repo.git - •
https://github.com/owner/repo
If the remote is NOT a GitHub URL:
ERROR: Git remote is not a GitHub repository. Remote URL: [actual remote URL] This skill only supports GitHub repositories.
Execution Flow
1. Parse tasks.md
Read the tasks file and extract:
- •Task IDs (T001, T002, etc.)
- •Task descriptions
- •Phase groupings
- •Parallel markers [P]
- •User story labels [US1], [US2], etc.
- •Dependencies between tasks
2. Create GitHub Issues
For each task in the list, create a GitHub issue:
Issue Title Format: [TaskID] [Story] Description
Example: [T012] [US1] Create User model in src/models/user.py
Issue Body Template:
## Task Details **Task ID**: T012 **Phase**: Phase 3: User Story 1 **User Story**: US1 **Parallel**: Yes (can be executed in parallel with other [P] tasks) ## Description Create User model in src/models/user.py ## File Path `src/models/user.py` ## Dependencies - Depends on: T011 (if applicable) - Blocks: T014, T015 (if applicable) ## Acceptance Criteria - [ ] File created at specified path - [ ] Model implements required fields from data-model.md - [ ] Tests pass (if applicable) --- *Generated from tasks.md by /speckit-09-taskstoissues* *Feature: [###-feature-name]*
Issue Labels (create if they don't exist):
- •
speckit- All spec-kit generated issues - •
phase-1,phase-2, etc. - Phase grouping - •
us-1,us-2, etc. - User story grouping - •
parallel- Tasks that can be parallelized
3. Create Issues via gh CLI
Use the GitHub CLI to create issues:
gh issue create --title "[T012] [US1] Create User model" --body "..." --label "speckit,phase-3,us-1"
CRITICAL SAFETY CHECK:
UNDER NO CIRCUMSTANCES EVER CREATE ISSUES IN REPOSITORIES THAT DO NOT MATCH THE REMOTE URL
Before each gh issue create command, verify:
- •You are in the correct repository
- •The remote URL matches a GitHub repository
- •The issue is being created in the correct repo
4. Link Dependencies
After all issues are created, add cross-references:
- •Edit issue bodies to include links to blocking/blocked-by issues
- •Use GitHub's issue reference syntax:
#123
Report
Output:
- •Number of issues created
- •List of issue numbers and titles
- •Any errors encountered
- •Link to the GitHub issues list for the repository
Error Handling
| Condition | Response |
|---|---|
| Not a GitHub remote | STOP with error message |
| gh CLI not installed | STOP with installation instructions |
| gh CLI not authenticated | STOP with auth instructions |
| Issue creation fails | Report error, continue with next task |
| Label creation fails | Continue without label |
Next Steps
After creating issues:
- •Review issues in GitHub
- •Assign team members
- •Add to project boards
- •Begin implementation following the task order