A skill your agent uses when building the conceptual contribution of an Annals of the American Association of Geographers manuscript — turning a finding into a geographic argument grounded in…

MITAuto-check passed

Install Aaag Theory Building

skills CLI
$ npx skills add brycewang-stanford/Awesome-Journal-Skills --skill aaag-theory-building -a claude-code

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

GitHub CLI
$ gh skill install brycewang-stanford/Awesome-Journal-Skills aaag-theory-building --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/Annals-of-the-American-Association-of-Geographers-Skills/skills/aaag-theory-building .claude/skills/aaag-theory-building && 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
aaag-theory-building
GitHub stars
1.2k
Token cost
~1.3k tokens
SKILL.md length
503 words
Files
1
Skills in repo
2,387
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when building the conceptual contribution of an Annals of the American Association of Geographers manuscript — turning a finding into a geographic argument grounded in…

  • Environment-society
  • SKILL.md covers When to trigger, Build the argument with a…, Theory across the four areas… and The portability test…, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Spatial process)

What it does

Aaag Theory Building is an agent skill from brycewang-stanford/Awesome-Journal-Skills. Use when building the conceptual contribution of an Annals of the American Association of Geographers manuscript — turning a finding into a geographic argument grounded in geographic theory (place, scale, space-time, environment-society, spatial process). Sharpens the argument; it does not run analyses.

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

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

  • Environment-society
  • Spatial process)

Example prompts

  • “/aaag-theory-building”

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

Aaag Theory Building loads about 1.3k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 503 words of instructions outside code blocks.

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

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). 503 words, ~1,291 tokens.

Download SKILL.mdSave it as .claude/skills/aaag-theory-building/SKILL.md (or your agent's skills folder).
name
aaag-theory-building
description
Use when building the conceptual contribution of an Annals of the American Association of Geographers manuscript — turning a finding into a geographic argument grounded in geographic theory (place, scale, space-time, environment-society, spatial process). Sharpens the argument; it does not run analyses.

Theory Building (aaag-theory-building)

An Annals paper is judged on the geographic argument, not only the result. The contribution must do conceptual work with geography's own apparatus — space, place, scale, region, territory, landscape, environment-society relations, spatial process — and be portable enough that other geographers can use it.

When to trigger

  • Moving from "we found X" to "X means Y for how geographers understand Z"
  • A reviewer said the paper is "descriptive," "atheoretical," or "a case study without a concept"
  • Deciding which geographic concept the argument advances or revises

Build the argument with a geographic concept

Pick the concept the paper actually moves and make it load-bearing:

  • Scale — the result holds/changes across scales; the argument is about cross-scale processes or the MAUP, not a single resolution.
  • Place / region — what is specific vs. generalizable about the setting; what the case is a case of.
  • Space-time / spatial process — diffusion, dependence, clustering, mobility as the mechanism, not a backdrop.
  • Environment-society — the coupling itself is the object; neither side is mere context.
  • Spatial data / representation — for Methods, the conceptual stakes of how space is measured and modeled.

Theory across the four areas (judged on its own terms)

AreaWhat "theory" looks likeThe bar
Methodsa formal/computational claim about geographic inferencegeneralizes beyond one dataset; states assumptions
Humana social-spatial mechanism or relational conceptengages social theory as geography
Nature-Societya mechanism coupling biophysical and social processboth sides theorized; feedbacks named
Physicala process model / hypothesis about earth-surface behaviortestable, scale-aware, mechanism-explicit
Generala cross-area conceptual movereorders how multiple areas see the topic

The portability test (Annals-specific)

State the contribution as a sentence another geographer could import: "___ is best understood as ___ rather than ___, which means [a different subfield] should expect ___." If the contribution cannot be lifted out of your case, it is a finding, not yet a geographic argument.

Show full SKILL.md (198 more words)Show less

From observation to claim

  • Name the mechanism / concept, not just the pattern ("clustering" is a pattern; "why and at what scale the process clusters" is the argument).
  • State scope conditions: where the argument holds and where it should break — geography rewards explicit scale and place boundaries.
  • Distinguish your claim from the nearest rival concept (link to aaag-literature-positioning).

Worked micro-example (illustrative)

A finding: "flood-relief funds reached richer neighborhoods faster in City X."

Pattern only: "relief was spatially unequal" (a map, not a concept)
Geographic argument: relief speed is governed by administrative SCALE mismatch — funds routed through
  units that do not match the geography of need, so the same policy produces uneven relief by design
Mechanism: scalar mismatch between funding units and exposure units
Scope conditions: holds where exposure crosses administrative boundaries; breaks where they coincide
Portability: any geographer studying service delivery can ask whether the governing unit matches the
  geography of the problem — the concept lifts out of floods

The pattern becomes a portable claim about scalar mismatch, not a description of one city's floods.

Checklist

  • The argument names a geographic concept and does conceptual work with it
  • Mechanism stated, not just pattern; scope conditions explicit
  • Portability sentence written (another subfield could import it)
  • Theory matched to the area's tradition and judged on its own terms
  • The strongest rival concept is named and distinguished

Anti-patterns

  • Descriptive mapping with no concept ("here is the spatial distribution of X")
  • Borrowing a non-geographic theory wholesale with no spatial/place/scale work
  • A Nature-Society argument that theorizes only the social or only the biophysical side
  • Claiming generality from one case with no scope conditions

Output format

【Geographic concept】scale / place / space-time / environment-society / representation
【Mechanism】the process the argument turns on
【Scope conditions】where it holds / breaks
【Portability】the import sentence
【Next】aaag-research-design

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 Annals-of-the-American-Association-of-Geographers-Skills/skills/aaag-theory-building of brycewang-stanford/Awesome-Journal-Skills.

Open the folder on GitHubat commit 932eb23

Compare with similar skills

Aaag Theory Building 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.

Aaag Theory Building compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Aaag Theory Building this skillbrycewang-stanford/Awesome-Journal-Skills1.2k—~1.3kAutomated safety check: PassMIT
Contributemindfold-ai/Trellis15k—~2.7kAutomated safety check: PassAGPL-3.0
Contributesuperset-sh/superset15k—~624Automated safety check: PassCustom licence
Contributingkortix-ai/suna20k—~3kAutomated safety check: WarnCustom licence
OpenDesign Contribution Flownexu-io/open-design100k—~3.5kAutomated safety check: NotesApache-2.0
Contributejeremylongshore/tons-of-skills-marketplace2.8k—~1.6kAutomated safety check: PassMIT

Similar skills

  • Contribute

    mindfold-ai/Trellis

    Guide for contributing to Trellis documentation and marketplace.

    15k GitHub stars~2.7k tokensUpdated 11 days ago
    DevelopmentAuto-check passed
  • Contribute

    superset-sh/superset

    Set up a Superset open-source contribution, from forking and cloning superset-sh/superset through local dev setup and the repo's rules to a merge-ready PR.

    15k GitHub stars~624 tokensUpdated today
    DevelopmentAuto-check passed
  • Contributing

    kortix-ai/suna

    The pull request loop for this repo: branch → commit → verify in your own box (local tests + local stack) → PR into main → demo video recorded with agent-browser on the local stack → gh --attach →…

    20k GitHub stars~3k tokensUpdated today
    DevelopmentAuto-check: warnings
  • OpenDesign Contribution Flow

    nexu-io/open-design

    Helps newcomers contribute to OpenDesign: ship a skill or design system, translate docs, fix docs or report a bug, ending in a pull request or issue.

    100k GitHub stars~3.5k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Contribute

    jeremylongshore/tons-of-skills-marketplace

    Read-only OSS contribution audit and routing skill. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~1.6k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Voyager Contribute

    voyager-crew/voyager

    Prepare Voyager commits, pull requests, and contribution evidence, or claim an issue and check review readiness.

    20k GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-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

Questions about Aaag Theory Building

What does Aaag Theory Building do?

A skill your agent uses when building the conceptual contribution of an Annals of the American Association of Geographers manuscript — turning a finding into a geographic argument grounded in…. Aaag Theory Building is an agent skill from brycewang-stanford/Awesome-Journal-Skills. Use when building the conceptual contribution of an Annals of the American Association of Geographers manuscript — turning a finding into a geographic argument grounded in geographic theory (place, scale, space-time, environment-society, spatial process).

When should I use Aaag Theory Building?

Aaag Theory Building fits situations like: environment-society; spatial process).

