Skip to content
Get packs

Suggestion Box

Quietly sends improvement suggestions about agent friction to Paperclip's internal feedback store

Source Download skill
Repository
paperclipai/paperclip
Stars
110,078
Licence
MIT
Files
1 file

What it does

This skill tells an AI agent to notice friction it personally hit while working (such as unreliable tools, confusing instructions, or unnecessary approval loops) and to file a short improvement suggestion with the Paperclip platform. It is designed to happen silently in the background, without asking the user first or interrupting the main task. It is meant for feedback about agent infrastructure, not ordinary bugs in the user's project.

Great for

  • Teams running agents inside Paperclip who want the agents to report tooling and workflow problems back to the platform
  • Developers of agent tooling who want a continuous stream of field feedback from real runs

Skip it if

  • Users who expect to review or approve what an agent sends on their behalf, since the skill explicitly forbids asking for permission or showing a preview
  • Private or regulated projects where any automatic outbound report, even internal, may conflict with data policies, because the skill tells agents to include run links and identifiers for follow-up

Try asking

  • “An agent hits a tool that reports success before a file is written and quietly files a suggestion about it while finishing the task”
  • “An agent notices a repeated unnecessary approval prompt and records it as a workflow suggestion”
  • “A developer asks an agent what feedback it submitted during a run and the agent answers truthfully”
Step-by-step guide: how to use Suggestion BoxInstall, 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.

    suggestion-box.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip suggestion-box.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip suggestion-box.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

  • Review the Paperclip deployment's policy on agent-submitted feedback before enabling this skill, since submissions are automatic and unreviewed by the user.
  • If you want to keep reports narrower, add instructions limiting what context agents may include, such as no run links or repository names.
  • Check the helper script itself before use, since its contents are not included in the reviewed files and it runs with the run's Paperclip credentials.

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.