hoziron-cli competency

Install, inspect, and configure competencies.

There is no activate/deactivate/pause/resume/install-deps verb in this command group — a competency isn't activated on its own. It's bundled into an agent-template package and equipped as part of creating/activating the agent that carries it. See Creating an Agent and agent activate for the actual activation path, and authoring.md for how required_skills gets declared in the first place (there's no separate CLI step to "install missing dependencies" — install the missing skill package directly with hoziron-cli catalog install).

Synopsis

hoziron-cli competency <subcommand> [options]

Subcommands

Subcommand	Description
`list`	List all installed competencies
`active`	Show currently active instances
`install <path>`	Install from a local directory
`info <id>`	Show detailed information
`check-deps <id>`	Check skill dependencies
`config <id>`	View or update settings
`check-schedules`	Check schedule drift (all bindings)
`reset-schedule`	Reset a schedule to manifest default

hoziron-cli competency list

List all installed competencies.

$ hoziron-cli competency list
NAME                           VERSION      STATUS
─────────────────────────────────────────────────────────
claims-intake                  1.2.0        installed
policy-lookup                  1.0.1        installed
code-review                    2.0.0        installed

# No competencies installed
$ hoziron-cli competency list
No competencies installed.

hoziron-cli competency active

Show currently active competency instances.

$ hoziron-cli competency active
COMPETENCY                     INSTANCE             STATE
claims-intake                  claims-intake-agent  Running
customer-svc                   cs-agent             Paused

# No active instances
$ hoziron-cli competency active
No active competency instances.

active queries GET /competencies/active, which is currently a live but stubbed endpoint on the daemon side — it always returns an empty instance list regardless of what's actually equipped to running agents. Use hoziron-cli agent list / hoziron-cli agent status for the authoritative view of which agents (and therefore which competencies) are currently running.

hoziron-cli competency install

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

hoziron-cli competency install <path>

Example

$ hoziron-cli competency install ./competencies/claims-intake/
Competency installed: claims-intake

# Validates:
# - COMPETENCY.md exists and is valid TOML
# - Required fields: description, required_skills
# - At least one required_skill is listed
#
# Identity (id/name) comes from the sibling MANIFEST.toml, not COMPETENCY.md.
# Category is optional; if set, must be a valid enum value.

Installing a competency does not activate it — it becomes available for an agent-template package to declare as a dependency (see Creating an Agent).

hoziron-cli competency info

Show detailed information about a competency.

$ hoziron-cli 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-cli competency check-deps

Verify that all required skills are installed.

$ hoziron-cli 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

If a dependency is missing, install it directly with hoziron-cli catalog install <skill-name> — there is no install-deps shortcut that does this for you.

hoziron-cli competency config

View or update settings for an active competency instance.

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

Flags

Flag	Description
`--list`	List 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-cli 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-cli competency config claims-intake --get auto_escalate_threshold
4

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

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

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

hoziron-cli 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-cli competency check-schedules
All competency schedules are healthy. No drift detected.

Output with drift detected

$ hoziron-cli 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

Status	Meaning
`missing`	Cron job ID is recorded but job no longer exists in the kernel scheduler
`not_created`	Manifest declares a schedule but no job was created on equip
`expression_mismatch`	Job exists but its expression differs from manifest default
`invalid_id`	Stored job ID is malformed (should not occur)

hoziron-cli competency reset-schedule

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

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

Flags

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

Example

$ hoziron-cli 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

category is optional. When set, valid values are:

Insurance
Security
Productivity
Development
Communication
Data
Finance
Research
Operations
Other

Taxonomy-backed classification for the catalog comes from [package.metadata] categories in MANIFEST.toml.

hoziron-cli competency

Synopsis

Subcommands

hoziron-cli competency list

hoziron-cli competency active

hoziron-cli competency install

Example

hoziron-cli competency info

hoziron-cli competency check-deps

hoziron-cli competency config

Flags

Examples

hoziron-cli competency check-schedules

Output with drift detected

Status values

hoziron-cli competency reset-schedule

Flags

Example

Competency Categories

See Also