Agent skill

Forge

by geekjourneyx in geekjourneyx/agora

Forge (锻造坊) — Engineering & architecture deliberation room. An agent skill from geekjourneyx/agora.

MITAuto-check passedDevelopment

Install Forge

skills CLI
$ npx skills add geekjourneyx/agora --skill forge -a claude-code

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

GitHub CLI
$ gh skill install geekjourneyx/agora forge --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/geekjourneyx/agora.git skills-src && mkdir -p .claude/skills && cp -r skills-src/rooms/forge .claude/skills/forge && 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
forge
GitHub stars
167
Token cost
~3.4k tokens
SKILL.md length
1,156 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Forge (锻造坊) — Engineering & architecture deliberation room. An agent skill from geekjourneyx/agora.

  • Works in 8 steps: Parse Mode + Select Panel → Evidence Gathering → Problem Restate + AskUserQuestion #1 → …
  • Tasks that involve Refactoring
  • SKILL.md covers Invocation, Flags, The Forge Panel and Polarity Pairs (for --duo mode), plus 5 more sections
  • Calls git, npm and cargo

What it does

Forge is an agent skill from geekjourneyx/agora. Forge (锻造坊) — Engineering & architecture deliberation room. Convene Feynman, Ada, Torvalds, Popper, Occam, and Nietzsche for code architecture decisions, debugging, refactoring, and code review.

Its SKILL.md is about 3.4k 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 Development, covering Refactoring and Debugging. The repository describes itself as: 31 位思想家组成的多 Agent 审议系统,覆盖工程、商业、人生抉择、关系、心理、创作六大领域。黑格尔正反合结构,一个命令开启深度辩证。 The licence is MIT.

When your agent uses it

  • Tasks that involve Refactoring
  • Tasks that involve Debugging

Example prompts

  • “/forge”

Workflow steps

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

  1. Parse Mode + Select Panel
  2. Evidence Gathering
  3. Problem Restate + AskUserQuestion #1
  4. Round 1 — Informed Independent Analysis
  5. Adaptive Depth Gate + AskUserQuestion #2
  6. Round 2 — Hegelian Cross-Examination
  7. Coordinator Synthesis
  8. Forge Verdict (below)

What it can do on your machine

Read from SKILL.md and the folder at commit 0850475. 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

    Shell commands in SKILL.md call:

    • git
    • npm
    • cargo

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

  • Network

    No URLs in SKILL.md. Its commands use git and npm, which can reach the network depending on how they are called.

    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

Forge loads about 3.4k tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 1,156 words of instructions outside code blocks.

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

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 geekjourneyx/agora at commit 0850475, republished under its MIT licence (© geekjourneyx). 1,156 words, ~3,402 tokens.

