review-persona

Reviews current work using a selected expert persona from an agents/personas directory.

3|Updated Feb 15, 2025
One-click install
npx skills add https://github.com/mark-torres10/ai_tools --skill review-persona-mark-torres10
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-persona
Source: https://github.com/mark-torres10/ai_tools/tree/main/skills/review-persona
Command: npx skills add https://github.com/mark-torres10/ai_tools --skill review-persona-mark-torres10

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Getting useful feedback on code, architecture, or experiments often requires a domain expert's perspective, which is not always available. This Skill runs a structured review of your current work through the lens of a specialized persona defined in an agents/personas directory, producing severity-ordered findings. ## Core Features & Use Cases - Persona-Based Review: Reads a selected persona file and evaluates your changed files, tests, docs, and config against that persona's standards for correctness, architecture, performance, and observability. - Automatic Persona Routing: Resolves the ai_tools root, discovers personas under agents/personas/, and routes by task intent using router.md files when no persona is explicitly named. - Structured Findings Output: Returns the persona used, findings ordered by severity with impact and recommended fixes, open questions, and suggested next actions. - Use Case: After refactoring a data pipeline, ask for a review as a data engineering expert and receive concrete, evidence-based critique scoped to your actual changes. ## Quick Start Review my current changes as a backend architect persona and list the findings by severity.

Frequently Asked Questions about review-persona

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

FAQPage Schema
How do I get a persona-based code review of my current work?

Ask for a review as a specific persona or let the Skill route by task intent. It reads the persona file from agents/personas/, collects your changed files and related artifacts, then returns findings ordered by severity with recommended fixes.

How does persona selection work when I don't name one?

The Skill checks for router.md files under the personas tree and routes by task intent. If multiple personas fit, it selects up to two and explains why; if none match, it reports no strong match and asks whether to proceed.

Where does the Skill look for persona files?

It first checks for an ai_tools directory in the workspace root containing agents/personas/. If absent, it falls back to a canonical path at /Users/mark/Documents/projects/ai_tools/, and asks the user if neither location works.

What does the review output include?

The output lists the persona used and why, findings ordered by severity with impact and recommended fixes, open questions and assumptions, and suggested next actions. If no material issues exist, it states that and lists residual risks.

What are the limitations of persona-based review?

The review is constrained to capabilities actually defined in the persona file and to the user's current work and stated goal. It does not invent persona expertise, so coverage depends on the quality and scope of available persona definitions.