@exellix/catalox-ai-skills

@exellix/catalox-ai-skills

Single source of truth for Catalox ai-skills and ai-sub-skills catalogs: resolve/merge forged sub-skills, CRUD, template tokens, authoring validation, and picker helpers.

Node-only — no browser bundle.

Catalox 6: This package bootstraps via Mongo (createCataloxFromEnvAsync / ensureCataloxFromEnv in init-mongo-and-catalox.ts). Env: MONGO_URI or MONGODB_URI. See documenations/catalox-6-rollout.md.

Usage

import {
  createCataloxFromEnv,
  resolveSkillRuntime,
  getSkillTemplatesForPresentation,
  createSubSkill,
  listSkillsForPicker,
  crossValidateSkillTokens,
} from "@exellix/catalox-ai-skills";

Execution (gateway invoke, FlexMD, Activix) stays in @exellix/ai-skills.

Re-consider skills (system)

Five built-in System Skills for AI response revision. Catalog keys (provisioned via AI_SKILLS_CATALOG_ITEMS, tagged usageHints.expectedObjectTypes: ["system"]):

Skill key	Purpose
re-consider.fill-gap	Fill a known gap in a prior response → gapOutput
re-consider.review	Review against original instructions → reviewStatus, reviewOutput
re-consider.rewrite-scope	Rewrite one scope/section → correctedScope
re-consider.rewrite-full	Full answer rewrite → correctedAnswer
re-consider.calibrate-decision	Recalibrate decision/priority/ranking → calibratedOutput

In the skills manager UI they appear under System Skills (not the preset catalog).

Template seeds live under templates/re-consider.*. Provision and sync like any other base skill:

npm run catalox:provision-ai-skills
npm run catalox:sync-skill-templates

Typed execution wrappers (fillReConsiderationGap, reviewReConsiderationResponse, etc.) are on ExellixSkillsClient in @exellix/ai-skills — see ai-skills README.

Provisioning

npm run catalox:provision-ai-skills
npm run catalox:sync-skill-templates
npm run catalox:verify

Provision upserts seed rows from AI_SKILLS_CATALOG_ITEMS and keeps other Catalox skills (e.g. imported cyber-analysis rows). To delete non-seed rows intentionally:

npx tsx scripts/provision-ai-skills-catalog.ts --prune

Catalog CLI (export / import)

Requires MONGO_URI / MONGODB_URI (package .env is loaded automatically).

# list / inspect
npm run catalox:skills -- list
npm run catalox:skills -- get Assets-Cyber-Analysis

# export (all, branch, or selected keys)
npm run catalox:skills -- export --out skills.json
npm run catalox:skills -- export --branch professional-answer --out branch.json
npm run catalox:skills -- export --skills Assets-Cyber-Analysis,Users-Cyber-Analysis --out cyber.json

# import a bundle
npm run catalox:skills -- import --file skills.json --dry-run
npm run catalox:skills -- import --file skills.json --mode replace

# build (+ optional apply) from folders of instructions.md + prompt.md [+ meta.json]
npm run catalox:skills -- from-md --dir ./my-skill-pairs --out bundle.json
npm run catalox:skills -- from-md --dir ./my-skill-pairs --apply --mode replace

After publish, the same entrypoint is available as catalox-ai-skills on PATH.