Outer Review

VerifiedCaution

Process external AI analyses commissioned by the human to extract tasks and reduce blind spots. It normalizes links, verifies claims against sources, and adds proper frontmatter. Use this after saving a raw external review to ensure independent perspective.

Sby Skills Guide Bot
ContentIntermediate
6/2/2026
Claude Code
#external-review#ai-analysis#blind-spot-reduction#content-validation

Recommended for

Automated summary

Processes an external AI analysis to extract actionable tasks and reduce blind spots.

Strengths

  • Reduces confirmation bias by leveraging different AI systems.
  • Automates link normalization and citation formatting.
  • Verifies claims by fetching original sources.
  • Structured integration of external feedback into the workflow.

Limitations

  • Requires manual commissioning and saving of the external review file.
  • Depends on the quality of the initial external analysis.
  • Can be time-consuming if many sources need verification.
When to use it

Use this skill after receiving an external analysis from a different AI system to validate and incorporate feedback into your project.

When not to use it

Do not use if the external analysis is already integrated or if source verification is unnecessary.

Security analysis

Caution
Quality score88/100

The skill instructs the agent to run a Python script via uv with a wildcard, and to fetch external URLs using WebFetch. While these are for legitimate purposes (link normalization and claim verification), they carry some risk if the input or environment is compromised. The skill does not include destructive or exfiltrating commands, but the tool usage warrants caution.

Findings
  • •Instructs execution of a bash command with a wildcard pattern (uv run python scripts/normalize_review_links.py obsidian/reviews/outer-review-YYYY-MM-DD-*.md), which could match unintended files if the environment is not controlled.
  • •Uses WebFetch to retrieve external URLs from the review file, which could be exploited if the review file contains malicious links (SSRF risk).
How this analysis is made

Examples

Process ChatGPT outer review
/outer-review obsidian/reviews/outer-review-2026-01-15-site-chatgpt-5-2-pro.md
Process Gemini outer review
/outer-review obsidian/reviews/outer-review-2026-02-10-site-gemini-1-5-pro.md

name: outer-review description: Commission and process external AI analysis to reduce blind spots. Manual invocation only.

Outer Review

Process an external AI review to extract actionable tasks. The human commissions the external review and saves the raw output; this skill processes it.

When to Use

  • When /outer-review [filepath] is invoked with a new outer review file
  • After a human has commissioned and saved an external AI analysis

Why External Review Matters

The Unfinishable Map's content is primarily generated and reviewed by Claude-based systems. This creates risk of:

  • Confirmation bias: The reviewing system shares assumptions with the generating system
  • Blind spot persistence: Gaps in Claude's knowledge propagate undetected
  • Style homogenization: Content converges toward patterns Claude favors
  • Coherence inflation: Arguments seem stronger than they are because the reviewer finds them compelling for the same reasons the writer did

External AI systems (GPT-4+, Gemini, etc.) have different training, different biases, and different blind spots. Their disagreements are informative even when wrong.

Prerequisites

The human must:

  1. Commission a review from an external AI system (ChatGPT, Gemini, etc.)
  2. Save the raw output to obsidian/reviews/outer-review-YYYY-MM-DD-[system-slug].md
  3. Add basic frontmatter (or leave for this skill to add)

Instructions

1. Read the Review File

The filepath is provided as an argument: /outer-review obsidian/reviews/outer-review-2026-01-15-site-chatgpt-5-2-pro.md

Read the file and assess its current state.

2. Add/Fix Frontmatter

Ensure the file has proper frontmatter:

---
title: "Outer Review - [System Name]"
created: YYYY-MM-DD
modified: YYYY-MM-DD
human_modified: null
ai_modified: YYYY-MM-DDTHH:MM:SS+00:00
draft: false
topics: []
concepts: []
related_articles:
  - "[[project]]"
ai_contribution: 90
author: [Human who commissioned it]
ai_system: [external-system-id]
ai_generated_date: YYYY-MM-DD
last_curated: null
---

**Date**: YYYY-MM-DD
**Reviewer**: [System name and version]
**Type**: Outer review (external AI analysis)

## About This Review

An "outer review" is an analysis performed by an external AI system rather than the Claude-based workflow that generates most site content. This provides an independent perspective, reducing the risk of self-reinforcing blind spots.

