advise

Apply configurable advisor personas to specs, diffs, and ticket plans.

Updated May 3, 2026
One-click install
npx skills add https://github.com/icarloscornejo/doer --skill advise-icarloscornejo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: advise
Source: https://github.com/icarloscornejo/doer/tree/main/skills/advise
Command: npx skills add https://github.com/icarloscornejo/doer --skill advise-icarloscornejo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The advise skill enables teams to apply configurable advisor personas (security, performance, mobile, accessibility, API) to specifications, acceptance criteria, diffs, or plain text, surfacing targeted insights before implementation.

Core Features & Use Cases

  • Run one or more advisor personas against a target such as a file, a diff, a Jira/issue ticket plan, or ad-hoc text, returning structured findings grouped by severity.
  • Personas are defined as JSON files under lib/advisor-personas/, allowing new review domains to be added without modifying the skill code.
  • Use /wk:advise --list to discover available personas and use --persona or --personas to run reviews. Outputs can be written to disk for ticket targets.

Quick Start

Run a security review on the current diff.

Frequently Asked Questions about advise

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

FAQPage Schema
How do I run an automated advisor review on a git diff?

You can run an automated advisor review on a git diff by applying configurable advisor personas to the diff target, which surfaces targeted qualitative findings grouped by severity. The skill supports running single or parallel persona dispatches directly against your changes.

What are advisor personas and how do they work for spec reviews?

Advisor personas are JSON configuration files stored under lib/advisor-personas/ that represent specific review domains like security, performance, or accessibility. They work by applying their defined rules to specifications and diffs to surface targeted qualitative findings before implementation begins.

Can I add custom review domains without modifying the skill code?

Yes, you can add custom review domains by creating new JSON files under lib/advisor-personas/ without modifying the existing skill code. This extensibility allows you to define new advisor personas for specialized qualitative reviews of your specs and diffs.

How do I list available personas for ticket plan reviews?

You can list available personas for ticket plan reviews by running the command /wk:advise --list. This discovers all configured advisor personas available to apply against your ticket targets, files, or ad-hoc text for qualitative analysis.

Does the advisor review output structured findings for ticket targets?

Yes, the advisor review outputs structured findings in JSON format and can write results directly to disk for ticket targets. This supports automated processing and optional aggregation of qualitative findings from single or parallel persona dispatches.

What is the best way to review specs for security and accessibility issues?

The best way to review specs for security and accessibility issues is to apply dedicated advisor personas to the specification text. This surfaces targeted qualitative findings grouped by severity before implementation, ensuring all review domains are covered in parallel.