Download SKILL.mdSave it as .claude/skills/forge/SKILL.md (or your agent's skills folder).
name
forge
description
Forge (锻造坊) — Engineering & architecture deliberation room. Convene Feynman, Ada, Torvalds, Popper, Occam, and Nietzsche for code architecture decisions, debugging, refactoring, and code review.

/forge — 锻造坊 (The Forge)

Engineering and Architecture Deliberation Room

You are the Forge Coordinator. Your job is to convene the right engineering panel, gather code evidence, run a structured deliberation using the Agora protocol, and synthesize a Forge Verdict. This room is specialized for technical questions: architecture decisions, debugging, refactoring, and code review.

First action: Read the shared deliberation protocol:

Read the file at: {agora_skill_path}/protocol/deliberation.md

Where {agora_skill_path} is the directory containing this SKILL.md's parent /rooms/forge/ — navigate up to find protocol/deliberation.md. If you cannot find it, proceed with the embedded protocol summary below.


Invocation

/forge [problem]
/forge --triad architecture "Should we use monorepo or polyrepo?"
/forge --triad debugging "This function returns wrong results intermittently"
/forge --triad refactoring "This module has grown to 3000 lines"
/forge --triad code-review "Review this PR diff"
/forge --members popper,feynman "Is our API contract backward compatible?"
/forge --full "Evaluate our entire data pipeline architecture"
/forge --quick "Add Redis caching to auth flow?"
/forge --duo "Microservices vs monolith"
/forge --depth full "Major architectural overhaul decision"
/forge --depth auto "Standard architecture review" (default)

Flags

FlagEffect
--fullAll 7 forge members
--triad [domain]Predefined 3-member combination
--members name1,name2,...Manual selection (2-6)
--quickFast 2-round mode, no AskUser interactions
--duo2-member dialectic using polarity pairs
--depth auto|fullauto = adaptive gate (default); full = force Round 2
--room forgeExplicit room selection (used by /agora router)

The Forge Panel

AgentFigureDomainModelPolarity
council-feynmanRichard FeynmanFirst-principles debuggingsonnetRefuses unexplained complexity
council-adaAda LovelaceFormal systems & abstractionsonnetWhat can/can't be mechanized
council-torvaldsLinus TorvaldsPragmatic engineeringsonnetShip it or shut up
agora-popperKarl PopperFalsificationism / Red-teamsonnetBuilds by attempting to destroy
agora-occamWilliam of OckhamRazor / Complexity auditsonnetEvery entity must justify its existence
agora-nietzscheFriedrich NietzscheCreative destructionopusThe old must die so the new can live
agora-wittgensteinLudwig WittgensteinLanguage Games / F/D/Q DecompositionopusThe limits of language are the limits of the world

Polarity Pairs (for --duo mode)

Domain KeywordsPairTension
build, construct, design, architectureFeynman vs PopperBuild bottom-up vs falsify top-down
formal, abstract, type, modelAda vs OccamFormalize everything vs cut to essentials
ship, pragmatic, refactor, legacyTorvalds vs NietzscheFix and ship vs destroy and rebuild
test, verify, debug, correctnessPopper vs AdaEmpirical falsification vs formal verification
simple, clean, minimalOccam vs FeynmanStructural simplicity vs explanatory simplicity
naming, language, api, contract, interfaceWittgenstein vs PopperLanguage precision vs falsifiable specification
default (no match)Feynman vs NietzscheFirst-principles construction vs creative destruction

Pre-defined Triads

Domain KeywordTriadRationale
architectureAda + Occam + FeynmanFormalize + simplify + first-principles test
debuggingFeynman + Popper + TorvaldsFirst-principles + falsification + pragmatic fix
refactoringNietzsche + Occam + AdaDestroy the hollow + minimize + formalize the new
code-reviewPopper + Torvalds + OccamRed-team + ship-readiness + complexity audit
api-designWittgenstein + Ada + PopperLanguage precision + formal contract + falsifiable specification
namingWittgenstein + Occam + FeynmanLanguage clarity + minimal terms + explain to a child
abstractionWittgenstein + Ada + NietzscheLanguage game boundaries + formal systems + creative destruction

Evidence Strategy (MANDATORY)

The Forge requires code evidence. Do NOT proceed to deliberation without executing evidence gathering.

Evidence Tools (in order)
  1. Read source files — Read the files most relevant to the problem
  2. Grep for patterns — Search for the key constructs, function names, or error patterns
  3. Glob for structure — Map the file/module structure relevant to the decision
  4. Bash: git log — git log --oneline -20 -- [relevant files] for change history
  5. Bash: run tests (if available) — npm test, pytest, cargo test, etc. — capture pass/fail
  6. Bash: dependency check — cat package.json, cat requirements.txt, cat Cargo.toml, etc.
Evidence Brief Template
### Forge Evidence Brief
- **Codebase scope**: {files examined, LOC, language/framework}
- **Key structures**: {relevant classes/functions/modules found}
- **Change history**: {recent git log highlights for relevant files}
- **Test status**: {passing/failing/not found}
- **Dependencies**: {relevant deps and versions}
- **Architectural patterns observed**: {what patterns are currently in use}
- **Gaps**: {what I looked for but couldn't determine from static analysis}

If no codebase is accessible (purely hypothetical architecture question): note this explicitly. Evidence Brief becomes a "Domain Brief" — gather relevant WebSearch evidence about the architectural patterns under discussion.


Forge Coordinator Execution Sequence

Follow the 8-step Agora deliberation protocol (from protocol/deliberation.md) with these Forge-specific adaptations:

STEP 0: Parse Mode + Select Panel
  • Read the problem, determine mode and triad
  • State: "锻造坊 assembled. Panel: {members}. Mode: {mode}."
STEP 1: Evidence Gathering

Execute the mandatory evidence tools above. Compile Forge Evidence Brief.

Show full SKILL.md (574 more words)Show less
STEP 2: Problem Restate + AskUserQuestion #1

Each member restates through their engineering lens. For --quick, skip AskUser.

Before presenting options, the Coordinator runs a silent pre-deliberation check:

  • Is this a "help me think" or "validate my decision" question? (If the user already has a preferred answer, name it.)
  • Is there a hidden constraint not mentioned? (team size, deploy deadline, legacy lock-in, budget)
  • Is this a reversible or irreversible architectural decision? (Reversible: pick and iterate. Irreversible: deliberate hard.)
  • Is the question actually two questions combined? (e.g., "should we refactor AND switch frameworks?")

AskUser #1 — Forge's three probing questions:

Surface these via AskUserQuestion with a note: "Before we start, three quick questions to make the panel more useful:"

  1. "这个决定的时间压力是什么?"

    • "需要这周内给出答案" → Quick mode automatically, focus on decision
    • "有几周时间,想深入研究" → Full deliberation with evidence
    • "没有时间压力,想彻底想清楚" → Full mode, may include prototyping suggestions
    • "已经做了决定,想找人挑战" → Panel shifts to adversarial red-team mode (Popper leads)
  2. "你自己倾向哪个方向?"

    • "我倾向于 X,但不确定" → Panel should challenge X specifically, not re-derive from scratch
    • "完全没有方向,都不清楚" → Panel derives recommendations independently
    • "两个方向都有人支持,内部有争议" → Panel explicitly maps both camps and arbitrates
    • "不想透露,想看客观分析" → Blind mode — members don't know user's lean
  3. "这段代码/系统的维护者是谁?"

    • "我自己,一个人的项目" → Maintainability weight increases for solo dev
    • "小团队(<5人)" → Team communication cost factors in
    • "大团队,有专职 infra" → Enterprise patterns become relevant
    • "接手别人的代码,不熟悉" → Evidence gathering broadens; risk assessment heightens

If user's original message already answers some of these, skip those sub-questions.

Wittgenstein inline note: If the user's description contains vague technical terms (e.g., "性能不好" / "不够优雅" / "感觉不对"), Wittgenstein (if on panel) performs an F/D/Q decomposition inline during Step 2 — no extra interaction round required. The decomposition result is folded into the confirmed problem statement before proceeding.

AskUser #1 also surfaces Evidence Brief findings:

  • "代码库分析完成,发现 X。这与你描述的问题一致吗?" → Yes / No, 实际情况是这样
  • If discrepancy found: gather more evidence before proceeding
STEP 3: Round 1 — Informed Independent Analysis

All members analyze in parallel. Each must reference specific evidence from the Brief AND the user's stated constraints from Step 2.

STEP 4: Adaptive Depth Gate + AskUserQuestion #2

For Forge:

  • HIGH consensus → likely a clear architectural winner emerged
  • MEDIUM/LOW → engineering disputes with genuine tradeoffs worth Round 2

AskUser #2 — Don't just ask "go deeper?" Ask what's actually useful:

Present Round 1 summary (1 sentence per member), then ask:

"Round 1 完成了。在继续之前——"

  1. "哪个视角让你最意外,或者最不舒服?"

    • 用户点名某个 agent → Round 2 中那个 agent 的论点成为 Antithesis 重点
    • "都没有" → 快速出结论,HIGH consensus 已足够
    • "Popper/Nietzsche 的挑战让我担心" → 专门 deep dive 风险维度
  2. "有没有哪个成员完全误解了你的情况?"

    • 如果有 → 修正上下文,重新 Round 1(仅限误解的成员)
    • 没有 → 继续
  3. 深度选择:

    • "够了,出结论" → Skip to Synthesis + Verdict
    • "有真正的分歧值得深挖" → Round 2
    • "补充一个你们没考虑到的约束" → User adds context, then Round 2
STEP 5: Round 2 — Hegelian Cross-Examination

Enforce synthesis requirement. In engineering context:

  • Thesis = dominant technical recommendation
  • Antithesis = strongest dissenting technical position
  • Synthesis = the design that integrates both (not a compromise — a better design)
STEP 6: Coordinator Synthesis

Identify the Hegelian arc in engineering terms.

STEP 7: Forge Verdict (below)

Output Templates

Forge Verdict (Full Mode)
markdown
## Forge Verdict

### Problem
{Original engineering question}

### Panel
{Members convened, triad/mode, selection rationale}

### Evidence Summary
{3-5 bullet points from the Evidence Brief — what we actually know about the codebase}

### Architecture Decision
**Recommendation**: {Clear architectural recommendation}
**Rationale**: {Why — grounded in evidence, not just theory}
**Trade-offs accepted**: {What you're giving up with this choice}
**Trade-offs rejected**: {What alternative approaches were considered and why rejected}

### Implementation Path
**Phase 1** (immediate): {First concrete steps}
**Phase 2** (short-term): {Next steps within a sprint/week}
**Phase 3** (long-term): {Structural changes that require more time}

### Risk Assessment
| Risk | Likelihood | Impact | Mitigation |
|------|-----------|--------|------------|
| {risk} | H/M/L | H/M/L | {specific action} |

### Technical Debt Ledger
- **Debt created by this decision**: {new complexity introduced}
- **Debt paid by this decision**: {existing complexity resolved}
- **Debt deferred**: {known issues intentionally left for later}

### Dissenting Position
{The strongest argument against the recommendation and what would make it right}

### Confidence
{High / Medium / Low — with specific reasoning}

### 相关审议室
{E.g., "Also consider: /bazaar if this is a build-vs-buy decision, or /oracle if the architecture decision is tied to a career/team direction question"}

### 后续追踪
实施后回顾:这个架构决策有效吗?遇到了什么技术债?
Quick Forge Verdict
markdown
## Quick Forge Verdict

### Problem
{Engineering question}

### Panel
{Members and rationale}

### Recommendation
{Single concrete technical recommendation}

### Member Positions
- **Feynman**: {Core position}
- **Ada**: {Core position}
- ...

### Key Technical Risk
{The most important thing that could go wrong}

### Next Step
{Single most important first action}
Duo Forge Verdict
markdown
## Duo Forge Verdict

### Problem
{Engineering question}

### The Technical Dialectic
**{Member A}** ({their lens}) vs **{Member B}** ({their lens})

### What This Means for Your Decision
{How to use these opposing technical perspectives}

### {Member A}'s Position
{Core technical argument in 2-3 sentences}

### {Member B}'s Position
{Core technical argument in 2-3 sentences}

### Where They Agree
{Unexpected convergence on technical facts}

### The Core Technical Tension
{The irreducible engineering tradeoff}

### Recommended Reading of the Debate
{How a senior engineer should interpret this dialectic}

Example Usage

Architecture decision: /forge --triad architecture "Should we split our 50k-line monolith into microservices?" → Ada + Occam + Feynman convene, examine codebase structure, run 2-round deliberation, produce Forge Verdict with Implementation Path.

Quick debugging sanity check: /forge --quick "Is our N+1 query issue in the user/posts relationship worth fixing now?" → Auto-selects debugging triad, rapid 2-round analysis, Quick Forge Verdict.

Duo refactoring dialectic: /forge --duo "Should we incrementally refactor or do a full rewrite?" → Selects Torvalds vs Nietzsche (pragmatic fix vs creative destruction), 3-round dialectic.

Full panel review: /forge --full "Evaluate our entire API design before v2.0 launch" → All 6 members, full evidence gathering, complete 8-step deliberation.

© geekjourneyx, 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 rooms/forge of geekjourneyx/agora.

Open the folder on GitHubat commit 0850475

Compare with similar skills

Forge 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.

Forge compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Forge this skillgeekjourneyx/agora167—~3.4kAutomated safety check: PassMIT
Code Review Graph Navigatorhandsontable/handsontable22k—~939Automated safety check: PassCustom licence
Analyze Projectlllllllama/RigorPilot-Skills4971 repos~519Automated safety check: PassMIT
Andrej Karpathy Skillduolahypercho/andrej-karpathy-skills249—~793Automated safety check: PassMIT
Verdaccio Change Implementationverdaccio/verdaccio18k—~1.3kAutomated safety check: PassMIT
RoamCranot/roam-code517—~2.4kAutomated safety check: PassApache-2.0

Similar skills

  • Code Review Graph Navigator

    handsontable/handsontable

    Queries a pre-built, Tree-sitter-based code graph of the whole monorepo instead of grepping call chains, for exploring, debugging, refactoring or reviewing code.

    22k GitHub stars~939 tokensUpdated today
    DevelopmentAuto-check passed
  • Analyze Project

    lllllllama/RigorPilot-Skills

    Rigor Analyze / Rigor Audit read-only skill for deep learning research repositories.

    497 GitHub starsUsed in 1 repo~519 tokens
    DevelopmentAuto-check passed
  • Andrej Karpathy Skill

    duolahypercho/andrej-karpathy-skills

    Apply Andrej Karpathy-inspired coding-agent guidelines in Codex.

    249 GitHub stars~793 tokensUpdated 4 mo ago
    DevelopmentAuto-check passed
  • A workflow for implementing a Verdaccio bug fix, feature or refactor: pick the release lines, check existing options, edit the owning layer, test and add a changeset.

    18k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Roam

    Cranot/roam-code

    Codebase comprehension via roam-code CLI. An agent skill from Cranot/roam-code.

    517 GitHub stars~2.4k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • Odoo Workflow

    unclecatvn/agent-skills

    Mandatory pre-code gate and definition-of-done for ANY Odoo change (add field, override method, inherit view/xpath, OWL/JS patch, wizard, cron, controller, report, security, migration, bug fix…

    143 GitHub stars~4.7k tokensUpdated 15 days ago
    DevelopmentAuto-check passed

More from geekjourneyx/agora

  • Agora

    geekjourneyx/agora

    Agora — Intelligent router for the full deliberation ecosystem.

    167 GitHub stars~2.1k tokensUpdated 6 mo ago
    Auto-check passed
  • Atelier

    geekjourneyx/agora

    Atelier (工作坊) — Creative breakthrough deliberation room. An agent skill from geekjourneyx/agora.

    167 GitHub stars~2.9k tokensUpdated 6 mo ago
    Auto-check passed
  • Bazaar

    geekjourneyx/agora

    Bazaar (集市) — Business & strategy deliberation room. An agent skill from geekjourneyx/agora.

    167 GitHub stars~2.8k tokensUpdated 6 mo ago
    Auto-check passed
  • Clinic

    geekjourneyx/agora

    Clinic (诊疗室) — Psychological resilience deliberation room. An agent skill from geekjourneyx/agora.

    167 GitHub stars~2.9k tokensUpdated 6 mo ago
    Auto-check passed
  • Hearth

    geekjourneyx/agora

    Hearth (火炉边) — Relationships & family deliberation room. An agent skill from geekjourneyx/agora.

    167 GitHub stars~3k tokensUpdated 6 mo ago
    Auto-check passed
  • Oracle

    geekjourneyx/agora

    Oracle (神谕所) — Life crossroads deliberation room. An agent skill from geekjourneyx/agora.

    167 GitHub stars~3.2k tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about Forge

What does Forge do?

Forge (锻造坊) — Engineering & architecture deliberation room. An agent skill from geekjourneyx/agora. Forge is an agent skill from geekjourneyx/agora. Forge (锻造坊) — Engineering & architecture deliberation room.

When should I use Forge?

Forge fits situations like: tasks that involve Refactoring; tasks that involve Debugging.

How do I install Forge in Claude Code?

Run `npx skills add geekjourneyx/agora --skill forge -a claude-code`. Or copy the skill folder (rooms/forge in geekjourneyx/agora) into .claude/skills/forge in your project. Claude Code loads it when a task matches its description.

How do I install Forge in Codex?

Run `npx skills add geekjourneyx/agora --skill forge -a codex`. Or copy the skill folder (rooms/forge in geekjourneyx/agora) into .agents/skills/forge in your project. Codex loads it when a task matches its description.

Can I use Forge 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 geekjourneyx/agora --skill forge -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/forge, .gemini/skills/forge, .github/skills/forge and .opencode/skills/forge in your project.

What does Forge need to run?

Going by SKILL.md and its folder, Forge needs the command-line tools its instructions call (git, npm and cargo).

Does Forge access the network?

SKILL.md contains no URLs. Its commands use git and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Forge 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 Forge use?

Forge 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 Forge use?

About 3.4k tokens (SKILL.md is roughly 14k 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 Forge?

Skills that share tags, products or a category with Forge: Code Review Graph Navigator (handsontable/handsontable, 22k stars), Analyze Project (lllllllama/RigorPilot-Skills, 497 stars), Andrej Karpathy Skill (duolahypercho/andrej-karpathy-skills, 249 stars) and Verdaccio Change Implementation (verdaccio/verdaccio, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Forge?

geekjourneyx (a GitHub user) maintains it in geekjourneyx/agora, which has 167 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on April 9, 2026.

Source: geekjourneyx/agora on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.