pp-visit-detroit-blog

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/travel/visit-detroit-blog/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Visit Detroit Blog — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `visit-detroit-blog-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install visit-detroit-blog --cli-only
   ```
2. Verify: `visit-detroit-blog-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/travel/visit-detroit-blog/cmd/visit-detroit-blog-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## When to Use This CLI

Reach for this CLI when an agent or user needs Detroit travel and editorial recommendations grounded in Visit Detroit's official blog: finding articles by neighborhood and topic together, reading full article bodies offline, discovering related reads, or assembling a shareable reading list. It is the right tool for 'what should I do, eat, or see in <Detroit neighborhood>' questions and for separating editorial from sponsored content. It is not a hotel/restaurant directory — it is the editorial blog.

## When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

## Unique Capabilities

These capabilities aren't available in any other tool for this API.

### Queries the website can't express
- **`blogs list`** — Filter Detroit articles by category AND neighborhood AND date window in one query — the slice the website's single-facet search can't express.

  _Reach for this when a request combines a topic and a place (and optionally recency) — e.g. 'recent dining articles in Corktown' — instead of issuing several single-facet searches and intersecting them by hand._

  ```bash
  inside-the-d-pp-cli blogs list --category Dining --region Corktown --since 2026-01-01 --agent
  ```
- **`blogs related`** — Find the articles that share the most categories and neighborhoods with a given post, ranked.

  _Use this to chain recommendations — after surfacing one good article, hand the user (or yourself) the next best reads without another keyword search._

  ```bash
  inside-the-d-pp-cli blogs related donuts --limit 5 --agent
  ```
- **`blogs coverage`** — Cross-tabulate article counts across every category and every neighborhood to see where coverage is dense or thin.

  _Use this to answer 'which neighborhoods have the most Outdoors coverage' or to spot gaps before recommending an under-covered area._

  ```bash
  inside-the-d-pp-cli blogs coverage --category Outdoors --agent
  ```

### Take it with you
- **`blogs reading-list`** — Materialize an ordered, deduped reading list (markdown/json/csv) from any filter to a file — with an option to drop sponsored posts for a neutral handout.

  _Use this when a person needs to hand a curated, source-stable list to a team or attendee — not a one-off query that disappears when the tab closes._

  ```bash
  inside-the-d-pp-cli blogs reading-list --region "Downtown Detroit" --category Culture --no-sponsored --output detroit-culture.md
  ```

## Command Reference

Run `visit-detroit-blog-pp-cli sync` once to populate the local store, then:

**blogs** — browse, read, and analyze articles

- `visit-detroit-blog-pp-cli blogs list` — filter articles across category, neighborhood, and date
- `visit-detroit-blog-pp-cli blogs get <slug>` — read a full article by slug, URI, or id
- `visit-detroit-blog-pp-cli blogs related <slug>` — articles sharing the most categories and neighborhoods
- `visit-detroit-blog-pp-cli blogs coverage` — category × neighborhood cross-tab
- `visit-detroit-blog-pp-cli blogs reading-list` — export an ordered md/json/csv reading list

**Top-level**

- `visit-detroit-blog-pp-cli search <query>` — offline ranked full-text search
- `visit-detroit-blog-pp-cli categories` — list blog categories with article counts
- `visit-detroit-blog-pp-cli regions` — list neighborhoods/regions with article counts
- `visit-detroit-blog-pp-cli recent` — newest articles by post date
- `visit-detroit-blog-pp-cli sync` — pull all articles into the local store


### Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

```bash
visit-detroit-blog-pp-cli which "<capability in your own words>"
```

`which` resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code `0` means at least one match; exit code `2` means no confident match — fall back to `--help` or use a narrower query.

## Recipes


### Recent dining articles in a neighborhood

```bash
visit-detroit-blog-pp-cli blogs list --category Dining --region "Eastern Market" --since 2025-01-01
```

Cross-axis filter: topic plus place plus recency in one query the site's single-facet search can't run.

### Neutral attendee reading list

```bash
visit-detroit-blog-pp-cli blogs reading-list --region "Downtown Detroit" --category Culture --no-sponsored --output detroit-culture.md
```

Builds a stable, sponsored-free markdown reading list to hand to a team — every web search is otherwise ephemeral.

### Where is the blog dense vs thin?

```bash
visit-detroit-blog-pp-cli blogs coverage --category Outdoors
```

Cross-tabulates Outdoors coverage by neighborhood — a two-dimensional view Algolia's facet API can't return.

### Agent: narrow a large result to high-gravity fields

```bash
visit-detroit-blog-pp-cli search "patio season" --agent --select title,uri,snippet --limit 5
```

Pairs --agent with --select so the agent gets only title, URL, and summary instead of full bodies for every hit — bounded context.

### Chain from one good article to the next

```bash
visit-detroit-blog-pp-cli blogs related ikea --limit 5 --agent
```

Returns the most topically and geographically similar posts to an article, as JSON, for follow-up recommendations.

## Auth Setup

No authentication required.

Run `visit-detroit-blog-pp-cli doctor` to verify setup.

## Agent Mode

Add `--agent` to any command. Expands to: `--json --compact --no-input --no-color --yes`.

- **Pipeable** — JSON on stdout, errors on stderr
- **Filterable** — `--select` keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on long article bodies:

  ```bash
  visit-detroit-blog-pp-cli blogs list --agent --select title,url,categories
  ```
- **Previewable** — `--dry-run` shows the request without sending
- **Offline-friendly** — sync/search commands can use the local SQLite store when available
- **Non-interactive** — never prompts, every input is a flag
- **Read-only** — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests

### Output shape

Commands emit a **bare JSON array** on stdout under `--json`/`--agent` or when piped — a single JS