Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.scoutica.com/llms.txt

Use this file to discover all available pages before exploring further.

The init command is your entry point for generating a brand-new Skill Card manually or interactively without ingesting documents (for parsing documents, see scan).

​
Command Syntax

scoutica init [options] [directory]

​
Options

OptionBehavior
--aiTriggers the AI Assistant flow instead of the manual Q&A wizard. Allows you to paste your bio, experience, or raw CV into the terminal and let the AI build the card.
directoryTarget directory where the .scoutica folder structure should be initialized. If omitted, uses the current working directory (./).

​
1. Manual Interactive Mode (Default)

The simplest way to start. When you run scoutica init, the CLI will prompt you in the terminal with targeted questions about your professional profile. 
scoutica init ./my-freelance-card
What it does:
  • Asks for your Name, Professional Title, Entity Type (e.g. human vs agent).
  • Asks for your Seniority and Years of Experience.
  • Asks for core Domains and explicit Skills.
  • Finally asks for basic Engagement Rules (e.g., Remote Policy, Minimum Base Pay EUR).
  • Outputs exactly 4 structured files: profile.json, rules.yaml, evidence.json, and SKILL.md.
Why use it:
  • If you have highly specific metadata that an AI might get wrong.
  • If you prefer to construct your data precisely from scratch rather than modifying generated output.
  • Excellent for extremely senior engineers whose experience transcends standard NLP parsing.

​
Use Case

You are creating a specialized stealth profile for a high-security consulting firm. You do not want any historical AI context mixing with your clean record. You use scoutica init, enter 5 highly tuned technical parameters, decline the rest, and manually edit the YAML and JSON.

​
2. AI Guided Mode (--ai)

If you want a lightning-fast process but don’t want to deal with moving files into folders to scan, use the --ai flag. 
scoutica init --ai
What it does:
  • Instead of asking 20 individual questions, it prompts you to paste a massive text dump into the terminal (like your LinkedIn summary, your website text, or your CV).
  • It pipes this input through your local AI Provider (gemini, claude, etc.).
  • It extracts the structured schema directly into your directory in seconds.
Why use it:
  • You already have a great written biography and don’t want to re-type it manually into a wizard.
  • You have an unstructured textual copy of your resume and just want to map it to the rigorous protocol syntax immediately.

​
Use Case

You just finished updating your Markdown-based portfolio website. You run scoutica init --ai, paste the raw source code of your index.md file, hit CTRL+D to submit, and your structured machine-readable profile generates seamlessly.