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
  preview           Build HTML layout and publish to here.now
  info              Show card summary

  org init          Create Employer Identity Card
  org verify        Verify domain ownership
  org publish       Push employer card to GitHub
  role create       Create a structured job posting
  role validate     Validate role(s) against schemas
  
  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
previewBuild a beautiful HTML preview and publish to here.now
resolveFetch and display a remote Skill Card by URL
infoShow a summary of your local card
orgScaffold and publish a Recruiter Card for employers
roleCreate and validate structured job postings
doctorRun system diagnostics and check prerequisites
updateUpdate the CLI and templates to the latest version

​
All commands

org

Scaffold a new Recruiter Card, verify your organization’s domain, and publish to GitHub.

role

Create structured role.json job postings and validate them against the protocol schemas.

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.

preview

Build a Neo-Brutalist HTML page from your card data and publish it to here.now.

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.