Ora : Spinners pour terminal

VérifiéSûr

Ajoutez des spinners de terminal avec Ora. Utilisez pour afficher des indicateurs de chargement dans les outils CLI, montrer la progression lors d'opérations asynchrones ou créer des interfaces en ligne de commande élégantes avec retour d'état.

Spar Skills Guide Bot
DeveloppementDébutant
28/07/2026
Claude CodeCursorWindsurfCopilotCodex
#ora#cli-spinner#terminal-ui#nodejs#progress-feedback

Recommandé pour

Synthèse automatique

Cette skill documente l'utilisation d'Ora, une bibliothèque Node.js qui affiche des spinners et des indicateurs de statut dans le terminal pendant des opérations asynchrones.

Points forts

  • API très simple : start(), succeed(), fail() couvrent la majorité des cas
  • Montre les opérations multi-étapes avec réutilisation d'une même instance de spinner
  • Explique comment mettre à jour spinner.text et utiliser stopAndPersist() pour des symboles personnalisés
  • Signale les pièges concrets : ESM-only depuis la v6 et comportement statique en CI

Limites

  • Ne couvre que l'affichage : aucune gestion d'annulation, de timeout ou de verbosité conditionnelle
  • Les exemples supposent des fonctions internes (exec, build, deployToCloud) non fournies
  • Pas d'indications sur l'intégration avec des frameworks de test ou des loggers structurés
Quand l'utiliser

À utiliser lorsqu'il faut ajouter des indicateurs de chargement ou de progression soignés à un outil en ligne de commande Node.js.

Quand l'éviter

À éviter si l'outil doit produire une sortie machine (JSON, logs structurés) ou si le projet n'est pas en Node.js.

Analyse de sécurité

Sûr
Score qualité90/100

The skill only documents usage patterns for the Ora terminal spinner library with benign TypeScript examples. It declares no tools, executes no commands, and contains no destructive, exfiltration, obfuscation, or safety-disabling behavior.

Aucun point d'attention détecté

Comment cette analyse est faite

Exemples

Add a spinner to an install step
Wrap my `npm install` call in a CLI script with an ora spinner that shows succeed on completion and fail plus exit code 1 on error.
Multi-step deploy feedback
Refactor my deploy script so each phase (build, tests, deploy, health check) reuses one ora spinner and ends with a clear succeed or fail message.
Custom persisted summary line
Use ora's stopAndPersist with a custom green checkmark and chalk colours to print a final 'Processed 42 files in 3.2s' summary line.

name: ora description: >- Add terminal spinners with Ora. Use when showing loading indicators in CLI tools, displaying progress during async operations, or building polished command-line interfaces with status feedback. license: Apache-2.0 compatibility: 'Node.js 16+' metadata: author: terminal-skills version: 1.0.0 category: development tags: [ora, cli, spinner, loading, terminal]

Ora

Overview

Ora creates elegant terminal spinners. Show progress during async operations (API calls, file processing, builds), then succeed/fail with a final status. Used by create-next-app, Vercel CLI, Angular CLI.

Instructions

Step 1: Basic Spinner

import ora from 'ora'

const spinner = ora('Installing dependencies...').start()

try {
  await exec('npm install')
  spinner.succeed('Dependencies installed')
} catch (err) {
  spinner.fail('Installation failed')
  process.exit(1)
}

Step 2: Multi-Step Operations

async function deploy(env: string) {
  const spinner = ora()

  spinner.start('Building project...')
  await build()
  spinner.succeed('Build complete')

  spinner.start('Running tests...')
  const results = await runTests()
  spinner.succeed(`${results.passed} tests passed`)

  spinner.start(`Deploying to ${env}...`)
  const url = await deployToCloud(env)
  spinner.succeed(`Deployed to ${url}`)

  spinner.start('Verifying deployment...')
  await healthCheck(url)
  spinner.succeed('Deployment verified ✓')
}

Step 3: With Other Libraries

import ora from 'ora'
import chalk from 'chalk'

const spinner = ora({
  text: 'Processing files...',
  color: 'cyan',
  spinner: 'dots',       // or 'line', 'arc', 'bouncingBar'
})

spinner.start()
spinner.text = `Processing ${chalk.bold('image-001.png')}...`
// ... after processing
spinner.text = `Processing ${chalk.bold('image-002.png')}...`

spinner.stopAndPersist({
  symbol: chalk.green('✓'),
  text: `Processed ${chalk.bold('42')} files in ${chalk.gray('3.2s')}`,
})

Guidelines

  • succeed() / fail() / warn() / info() stop the spinner with a status icon.
  • stopAndPersist() for custom symbols/text when the built-in statuses don't fit.
  • Update spinner.text during long operations to show progress.
  • Ora is ESM-only since v6. Use import ora from 'ora'.
  • In CI environments, ora falls back to static text (no animation).

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/ora-terminal-spinners-ms47vp7r/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/ora-terminal-spinners-ms47vp7r' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/ora-terminal-spinners-ms47vp7r/download' --output '.skill-downloads/ora-terminal-spinners-ms47vp7r/SKILL.md.part' && mv '.skill-downloads/ora-terminal-spinners-ms47vp7r/SKILL.md.part' '.skill-downloads/ora-terminal-spinners-ms47vp7r/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Environnement déclaré par l’auteur : Node.js 16+

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.

Claude Code
test -f '.skill-downloads/ora-terminal-spinners-ms47vp7r/SKILL.md' && test -s '.skill-downloads/ora-terminal-spinners-ms47vp7r/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/ora' && cp -R '.skill-downloads/ora-terminal-spinners-ms47vp7r' '.claude/skills/ora'

Cursor
test -f '.skill-downloads/ora-terminal-spinners-ms47vp7r/SKILL.md' && test -s '.skill-downloads/ora-terminal-spinners-ms47vp7r/SKILL.md' && mkdir -p '.cursor/skills' && test ! -e '.cursor/skills/ora' && cp -R '.skill-downloads/ora-terminal-spinners-ms47vp7r' '.cursor/skills/ora'

Codex
test -f '.skill-downloads/ora-terminal-spinners-ms47vp7r/SKILL.md' && test -s '.skill-downloads/ora-terminal-spinners-ms47vp7r/SKILL.md' && mkdir -p '.agents/skills' && test ! -e '.agents/skills/ora' && cp -R '.skill-downloads/ora-terminal-spinners-ms47vp7r' '.agents/skills/ora'

OpenSkills

OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.

Installation officielle d’OpenSkills
openskills install './.skill-downloads/ora-terminal-spinners-ms47vp7r'

openskills read 'ora-terminal-spinners-ms47vp7r'

La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.

Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.

openskills sync

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/ora-terminal-spinners-ms47vp7r/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires