Agent skill

First Principles Thinking

by aAAaqwq in aAAaqwq/AGI-Super-Team

Use Socratic questioning to expose assumptions, reduce a problem to fundamental truths, and rebuild options when a user is stuck or requests first-principles analysis.

MITAuto-check passedEducation

Install First Principles Thinking

skills CLI
$ npx skills add aAAaqwq/AGI-Super-Team --skill first-principles-thinking -a claude-code

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

GitHub CLI
$ gh skill install aAAaqwq/AGI-Super-Team first-principles-thinking --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/aAAaqwq/AGI-Super-Team.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/first-principles-thinking .claude/skills/first-principles-thinking && 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
first-principles-thinking
GitHub stars
105
Used in
1 other repo
Token cost
~1.2k tokens
SKILL.md length
336 words
Files
1
Skills in repo
161
Repo updated
First seen
Licence
MIT

At a glance

Use Socratic questioning to expose assumptions, reduce a problem to fundamental truths, and rebuild options when a user is stuck or requests first-principles analysis.

  • Works in 6 steps: Clarification → Probe Assumptions → Probe Evidence → …
  • Tasks that involve Tutoring and explanations
  • SKILL.md covers When to Apply, The Process, Questioning Toolkit and Conversation Guidelines, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

First Principles Thinking is an agent skill from aAAaqwq/AGI-Super-Team. Use Socratic questioning to expose assumptions, reduce a problem to fundamental truths, and rebuild options when a user is stuck or requests first-principles analysis.

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 Education, covering Tutoring and explanations. The repository describes itself as: An installable, cross-framework AI organization: C-suite agents, expert subagents, curated skills, independent review, and one-command setup across 18 AI client/runtime adapters. The licence is MIT.

When your agent uses it

  • Tasks that involve Tutoring and explanations

Example prompts

  • “/first-principles-thinking”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Clarification
  2. Probe Assumptions
  3. Probe Evidence
  4. Alternative Perspectives
  5. Implications
  6. Meta-Questions

What it can do on your machine

Read from SKILL.md and the folder at commit 331ecd3. 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 (its code samples are markdown).

    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

First Principles Thinking loads about 1.2k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 336 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
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 aAAaqwq/AGI-Super-Team at commit 331ecd3, republished under its MIT licence (© aAAaqwq). 336 words, ~1,156 tokens.

Download SKILL.mdSave it as .claude/skills/first-principles-thinking/SKILL.md (or your agent's skills folder).
name
first-principles-thinking
description
Use Socratic questioning to expose assumptions, reduce a problem to fundamental truths, and rebuild options when a user is stuck or requests first-principles analysis.

First Principles Thinking Coach

Guide users through Socratic questioning to surface assumptions, reach fundamental truths, and rebuild solutions from scratch.

When to Apply

Apply when the user is:

  • Stuck on a problem where conventional solutions aren't working
  • Making a high-stakes decision that warrants deeper analysis
  • Building something new (not optimizing existing)
  • Facing "industry standard" constraints that feel arbitrary

Skip when:

  • User needs a quick factual answer
  • Problem is well-solved by existing solutions
  • Time pressure outweighs depth value

The Process

┌──────────────────┐
│ 1. STATE PROBLEM │ ← Get the problem in user's words
└────────┬─────────┘
         ▼
┌──────────────────┐
│ 2. SURFACE       │ ← Ask: "What are you assuming here?"
│    ASSUMPTIONS   │    List everything they take for granted
└────────┬─────────┘
         ▼
┌──────────────────┐
│ 3. CHALLENGE     │ ← For each assumption: "Why do you believe this?"
│    EACH ONE      │    "What if the opposite were true?"
└────────┬─────────┘
         ▼
┌──────────────────┐
│ 4. FIND          │ ← Physics, economics, human nature
│    FUNDAMENTALS  │    "What's actually true regardless of convention?"
└────────┬─────────┘
         ▼
┌──────────────────┐
│ 5. REBUILD       │ ← From fundamentals only, what solutions emerge?
└──────────────────┘

Questioning Toolkit

Use these question types sequentially. Don't rapid-fire—let user respond between each.

1. Clarification
  • "What exactly do you mean by ____?"
  • "Can you give me a concrete example?"
  • "What does success look like here?"
2. Probe Assumptions
  • "What are you assuming must be true?"
  • "Why do you believe that?"
  • "What if the opposite were true?"
  • "Who says it has to be this way?"
3. Probe Evidence
  • "What evidence supports this?"
  • "How do you know that's true?"
  • "What would change your mind?"
4. Alternative Perspectives
  • "How would [expert in different field] see this?"
  • "What would a beginner notice that you're missing?"
  • "What would your harshest critic say?"
5. Implications
  • "If that's true, what follows?"
  • "What are the consequences of this belief?"
  • "What does this prevent you from considering?"
6. Meta-Questions
  • "Why is this the question you're asking?"
  • "What question should you be asking instead?"
  • "What's the real problem underneath this?"

Conversation Guidelines

Pacing: One question at a time. Wait for response. Build on what they say.

Depth: Push past surface answers. "Why?" can be asked 5+ times before hitting bedrock.

Tone: Curious collaborator, not interrogator. "That's interesting—what makes you say that?" not "Prove it."

Document: After each section, summarize what's been uncovered. This creates momentum and shows progress.

Example summary after assumptions phase:

"So we've identified three assumptions you're working with: (1) batteries need to cost $600/kWh, (2) existing suppliers are the only option, (3) the form factor must match current designs. Let's examine the first one..."

Example Session Skeleton

User: "I want to start a podcast but it seems expensive."

Claude: "Let's break this down. When you say 'expensive', what specific costs are you imagining?"

User: "Microphone, editing software, hosting, marketing..."

Claude: "Got it. What's your assumption about what a microphone needs to cost?"

User: "I've seen podcasters use $300-400 mics."

Claude: "Why do you believe you need that tier of equipment?"

User: "That's what the successful ones use."

Claude: "What's actually required for audio quality that listeners find acceptable? Not aspirational—fundamental."

[Continue drilling until reaching bedrock: "People need to hear words clearly. That requires X dB signal-to-noise ratio, which requires Y, which can be achieved with Z."]

Output Format

End sessions with a summary document:

markdown
## Problem
[Original problem statement]

## Assumptions Challenged
| Assumption | Why Believed | Fundamental Truth |
|------------|--------------|-------------------|
| X costs $Y | Industry standard | Raw materials cost $Z |

## First Principles Identified
1. [Bedrock truth]
2. [Bedrock truth]

## New Solution Space
Given only the fundamentals, these approaches become possible:
- [Option A]
- [Option B]

## Next Action
[Concrete next step the user can take]

© aAAaqwq, 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 skills/first-principles-thinking of aAAaqwq/AGI-Super-Team.

Open the folder on GitHubat commit 331ecd3

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in aAAaqwq/AGI-Super-Team, which our catalogue first saw on October 7, 2026.

Compare with similar skills

First Principles Thinking 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.

First Principles Thinking compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
First Principles Thinking this skillaAAaqwq/AGI-Super-Team1051 repos~1.2kAutomated safety check: PassMIT
DeepTutor CLIHKUDS/DeepTutor41k—~2.3kAutomated safety check: PassApache-2.0
AI Engineering Project Tutorrohitg00/ai-engineering-from-scratch65k—~1.6kAutomated safety check: PassMIT
Hung-Yi Lee Teaching Stylevoidful/hung-yi-lee-skill1.3k—~13kAutomated safety check: PassNone
Claude Certification Tutorrohitg00/ai-engineering-from-scratch65k—~3kAutomated safety check: PassMIT
StudyVault Quiz Tutorbevibing/tutor-skills1.3k—~1.4kAutomated safety check: PassMIT

Similar skills

  • DeepTutor CLI

    HKUDS/DeepTutor

    Teaches the agent to set up and run DeepTutor from the command line: chat and capabilities, knowledge bases, partners, memory, sessions, notebooks and the server or Web app.

    41k GitHub stars~2.3k tokensUpdated 3 days ago
    EducationAuto-check passed
  • AI Engineering Project Tutor

    rohitg00/ai-engineering-from-scratch

    Tutors a learner through one stage of a hands-on AI engineering project per session: lesson, prediction, code, grader run and reflection, with hints but never full solutions.

    65k GitHub stars~1.6k tokensUpdated today
    EducationAuto-check passed
  • Hung-Yi Lee Teaching Style

    voidful/hung-yi-lee-skill

    Explains machine learning, LLMs, AI agents and speech modeling in a Hung-Yi Lee-inspired teaching style, drawing on a knowledge base built from his lectures and research references.

    1.3k GitHub stars~13k tokensUpdated 1 mo ago
    EducationAuto-check passed
  • Claude Certification Tutor

    rohitg00/ai-engineering-from-scratch

    Guides a learner through one of four independent Claude certification tracks with onboarding, lessons, practice labs, mock exams and remediation.

    65k GitHub stars~3k tokensUpdated today
    EducationAuto-check passed
  • StudyVault Quiz Tutor

    bevibing/tutor-skills

    Quizzes you on the notes in an Obsidian StudyVault, tracks proficiency per concept and drills weak areas in four-question rounds.

    1.3k GitHub stars~1.4k tokensUpdated 7 mo ago
    EducationAuto-check passed
  • Designs a review-and-practice lesson around an independent first attempt, targeted feedback, supported practice, a fresh independent check and a next step.

    40k GitHub stars~1.1k tokensUpdated today
    EducationAuto-check passed

More from aAAaqwq/AGI-Super-Team

All 161 skills in this repo
  • Content Creator

    aAAaqwq/AGI-Super-Team

    Create SEO-optimized marketing content with consistent brand voice.

    105 GitHub starsUsed in 3 repos~1.9k tokens
    Auto-check passed
  • Financial Calculator

    aAAaqwq/AGI-Super-Team

    Advanced financial calculator with future value tables, present value, discount calculations, markup pricing, and compound interest.

    105 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Performing Security Code Review

    aAAaqwq/AGI-Super-Team

    This skill provides automated assistance for security agent tasks Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    105 GitHub starsUsed in 1 repo~920 tokens
    Auto-check passed
  • Frontend Design Ultimate

    aAAaqwq/AGI-Super-Team

    Create distinctive, production-grade static sites with React, Tailwind CSS, and shadcn/ui — no mockups needed.

    105 GitHub starsUsed in 2 repos~2.7k tokens
    Auto-check passed
  • Sysadmin Toolbox

    aAAaqwq/AGI-Super-Team

    Tool discovery and shell one-liner reference for sysadmin, DevOps, and security tasks.

    105 GitHub starsUsed in 2 repos~775 tokens
    Auto-check passed
  • Zsxq Smart Publish

    aAAaqwq/AGI-Super-Team

    Publish and manage content on 知识星球 (zsxq.com). An agent skill from aAAaqwq/AGI-Super-Team.

    105 GitHub stars~1.5k tokensUpdated 10 days ago
    Auto-check passed

Categories

Questions about First Principles Thinking

What does First Principles Thinking do?

Use Socratic questioning to expose assumptions, reduce a problem to fundamental truths, and rebuild options when a user is stuck or requests first-principles analysis. First Principles Thinking is an agent skill from aAAaqwq/AGI-Super-Team. Use Socratic questioning to expose assumptions, reduce a problem to fundamental truths, and rebuild options when a user is stuck or requests first-principles analysis.

When should I use First Principles Thinking?

First Principles Thinking fits situations like: tasks that involve Tutoring and explanations.

How do I install First Principles Thinking in Claude Code?

Run `npx skills add aAAaqwq/AGI-Super-Team --skill first-principles-thinking -a claude-code`. Or copy the skill folder (skills/first-principles-thinking in aAAaqwq/AGI-Super-Team) into .claude/skills/first-principles-thinking in your project. Claude Code loads it when a task matches its description.

How do I install First Principles Thinking in Codex?

Run `npx skills add aAAaqwq/AGI-Super-Team --skill first-principles-thinking -a codex`. Or copy the skill folder (skills/first-principles-thinking in aAAaqwq/AGI-Super-Team) into .agents/skills/first-principles-thinking in your project. Codex loads it when a task matches its description.

Can I use First Principles Thinking 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 aAAaqwq/AGI-Super-Team --skill first-principles-thinking -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/first-principles-thinking, .gemini/skills/first-principles-thinking, .github/skills/first-principles-thinking and .opencode/skills/first-principles-thinking in your project.

What does First Principles Thinking need to run?

SKILL.md names no scripts, command-line tools or credentials: First Principles Thinking is instructions for the agent only.

Does First Principles Thinking 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 First Principles Thinking 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 First Principles Thinking use?

First Principles Thinking 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 First Principles Thinking use?

About 1.2k tokens (SKILL.md is roughly 4.6k 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 First Principles Thinking?

Skills that share tags, products or a category with First Principles Thinking: DeepTutor CLI (HKUDS/DeepTutor, 41k stars), AI Engineering Project Tutor (rohitg00/ai-engineering-from-scratch, 65k stars), Hung-Yi Lee Teaching Style (voidful/hung-yi-lee-skill, 1.3k stars) and Claude Certification Tutor (rohitg00/ai-engineering-from-scratch, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains First Principles Thinking?

aAAaqwq (a GitHub user) maintains it in aAAaqwq/AGI-Super-Team, which has 105 GitHub stars. The repository holds 161 skills in this directory. The repository was last updated on September 27, 2026.

Source: aAAaqwq/AGI-Super-Team on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.