create-issue-interaction-ui

Guides contributors through adding a new issue-thread interaction kind across shared contracts, server, UI, and SDK layers.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/nabitllc/todero --skill create-issue-interaction-ui-nabitllc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-issue-interaction-ui
Source: https://github.com/nabitllc/todero/tree/main/.agents/skills/create-issue-interaction-ui
Command: npx skills add https://github.com/nabitllc/todero --skill create-issue-interaction-ui-nabitllc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding a new issue-thread interaction kind to the Todero codebase touches four separate layers (shared contract, server service, UI card, and external helpers), and missing any one of them causes broken agent flows, drifted staleness logic, or 400 errors in production. This Skill gives contributors a proven, ordered playbook so nothing is skipped. ## Core Features & Use Cases - Layered implementation plan: Walks through the shared Zod contract, server service and routes, React card components, and CLI/MCP/plugin SDK helpers in the correct order. - Canonical prior art: Points to the checkbox confirmation rollout (commit 4d5322c82, PR #7649) as the reference diff and maps new kinds to the closest existing interaction pattern. - Invariants and anti-patterns: Codifies board-only resolution, company scoping, stale-target expiration, idempotency keys, and review-observed mistakes to avoid. - Use Case: A maintainer needs to add an in-thread approval card with target binding; they follow the checklist to land the shared types first, then wire the service, card, fixtures, Storybook, and agent guidance, and run the focused vitest set before review. ## Quick Start Ask the agent to add a new issue-thread interaction kind to the Todero repo following this skill, starting with the shared contract in packages/shared.

Frequently Asked Questions about create-issue-interaction-ui

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

FAQPage Schema
How do I add a new issue-thread interaction kind in Todero?

Start with the shared contract: add the kind constant, payload and result interfaces, and Zod validators in packages/shared. Then extend the server service and routes, build the UI card and fixtures, add CLI/MCP/plugin SDK helpers, and update the agent guidance docs.

Which existing interaction kind should I model a new card after?

Pick the closest of the four canonical kinds. Use request_confirmation for target-bound yes/no flows, request_checkbox_confirmation for bounded multi-select, ask_user_questions for structured forms, and suggest_tasks when the card produces creatable child entities.

When should I not create a new interaction kind?

Do not create a new kind when you are only adding fields to an existing interaction without a new payload schema; patch the existing validators and UI instead. Also avoid it for non-thread UI like sidebars or board widgets, which follow different component conventions.

Why does the UI vitest run fail with 'act is not a function'?

This failure means the shell is running with NODE_ENV=production, which loads React's production build. Re-run the focused test set with NODE_ENV=test explicitly set.

What server invariants must a new interaction kind enforce?

Resolution must be board-only with agent-authored accept or reject returning 403, all reads and writes must filter by companyId, stale targets must expire through the shared helper, and duplicate POSTs must honor the deterministic idempotency key.