Skip to content

Create Issue Interaction UI

Guides a Paperclip contributor through adding a new issue-thread interaction card type end to end.

Stars
110,078
Licence
MIT
Files
1 file

What it does

This is a developer guide for contributors who change the Paperclip codebase itself. When installed, the agent gets a step-by-step checklist for adding a new kind of interactive card to issue threads, covering the shared type and validator code, the server service and routes, the UI components and tests, and the channel and helper docs. It points to an existing example change to copy and lists invariants such as bounded option lists, resolver authority, and company scoping. It does not change how Paperclip agents run in a deployed company.

Great for

  • Paperclip maintainers adding a new interaction kind such as a new confirmation or form card
  • Coding agents making changes inside the paperclipai/paperclip repository

Skip it if

  • Production Paperclip agents, because the file itself says not to install it there and it is aimed at repository changes, not operations
  • Changing how agents call existing interactions, which the guide says belongs in skills/paperclip instead
  • Building non-thread UI such as sidebars or project board widgets, which the guide says follows other conventions

Try asking

  • “Add a new ranked-choice interaction kind to issue threads following the existing checkbox confirmation pattern”
  • “Extend the suggest_tasks interaction with a new variant that has a different payload shape”
  • “Walk me through the order of changes needed to add a new Zod validator and UI card for issue interactions”
Step-by-step guide: how to use Create Issue Interaction UIInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    create-issue-interaction-ui.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip create-issue-interaction-ui.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip create-issue-interaction-ui.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Read the referenced checkbox confirmation commit first, since the guide treats it as the template.
  • Start with the shared contract layer, which the guide says should land first and be the smallest correct change.
  • Pick the closest existing interaction kind and reuse its plumbing rather than inventing new mechanics.

What's inside

  • SKILL.md

Redistributed unmodified from paperclipai/paperclip under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.