lucianfialho/spec2cli/spec2cli-basics

Claude Code and agent skill by lucianfialho/spec2cli

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Core spec2cli usage: load specs, run commands, format output

Install

npx vskill@latest install lucianfialho/spec2cli/spec2cli-basics

SKILL.md

spec2cli — Basics

spec2cli turns any OpenAPI/Swagger spec into a working CLI. No code generation.

Loading a spec

bash
# Local file (YAML or JSON)
spec2cli --spec ./openapi.yaml <group> <command>
 
# Remote URL
spec2cli --spec https://api.example.com/openapi.json <group> <command>
 
# Swagger 2.0 is auto-converted
spec2cli --spec ./swagger2.json <group> <command>

Discovering commands

bash
# Human-readable help
spec2cli --spec ./api.yaml --help
spec2cli --spec ./api.yaml pets --help
spec2cli --spec ./api.yaml pets create --help
 
# AI-optimized: compact YAML with all commands, params, types
spec2cli --spec ./api.yaml --agent-help

Always start with `--agent-help` — it returns everything you need in one call.

Running commands

Commands follow the pattern: spec2cli --spec <spec> <group> <command> [--flags]

bash
spec2cli --spec api.yaml pets list
spec2cli --spec api.yaml pets list --status available --limit 5
spec2cli --spec api.yaml pets get --petId 1
spec2cli --spec api.yaml pets create --name Rex --tag dog

Output formats

FlagFormatBest for
--output jsonCompact JSON, one linePiping, scripts
--output prettyColorized indented JSONHuman reading (default in TTY)
--output tableAligned columnsScanning lists
--output yamlYAMLConfig files, readability
--quietNo output, just exit codeConditional scripts
--max-items NLimit array resultsLarge responses
bash
spec2cli --spec api.yaml --output json pets list
spec2cli --spec api.yaml --output table pets list
spec2cli --spec api.yaml --output yaml pets get --petId 1
spec2cli --spec api.yaml --max-items 5 pets list

Verbose mode

Show the HTTP request and response for debugging:

bash
spec2cli --spec api.yaml --verbose pets get --petId 1
# → GET https://api.example.com/pets/1
#   Accept: application/json
# ← 200 OK

Project config

Skip --spec by creating a .toclirc:

bash
spec2cli init --spec ./openapi.yaml --base-url https://api.example.com
# Now just: spec2cli pets list

Tips

  • Use --output json when piping to jq
  • Use --agent-help before anything else — one call gives you the full API surface
  • Required params are enforced — the CLI errors before making the request
  • Swagger 2.0 and OpenAPI 3.x both work transparently

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
19
7-day trend score
0

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/lucianfialho/spec2cli/spec2cli-basics/badge)](https://verified-skill.com/skills/lucianfialho/spec2cli/spec2cli-basics)

Something wrong with this skill or its page? Tell us.