Ninja Enrich

VérifiéPrudence

Remplit le champ 'long_description' dans les fichiers meta.yaml en récupérant le contenu depuis les pages de manuel, les méta-descriptions de sites web ou l'output --help. Utile pour générer automatiquement des descriptions après l'ajout de nouveaux scripts ou de champs website. Prend en charge --force pour forcer la mise à jour et --dry-run pour prévisualiser les modifications.

Spar Skills Guide Bot
DeveloppementIntermédiaire
9002/06/2026
Claude Code
#meta-yaml#enrichment#automation#man-pages

Recommandé pour

Notre avis

Enrichit les champs long_description des fichiers meta.yaml à partir de pages de manuel, de descriptions de sites web ou de l'aide en ligne.

Points forts

  • Utilise plusieurs sources (man, web, --help) pour trouver la meilleure description
  • Respecte les descriptions existantes sauf si --force est utilisé
  • Support du mode dry-run et du filtrage par chemin
  • Mise à jour automatique du cache SQLite

Limites

  • Dépend de la disponibilité des pages de manuel ou des balises meta sur les sites web
  • Ne peut pas remplacer une rédaction manuelle nuancée
  • L'extraction depuis --help peut donner des lignes peu pertinentes
Quand l'utiliser

À utiliser après avoir ajouté de nouvelles commandes avec pages de manuel ou sites web référencés, ou pour rafraîchir périodiquement les descriptions.

Quand l'éviter

Éviter lorsque les descriptions sont rédigées à la main et doivent rester inchangées, ou si les sources en amont sont peu fiables.

Analyse de sécurité

Prudence
Score qualité88/100

The skill runs a Bash script that performs network requests and writes to files. While the described actions are legitimate for enrichment, the script's implementation is not provided, and network fetches carry inherent risk. No indication of direct harmful commands, but caution is warranted.

Points d'attention
  • Executes a shell script (.claude/scripts/ninja-enrich.sh) that may fetch content from external websites, which could potentially be used to introduce malicious content or exfiltrate data if the script is compromised.
  • Modifies files (meta.yaml) and rebuilds SQLite cache, which could cause data loss or corruption if the script behaves unexpectedly.

Exemples

Enrich a subtree
/ninja-enrich --path mainmenu/network
Force refresh all descriptions
/ninja-enrich --force
Preview changes without writing
/ninja-enrich --dry-run

name: ninja-enrich description: "Enrich meta.yaml long_description fields from man pages and websites" argument-hint: "[--force] [--path mainmenu/...] [--dry-run]" disable-model-invocation: true allowed-tools: Bash, Read

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:

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

Sources (tried in order per tool)

  1. Man pageman -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
Skills similaires