# Push specific files (commits are free — no version bump)
adom-wiki-publish push adom-google --files README.md SKILL.md -m "Update docs"

# When ready to cut a new installable release
adom-wiki-publish publish adom-google --bump patch

# Show page status (commits, version, hero status)
adom-wiki-publish status adom-google

# Open the wiki page in pup and screenshot it for visual verification
adom-wiki-publish verify adom-google

adom-wiki-publish push adom-google --files path/to/new-file.md -m "Add new-file"

adom-wiki-publish lint .

# Publishing adom-google to Wiki v2

This file is your **runbook** for syncing this package to the wiki. Any Claude
thread can read this and know exactly how to push updates without re-learning
the API. Auto-generated by `adom-wiki-publish create`.

## Quick sync: "update the wiki for adom-google"

The simplest path uses the CLI:

```bash
# Push specific files (commits are free — no version bump)
adom-wiki-publish push adom-google --files README.md SKILL.md -m "Update docs"

# When ready to cut a new installable release
adom-wiki-publish publish adom-google --bump patch
```

## Verifying it worked

```bash
# Show page status (commits, version, hero status)
adom-wiki-publish status adom-google

# Open the wiki page in pup and screenshot it for visual verification
adom-wiki-publish verify adom-google
```

## Bundle info

- **Type:** app
- **Wiki page:** https://wiki.adom.inc/pages/adom-google
- **Install:** `adompkg install adom-google`
- **Source:** this repository (commit, push, then sync to wiki)

## Adding a new file

Use `adom-wiki-publish push`:

```bash
adom-wiki-publish push adom-google --files path/to/new-file.md -m "Add new-file"
```

The CLI auto-detects binary files (.png, .jpg, .pdf, etc.) and base64-encodes them.
Text files get scanned for secrets before pushing.

## Hero image

Hero images live in `docs/hero.png` (or `docs/hero.jpg`). The `publish` command
auto-uploads it and sets the wiki metadata.

**Hero quality rules** (enforced by the linter):
- BEST: Screenshot of the real tool running with real data
- GOOD: Screenshot of real CLI output in a terminal
- ACCEPTABLE: Screenshot of a real app the skill controls
- BAD: Screenshot of the wiki page itself (circular)
- NEVER: AI-generated cards, stock photos, ImageMagick text-on-background

If you can't capture a real screenshot right now, defer — do not fake one.

## Running the linter

```bash
adom-wiki-publish lint .
```

Before any `publish`, the linter runs automatically. Fix any FAIL checks before
the tarball will upload.

## Notes

- This file is committed to git so any future Claude session can read it.
- The CLI auto-updates the skill list (for bundles) when you `push` new sub-skills.
- For more details on the CLI: `adom-wiki-publish --help` or read the
  `adom-wiki-publish` skill at `~/.claude/skills/adom-wiki-publish/SKILL.md`.