Readme Updater

3. Generate org chart image

For each company that does NOT already have an images/org-chart.png, generate one:

~/paperclip scripts/generate-company-assets.ts <company-directory>

If the image already exists and the company hasn't changed, skip regeneration. If the user explicitly asks to regenerate, run it again.

4. Write the README

Replace the ## Companies section in README.md with entries for every discovered company. Preserve all other sections (## Structure, ## Shared Skills, ## Usage, etc.) exactly as they are.

Entry format

Each company entry MUST follow this exact format:

### [Company Name](./<directory-name>)

```bash
npx companies.sh add paperclipai/companies/<directory-name>
```

<One-sentence description from COMPANY.md body. Keep it concise — one to two sentences max.> Built from [upstream name](upstream-url).

![Company Name Org Chart](./<directory-name>/images/org-chart.png)

> **Agents (N):** Agent One, Agent Two, Agent Three (limit to 25 "and N more")
>
> **Skills (N):** skill-one, skill-two, skill-three (limit to 25 "and N more")

Rules:

• The heading links to the company directory
• The description is a brief summary, NOT the full COMPANY.md body
• The upstream source link comes from the "Generated from" line in COMPANY.md. Append it naturally to the description sentence (e.g., "Built from gstack.")
• The org chart image path is always ./<dir>/images/org-chart.png
• Agent names are title-cased with hyphens replaced by spaces
• Skill names stay hyphenated (as directory names)
• Agent and skill counts go in parentheses after the label
• If a company has no skills directory or no skills, omit the Skills line

Index table

Before the ## Companies heading, include a summary index table:

| Company                         | Agents | Skills | Source        |
| ------------------------------- | ------ | ------ | ------------- |
| [Company Name](#heading-anchor) | N      | N      | [source](url) |

• The Company column links to the heading anchor (lowercase, hyphens for spaces)
• Skills column shows — if the company has no skills
• Table order matches the company entry order below

Ordering

The first three companies are always GStack, Superpowers Dev Shop, and Agency Agents, in that order. Remaining companies follow alphabetically by directory name. Place default last if it is included.

Naming overrides

Some companies use a display name different from their COMPANY.md name field. Always apply these overrides:

• agency-agents directory → display as Agency Agents (not "The Agency")

5. Verify

After writing, read back the README and confirm:

• Every company directory with a COMPANY.md has an entry
• No company entries exist for directories that were removed
• All image paths point to files that exist
• Agent and skill counts match actual directory contents