# Infographics

Use when generating Basic Memory PR, changelog, release, or weekly images from Codex.

- Repository: https://github.com/basicmachines-co/basic-memory (4440 stars)
- Category: Git and review
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add basicmachines-co/basic-memory --skill infographics -g -a claude-code -y`
Codex: `npx skills add basicmachines-co/basic-memory --skill infographics -g -a codex -y`
Cursor: `npx skills add basicmachines-co/basic-memory --skill infographics -g -a cursor -y`
Gemini CLI: `npx skills add basicmachines-co/basic-memory --skill infographics -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add basicmachines-co/basic-memory`

## Description

Use when generating Basic Memory PR, changelog, release, or weekly images from Codex.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Basic Memory Images

Generate repository visuals with evidence-grounded content and canonical output
paths. The file and marker names still say "infographic" for compatibility, but
PR generation is image-first: scene, poster, painting, photograph, cover,
tableau, staged artifact, or another editorial visual moment that describes the
intent of the PR. PR images are non-gating BM Bossbot artifacts; changelog and
release-summary images are manual evidence-pack workflows.

## Output Contract

- Base output directory: `docs/assets/infographics/`
- PR image: `docs/assets/infographics/pr-<number>.webp`
- Changelog image: `docs/assets/infographics/changelog.webp`
- Weekly image:
  - This is always a 2-Week Retro window: previous ISO week through current ISO
    week (`start-week = current-week - 1`, `end-week = current-week`).
  - Same year window: `docs/assets/infographics/<year>-w<start-week>-w<end-week>.webp`
  - Cross-year window:
    `docs/assets/infographics/<start-year>-w<start-week>-<end-year>-w<end-week>.webp`

## PR Mode

PR mode uses the BM Bossbot summary block as source material. Do not hand-write
claims that are not present in the PR body.

1. Fetch the PR body:

```bash
gh pr view <number> --json body --jq '.body // ""' > /tmp/bm-pr-body.md
```

2. Generate the canonical asset:

```bash
uv run --script scripts/generate_pr_infographic.py \
  --pr-number <number> \
  --pr-body-file /tmp/bm-pr-body.md \
  --theme "<optional visual theme>" \
  --provenance-output /tmp/bm-infographic-provenance.md \
  --output docs/assets/infographics/pr-<number>.webp
```

If the PR body contains a managed image theme block, the script reads it
automatically:

```markdown
<!-- BM_INFOGRAPHIC_THEME:start -->
<theme>
<!-- BM_INFOGRAPHIC_THEME:end -->
```

Before spending an image call, test the prompt path locally:

The rest: https://github.com/basicmachines-co/basic-memory/blob/HEAD/.agents/skills/infographics/SKILL.md
