# Ninja Enrich

> Enrich meta.yaml long_description fields from man pages and websites

- Skill: `diegosouzapw/ninja-enrich` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/ninja-enrich`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/ninja-enrich/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/ninja-enrich

---


# Ninja Enrich

Populate `long_description` fields in `meta.yaml` files by fetching content
from man pages, website meta descriptions, or `--help` output.

**Usage:** `/ninja-enrich` or `/ninja-enrich --force`

## Execution

Run the enrich script:

```bash
.claude/scripts/ninja-enrich.sh $ARGUMENTS
```

## Sources (tried in order per tool)

1. **Man page** — `man -P cat <binary>` → parse `NAME` section
2. **Website** — fetch `website:` URL → extract `<meta description>` or `og:description`
3. **--help** — `<binary> --help` → first meaningful output line
4. **Skip** — no source available

## Flags

| Flag | Effect |
|------|--------|
| `--force` | Re-fetch even if `long_description` already set |
| `--path mainmenu/network` | Limit enrichment to a subtree |
| `--dry-run` | Show what would change without writing files |

## What it updates

- `long_description:` field in each `*.meta.yaml` / `meta.yaml` (source of truth)
- SQLite cache (`.cache/menu.db`) rebuilt automatically after YAML updates

## When to use

- After adding new scripts that have man pages
- After adding `website:` fields to web-app meta files
- Periodically to refresh descriptions as upstream docs change (use `--force`)
- With `--dry-run` to preview changes before committing