Rea Tool Design

morluto/rea/.agents/skills/rea-tool-design

by morlutob2f3dc81fa503c2b9ff0d8625336ed2e74d1e829No license472K starsListed Oct 14, 2026Updated Nov 10, 2026Repository updated today

Audit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.

AI-generated overview

Guides auditing, investigating, designing or changing REA investigation tools, CLI/MCP contracts, provider capabilities and Evidence semantics.

What it does
Provides a procedure for auditing existing REA tools and for proposing new ones: scope representative tasks, exercise the live workflow, and separate reproduced bugs, supported limitations, design opportunities and unverified claims. For design requests it returns a proposed tool boundary, input/result shape, Evidence semantics, nearest alternative and verification approach, implementing only when asked. It also covers provider-backed workflow verification, wording audits and agent trials using the repository's own evaluation tooling.
When to use it
Use when auditing or redesigning REA investigation tools, CLI or MCP contracts, provider capabilities or Evidence semantics, or when running tool-description wording audits and agent trials. Also relevant when implementing or verifying changes to those contracts.
Requirements
Relies on the repository's documentation (tool-design, testing, client-verification guides and CONTRIBUTING) and its evaluation tooling; provider-backed work needs access to REA and provider environments. Ships no scripts.

REA tool design

Use the tool-design guide for tool boundaries, contract semantics, provider ownership, and discoverability. Inspect the current contract and nearest existing tool relevant to the analyst question; source, documentation, and live catalogs may describe different versions.

For provider-backed work, exercise the analyst's task through REA and compare relevant native provider and independent artifact observations where available. Check applicable partial results, recovery and session boundaries; report what was not exercised. For failure guidance, follow design recovery around the failure. Use workflow verification to select evidence for the proposed contract instead of seeking provider API parity.

For an audit, follow audit existing tools: scope representative tasks, exercise the live workflow, and distinguish reproduced bugs, supported limitations, design opportunities and unverified claims. Check relevant rendered MCP prompts, guided workflows and packaged skill advice against the live contracts and exercise their suggested handoffs. Report working alternatives and evidence limits as well as findings.

For wording audits and agent trials, use focused tool-description trials. Start with representative workflow boundaries and repeat failures or ambiguous outcomes; keep actual arguments and supported final claims separate. Reuse the repository's evaluation tooling and report actual runtime/model versions and synthetic versus production coverage rather than copying a harness into a skill.

For a design request, return the proposed boundary, input/result shape, Evidence semantics, nearest alternative, and verification approach. Implement when requested, preserving the user's scope and existing authorization.

For implementation or verification, consult testing for the affected consumer and provider lanes, and contributing for generated-file ownership. Read provider/workflow guides only as the task requires.

Source and attribution

Source:morluto/reain.agents/skills/rea-tool-designat commitb2f3dc8

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Add a badge to your README

Show readers this skill is listed on SourceWeft. The badge links to this page.

Preview of the “Listed on SourceWeft” badge
[![Listed on SourceWeft](https://sourceweft.com/badge/skills/gh-morluto-rea-rea-tool-design-agents-skills-rea-tool-design-de314d97d7c44ad5.svg)](https://sourceweft.com/skills/gh-morluto-rea-rea-tool-design-agents-skills-rea-tool-design-de314d97d7c44ad5?utm_source=readme&utm_medium=badge)

Report or request removal