Agent skill

Phg Argument Synthesis

by brycewang-stanford in brycewang-stanford/Awesome-Journal-Skills

A skill your agent uses when turning a mapped literature into one cumulative argument for a Progress in Human Geography (PiHG) review essay — synthesizing many sources into a claim the field could…

MITAuto-check passedMarketing & SEO

Install Phg Argument Synthesis

skills CLI
$ npx skills add brycewang-stanford/Awesome-Journal-Skills --skill phg-argument-synthesis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install brycewang-stanford/Awesome-Journal-Skills phg-argument-synthesis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/brycewang-stanford/Awesome-Journal-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Progress-in-Human-Geography-Skills/skills/phg-argument-synthesis .claude/skills/phg-argument-synthesis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
phg-argument-synthesis
GitHub stars
1.2k
Token cost
~1.2k tokens
SKILL.md length
565 words
Files
1
Skills in repo
2,387
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when turning a mapped literature into one cumulative argument for a Progress in Human Geography (PiHG) review essay — synthesizing many sources into a claim the field could…

  • Works in 5 steps: State the thesis in one sentence. The… → Decompose the thesis into 3–5… → Under each sub-claim, marshal the… → …
  • Tasks that involve Positioning and messaging
  • SKILL.md covers When to trigger, Summary vs. synthesis (the…, Build the cumulative spine and The "one sentence" and "adds…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Phg Argument Synthesis is an agent skill from brycewang-stanford/Awesome-Journal-Skills. Use when turning a mapped literature into one cumulative argument for a Progress in Human Geography (PiHG) review essay — synthesizing many sources into a claim the field could not see from any one of them. Builds the synthetic spine; it does not gather sources (see phg-literature-positioning) or make the critical turn (see phg-critical-intervention).

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Positioning and messaging and Essays and academic help. The repository describes itself as: Journal-specific Claude Code/Codex skill packs covering mainstream journals — AER, QJE, Nature, Cell, 管理世界, 经济研究 & 200+ more — your fast track to getting published. | 覆盖主流期刊的… The licence is MIT.

When your agent uses it

  • Tasks that involve Positioning and messaging
  • Tasks that involve Essays and academic help

Example prompts

  • “/phg-argument-synthesis”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. State the thesis in one sentence. The whole essay is the defense of this claim. If you cannot, go
  2. Decompose the thesis into 3–5 sub-claims. These become the sections — organized by argument, not
  3. Under each sub-claim, marshal the evidence from across the corpus: which works support it, which
  4. Make the sources talk to each other. Put works that never cite each other into the same paragraph
  5. Handle disconfirming work honestly — a synthesis that ignores contrary evidence is advocacy, not a

What it can do on your machine

Read from SKILL.md and the folder at commit 932eb23. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Phg Argument Synthesis loads about 1.2k tokens when it runs. Until then it costs about 94 tokens; SKILL.md has 565 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~94
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from brycewang-stanford/Awesome-Journal-Skills at commit 932eb23, republished under its MIT licence (© brycewang-stanford). 565 words, ~1,204 tokens.

Download SKILL.mdSave it as .claude/skills/phg-argument-synthesis/SKILL.md (or your agent's skills folder).
name
phg-argument-synthesis
description
Use when turning a mapped literature into one cumulative argument for a Progress in Human Geography (PiHG) review essay — synthesizing many sources into a claim the field could not see from any one of them. Builds the synthetic spine; it does not gather sources (see phg-literature-positioning) or make the critical turn (see phg-critical-intervention).

Argument Synthesis (phg-argument-synthesis)

The single most important craft in a PiHG essay: synthesis. A review is not an ordered summary of what others found; it is an argument the sources add up to but none of them made alone. Reviewers and editors reject "annotated bibliography" pieces on sight. This skill turns a mapped literature (phg-literature-positioning) into a cumulative claim organized by your concept (phg-theory-building).

When to trigger

  • You have the corpus and the concept, and must now build the spine
  • The draft reads as "A found X, B found Y, C found Z" — a list, not an argument
  • A reviewer said "this is descriptive," "where is the argument?," or "just a summary"
  • You cannot state the essay's thesis in one sentence

Summary vs. synthesis (the core distinction)

Summary (reject)Synthesis (PiHG)
Organized by source (paper by paper)Organized by your concept / claim
"X studied A; Y studied B""Across X and Y, the field has assumed Z — which fails because…"
Coverage is the goalAn argument is the goal; coverage serves it
Reader learns what existsReader learns how to think about the field

If a paragraph's topic sentence names an author rather than an idea, you are summarizing. Rewrite so ideas are the subjects and sources are the evidence.

Build the cumulative spine

  1. State the thesis in one sentence. The whole essay is the defense of this claim. If you cannot, go back to phg-critical-intervention.
  2. Decompose the thesis into 3–5 sub-claims. These become the sections — organized by argument, not by the literature's own buckets.
  3. Under each sub-claim, marshal the evidence from across the corpus: which works support it, which complicate it, and how they combine into the point.
  4. Make the sources talk to each other. Put works that never cite each other into the same paragraph when your concept shows they are addressing the same relation.
  5. Handle disconfirming work honestly — a synthesis that ignores contrary evidence is advocacy, not a review. Fold it in and show why the thesis survives (or scope it).
Show full SKILL.md (226 more words)Show less

The "one sentence" and "adds up" tests

  • One-sentence test: can you say what the essay argues (not covers) in a sentence? If not, there is no spine yet.
  • Adds-up test: does the conclusion state something no single cited work says? A review whose conclusion is already in one of its sources has synthesized nothing.

Reconcile, periodize, or adjudicate

Three reliable synthetic structures (pick the one your literature needs):

  • Reconcile — show two camps that talk past each other are compatible under your concept.
  • Periodize — narrate how the field's thinking moved through phases, to intervene in the next.
  • Adjudicate — weigh a live disagreement and argue which side the evidence, read together, favors.

Checklist

  • Thesis stated in one sentence; essay is its defense
  • Sections organized by sub-claims, not by the literature's buckets or by source
  • Paragraph topic sentences name ideas, not authors
  • Works that never cite each other are brought into contact where the concept links them
  • Disconfirming evidence engaged, not ignored
  • Conclusion states something no single source states (adds-up test)

Anti-patterns

  • Annotated-bibliography structure (one paragraph per paper)
  • Topic sentences that start with an author's name
  • "Coverage" mistaken for contribution — comprehensive but argument-free
  • Cherry-picking supportive work and dropping the inconvenient
  • A conclusion that merely restates the most-cited paper's point

Output format

【Thesis】the one-sentence claim the essay defends
【Sub-claims】the 3–5 argument-sections
【Synthetic structure】reconcile / periodize / adjudicate
【Sources in contact】which non-citing works your concept joins
【Adds-up?】does the conclusion exceed any single source? [Y/N]
【Next】phg-critical-intervention

Supplementary resources

© brycewang-stanford, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in Progress-in-Human-Geography-Skills/skills/phg-argument-synthesis of brycewang-stanford/Awesome-Journal-Skills.

Open the folder on GitHubat commit 932eb23

Compare with similar skills

Phg Argument Synthesis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Phg Argument Synthesis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Phg Argument Synthesis this skillbrycewang-stanford/Awesome-Journal-Skills1.2k—~1.2kAutomated safety check: PassMIT
Mind Literature Positioningfranklee16/academic-research-skills2231 repos~890Automated safety check: PassNone
Marketing OsYuzzyuk/marketing-os540—~2.5kAutomated safety check: PassMIT
Revenue Centric Designheliocosta-dev/revenue-centric-design740—~1.6kAutomated safety check: PassCustom licence
Startup Positioningferdinandobons/startup-skill1.2k—~4.6kAutomated safety check: PassMIT
Stanley Druckenmiller Investmenttradermonty/claude-trading-skills3k1 repos~2kAutomated safety check: PassMIT

Similar skills

  • Mind Literature Positioning

    franklee16/academic-research-skills

    A skill your agent uses when positioning a Mind article against the existing philosophical literature so the thesis reads as a genuine move in a live debate.

    223 GitHub starsUsed in 1 repo~890 tokens
    Marketing & SEOAuto-check passed
  • Marketing Os

    Yuzzyuk/marketing-os

    A complete marketing department in one skill. An agent skill from Yuzzyuk/marketing-os.

    540 GitHub stars~2.5k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Revenue Centric Design

    heliocosta-dev/revenue-centric-design

    Playbook for designing SaaS and startup products that convert, retain, and monetize — landing pages & CRO, checkout & forms, onboarding/activation, churn reduction, pricing psychology, dashboards…

    740 GitHub stars~1.6k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Startup Positioning

    ferdinandobons/startup-skill

    Market positioning strategy using the April Dunford framework, enriched with JTBD discovery, Moore positioning statement, and Neumeier's Onliness Test.

    1.2k GitHub stars~4.6k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Stanley Druckenmiller Investment

    tradermonty/claude-trading-skills

    Druckenmiller Strategy Synthesizer - Integrates 8 upstream skill outputs (Market Breadth, Uptrend Analysis, Market Top, Macro Regime, FTD Detector, VCP Screener, Theme Detector, CANSLIM Screener)…

    3k GitHub starsUsed in 1 repo~2k tokens
    Marketing & SEOAuto-check passed
  • B2b Playbook

    weilun88313/B2B-Playbook

    Turn B2B marketing work into evidence-aware outputs using market, positioning, demand, account-program, lifecycle, and tool-selection guidance.

    203 GitHub stars~3.1k tokensUpdated 29 days ago
    Marketing & SEOAuto-check passed

More from brycewang-stanford/Awesome-Journal-Skills

All 2,387 skills in this repo
  • Aaag Data Analysis

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when running and reporting the analysis for an Annals of the American Association of Geographers manuscript — spatial statistics and modeling, remote-sensing accuracy, or…

    1.2k GitHub stars~1.3k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Literature Positioning

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when positioning an Annals of the American Association of Geographers manuscript in the literature — engaging geographic scholarship across the relevant area and the…

    1.2k GitHub stars~1.3k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Rebuttal

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when responding to an Annals of the American Association of Geographers decision letter (major/minor revision) — building a point-by-point response to the subject editor and…

    1.2k GitHub stars~1.4k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Research Design

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when defending the research design of an Annals of the American Association of Geographers manuscript — spatial/quantitative analysis and GIScience, remote-sensing and…

    1.2k GitHub stars~1.4k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Review Process

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when you need to understand how the Annals of the American Association of Geographers evaluates a manuscript — double-anonymous review routed through a subject editor by…

    1.2k GitHub stars~1.3k tokensUpdated 14 days ago
    Auto-check passed
  • Aaag Submission

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when running the final pre-submission preflight for the Annals of the American Association of Geographers via ScholarOne Manuscripts — area/article-type selection…

    1.2k GitHub stars~1.6k tokensUpdated 14 days ago
    Auto-check passed

Categories

Questions about Phg Argument Synthesis

What does Phg Argument Synthesis do?

A skill your agent uses when turning a mapped literature into one cumulative argument for a Progress in Human Geography (PiHG) review essay — synthesizing many sources into a claim the field could…. Phg Argument Synthesis is an agent skill from brycewang-stanford/Awesome-Journal-Skills. Use when turning a mapped literature into one cumulative argument for a Progress in Human Geography (PiHG) review essay — synthesizing many sources into a claim the field could not see from any one of them.

When should I use Phg Argument Synthesis?

Phg Argument Synthesis fits situations like: tasks that involve Positioning and messaging; tasks that involve Essays and academic help.

How do I install Phg Argument Synthesis in Claude Code?

Run `npx skills add brycewang-stanford/Awesome-Journal-Skills --skill phg-argument-synthesis -a claude-code`. Or copy the skill folder (Progress-in-Human-Geography-Skills/skills/phg-argument-synthesis in brycewang-stanford/Awesome-Journal-Skills) into .claude/skills/phg-argument-synthesis in your project. Claude Code loads it when a task matches its description.

How do I install Phg Argument Synthesis in Codex?

Run `npx skills add brycewang-stanford/Awesome-Journal-Skills --skill phg-argument-synthesis -a codex`. Or copy the skill folder (Progress-in-Human-Geography-Skills/skills/phg-argument-synthesis in brycewang-stanford/Awesome-Journal-Skills) into .agents/skills/phg-argument-synthesis in your project. Codex loads it when a task matches its description.

Can I use Phg Argument Synthesis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add brycewang-stanford/Awesome-Journal-Skills --skill phg-argument-synthesis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/phg-argument-synthesis, .gemini/skills/phg-argument-synthesis, .github/skills/phg-argument-synthesis and .opencode/skills/phg-argument-synthesis in your project.

What does Phg Argument Synthesis need to run?

SKILL.md names no scripts, command-line tools or credentials: Phg Argument Synthesis is instructions for the agent only.

Does Phg Argument Synthesis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Phg Argument Synthesis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Phg Argument Synthesis use?

Phg Argument Synthesis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Phg Argument Synthesis use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Phg Argument Synthesis?

Skills that share tags, products or a category with Phg Argument Synthesis: Mind Literature Positioning (franklee16/academic-research-skills, 223 stars), Marketing Os (Yuzzyuk/marketing-os, 540 stars), Revenue Centric Design (heliocosta-dev/revenue-centric-design, 740 stars) and Startup Positioning (ferdinandobons/startup-skill, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Phg Argument Synthesis?

brycewang-stanford (a GitHub user) maintains it in brycewang-stanford/Awesome-Journal-Skills, which has 1,231 GitHub stars. The repository holds 2,387 skills in this directory. The repository was last updated on September 27, 2026.

Source: brycewang-stanford/Awesome-Journal-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.