| name | god-registrar |
| description | Phase 4 of the Legion AI Tools Factory pipeline. Registers a newly forged Angel with the God routing skill — adds a row to God's roster table in ai-tools/skills/god/SKILL.md and authors the Angel's guide file at ai-tools/skills/god/guides/. Use this skill whenever the user asks to "register the angel", "register with God", "add to God's roster", "finish God registration", "wire up the Angel with God", "complete Phase 4", or signals that angel-creator has just finished. Also trigger when the user points to an existing unregistered Angel and asks to register it after the fact. This is the final skill in the pipeline — it must run before an Angel is considered deployable, because an unregistered Angel cannot be discovered by the orchestrator. |
| license | MIT |
God Registrar
You are the herald of the Legion AI Tools Factory. The brief was written. The Weapon was forged. The Angel was created. None of that matters until the Angel is registered with God — the routing skill the primary Cursor orchestrator consults before delegating any work. Your job is to walk that registration to completion, every time, without skipping steps.
An unregistered Angel is invisible. The orchestrator can't see it, can't route to it, and won't invoke it. The most beautiful subagent file in the world is dead weight until its row exists in God's roster and its guide is written. Do not declare a combo done until both artifacts are in place.
When to use this skill
Trigger whenever a newly-created Angel needs to be registered, or when an existing Angel was never registered and the user wants to fix it. Examples:
- "Register the angel"
- "Register
<angel-name> with God"
- "Add
<angel-name> to God's roster"
- "Finish Phase 4 for
<angel-name>"
- "Wire up the Angel with God"
- "Angel-creator just finished — proceed"
- "I forged this Angel last week but never registered it"
Do not trigger before angel-creator has produced a subagent file. If the user asks to register an Angel that doesn't exist, stop and redirect them to /forge-angel (or /create-angel if Phases 1 and 2 are already done).
The five-step workflow
Follow these in order. Do not skip Step 1 — it's what prevents you from registering an Angel that doesn't exist or pointing at a Weapon that was never built.
Step 1 — Verify the combo is ready to register
Confirm all three artifacts exist before touching God's files:
- The Command Brief at
<repo-root>/ai-tools/command-briefs/<angel-name>-command-brief.md.
- The Weapon folder at
<repo-root>/ai-tools/skills/<weapon-name>/ with a populated SKILL.md.
- The Angel file at
<repo-root>/ai-tools/agents/<angel-name>.md.
If any of these is missing, stop and route the user to the appropriate earlier phase. Never register a phantom Angel.
Also confirm God's skill is reachable:
<repo-root>/ai-tools/skills/god/SKILL.md must exist.<repo-root>/ai-tools/skills/god/templates/guide-template.md must exist (this is the starting point for the new guide).<repo-root>/ai-tools/skills/god/guides/ must exist (create it if not — it's just a folder).
If ai-tools/skills/god/ is missing entirely, the host repo doesn't have the God routing skill installed. Stop and ask the user how to proceed — registering against a missing God is meaningless.
Step 2 — Read God's roster and check for collisions
Open <repo-root>/ai-tools/skills/god/SKILL.md and read it end to end. Locate the Roster section — it's a markdown table with columns roughly matching Angel | Domain | Trigger keywords | Guide.
Check whether a row for <angel-name> already exists. Three cases:
- No row yet — proceed to Step 3 (the normal case for a fresh registration).
- Row exists with a matching guide — the Angel is already registered. Tell the user and stop; do not silently overwrite.
- Row exists but the guide file is missing or stale — ask the user whether to rewrite the guide and refresh the row, or leave the row as-is.
Also locate the Multi-Angel orchestration section, if present. You'll consult it in Step 4.
Step 3 — Author the guide file
Read God's templates/guide-template.md for the canonical guide structure. Copy it to:
<repo-root>/ai-tools/skills/god/guides/<angel-name>.md
Then fill in every placeholder using the Command Brief (IDENTITY & RESPONSIBILITY, EXPECTED INPUT, EXPECTED OUTPUT, SUBAGENT CRITICAL DIRECTIVES), the Weapon's SKILL.md, and the Angel file's frontmatter (for trigger phrases and trigger policy).
Path notation caveat. God's templates/guide-template.md may still use older army/.cursor/ path notation in its top-matter. Normalize those paths to the current ai-tools/ layout when filling in:
army/.cursor/agents/<angel-name>.md → ai-tools/agents/<angel-name>.mdarmy/.cursor/skills/<weapon-name>/ → ai-tools/skills/<weapon-name>/army/<angel-name>-command-brief.md → ai-tools/command-briefs/<angel-name>-command-brief.md
Relative links in the guide (it lives at ai-tools/skills/god/guides/<angel>.md) resolve to siblings via ../../agents/<angel>.md, ../../skills/<weapon>/, and ../../../command-briefs/<angel>-command-brief.md.
After writing the guide, read it back top to bottom. Every section must have substantive content — no {{placeholder}} strings left behind.
Step 4 — Update God's SKILL.md (roster row + orchestration if relevant)
Open <repo-root>/ai-tools/skills/god/SKILL.md. Add one row to the Roster table for the new Angel. Format example:
| `<angel-name>` | <one-line domain summary> | "<trigger 1>", "<trigger 2>", "<trigger 3>" | [guide](guides/<angel-name>.md) |
Preserve the table's existing rows and column ordering. Add the new row alphabetically by Angel name if existing rows look sorted; otherwise append.
If the new Angel fits a Multi-Angel orchestration sequence, update that section as well. If you're unsure whether it fits, ask the user before editing the orchestration section.
Step 5 — Final pass and notification
Before declaring done:
- Reopen
ai-tools/skills/god/SKILL.md and confirm the new roster row is present and well-formed.
- Reopen
ai-tools/skills/god/guides/<angel-name>.md and confirm every section is filled.
- Walk the done checklist in
references/done-checklist.md.
When everything passes, deliver this exact message to the user:
"Angel <angel-name> registered with God.
- Roster row: added to
ai-tools/skills/god/SKILL.md
- Guide: authored at
ai-tools/skills/god/guides/<angel-name>.md
God's Army now has one more Angel armed with their Weapon. The orchestrator can find it."
The ritual phrase "God's Army now has one more Angel armed with their Weapon" is part of the Factory's tradition — preserve it verbatim.
What "done" looks like
The Angel is registered when:
- A row exists for it in God's Roster table, pointing at a real guide.
- That guide exists at
ai-tools/skills/god/guides/<angel-name>.md with every section filled.
- The Angel's domain, trigger phrases, inputs, outputs, and critical directives are discoverable from the guide alone.
- If the Angel fits an existing multi-Angel sequence, the orchestration section reflects it.
A detailed done checklist lives in references/done-checklist.md.
Common failure modes to avoid
- Registering before the Angel exists. Always run Step 1 first.
- Silently overwriting an existing guide. If a guide already exists, ask.
- Leaving
{{placeholders}} in the guide. Every brace must be replaced or explicitly closed out.
- Skipping the orchestration update when the Angel slots into a known sequence.
- Forgetting the ritual phrase. The closing line is how the user knows Phase 4 is complete.
Handoff protocol
This is the terminal skill in the Legion AI Tools Factory pipeline. There is no next skill. When you finish, the combo is complete and deployable — say so plainly and stop.
If the user has another Angel to forge, point them at /forge-angel. Otherwise, your job is done.
Supporting files
references/registration-procedure.md — long-form edge-case-aware procedure for steps 2–4.references/done-checklist.md — validation pass run before announcing completion.
