# AGI-skill-unification

> Multi-harness skill catalog unity — AAA catalog, Grok/Claude/Codex views, alias table (V3 short→disk), mesh-sync, BOOT gate, Hermes bridge. Load when auditing skill mesh, resolving dual names, rebinding harness skills, or before claiming skill inventory complete.

- Skill: `ariffazil/agi-skill-unification-2` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add ariffazil/agi-skill-unification-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ariffazil/agi-skill-unification-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ariffazil (https://skillmd.com/u/ariffazil)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/ariffazil/agi-skill-unification-2

---


# Skill Unification — AAA Catalog × Harness Views

## Iron rule

**AAA is the catalog. Harnesses are views.**  
Doctrine bodies may live under `/root/AAA/skills` *or* `/root/.agents/skills` (doctrine_core).  
Do not invent a second Grok-only catalog.

## Always load first (BOOT gate)

`AAA/skills/BOOTSTRAP_MANIFEST.json` — 9 universals (substrate + knowledge) through READY, then domain skills.

## Canonical artifacts (AAA)

| Artifact | Path |
|----------|------|
| Alias table (63/63) | `/root/AAA/skills/SKILL_ALIAS_TABLE.json` |
| Mesh sync | `/root/AAA/skills/scripts/skill-mesh-sync.sh` |
| V3 registry | `/root/AAA/skills/FEDERATED_SKILLS_REGISTRY_V3.yaml` |
| Meta atlas | `meta-mesa-skill-atlas` (this organ’s sister skill) |
| Complete receipt | `/root/AAA/skills/docs/SKILL-UNIFICATION-COMPLETE-2026-07-12.md` |
| Hermes bridge | `/root/A-FORGE/forge_work/2026-07-12/HERMES-V3-DOMAIN-BRIDGE.md` |

## Resolve a V3 short name

```bash
python3 -c "import json;d=json.load(open('/root/AAA/skills/SKILL_ALIAS_TABLE.json'));
print([a for a in d['aliases'] if a['v3_name']=='meta-atlas'][0])"
```

Prefer `primary_path` / `primary_resolved`. Never invent paths from short names alone.

## Mesh hygiene

```bash
# dry-run
bash /root/AAA/skills/scripts/skill-mesh-sync.sh
# apply missing links (Grok natives preserved)
bash /root/AAA/skills/scripts/skill-mesh-sync.sh --apply
# CI / pre-seal
bash /root/AAA/skills/scripts/skill-mesh-sync.sh --check
```

Harnesses synced: `~/.grok/skills`, `~/.claude/skills`, `~/.codex/skills`.

## Grok native keepers (not AAA bodies)

`arif-governed-autonomous-execution` · `grok-zen-aaa-substrate` · `grok-federation-skill-upgrader` · `orthogonal-skill-update` · `create-skill` · `check-work` · `help` · `imagine`

Pruned: `docx` `pptx` `xlsx` `code-review` → `~/.grok/skills/.deprecated/`

## Pre-seal checklist

1. `skill-mesh-sync.sh --check` exit 0  
2. Alias `resolved == v3_mapped == 63` and `unresolved == []`  
3. No live `TOMBSTONE.json` on V3 primaries (use `RESTORED_LIVE.json` if re-hydrated)  
4. Grok office skills not live top-level  
5. meta-mesa §0 matches live maturity  

## Agent Spawning — Pre-Seal Audit Protocol

Every AAA agent now declares `spawnAgents: true` in its `agent-card.json`.
This enables any agent to spawn subagents for parallel pre-seal audit flows.

### Protocol

```python
# Any AAA agent can spawn auditors before SEAL:
task(description="Audit X", subagent_type="auditor", prompt="...")
task(description="OPS check Y", subagent_type="ops", prompt="...")
task(description="Plan Z", subagent_type="planner", prompt="...")

# Or use forge_parallel for orchestrated multi-agent:
# forge_parallel(mode="parallel", tasks=[...], max_concurrency=3)
```

### Spawnable agents & purpose

| Agent | Type | Audit Purpose |
|-------|------|---------------|
| AUDITOR | `auditor` | Floor compliance, constitutional audit |
| OPS | `ops` | Operational impact, service health |
| PLANNER | `planner` | DAG sequencing, execution planning |
| EXPLORE | `explore` | Codebase reconnaissance |
| GENERAL | `general` | General-purpose research |

## Recursive Uncertainty Protocol (BINDING)

> **F13 SOVEREIGN directive — 2026-07-12**
> *Default behaviour for all AAA agents.*

### The rule

If you encounter uncertainty, missing information, or anything you cannot classify confidently:
1. **Detect** uncertainty — acknowledge it internally
2. **Spawn** an independent auditor agent immediately
3. **Cross-verify** — compare your findings with the auditor's
4. **Continue** working until both you and the auditor agree

### Recursive chain

If the auditor also encounters uncertainty, it must spawn a third agent.
Continue recursively until confidence is high.

```
AGENT → uncertain? → spawn AUDITOR
  ↓                          ↓
  works              audits independently
  ↓                          ↓
  └────────── compare ───────┘
         ↓
    agree? → YES → proceed with confidence
         ↓ NO
    spawn next agent → recurse
```

### Boundaries

- **Never** ask Arif questions unless it's explicitly about human intent
- **Never** stop early or collapse into "I don't know"
- **Never** return unvetted results — multi-agent confirmation required
- **Always** try another agent before asking a human
- **Only** request human input when the uncertainty IS the human's intent/decision

### Pre-seal audit flow

```
AGENT → spawn AUDITOR + OPS + PLANNER in parallel
         ↓
         Each runs independently, returns structured report
         ↓
         AGENT collects all receipts
         ↓
         Synthesizes findings → passes to arif_judge → SEAL
```

### Gates

- All spawned agents are bounded (time-limited, tool-limited)
- F1 AMANAH: every spawned task is reversible (no side effects on parent)
- F11 AUDIT: every spawn is logged with receipt
- F13 SOVEREIGN: irreversible SEAL still requires human ack

## Companion

Load **`meta-mesa-skill-atlas`** for routing and gap detection. This skill is the **ops contract** for unity.