Skill Feedback Collector

Pause the agent and wait for human feedback via a browser-based UI connected through WebSocket. Includes a task queue for batch execution of pre-loaded tasks.

When to Use

• After completing a task, to let the user verify the result
• When encountering uncertain parameters (colors, layouts, API choices, business logic)
• Before making destructive or irreversible changes that need user confirmation
• When the user prefers interactive confirmation over autonomous execution
• When batch-executing multiple pre-loaded tasks from the queue

Instructions

Follow these guidelines when this skill is active:

1. After completing a task, call

   ask_human_feedback

   with a summary and options for next steps. This lets the user decide what to do next rather than ending the session.

2. When unsure about implementation details, call

   ask_human_feedback

   with your question instead of making assumptions. Getting explicit input leads to better results.

3. The response from

   ask_human_feedback

   is your next instruction. Execute it, then call

   ask_human_feedback

   again when done. This creates a productive feedback loop.

4. If the task queue returns a task automatically (queue was non-empty), execute that task and call

   ask_human_feedback

   again when complete. The queue feeds tasks until empty.

5. Mode switching:

   • User says "free mode" / "自由模式" → call

     set_feedback_mode(enabled: false)

     to work without pausing
   • User says "feedback mode" / "确认模式" → call

     set_feedback_mode(enabled: true)

     to resume the confirmation loop

Best Practices

• Ask the user before ending a session — they may have more tasks
• Confirm before making destructive changes (force push, drop table, delete files)
• If feedback mode is disabled (bypass message returned), continue working autonomously

Tools

ask_human_feedback

Pauses execution and sends the

reason

Parameters:

reason

Example reason format:

Completed: [specific work done]
Changes: [files modified, endpoints added, etc.]

What would you like me to do next?
1. [Option A]
2. [Option B]
3. Something else

set_feedback_mode

Toggle feedback confirmation on/off. When off,

ask_human_feedback

Parameters:

enabled

Setup

npm install && npm run build

MCP configuration:

{
  "command": "node",
  "args": ["build/index.js"],
  "cwd": "/path/to/skill-feedback-collector"
}

Browser UI:

http://<server-ip>:18061

FEEDBACK_PORT

18061

FEEDBACK_TOKEN

Workflow

User message → Agent works → calls ask_human_feedback("Done. Next?")
                                    ↓
                    [Queue has tasks?] → YES → returns next task → Agent continues
                                    ↓ NO
                    [Waits for human input via browser UI]
                                    ↓
                    Human responds → Agent receives → works → calls ask_human_feedback again
                                    ↓
                    ... loop continues until user indicates they are done ...

Security

• Set

  FEEDBACK_TOKEN

  when deploying on shared or public networks to restrict access
• Use a firewall to limit which IPs can reach the HTTP/WebSocket port
• The server binds to

  0.0.0.0

  by default for convenience; restrict network access at the OS or firewall level if needed
• Conversation history (

  feedback-history.json

  ) is stored locally in the skill directory; review and rotate if it contains sensitive information
• This skill does not make outbound network requests, download external resources, or execute shell commands

Tips

• The task queue lets users pre-load multiple tasks for sequential execution
• Users can add tasks to the queue while the agent is working
• HTTP long-polling fallback activates automatically when WebSocket is unavailable
• Browser notifications and sound alerts notify you when the agent has a question
• Conversation history is persisted locally (max 500 entries)