mturac/visualship

Dernière activité source enregistrée: 27 octobre 2026 à 01:39

Catalogue SkillsMP mis à jour: 5 novembre 2026 à 19:57

skills collectés: 1

Étoiles GitHub: 0
Forks GitHub: 0

Installer avec un assistant IA

Copiez ce prompt dans l’assistant IA que vous utilisez.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/mturac/visualship.

README du dépôt

Fichier source du README : README.md

Lire le README source

Afficher le README complet

# visualship ![visualship: FAIL on a badge-only README, PASS once a hero screenshot exists](docs/hero.png) **No hero, no ship.** `visualship` is a tiny CLI + agent skill that refuses to ship a public repo until its README shows a real screenshot or GIF above the fold — not a wall of badges. AI agents now publish repos in minutes. Most land with a generated wall of text, six badges and zero pictures of the thing working. visualship is a one-second gate you (or your agent) run before flipping a repo public. ## Install ```sh git clone https://github.com/mturac/visualship && node visualship/bin/visualship.js check . ``` Zero dependencies. Node >= 18. ## What it checks | Verdict | When | Exit | |---|---|---| | `FAIL` | README missing, no image, only badges (shields.io, codecov, coveralls, Actions badges), broken local image path, or hero below line 40 | 1 | | `WARN` | No install one-liner in a code block, or unsourced metric claims (`used by 10,000+`, `#1 on Product Hunt`) | 0 | | `PASS` | Real hero image above the fold, install line, no invented numbers | 0 | The last line is always machine-readable: `VERDICT<TAB>PASS|WARN|FAIL`. ## Example ```text $ node bin/visualship.js check fixtures/fail FAIL no image in README — add a screenshot/GIF hero VERDICT FAIL $ node bin/visualship.js check . OK hero visual: docs/hero.png (line 3) VERDICT PASS ``` ## Agent skill Drop [`skills/visualship/SKILL.md`](skills/visualship/SKILL.md) into your agent's skills folder (Claude Code, Codex, Cursor, …). When asked to ship/publish/open-source a repo, the agent runs the check first and adds a hero visual before going public. Not a security scanner — pair it with a skill security tool for that. ## License MIT © Turaç (mturac)

Chargement du README du dépôt…

Skills dans ce dépôt

classification en attente

skill

métier

description

mis à jour

visualship

non classé

Use before shipping, publishing, or open-sourcing a repo (making it public, tagging a release, posting it). Runs the visualship README hero gate.

Langue du texte source : anglais

2026-10-27

Affichage de 1 skills collectés sur 1.