Menu
Aggregate multi-reviewer feedback into consolidated, prioritized, and actionable recommendations
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/jmagly/aiwg --skill review-synthesisThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Based on SOC occupation classification
Showing SKILL.md
| namespace | aiwg |
| name | review-synthesis |
| platforms | ["all"] |
| description | Aggregate multi-reviewer feedback into consolidated, prioritized, and actionable recommendations |
Aggregate multi-reviewer feedback into consolidated, actionable recommendations.
Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):
This skill aggregates feedback from multiple reviewers into cohesive, prioritized recommendations by:
When triggered, this skill:
Collects review inputs:
Categorizes feedback:
Identifies patterns:
Resolves conflicts:
Prioritizes actions:
Generates synthesis:
content_feedback:
sources:
- content-writer
- editor
- copywriter
- content-strategist
aspects:
- messaging_clarity
- value_proposition
- tone_voice
- cta_effectiveness
- audience_alignment
weight: high
priority_in_conflict: medium
brand_feedback:
sources:
- brand-guardian
- creative-director
- art-director
aspects:
- visual_identity
- verbal_identity
- brand_consistency
- guideline_compliance
weight: high
priority_in_conflict: high
technical_feedback:
sources:
- quality-controller
- production-coordinator
- technical-marketing-writer
aspects:
- specifications
- file_formats
- rendering_quality
- platform_compatibility
weight: medium
priority_in_conflict: high_for_blocking
legal_feedback:
sources:
- legal-reviewer
- legal-liaison
aspects:
- claims_substantiation
- disclosures
- trademark_usage
- regulatory_compliance
weight: critical
priority_in_conflict: highest
strategic_feedback:
sources:
- campaign-strategist
- marketing-analyst
- positioning-specialist
aspects:
- campaign_alignment
- competitive_positioning
- market_fit
- kpi_potential
weight: medium
priority_in_conflict: medium
conflict_resolution:
priority_order:
1: legal_compliance # Always wins
2: brand_guidelines # Strong preference
3: technical_requirements # If blocking
4: strategic_alignment # Business logic
5: content_preference # Style choices
6: design_preference # Aesthetic choices
escalation_triggers:
- legal_vs_brand
- strategy_vs_brand
- multiple_blockers
- no_clear_winner
resolution_methods:
consensus: Majority agreement (3+ reviewers)
expertise: Defer to domain expert
priority: Apply priority hierarchy
escalate: Flag for stakeholder decision
conflict_types:
direct_contradiction:
description: Reviewer A says X, Reviewer B says not-X
resolution: Apply priority hierarchy
documentation: Required
style_preference:
description: Different aesthetic preferences
resolution: Defer to brand/creative director
documentation: Optional
scope_disagreement:
description: Disagree on what needs changing
resolution: Defer to strategic alignment
documentation: Required
priority_disagreement:
description: Agree on issue, disagree on severity
resolution: Take higher severity
documentation:
# Review Synthesis Report
**Asset**: Q1 Product Launch Campaign - Landing Page
**Reviews Collected**: 6
**Date**: 2025-12-08
**Synthesizer**: review-synthesis skill
## Executive Summary
| Metric | Count |
|--------|-------|
| Total Comments | 47 |
| Consensus Items | 28 |
| Conflicts Resolved | 8 |
| Escalations Needed | 2 |
| Blocking Issues | 3 |
| Major Issues | 12 |
| Minor Issues | 25 |
| Suggestions | 7 |
**Overall Assessment**: Asset requires revisions before approval.
## Reviewer Participation
| Reviewer | Role | Comments | Focus Areas |
|----------|------|----------|-------------|
| Sarah Chen | Brand Guardian | 12 | Visual identity, logo usage |
| Marcus Johnson | Editor | 8 | Copy clarity, grammar |
| Elena Rodriguez | Legal Reviewer | 5 | Claims, disclosures |
| David Kim | Campaign Strategist | 10 | Messaging, positioning |
| Amy Liu | Quality Controller | 7 | Technical specs |
| James Wilson | Creative Director | 5 | Overall creative |
## Consensus Items (High Confidence)
### 1. Hero Headline Needs Strengthening
- **Reviewers**: Sarah, Marcus, David (3/6 = consensus)
- **Current**: "Introducing Our New Product"
- **Issue**: Generic, doesn't communicate value
- **Recommendation**: "Cut Your Workflow Time in Half"
- **Priority**: High
- **Effort**: Low (copy change only)
### 2. CTA Button Color
- **Reviewers**: Sarah, Amy, James (3/6 = consensus)
- **Current**: Light gray (#CCCCCC)
- **Issue**: Low contrast, doesn't stand out
- **Recommendation**: Brand green (#00AA55)
- **Priority**: High
- **Effort**: Low
: Elena (legal = authoritative)
: Form collects email without privacy notice
: Add privacy policy link
: Blocking
: Low
(Sarah, Brand Guardian): Use lifestyle photography
(James, Creative Director): Use product-only shots
: Lifestyle photography
: Brand guidelines specify lifestyle imagery for hero sections
: Brand guidelines (priority 2)
(Marcus, Editor): Professional, formal tone
(David, Strategist): Casual, conversational tone
: Professional with conversational elements
: Hybrid approach matches brand voice profile (Friendly Professional)
: Brand alignment via voice profile
(David, Strategist): Show all 10 features
(Sarah, Brand Guardian): Limit to top 5
: Top 5 features with "See all features" link
: Balances completeness with visual clarity
: Consensus via compromise
: Whether to show pricing on landing page
(David): Show pricing for transparency
(Marcus): Hide pricing, focus on value
: Strategic decision beyond reviewer authority
: Marketing Director
: Before final approval
: Include comparison chart with competitors?
(David): Yes, differentiates product
(Elena): Risk of legal issues without substantiation
: Legal/strategy conflict
: Marketing Director + Legal
: Before final approval
| # | Item | Owner | Effort | Source |
|---|------|-------|--------|--------|
| 1 | Add privacy disclosure | Legal | 15 min | Elena |
| 2 | Fix contrast ratio on CTA | Design | 10 min | Consensus |
| 3 | Add alt text to images | Tech | 20 min | Amy |
| # | Item | Owner | Effort | Source |
|---|------|-------|--------|--------|
| 4 | Revise hero headline | Copy | 30 min | Consensus |
| 5 | Update product image style | Design | 2 hrs | Conflict resolution |
| 6 | Add feature limit with "more" link | Dev | 1 hr | Conflict resolution |
| # | Item | Owner | Effort | Source |
|---|------|-------|--------|--------|
| 7 | Tighten body copy | Copy | 45 min | Marcus |
| 8 | Adjust mobile spacing | Dev | 30 min | Amy |
| 9 | Update testimonial format | Design | 1 hr | Sarah |
| # | Item | Owner | Effort | Source |
|---|------|-------|--------|--------|
| 10 | Consider A/B test on CTA copy | Strategy | - | David |
| 11 | Add social proof counter | Dev | 2 hrs | James |
| 12 | Optimize image file sizes | Tech | 30 min | Amy |
: 12 action items
: 8.5 hours
: 3 (must fix before approval)
: 2 (need stakeholder decision)
[ ] Complete blocking fixes (3 items)
[ ] Resolve escalations with Marketing Director
[ ] Complete high-priority items (3 items)
[ ] Re-review by Brand Guardian
[ ] Legal sign-off (if escalation resolved)
[ ] Final approval
[Full feedback text...]
[Full feedback text...]
[etc.]
User: "Synthesize reviews for the landing page"
Skill processes:
1. Collect reviews from .aiwg/marketing/reviews/landing-page/
2. Parse 47 total comments
3. Categorize by type and severity
4. Identify 28 consensus items
5. Resolve 8 conflicts
6. Flag 2 escalations
7. Generate prioritized action list
Output:
"Review Synthesis Complete
6 reviewers, 47 comments analyzed:
- Consensus items: 28
- Conflicts resolved: 8
- Escalations needed: 2
Blocking Issues (3):
1. Missing privacy disclosure
2. CTA contrast ratio
3. Missing alt text
Key Conflicts Resolved:
- Image style: Lifestyle (brand guidelines win)
- Headline tone: Professional with conversational elements
Report: .aiwg/marketing/synthesis/landing-page-synthesis.md"
User: "What conflicts exist in the reviews?"
Skill identifies:
- Direct contradictions
- Style disagreements
- Priority conflicts
Output:
"8 Conflicts Found:
Resolved (6):
1. Image style (lifestyle vs product-only) → Lifestyle
2. Headline tone (formal vs casual) → Hybrid
3. Feature count (10 vs 5) → 5 with link
Needs Escalation (2):
1. Pricing display - strategic decision
2. Competitor comparison - legal concern
See full rationale in synthesis report."
User: "Summarize all feedback"
Skill generates:
- Comment counts
- Key themes
- Top action items
Output:
"Review Summary:
Top 3 Themes:
1. CTA needs more visibility (4 reviewers)
2. Hero messaging too generic (3 reviewers)
3. Legal disclosures missing (blocker)
Estimated Revision Effort: 8.5 hours
Blocking Items: 3
Approval ETA: After escalation decisions"
This skill uses:
parallel-dispatch: Launch multiple reviewersartifact-metadata: Track review statusproject-awareness: Context for priority decisionssynthesis_workflow:
input_agents:
- brand-guardian
- editor
- legal-reviewer
- campaign-strategist
- quality-controller
- creative-director
synthesis_agent: documentation-synthesizer
escalation_path:
- marketing-project-manager
- creative-director
- legal-liaison
synthesis_config:
consensus_threshold: 3 # reviewers for consensus
auto_resolve_style: true # resolve style conflicts automatically
escalation_timeout: 48h # escalate if no decision
priority_weights:
legal: 100
brand: 80
technical_blocking: 75
strategic: 60
content: 50
design: 40
output_config:
include_raw_feedback: true
anonymize_reviewers: false
generate_action_tickets: true
notify_escalation_owners: true
.aiwg/marketing/synthesis/{asset}-synthesis.md.aiwg/marketing/synthesis/{asset}-actions.json.aiwg/marketing/escalations/.aiwg/marketing/reviews/{asset}/