reversa-researcher

Convert raw target audience data into structured personas with user journeys.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-researcher-afsjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-researcher
Source: https://github.com/afsjr/secretaria_escola_csm/tree/main/.agents/skills/reversa-researcher
Command: npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-researcher-afsjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turns a raw target audience into well-structured personas with clear journeys, so product decisions have a reliable human-centered foundation.

Core Features & Use Cases

  • Persona development: Converts “Público-alvo (bruto)” from ideation.md into 1–3 personas with consistent naming and structure.
  • Journey mapping: Produces a 5–7 step main journey per persona to guide PRD features and UX assumptions.
  • Workflow integration: Loads configuration and input from .reversa/state.json and <output_folder>/ideation.md, then writes <output_folder>/personas.md for downstream drafting.

Quick Start

Ask the AI to run reversa-researcher to create personas and journeys from ideation.md for use in the PRD.

Frequently Asked Questions about reversa-researcher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert raw target audience information into structured personas for product discovery?

To convert raw target audience information into structured personas, you need a tool that processes ideation inputs and generates user profiles with defined journeys. This Skill transforms raw audience data from an ideation file into 1 to 3 confirmed personas with 5 to 7 journey steps each.

What is the best way to generate user journeys for PRDs from initial ideation notes?

The best way to generate user journeys for PRDs is to extract problem and value metrics from ideation notes and map them to persona behaviors. This Skill creates a 5 to 7 step main journey per persona, providing a reliable human-centered foundation for downstream PRD drafting.

How does persona generation work when building product requirements from an ideation file?

Persona generation works by reading an ideation file containing raw audience details, problem statements, and delivered values. The system then iteratively confirms 1 to 3 personas and outputs a structured personas document with mandated formats for immediate product integration.

Can I use ideation notes to automatically create customer journey steps for multiple personas?

Yes, you can use ideation notes to automatically create customer journey steps for multiple personas. The Skill reads your ideation inputs and iteratively confirms up to 3 personas, mapping a 5 to 7 step journey for each one to guide UX assumptions and feature prioritization.

Do I need a specific state configuration file to generate personas from audience research?

Yes, you need a specific state configuration file to generate personas from audience research. The process requires reading a state.json file alongside your ideation document to correctly load configurations and output the finalized personas in the designated language format.

Why are my personas not generating correctly from the raw audience data in my ideation file?

Your personas may not generate correctly from raw audience data if your ideation file lacks the required fields. The system specifically looks for raw target audience, problem, and delivered value sections, and needs iterative confirmation to produce the mandated persona and journey output.