Skip to main content
The Scoutica CLI is a single Bash script installed to ~/.scoutica/bin/scoutica. It handles the full lifecycle of a Skill Card — from creation to validation, publishing, and discovery.

​
Help output

Scoutica CLI v0.1.0
Your skills. Your rules. Your data.

Usage:
  scoutica <command> [options] [directory]

Commands:
  init              Create your Skill Card (interactive wizard)
  init --ai         Create card using AI assistant
  scan              Auto-generate card from your documents (AI-powered)
  resolve           Fetch and display a card from a URL
  validate          Validate card against protocol schemas
  publish           Push card to GitHub
  info              Show card summary
  update            Update the Scoutica CLI to the latest version
  doctor            Diagnostics and system check for the CLI
  help              Show this help
  version           Show version

Examples:
  # Create your card in the current directory
  scoutica init

  # Create card in a specific folder
  scoutica init ./my-card

  # Validate and publish
  scoutica validate && scoutica publish

  # Auto-generate card from your CV folder
  scoutica scan ~/CV/

​
Command summary

CommandDescription
initInteractive wizard to create your Skill Card
scanAI-powered card generation from your documents
validateValidate your card against the protocol schemas
publishStage and push your card files to GitHub
resolveFetch and display a remote Skill Card by URL
infoShow a summary of your local card
doctorRun system diagnostics and check prerequisites
updateUpdate the CLI and templates to the latest version

​
All commands

init

Create your Skill Card with an interactive wizard or AI-guided flow.

scan

Auto-generate a card from your CV, certificates, and portfolio using a local AI CLI.

validate

Validate your card against the JSON Schema before publishing.

publish

Stage only canonical card files and push them to your GitHub repo.

resolve

Fetch and display any Skill Card from a public URL.

info

Show a quick summary of the card in the current directory.

doctor

Run a full system check to verify all prerequisites are installed.

update

Re-run the installer to fetch the latest CLI and templates.

​
Global conventions

All commands accept an optional [directory] argument. When omitted, the current working directory is used. 
scoutica validate            # validates ./
scoutica validate ./my-card  # validates ./my-card/
Exit codes follow standard UNIX conventions: 0 for success, non-zero for failure.