Design an effective human request
Purpose: Design clear notifications, durable questions, choices, and exact approval requests.
Use it when: Use when shaping a request, Inbox interaction, notification, or human approval prompt.
Install
Section titled “Install”Check out the published v0.6.2 tag of the Commentary Skills repository, then copy the complete skills/design-effective-interactions/ folder into the skills directory for your compatible SKILL.md agent. Preserve references and metadata. Restart or refresh the harness if it loads skills at startup.
Invoke
Section titled “Invoke”Copy this request into a compatible agent:
Use `design-effective-interactions` to improve this question: “Should we ship?” Make the needed decision, consequence, options, and response action clear while avoiding false urgency.Expected result: The agent returns a concise, actionable request design; it does not send the request.
Workflow
Section titled “Workflow”State who needs to act, what they must decide, the consequence and deadline if any, then choose the smallest interaction surface that preserves context.
Environment and limits
Section titled “Environment and limits”Read the published v0.6.2 SKILL.md and its referenced files for the exact transport, scopes, target, and environment settings; those instructions are authoritative for this skill. For transport setup, see CLI, MCP, and Developer access. Never store credentials in the skill folder or send them to a renderer. Design guidance does not authorize sending a message or creating an Interaction. Avoid manipulative urgency or vague approval requests.