amoa-kanban-management

name	amoa-kanban-management
description	GitHub Projects V2 kanban board management. Use when creating boards, adding columns, moving items. Trigger with kanban or column requests. Loaded by ai-maestro-orchestrator-agent-main-agent
license	Apache-2.0
compatibility	Requires gh CLI authenticated with project scopes. Requires AI Maestro installed.
metadata	{"author":"Emasoft","version":"1.0.0"}
context	fork
user-invocable	false
agent	amoa-main

Kanban Board Management Skill

Overview

Manage GitHub Projects V2 kanban boards: create boards, columns, move items, sync status.

Prerequisites

gh CLI authenticated with project and read:project OAuth scopes. See references/gh-auth-scopes.md

Instructions

1. Verify scopes: gh auth status 2>&1 | grep -q "project" || echo "ERROR: gh auth refresh -h github.com -s project,read:project"
2. Query board/column IDs via GraphQL. See references/kanban-procedures.md

3. Execute procedure. NEVER call updateProjectV2Field directly -- use scripts/gh-project-add-columns.py
4. Verify JSON output. Columns: references/kanban-column-system.md

Copy this checklist and track your progress:

• Verify OAuth scopes with pre-flight check
• Query board/column IDs, execute procedure from references/kanban-procedures.md
• Confirm JSON output matches expected format

Output

JSON from GraphQL mutations and board state reports.

Examples

Input: move-item --project 42 --item ITEM_ID --column "AI Review" Output: {"updateProjectV2ItemFieldValue":{"projectV2Item":{"id":"ITEM_ID"}}} See references/kanban-examples.md

Error Handling

See references/kanban-error-handling.md

Resources

• Auth & OAuth Scopes
• GraphQL Mutations
• Pitfalls & Guards
• Procedures
• Column System
• Checklists
• Error Handling
• Examples