| name | Goal Builder Workflow |
| description | Transform GitHub issues into Linear goal tickets. Use when organizing issues, creating goals, managing GitHub to Linear workflow, or when user mentions issue management. |
Goal Builder Workflow
This skill provides structured workflows and templates for transforming GitHub issues into Linear goal tickets using MCP servers.
đź”´ CRITICAL: ALWAYS USE YOUR COMMANDS đź”´
MANDATORY: You MUST use your slash commands for ALL actions:
/show-issues- ALWAYS use this to show GitHub issues/show-drafts- ALWAYS use this to show draft Linear goals/analyze-issues- ALWAYS use this to analyze groupings/create-goal [issue-numbers]- ALWAYS use this to create new goals from issues/edit-draft [goal-id]- ALWAYS use this to edit existing draft goals/save-draft- ALWAYS use this to save drafts
NEVER manually list issues or create goals without these commands!
Quick Start
Creating New Goals from GitHub Issues
- Use command:
/show-issues(shows GitHub issues via MCP) - Use command:
/analyze-issuesfor groupings - Use command:
/create-goal [numbers]to draft WITH user- Command automatically loads full issue content via GitHub MCP
- Agent sees complete issue body, not just preview
- Goal created in Linear with status="draft" via Linear MCP
- User manually changes draft→todo when ready
Editing Existing Draft Goals
- Use command:
/show-drafts(shows draft goals via Linear MCP) - User selects which draft to edit
- Use command:
/edit-draft [goal-id]to modify WITH user- Command automatically loads full goal content via Linear MCP
- Agent sees complete description, not just preview
- Goal updated in Linear (stays as "draft")
- User manually changes draft→todo when ready
Core Principles
- Interactive Writing: Draft real content with the user, not templates
- Status Management: Always create with status="draft"
- Relationship Tracking: Close GitHub issues after goal creation
- User Control: User decides when to transition draft→todo
- MCP Integration: All GitHub and Linear operations use MCP servers
Workflow Steps
For detailed step-by-step workflows, see WORKFLOW.md.
Templates
For template examples, see TEMPLATES.md.
Important Notes
- Goals are building blocks for the Plan Builder
- Each goal should be substantial but achievable
- Group related issues that form a coherent feature
- The user controls the draft→todo transition
- All API operations use MCP servers (not Python scripts)