Skip to content

REA Tool Design

Guides an agent in designing or changing REA investigation tools and their CLI/MCP contracts

Repository
morluto/rea
Stars
420,737
Licence
MIT
Files
1 file

What it does

This skill teaches an AI agent how to design or modify tools inside the REA project, which appears to be an investigation toolkit exposing commands through a CLI and MCP (Model Context Protocol) interface. Once installed, the agent consults the project's tool-design, testing and contributing guides, inspects the nearest existing tool, and returns a proposed boundary, input/result shape, evidence semantics, a nearest alternative, and a verification plan. It implements changes only when asked and within the user's stated scope.

Great for

  • Maintainers of the REA project adding or reshaping investigation tools
  • Contributors who need to change CLI or MCP contracts or provider capabilities without breaking consumers
  • Developers who want a reviewed design before writing code

Skip it if

  • People outside the REA codebase, since it relies on REA's own docs and file layout and is not a general tool-design guide (it would give little value elsewhere)
  • Ad hoc investigations that just need REA run, because this skill covers design and changes, not everyday use

Try asking

  • “Design a new tool that lists open ports for a target host, including its input and result shape”
  • “Propose how to change the Evidence semantics of an existing REA tool without breaking current MCP clients”
  • “Check whether a provider capability should be a new tool or an extension of the nearest existing one”
  • “Plan the tests and generated-file updates needed for a change to a CLI contract”
Step-by-step guide: how to use REA Tool DesignInstall, 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.

    rea-tool-design.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip rea-tool-design.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip rea-tool-design.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

  • Name the analyst question you want answered so the agent can find the closest existing tool to compare against
  • State whether you want a design only or implementation, since the skill asks the agent to preserve your authorization scope
  • Note that docs, source and live catalogs may differ; ask the agent to confirm which version it is reading

What's inside

  • SKILL.md

Redistributed unmodified from morluto/rea 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.