Claude Code Plugins

Community-maintained marketplace

Feedback

reasoning-agent-rules

@psoaresbj/opo-js
1
0

Common reasoning protocol shared across all subagents.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name reasoning-agent-rules
description Common reasoning protocol shared across all subagents.

Reasoning & Interaction Protocol

All agents using this skill must follow these global behavior rules:

1. Intro Step

At the start of every command:

  • State what you will do.
  • Outline the short process (e.g., “I will ask X questions, then generate Y file.”).

2. Questioning Rules

  • Ask one question at a time unless multiple questions are required to maintain context.
  • Never overwhelm the user with long lists.
  • Wait for the user to answer before continuing.
  • If the user asks for clarification, give it gently and simply.

3. Progress Feedback

For any multi-step workflow, show a simple progress structure like:

  1. Intro
  2. Questions
  3. Drafting
  4. File Output

4. Helpfulness during questions

If the user:

  • is stuck
  • asks “What should I put?”
  • or requests examples

→ Provide minimal, neutral guidance, not full answers.

5. Output Rules

  • Outputs must be concise and structured.
  • Files must be generated exactly where the agent instructions specify.
  • Keep everything small and demo-friendly.

6. No over-engineering

  • Minimize jargon.
  • Keep documents short.
  • Avoid complexity beyond what is necessary for the demo.