hoziron competency

Manage competencies — install, activate, configure, and monitor.

Synopsis

hoziron competency <subcommand> [options]

Subcommands

SubcommandDescription
listList all available competencies
activeShow currently active instances
install <path>Install from a local directory
activate <id>Activate a competency
deactivate <id>Deactivate an instance
info <id>Show detailed information
check-deps <id>Check skill dependencies
install-deps <id>Install missing dependencies
pause <id>Pause a running instance
resume <id>Resume a paused instance
config <id>View or update settings
check-schedulesCheck schedule drift (all bindings)
reset-scheduleReset a schedule to manifest default

hoziron competency list

List all installed competencies.

$ hoziron competency list
ID               NAME                  CATEGORY    STATUS     SKILLS
claims-intake    Claims Intake         Insurance   Active     3/3 ✓
policy-lookup    Policy Lookup         Insurance   Installed  1/1 ✓
code-review      Code Review           Development Installed  2/2 ✓
customer-svc     Customer Service      Insurance   Active     2/3 ✗

hoziron competency active

Show currently active competency instances.

$ hoziron competency active
ID               NAME              AGENT                STATE
claims-intake    Claims Intake     claims-intake-agent  Running
customer-svc     Customer Service  cs-agent             Paused

hoziron competency install

Install a competency from a local directory containing COMPETENCY.toml.

hoziron competency install <path>

Example

$ hoziron competency install ./competencies/claims-intake/
✓ Competency 'claims-intake' installed

# Validates:
# - COMPETENCY.toml exists and is valid TOML
# - Required fields: id, name, description, category, required_skills, [agent]
# - Category is a valid enum value
# - At least one required_skill is listed

Error: already installed

$ hoziron competency install ./competencies/claims-intake/
✗ Competency 'claims-intake' is already installed

hoziron competency activate

Activate a competency, creating its agent instance.

hoziron competency activate <id> [--name <instance-name>]

Flags

FlagDescription
-n, --name <name>Instance name (required for multiple instances of the same competency)

Examples

# Activate with default name
$ hoziron competency activate claims-intake
✓ Competency 'claims-intake' activated
  Agent: claims-intake-agent (Running)

# Activate with custom instance name
$ hoziron competency activate claims-intake --name claims-intake-eu
✓ Competency 'claims-intake' activated as 'claims-intake-eu'

Error: missing dependencies

$ hoziron competency activate claims-intake
✗ Cannot activate: missing required skills
  ✗ document-ocr (not installed)
  ✓ postgresql-connector
  ✓ email-skill

Run: hoziron competency install-deps claims-intake

hoziron competency deactivate

Deactivate an active competency instance.

$ hoziron competency deactivate claims-intake
✓ Competency 'claims-intake' deactivated

hoziron competency info

Show detailed information about a competency.

$ hoziron competency info claims-intake
Competency: Claims Intake
ID: claims-intake
Category: Insurance
Status: Active
Description: First Notice of Loss processing for property and auto claims

Agent:
  Name: claims-intake-agent
  Description: Processes first notice of loss and initiates claims

Required Skills:
  ✓ document-ocr
  ✓ postgresql-connector
  ✓ email-skill

Required Permissions:
  • database:read
  • database:write
  • api:claimcenter:write

Integrations:
  • guidewire-claimcenter
  • lexisnexis-clue

Schedule: 0 */6 * * *

Settings:
  auto_escalate_threshold = "4" (Auto-Escalate Severity)
  require_clue_report = "true" (Require CLUE Report)

Metrics:
  • Claims Processed (claims_processed_count)
  • Avg Processing Time (avg_processing_time_ms)

hoziron competency check-deps

Verify that all required skills are installed.

$ hoziron competency check-deps claims-intake
Dependency Status for 'claims-intake':
  ✓ document-ocr (v1.2.0 installed)
  ✓ postgresql-connector (v2.1.0 installed)
  ✗ email-skill (NOT INSTALLED)

Status: 2/3 dependencies satisfied

hoziron competency install-deps

Install any missing required skills from the catalog.

$ hoziron competency install-deps claims-intake
Installing missing dependencies...
  ↓ email-skill@1.3.0 ... ✓

All dependencies satisfied (3/3)

hoziron competency pause

Pause a running competency instance (agent stops processing but retains state).

$ hoziron competency pause claims-intake
✓ Competency 'claims-intake' paused

hoziron competency resume

Resume a paused competency instance.

$ hoziron competency resume claims-intake
✓ Competency 'claims-intake' resumed

hoziron competency config

View or update settings for an active competency instance.

hoziron competency config <id> [--list] [--get KEY] [--set KEY=VALUE] [--unset KEY]

Flags

FlagDescription
--listList all current settings (default when no flags given)
--get <KEY>Print a single setting value
--set <KEY=VALUE>Set a setting value (repeatable)
--unset <KEY>Remove a setting value (repeatable)

Examples

# List all settings
$ hoziron competency config claims-intake
Settings for 'claims-intake':
  auto_escalate_threshold = "4" (Auto-Escalate Severity)
  require_clue_report = "true" (Require CLUE Report)

# Get a single value
$ hoziron competency config claims-intake --get auto_escalate_threshold
4

# Update a setting
$ hoziron competency config claims-intake --set auto_escalate_threshold=3
✓ Setting updated: auto_escalate_threshold = "3"

# Update multiple settings at once
$ hoziron competency config claims-intake \
    --set auto_escalate_threshold=3 \
    --set require_clue_report=false
✓ 2 settings updated

# Remove a custom setting
$ hoziron competency config claims-intake --unset custom_field
✓ Setting removed: custom_field

hoziron competency check-schedules

Check schedule health across all equipped competency bindings. Reports drift entries where cron jobs are missing, uncreated, or have mismatched expressions.

$ hoziron competency check-schedules
All competency schedules are healthy. No drift detected.

Output with drift detected

$ hoziron competency check-schedules
AGENT                                  COMPETENCY               STATUS             EXPECTED
550e8400-e29b-41d4-a716-446655440000   claims-intake            missing            0 */6 * * *
662f9200-a31c-42d5-b817-557766551111   fnol-notify              expression_mismatch */30 * * * *

Status values

StatusMeaning
missingCron job ID is recorded but job no longer exists in the kernel scheduler
not_createdManifest declares a schedule but no job was created on equip
expression_mismatchJob exists but its expression differs from manifest default
invalid_idStored job ID is malformed (should not occur)

hoziron competency reset-schedule

Reset a competency's cron schedule to the manifest default. Removes any existing job and creates a fresh one.

hoziron competency reset-schedule --agent-id <UUID> --competency-id <ID>

Flags

FlagDescription
--agent-id <UUID>Agent the competency is equipped to
--competency-id <ID>Competency whose schedule to reset

Example

$ hoziron competency reset-schedule \
    --agent-id 550e8400-e29b-41d4-a716-446655440000 \
    --competency-id claims-intake
Schedule reset for competency 'claims-intake' on agent '550e8400-e29b-41d4-a716-446655440000'.

Competency Categories

Valid category values:

  • Insurance
  • Security
  • Productivity
  • Development
  • Communication
  • Data
  • Finance
  • Research
  • Operations
  • Other

See Also