Installation¶

FAT Agent with Superpowers is a Claude Code plugin. There are three ways to install it depending on your setup.

Option 1: Claude Code Plugin (Recommended)¶

The simplest approach. Run this in your terminal:

claude plugins add https://github.com/wrxck/fat-agent-with-superpowers

This registers the plugin with Claude Code. The skill and all scripts are available immediately in every conversation.

Verifying installation¶

After installing, start a new Claude Code session and say:

You: What plugins do you have?

You should see fat-agent-with-superpowers listed.

Option 2: Manual Git Clone¶

Clone the repository directly into your Claude skills directory:

git clone https://github.com/wrxck/fat-agent-with-superpowers ~/.claude/skills/fat-agent

This places the full project (scripts, references, templates, tests) under ~/.claude/skills/fat-agent/.

Directory layout after cloning¶

~/.claude/skills/fat-agent/
  plugins/fat-agent-with-superpowers/
    skills/fat-agent-with-superpowers/SKILL.md
    scripts/
      analyse-html.py
      calculate-score.py
      modules/
        base.py
        seo.py
        security.py
        ...
    references/
    templates/
    tests/

Option 3: Claude.ai Project Setup¶

If you use Claude.ai (the web interface) with Projects:

Create a new Project or open an existing one.
Go to Project Knowledge.
Upload the SKILL.md file from plugins/fat-agent-with-superpowers/skills/fat-agent-with-superpowers/.
Optionally upload the reference files from references/ for deeper fix guidance.

Limitations

The Claude.ai project approach does not give Claude access to the Python scripts. Audits will rely on Claude's own analysis rather than the automated analysis pipeline. For the full experience, use Claude Code with Option 1 or 2.

Requirements¶

Claude Code (any recent version)
Python 3.10+ (for the analysis scripts)
Node.js 18+ (optional, for Lighthouse integration)
Playwright (optional, for visual regression screenshots)

Checking Python version¶

python3 --version

Installing optional dependencies¶

For Lighthouse integration:

npm install -g lighthouse

For visual regression:

pip install playwright
playwright install chromium

Updating¶

Plugin method¶

claude plugins update fat-agent-with-superpowers

Git clone method¶

cd ~/.claude/skills/fat-agent
git pull origin main

Uninstalling¶

Plugin method¶

claude plugins remove fat-agent-with-superpowers

Git clone method¶

rm -rf ~/.claude/skills/fat-agent