How do I install Aaag Theory Building in Claude Code?

Run `npx skills add brycewang-stanford/Awesome-Journal-Skills --skill aaag-theory-building -a claude-code`. Or copy the skill folder (Annals-of-the-American-Association-of-Geographers-Skills/skills/aaag-theory-building in brycewang-stanford/Awesome-Journal-Skills) into .claude/skills/aaag-theory-building in your project. Claude Code loads it when a task matches its description.

How do I install Aaag Theory Building in Codex?

Run `npx skills add brycewang-stanford/Awesome-Journal-Skills --skill aaag-theory-building -a codex`. Or copy the skill folder (Annals-of-the-American-Association-of-Geographers-Skills/skills/aaag-theory-building in brycewang-stanford/Awesome-Journal-Skills) into .agents/skills/aaag-theory-building in your project. Codex loads it when a task matches its description.

Can I use Aaag Theory Building 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 aaag-theory-building -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aaag-theory-building, .gemini/skills/aaag-theory-building, .github/skills/aaag-theory-building and .opencode/skills/aaag-theory-building in your project.

What does Aaag Theory Building need to run?

SKILL.md names no scripts, command-line tools or credentials: Aaag Theory Building is instructions for the agent only.

Does Aaag Theory Building 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 Aaag Theory Building 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 Aaag Theory Building use?

Aaag Theory Building 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 Aaag Theory Building use?

About 1.3k tokens (SKILL.md is roughly 5.2k 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 Aaag Theory Building?

Skills that share tags, products or a category with Aaag Theory Building: Contribute (mindfold-ai/Trellis, 15k stars), Contribute (superset-sh/superset, 15k stars), Contributing (kortix-ai/suna, 20k stars) and OpenDesign Contribution Flow (nexu-io/open-design, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Aaag Theory Building?

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.