# @exellix/catalox-ai-skills

> Catalox skill catalog domain for ai-skills and ai-sub-skills — resolve, merge, CRUD, tokens, and picker helpers

Latest version **1.3.0** (published 2026-08-02) · exellix-license license · 0 weekly downloads

## Install

```sh
npm install @exellix/catalox-ai-skills
pnpm add @exellix/catalox-ai-skills
yarn add @exellix/catalox-ai-skills
bun add @exellix/catalox-ai-skills
```

Provides the command `catalox-ai-skills`.

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.3.0 |
| Published | 2026-08-02 |
| First published | 2026-06-28 |
| Weekly downloads | 0 |
| License | exellix-license |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=20 |
| Dependencies | 3 |
| Unpacked size | 585.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | exellix |
| Maintainers | exellix |
| Keywords | ai, skills, catalox, catalog |

## Links

- npm: https://www.npmjs.com/package/@exellix/catalox-ai-skills
- Repository: https://github.com/exellix/ai-tasks-mono-repo
- Homepage: https://github.com/exellix/ai-tasks-mono-repo#readme
- Issues: https://github.com/exellix/ai-tasks-mono-repo/issues
- npm.io page: https://npm.io/package/@exellix/catalox-ai-skills

## Dependencies (3)

- [@x12i/env](https://npm.io/package/@x12i/env.md) ^4.0.3
- [@x12i/catalox](https://npm.io/package/@x12i/catalox.md) ^6.0.0
- [@x12i/catalox-contracts](https://npm.io/package/@x12i/catalox-contracts.md) ^6.0.0

## Alternatives

- [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads
- [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads
- [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads
- [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads
- [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads

## Recent versions

- 1.3.0 (latest) — 2026-08-02
- 1.2.0 — 2026-07-13
- 1.1.0 — 2026-07-13
- 1.0.7 — 2026-07-11
- 1.0.6 — 2026-07-10
- 1.0.5 — 2026-07-05
- 1.0.4 — 2026-06-30
- 1.0.2 — 2026-06-29
- 1.0.1 — 2026-06-29
- 1.0.0 — 2026-06-28

## README

# @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`**](../documenations/catalox-6-rollout.md).

## Usage

```typescript
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:

```bash
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](../ai-skills/README.md#direct-functions-re-consider).

## Provisioning

```bash
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:

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

## Catalog CLI (export / import)

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

```bash
# 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.

---
_Source: https://npm.io/package/@exellix/catalox-ai-skills · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._