[External system's review content follows...]

3. Normalize Links

External AI systems often produce footnote-style markdown links like ([Source][1]) with reference definitions at the end. Run the link normalization script:

uv run python scripts/normalize_review_links.py obsidian/reviews/outer-review-YYYY-MM-DD-*.md

This script:

  • Removes self-references to unfinishablemap.org (just noise)
  • Converts external footnote refs to inline links like (See [Chalmers](url))
  • Adds an "External Sources" section with properly labeled academic references
  • Preserves inline links that are already well-formatted

Also convert any Map URLs to internal wikilinks:

  • https://unfinishablemap.org/tenets/ → [[tenets]]
  • https://unfinishablemap.org/topics/free-will/ → [[free-will]]
  • https://unfinishablemap.org/concepts/qualia/ → [[qualia]]

4. Verify Claims Against Sources

External AI reviewers can also be wrong. Before accepting criticism, verify key claims by fetching the cited sources.

For each significant claim the reviewer makes about what an author says:

  1. Identify the source: Look for URLs in the External Sources section or inline citations
  2. Fetch the source: Use WebFetch to retrieve the actual paper/article
  3. Check the claim: Does the source actually say what the reviewer claims?

What to verify:

  • Direct quotes or paraphrases of philosophers' positions
  • Claims about what a paper "explicitly states" or "clearly shows"
  • Attributions of specific arguments or frameworks to specific authors
  • Claims that the Map misrepresents a source

Add verification notes to the review file:

After verifying, add a ## Verification Notes section to the review file documenting what you checked:

## Verification Notes

**Verified claims:**
- ✓ Reviewer correctly notes that Chalmers treats organizational invariance as contingent, not necessary (confirmed in "Absent Qualia" paper)
- ✓ Five constraints framework is indeed from Saad (2025), not Chalmers & McQueen

**Unverified claims:**
- ? Could not access Springer PDF to confirm Saad's exact formulation

**Disputed claims:**
- ✗ Reviewer says Chalmers "explicitly endorses" Many-Worlds—but the cited passage says "considerable sympathy," which is weaker than endorsement

This prevents blindly accepting external criticism that may itself be inaccurate.

5. Evaluate Review Quality

Read through the review and categorize findings, taking verification results into account:

High value findings (verified or plausible):

  • Logical gaps not previously noticed
  • Counterarguments not addressed
  • Inconsistencies between pages
  • Missing connections that should exist
  • Novel framings of existing positions
  • Misattributions confirmed by source checking

Lower value findings:

  • Objections already addressed elsewhere
  • Misunderstandings of the position
  • Requests to adopt a different position entirely
  • Style preferences that don't affect clarity
  • Claims that failed verification (the reviewer was wrong)

6. Generate Tasks

For high-value findings, create tasks in obsidian/workflow/todo.md:

### P1: [Specific issue from outer review]
- **Type**: [research-topic | expand-topic | refine-draft | cross-review]
- **Notes**: From outer review YYYY-MM-DD. [Brief description of the issue and why it matters]
- **Review file**: `reviews/outer-review-YYYY-MM-DD-[slug].md`
- **Source**: outer-review
- **Generated**: YYYY-MM-DD

Important: Always include the Review file field with the path to the outer review. This allows the refine-draft skill to read the full context and verification notes when addressing the issue.

Priority guidance:

  • P1: Logical errors, internal contradictions, unaddressed strong objections
  • P2: Missing connections, expansion opportunities, clarity improvements
  • P3: Style suggestions, minor enhancements

7. Log to Changelog

Append to obsidian/workflow/changelog.md:

### HH:MM - outer-review
- **Status**: Success
- **Reviewer**: [System name]
- **File**: [filepath]
- **Claims verified**: [count]
- **High-value findings**: [count]
- **Tasks generated**: [count with priorities]

8. Commit

Create a git commit:

feat(auto): outer-review - process [system name] analysis

- Identified [N] actionable issues
- Generated [N] tasks (P1: X, P2: Y, P3: Z)

Evaluating Impact (After Tasks Complete)

After tasks from an outer review have been completed, evaluate the review's value:

  1. Count completed tasks: How many issues were addressed?
  2. Assess depth: Did the review surface deep insights or obvious issues?
  3. Track new content: What articles/sections resulted from the review?
  4. Note patterns: What kinds of issues does this external system catch that internal review misses?

This helps calibrate future review frequency and system selection.

Important

  • This skill requires manual invocation with a filepath argument
  • The human commissions and saves the external review; this skill processes it
  • External systems may have different biases—their criticism isn't automatically correct
  • The goal is diverse perspective, not consensus
  • Some external criticism will be based on misunderstanding—that's expected
  • Focus on actionable findings that improve content quality

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/outer-review-mm5t8bxm/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/outer-review-mm5t8bxm' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/outer-review-mm5t8bxm/download' --output '.skill-downloads/outer-review-mm5t8bxm/SKILL.md.part' && mv '.skill-downloads/outer-review-mm5t8bxm/SKILL.md.part' '.skill-downloads/outer-review-mm5t8bxm/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

Original excerpt: Prerequisites

The human must:

  1. Commission a review from an external AI system (ChatGPT, Gemini, etc.)
  2. Save the raw output to obsidian/reviews/outer-review-YYYY-MM-DD-[system-slug].md
  3. Add basic frontmatter (or leave for this skill to add)

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

After inspection, copy the complete folder into your project using one of the commands below, then open a new tool session. The command stops if a folder with the same name already exists: compare the files before replacing it.

Claude Code
test -f '.skill-downloads/outer-review-mm5t8bxm/SKILL.md' && test -s '.skill-downloads/outer-review-mm5t8bxm/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/outer-review' && cp -R '.skill-downloads/outer-review-mm5t8bxm' '.claude/skills/outer-review'

OpenSkills

OpenSkills must already be installed. The local install/read procedure is checked with OpenSkills 1.5.0, which requires Node.js ≥ 20.6.0. Catalog slugs are not resolved automatically.

Official OpenSkills installation
openskills install './.skill-downloads/outer-review-mm5t8bxm'

openskills read 'outer-review-mm5t8bxm'

Reading should display the installed file content and its base directory. It does not run the skill or install its dependencies.

For an agent that reads AGENTS.md, then sync the index. This command changes AGENTS.md: review the diff before using it.

openskills sync

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/outer-review-mm5t8bxm/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills