# Agent Setup Log

## Google Sheets Automation Skill

Installed the `google-sheets-automation` skill from [opencode-awesome-skills](https://github.com/EdEngineering/opencode-awesome-skills.git).

### Files created

- `.agents/skills/google-sheets-automation/SKILL.md` — skill instructions for the agent
- `.agents/skills/google-sheets-automation/scripts/auth.py` — OAuth2 login/logout/status
- `.agents/skills/google-sheets-automation/scripts/sheets.py` — read/write/find/metadata operations
- `pyproject.toml` — project config + deps for `uv sync`
- `third_party/opencode-awesome-skills/` — git submodule of upstream skill repo

### Setup commands

```bash
uv sync                          # install deps
source .venv/bin/activate        # activate venv
```

### First-time auth

```bash
python .agents/skills/google-sheets-automation/scripts/auth.py login
```

You'll need a `credentials.json` from Google Cloud Console (Sheets API enabled, OAuth 2.0 Desktop App).

### Usage

All commands go through `scripts/sheets.py`:
- `get-text`, `get-range`, `find`, `get-metadata` (read)
- `update-range`, `append-rows`, `clear-range`, `batch-update` (write)

See the SKILL.md for full docs.

### Submodule

```bash
git submodule update --init --recursive   # clone third_party deps
```

---

## Fitness Trainer Agent

- **Agent config**: `.opencode/agents/fitness-trainer.md` — a primary agent that acts as your personal trainer
- **Workout programming skill**: `.agents/skills/fitness-workout/` — methodology guidelines and helpers
- **Workout/check-in logs**: `logs/workouts/` and `logs/checkins/` — markdown files written by the agent

### Historical data

`inputs/Juggernaut training.xlsx` was downloaded from Google Sheets (previous Juggernaut training cycles from before 2025). Google Sheets auth can be set up later if needed — see the Google Sheets Automation Skill above.