From cmux-todo-board
Turn a raw, unstructured task description into a well-formed GitHub issue and create it. Usage — /board-create-issue <raw task text>. The agent analyzes the input, drafts a clear title + body + acceptance criteria, picks a canonical status label, and runs `gh issue create`.
How this skill is triggered — by the user, by Claude, or both
Slash command
/cmux-todo-board:board-create-issueThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Takes a **raw task description** (the text after the command) and creates a
Takes a raw task description (the text after the command) and creates a properly structured GitHub issue on the board's repo.
/board-create-issue <raw task text>
gh (GitHub CLI) authenticated.--repo owner/repo, $BOARD_REPO, or the current repo./board-init once first.Parse the raw input. Everything after the command is the raw task. If a
--repo owner/repo is present, use it; otherwise use $BOARD_REPO or the
current repo (gh repo view). If no repo can be resolved, ask the user.
Analyze and structure. From the raw text, produce:
feat:, fix:, chore:, docs:, refactor:). Max ~70 chars.## Context — what/why, restating the raw intent in clear terms.## Acceptance criteria — a checklist (- [ ]) of concrete, testable
outcomes inferred from the task.## Notes — assumptions made, open questions, or scope boundaries.## Notes rather than guessing.Pick a status label. Default to inbox (new, untriaged). Use
ready ONLY if the task is unambiguous and immediately actionable. Never set
in-progress, needs-review, or done on creation. If genuinely blocked or
under-specified, use needs-info.
Create the issue. Pass the body via a temp file or heredoc to preserve markdown/newlines:
gh issue create --repo "$REPO" \
--title "<title>" \
--body-file <(printf '%s\n' "$BODY") \
--label "<status-label>"
Add extra non-status labels (e.g. enhancement, bug) when clearly implied,
but only if they already exist on the repo (gh label list).
Report. Print the created issue number, title, label, and URL. Suggest
/board-pull to refresh the local board.
board-config --get); default EN.board-init that mutates the remote repo. Confirm the resolved repo
before creating if there is any doubt about which repo is active.Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub kaiukov/claude-code-cmux-todo-plugin --plugin cmux-todo-board